Product guide

使用文档

从部署、添加站点到保存凭据，按步骤完成配置并排查常见问题。

新增站点 查看执行记录

01 · Getting started

快速开始

所有站点都遵循同一套配置流程，站点负责执行时间，凭据代表具体账号。同一站点可以添加多个账号。

  1. 新增站点进入“站点管理”，选择站点类型、名称和每日执行时间。
  2. 保存凭据进入站点详情，按站点类型填写 Cookie 或账号密码。
  3. 立即签到保存后先手动执行一次，确认凭据和服务器网络均可用。
  4. 查看结果在“执行记录”和“系统日志”中核对返回信息；验证完成后再启用自动签到。
建议：首次配置时把执行时间设在未来几分钟，手动签到通过后再调整为长期计划。

02 · New API

配置 New API 站点

  1. 填写站点地址使用完整域名，例如 https://example.com，不要附带控制台路径、查询参数或锚点。
  2. 复制 Cookie登录目标站点后，从浏览器开发者工具的 Network 请求中复制完整 Cookie；仅有 session 值时也可直接填写。
  3. 填写用户请求头自定义请求头通常需要 New-API-User: <用户 ID>，用户 ID 必须与 Cookie 所属账号一致。
  4. 立即验证保存后执行一次签到；若提示未授权，请重新登录目标站点并更新 Cookie。
Cookie 获取提示：在已登录页面按 F12 打开开发者工具，切换到 Network，刷新页面并选择任意同域 API 请求，在 Request Headers 中复制 Cookie。

03 · cloud.189.cn

配置天翼云盘

  • 填写可登录天翼云盘网页端的手机号/邮箱账号和密码，系统会在每次签到前重新登录。
  • 若登录信息无误但持续失败，请检查服务器到 open.e.189.cn、api.cloud.189.cn 和 cloud.189.cn 的 DNS 与出站网络。
  • 可在项目目录运行 bash scripts/diagnose_cloud189.sh 辅助诊断。
  • 同一个天翼云盘站点可以逐个新增多个账号，执行时会分别记录结果。

04 · HTTP OAuth

配置 AgentRouter 登录即签到

  1. 选择访问域名大陆网络推荐 ps.air-outer.com，也可保留并手动选择原域名 agentrouter.org；已有站点可在编辑页切换。
  2. 人工准备一次在自己的正常浏览器登录 GitHub；如果使用 Google、密码或 2FA，均在 GitHub 页面内完成。再从 AgentRouter 点一次“使用 GitHub 继续”，确保 OAuth 已授权。
  3. 导出 GitHub Cookie打开 GitHub 开发者工具的 Network，刷新任意 github.com 页面，选择文档请求，从 Request Headers 复制完整 Cookie；不要只复制 document.cookie。
  4. 保存会话在 AgentRouter 站点详情选择 GitHub 并粘贴 Cookie。凭据会使用 APP_SECRET 加密保存。
  5. 纯脚本签到系统请求 AgentRouter OAuth state，携带 GitHub Cookie 获取 code，再调用 AgentRouter 回调。响应中的 checked_in=true 才记录为本次到账。
会话边界：GitHub 会话过期、撤销 OAuth、设备验证或重新要求授权/2FA 时，任务会提示重新在浏览器处理并导出 Cookie，不会尝试保存或填写密码。

05 · Push notifications

配置 Bark 推送

  1. 复制 Device Key在 iPhone 的 Bark App 中复制测试推送地址，其中紧跟服务器域名的路径段就是 Device Key。
  2. 填写服务器地址在“系统设置”中保持默认的 https://api.day.app，自建 Bark 时填写服务器根地址或部署子路径。
  3. 启用并保存填写 Device Key 后启用推送。Device Key 使用 APP_SECRET 加密保存，页面不会回显。
  4. 发送测试保存后点击“发送 Bark 测试推送”；测试成功后，手动和自动签到都会发送汇总。
结果边界：推送会包含站点、触发方式、成功/已签到/失败数量及失败详情。Bark 暂时不可用时只记录系统日志，不会修改签到结果。

06 · Troubleshooting

常见问题

New API 提示 Cookie 无效或未授权

重新登录目标站点，获取最新 Cookie，并确认 New-API-User 与当前账号的用户 ID 一致。

天翼云盘账号正确但登录失败

先运行网络诊断脚本。如果 DNS 和 HTTPS 均正常，再确认账号没有触发验证码、设备验证或临时风控。

自动签到没有执行

确认站点已启用、系统时区正确、执行时间格式为 HH:MM，并检查当天是否已有成功或“已签到”记录。

AgentRouter 提示 GitHub 会话失效或需要授权

在自己的浏览器重新完成 GitHub 登录、AgentRouter 授权或 2FA，然后从 github.com 请求头复制最新 Cookie 并替换后台凭据。

保存账号后如何确认有效

保存时会执行适配器支持的凭据校验。最可靠的方法仍是立即签到，并在执行记录中查看该账号的返回摘要。

07 · Security

凭据安全

  • 部署前务必修改 APP_SECRET，它用于加密 Cookie 和账号密码。
  • 不要把真实凭据写入 README、Compose 文件、截图、Issue 或聊天记录。
  • 只在受信任的个人服务器部署；当前后台是单用户系统，没有登录鉴权。
  • AgentRouter 的 GitHub Cookie 和 Bark Device Key 均属敏感信息；务必修改 APP_SECRET，并限制后台与数据目录的访问。
  • Google/GitHub 密码与 2FA 不进入本系统；脚本仅保存 GitHub Cookie，并在上游刷新 Cookie 时加密回存。
  • 怀疑凭据泄漏时，先在对应平台退出登录或修改密码，再删除后台中的旧凭据。