本地部署的 OpenAI / Anthropic 双协议兼容网关,透明代理 CommandCode AI,内置中文仪表盘 · A locally deployed OpenAI / Anthropic dual-protocol gateway that transparently proxies CommandCode AI with a built-in dashboard
Repo wjf1/commandcode-proxy, read from GitHub 1 min ago. wjf1 has not joined Take My Repo.
管理面写操作一次性凭据(批次 B 回移植):/api/* 的写请求凭 x-admin-token(401 拦截),与 PROXY_API_KEY 权限分离——数据面密钥泄露不再等于管理面失守;token 由服务端注入 dashboard 页 <head> meta(前端 apiJson 自动携带),可用 ADMIN_API_TOKEN 固定供脚本使用。配套 B2 Host 回环白名单(防 DNS rebinding 页面连 token 一起读走,ADMIN_ALLOWED_HOSTS 可追加);新增 src/utils/admin-guard.ts 与纯函数测试,新增「无 token 401」守卫用例,既有集成/掩码测试同步带凭据。
升级注意(脚本调用方):直接用 curl / 脚本打 /api/* 写接口的调用方现在必须带 x-admin-token,否则收到 401。取 token 的两种方式:读仪表盘页面 <head> 里的 meta,或设 ADMIN_API_TOKEN 固定值。/v1/* 数据面不受影响,仍只认 PROXY_API_KEY。
非回环绑定且未设 PROXY_API_KEY 时拒绝启动(原为仅告警),与同源仓 multi-upstream-gateway 安全默认对齐;ALLOW_INSECURE_BIND=1 显式豁免。同批:补 pretest:coverage 钩子(test:coverage 先 build,防集成用例 spawn 过期 dist);新增 gitleaks 扫描 workflow;修复 tests/proxy-agent.test.ts 未使用的 dns import(此前连续挂 CI)。
HANDOFF.md:面向 GitHub 协同的六模块接力文档(概况 / 技术栈 / 架构拓扑 / 最近变更 / 待办 / 避坑),覆盖 4.22.2-4.22.4 三轮网络链路演进;机器专属的部署运维细节拆分至本地 HANDOFF.local.md(.git/info/exclude 排除,不入库)。dns.setDefaultResultOrder('ipv4first')(可通过 COMMANDCODE_DNS_ORDER 自定义),彻底避开国内运营商恶劣的 IPv6 握手黑洞与 10 秒超时(UND_ERR_CONNECT_TIMEOUT);proxy-agent 启动时自动执行 TCP 快速探针;若本地代理未开启或切换至无代理环境,自动平滑回退为 IPv4 优先直连模式,绝不阻塞任何模型调用;https://api.commandcode.ai 时,因国内网络对 Cloudflare CDN 节点的丢包、高延迟及 IPv6 首选握手失败,导致后台额度同步、健康探活及部分模型调用频繁抛出 fetch failed(UND_ERR_CONNECT_TIMEOUT)。
src/utils/proxy-agent.ts,基于 undici 的 ProxyAgent 与 setGlobalDispatcher,将全局出站 fetch 流量路由至本机科学上网客户端(默认 http://127.0.0.1:7897);config.json(upstream.proxy)与环境变量(HTTPS_PROXY / HTTP_PROXY / ALL_PROXY);NO_PROXY,确保本地回环地址(localhost,127.0.0.1,::1)直连,保证本地测试与 Fastify 服务不受代理影响;start.cmd 与 .env 中固化出站代理支持;tests/proxy-agent.test.ts 单元测试,全量 48 个套件、621 个测试用例 100% 通过。api.commandcode.ai 会被解析为 198.18.x.x 假 IP,DNS rebinding guard 将其判为保留地址直接拒绝,start.cmd 注入 COMMANDCODE_UPSTREAM_ALLOWED_HOSTS=api.commandcode.ai,dns.fake-ip-filter 加入 +.commandcode.ai,watchdog.ps1 同步注入环境变量(被 .gitignore 忽略,需本机部署手动同步)。~/.env(2026-09-04 凭据文件)使 admin-key-mask 一项隔离断言失败,与本次变更无关。ORIGIN_SCHEME_CHECK=off 显式回退。优化提升计划收尾:架构 D(upstream Pipeline)完成 + 仪表盘运营能力可视化。
零配置升级承诺:API 行为与错误语义零变化(导出面 14 符号逐一比对一致);
前端为纯增量两张只读卡片,默认渲染不变。
pipeline/ 5 个阶段模块(timeouts 超时装配 / request 受控请求含 SSRF 重定向防护 /GET /api/features 只读端点:健康检查/Webhook/Prompt 版本/限流/模型访问/审计tsc --noEmit、eslint 零错误。