vsdoex Docs

排查手册

常见问题

把使用说明和部署说明里的高频故障集中到一页，方便快速定位。

项目：Codex 中转站 公开脱敏版 路由：/faq

返回 401 Unauthorized

  • 客户端填错了 API Key。
  • 客户端还在用已经失效的旧 key。
  • 请求头没有正确带上 Authorization: Bearer ...。

先确认当前软件里填的是不是对应用途的 key。

返回 302 或跳登录页

通常表示 API 域名被错误套上了 Cloudflare Access。

正确状态:
admin.vsdoex.asia 受保护
api.vsdoex.asia 不受保护

返回 502

通常表示服务端容器没正常起来，或者 Tunnel 到本地服务的转发异常。

cd /opt/cliproxyapi
docker compose --env-file .env.cloudflare logs --tail=100 cloudflared

调用能连上，但模型报错

  • 检查上游授权状态。
  • 检查渠道状态。
  • 检查代理配置是否有效。

chat/completions 返回代理错误

  • 把出口 IP 填成了代理主机。
  • 端口填错。
  • 协议填错，HTTP 写成 SOCKS5 或反过来。
  • 代理账号密码错误。
  • 代理服务未启用。

某个 key 怀疑泄露

  1. 去 config.yaml 删除那个 key。
  2. 重启 cli-proxy-api。
  3. 给对应软件换一个新 key。
  4. 再测试 /v1/models。

快速排查命令

查看服务状态:
cd /opt/cliproxyapi
docker compose ps

查看 API 服务日志:
cd /opt/cliproxyapi
docker compose logs --tail=100 cli-proxy-api

查看 Tunnel 日志:
cd /opt/cliproxyapi
docker compose logs --tail=100 cloudflared