展开本页目录
开始前准备什么
- 记录 CC Switch 与目标客户端版本、错误全文和时间；备份客户端配置。
- 在路由面板复制实际监听地址与端口；默认值仅用于示例。
- 确定模型请求在本机、WSL、SSH 还是容器内发出，先不发送模型请求。
- 定位运行环境
- 检查监听
- 确认应用路由
- 核对上游
- 恢复小任务
下载本地监听检查
无 Key，无模型请求；只允许 loopback HTTP。
先区分本地连不上和上游拒绝
| 观察 | 代表什么 | 下一步 |
|---|---|---|
| TCP refused | 该环境没有可用监听或端口错误 | 看路由开关、实际地址与端口占用 |
| TCP timeout | 路径、绑定或系统代理影响 | 在实际环境逐段检查网络 |
| HTTP 401 / 400 | 已到 HTTP 服务；可能是认证或请求格式 | 看对应路由和上游错误正文 |
| HTTP 502 / 转发错误 | 本地服务收到但上游失败 | 查上游地址、网络、协议与代理 |
| GET / 返回 404 | 根路径未定义但 HTTP listener 有响应 | 不是模型调用成功，也不必然是路由停了 |
- 观察
- TCP refused
- 代表什么
- 该环境没有可用监听或端口错误
- 下一步
- 看路由开关、实际地址与端口占用
- 观察
- TCP timeout
- 代表什么
- 路径、绑定或系统代理影响
- 下一步
- 在实际环境逐段检查网络
- 观察
- HTTP 401 / 400
- 代表什么
- 已到 HTTP 服务；可能是认证或请求格式
- 下一步
- 看对应路由和上游错误正文
- 观察
- HTTP 502 / 转发错误
- 代表什么
- 本地服务收到但上游失败
- 下一步
- 查上游地址、网络、协议与代理
- 观察
- GET / 返回 404
- 代表什么
- 根路径未定义但 HTTP listener 有响应
- 下一步
- 不是模型调用成功，也不必然是路由停了
只测监听：无需 Key，不发模型请求
下载检查脚本，在真实客户端运行环境执行。它只允许本地 HTTP 地址，用 TCP 与 GET / 检查 listener；不读取 Key、不访问模型接口。根路径 404 仍能说明 HTTP 服务响应，需要再检查路由日志确认服务身份。
本地监听检查
bash
python3 cc-switch-connection-check.py --base http://127.0.0.1:15721
本站绘制的内容说明图：本页检测只判断本地代理是否有响应；根路径 404 仍可能说明服务在运行，不能据此判断模型接口失败。
服务开关和应用路由分别确认
- 在 CC Switch 当前路由面板核对总开关与目标应用开关，确认实际 provider。
- 客户端指向本地地址、Key 显示 PROXY_MANAGED 属于路由托管；真实上游 Key 与模型在 CC Switch。不要在客户端把占位值换成真实 Key。
- 端口冲突时先停止路由，再改地址或端口、保存、启动；检查客户端最终配置随之更新。
- 保留请求日志中的 requested model → actual model、协议和错误；不要分享真实 Key、私有提示词或本机敏感路径。
本站绘制的内容说明图：此图区分本地代理地址、被管理凭据和上游模型；不能把本地根路径通达当收费调用成功。
WSL、SSH、容器要看实际网络边界
| 客户端运行处 | 127.0.0.1 指向 | 检查办法 |
|---|---|---|
| 本机进程 | 本机 | 在同机验证 listener 与目标应用开关 |
| WSL2 默认 NAT | WSL 自己的环境 | 官方建议用 mirrored networking；核对当前 WSL 模式 |
| Remote SSH | 远程机器 | 使用该主机自己的 provider；不要照抄桌面 localhost |
| Dev Container | 容器内 | 按自己的隔离网络设计地址；检查容器实际配置 |
| 系统 HTTP 代理 | 可能把 loopback 再转发 | 只测本地时直连；核对 NO_PROXY 和代理进程 |
- 客户端运行处
- 本机进程
- 127.0.0.1 指向
- 本机
- 检查办法
- 在同机验证 listener 与目标应用开关
- 客户端运行处
- WSL2 默认 NAT
- 127.0.0.1 指向
- WSL 自己的环境
- 检查办法
- 官方建议用 mirrored networking；核对当前 WSL 模式
- 客户端运行处
- Remote SSH
- 127.0.0.1 指向
- 远程机器
- 检查办法
- 使用该主机自己的 provider；不要照抄桌面 localhost
- 客户端运行处
- Dev Container
- 127.0.0.1 指向
- 容器内
- 检查办法
- 按自己的隔离网络设计地址；检查容器实际配置
- 客户端运行处
- 系统 HTTP 代理
- 127.0.0.1 指向
- 可能把 loopback 再转发
- 检查办法
- 只测本地时直连；核对 NO_PROXY 和代理进程
需要恢复直连时，先让 CC Switch 归还配置
官方 README 说明：关闭本地路由会写回此前标为 Direct 的 provider，退出 CC Switch 也会先恢复直连设置。先确认要恢复的供应商，再关闭对应路由并回读配置、重启目标客户端；只删除 localhost 行可能仍被接管覆盖。
- API 直连与官方订阅分别选择，保留原认证和其他配置，不清空整个目录。
- 恢复后检查实际最终地址和认证来源，再做最小请求。
- 要用自定义直连，Responses、Messages、Chat 的地址和模型权限分别核对。
恢复验收：先小请求，再读一个测试文件
- 先以本地脚本确认 listener；路由日志与客户端配置说明当前模式。
- 接着自行发送最小任务，核对有效回答、上游 ID 和日志；这一步可能产生费用。
- 在隔离目录要求客户端读取一份三行 README，报告第三行原文；确认真正读取文件，再恢复较大任务。
- 本页仅提供检查材料，没有执行你的 listener、上游请求或付费任务；不要把端口可达标记为完整接入成功。
怎样确认已经完成
- 真实运行环境能访问正确 listener，身份由 CC Switch 面板和日志确认。
- 客户端接管状态、上游 provider 和准确模型可对应。
- 恢复后有效回答与文件读取分别通过。
常见问题
看到 PROXY_MANAGED 是 Key 丢了吗？
路由模式中它是客户端占位，真实供应商 Key 在 CC Switch。先核对路由是否启用和对应 provider，不手动把真实 Key 塞进被接管文件。
Windows 终端能用，WSL 为什么不行？
WSL2 默认 NAT 下 localhost 不自动访问 Windows 的路由。官方建议 mirrored networking；核对当前版本和模式，再在 WSL 自己的环境测试。
脚本返回 404 可以继续吗？
它说明根路径收到了 HTTP 响应，不证明模型路由成功。确认监听身份、目标应用接管和上游配置，再做单独模型验收。
应不应该把 listener 改成 0.0.0.0？
先确定网络设计和访问范围。官方默认 loopback 供本机使用；不要为解决一次连接失败直接向全部接口开放凭据路由。