常见问题

调用类

请求返回 401？

• 检查 Authorization: Bearer <API_KEY> 头是否带上、值是否与 Worker 的 API_KEY secret 一致；
• 子密钥只能调 /v1/*，用子密钥访问 /admin/* 一律 401；
• 根路径 / 返回 401 是刻意的（避免被扫到），不算故障。

qoder 请求偶发「服务繁忙」？

那是上游排队（实测常见 21–25 秒）：服务端按它给的延迟等待重试（单次等待上限 10 秒、最多 3 次、总预算 45 秒），超预算会如实报「排队太挤」。稍后重试即可， 这是容量问题，不是账号或配置问题。

腾讯渠道报 11128 unapproved channel？

上游开启了客户端真实性检测，非官方客户端（本反代即属此类）的请求可能被拒。 两家腾讯渠道已降级到路由最后，有其它渠道时先走别的。这不是本服务可修的问题。

zcode 报 405 / code 3012 unusual activity？

判为账号 / IP 级风控（官方身份块已逐字对齐且实测正确）。参考实现也明确： 身份块达标仍 3012 目前没有已知解释。

部署类

2 - Deploy Cloudflare 失败，日志是认证/权限错误？

检查 GitHub Secrets CF_ACCOUNT_ID / CF_API_TOKEN 是否已配、Token 是否用的 「Edit Cloudflare Workers」模板。若报「不能创建 Worker」，见 部署 · 配置 Secrets 的 Admin 说明。

部署成功但面板 401 / 写入凭据被拒？

Worker 端 API_KEY / CREDENTIAL_KEY 没设或值不对。两种设法见 部署 · 运行时口令。

本地 npm ci 通过、CI 却报 ERESOLVE？

CI 的 npm 版本更旧、peer 校验更严格（peerOptional 照样校验）。用同款版本复现：

npx -y npm@10.9.2 ci

账号类

账号「动不动就掉登录」？

面板账号列表会显示凭据过期时刻（epoch ms）—— 这是唯一能区分「凭据过期」还是 「账号被限流」的观测口。支持续期的家（8 家）会在过期前 1 小时被 cron 自动换新； 不支持续期的家到期后需要重新登录 / 导入。

导入凭据后账号出现在别家名下？

各家判别式对形状重叠的字段有顺序依赖（如 lobsterai 与 raccoon 的 user_id 都是纯数字）。显式声明 "provider":"<id>" 导入即可精确落位；如果声明了还落错， 那是判别式缺陷，欢迎提 issue。

Qoder 中国版凭据导入后被认成国际版？

两家凭据形状完全相同，自动识别分不清。粘贴导入时必须显式声明 {"provider":"qodercn","accounts":[…]}；面板设备码登录无歧义。