反向代理 / 反代
也写作「反代网关」「把客户端反代成 API」
- 登录态代理
- OAuth / PAT 入池
- 本地回环
MIT 开源 · v1.0.1 · Python 3.10+ · Docker / ghcr
三套 AI 客户端各带一套反代网关:三个窗口、三套地址、三遍配置,一个账号挂了客户端只会报错。 本仓库把三家引擎原样收进同一个进程,在上面加一层融合网关 —— 一把合并 Key 按模型与区域自动选路,401/429/502/503/504 自动换到下一家,客户端无感。
Base URL : http://127.0.0.1:8817/v1
API Key : mrg-xxxxxxxx # 面板「网关 Key」里的合并 Key
Model : auto # 或任意一家的模型名,门户自己挑路
01 · 问题
WorkBuddy、Qoder、Trae 的客户端各自带一套反代网关,各管各的账号、各开各的端口、各有一套看板。单看哪家都合理,三家一起用就变成三件事。
02 · 收敛
融合层不加新协议,只做减法:把「三家」对外变成「一家」。
三家引擎跑在同一个 Python 进程里,模块名前缀 wb_* / qoder_* / trae_* 互不污染。启停、日志、自检都只看一处。
只有 8817 对外。8811 / 8812 / 8813 属于内部回环,外部连不上 —— 少记三个地址,也少暴露三个面。
合并 Key 按「模型在谁家、哪个区可用」选路;401/429/502/503/504 自动换下一家。每把 Key 还能限定可用模型与可用引擎。
账号池、模型清单、数据指标、请求流水、网关 Key、福利中心、设置与一键更新,同一个 React 看板里看完三家。
对外统一 OpenAI Chat Completions / Responses 与 Anthropic Messages,含 SSE 流式。/v1/* 与 /api/v1/* 等价,客户端填哪个都行。
03 · 架构
请求路径与看板路径分开走,同一个端口、两套语义。
客户端 → 门户(鉴权 + 选路)→ 引擎(选号 + 上游协议)→ 上游
浏览器 → 门户 /api/hub/*(一次拿三家)→ 引擎 /usage、/accounts
POST /v1/chat/completionsOpenAI Chat,支持流式与非流式POST /v1/responsesResponses API,Codex 走这条POST /v1/messagesAnthropic Messages,x-api-key 与 Authorization 都认GET /v1/models三家合并去重,同名只算一个ANY /api/v1/*与 /v1/* 完全等价的别名GET /api/hub/*看板聚合:健康、账号、指标、流水、Key04 · 叫法
这些词说的都是本项目 —— 按你熟悉的说法读下去就行,每张卡右边是它在 Hub 里的具体实现。
也写作「反代网关」「把客户端反代成 API」
也写作「模型中转」「统一中转」
也写作「格式转换」「OpenAI 转 Anthropic」
也写作「Gateway」「统一入口」
也写作「账号轮询」「批量签到」「积分管理」
也写作「自动换家」「failover」「轮询」
也写作「给 Codex 用」「接 Claude Code」
也写作「容器化」「私有化部署」「NAS 上跑」
05 · 面板
React 19 + Vite 构建,静态产物直接由门户提供,和 API 同源。下面是按 v1.0.1 功能重绘的界面示意(非实盘截图)。
| 账号 | 引擎 | 出口 | 今日积分 | 签到 | 健康 | 操作 |
|---|---|---|---|---|---|---|
| 团子 | wb | cn | 190 万 / 250 万 | 已签到 | 健康 | 启停 · 测试 · 积分明细 |
| 夜梦 | qd | int1 | 81.2 万 / 400 万 | 已签到 | 健康 | 启停 · 测试 · 积分明细 |
| 阿柚 | trae | cn | 3.0 万 / 12 万 | 未签到 | 限流冷却 42s | 签到 · 测试 · 代理槽位 |
| 白露 | wb | int | — | 已签到 | 本地停用 | 启用 · 积分明细 |
签到状态、积分增减、出口区域绑定、启停与连通性测试在同一页;被限流的账号会显示冷却剩余时间。
| 模型 | 来源 | 可用区 | 协议 | 定价 |
|---|---|---|---|---|
| glm-4.6 | wbqd | cn | Chat · Messages | ¥ / 百万 token |
| kimi-k2 | qd | cn · int | Chat | ¥ / 百万 token |
| deepseek-v3.2 | traewb | cn | Chat · Responses | ¥ / 百万 token |
| claude-sonnet-4.5 | trae | int1 | Messages | $ / 百万 token |
| auto | hub | 按可用性 | 全部 | 由实际命中引擎计 |
同一家上游的模型名会原样保留;清单里的可用区与协议随上游调整而变化,实时状态以面板为准。定价列可自定义,供指标页换算花费。
区间可切今天 / 7 天 / 30 天 / 本月 / 全部 / 自定义;含 Top 账号、Top 模型、Top 提供商、活跃热力图与趋势线。若某一家没返回数据,页面顶部会挂黄色横幅说明当前只是半边统计。
| Key | 类型 | 可用模型 | 可用引擎 | 今日 | 状态 |
|---|---|---|---|---|---|
| mrg-8f2a… | 合并 | 全部 | wb · qd · trae | 2.1 万 / 20 万 | 启用 |
| mrg-31cc… | 合并 | 仅 4 个 | 仅 qd | 3,208 / 5 万 | 启用 |
| wb-77b0… | 引擎 wb | wb 全部 | wb | 1,046 / — | 启用 |
| trae-2e… | 引擎 trae | 仅 2 个 | trae | — / 1 万 | 限额将满 |
越权请求直接返回 403 model_not_allowed 或 503 engine_not_allowed;「一键测试」用当前 Key 真发一条,返回形如 PASS 200 · 1800 ms · qd:cn。
06 · 选路与故障转移
门户先看模型在谁家、哪个区可用;出错码命中白名单就换下一家,但绝不在已经写出字节之后换。
校验合并 Key 与作用域:模型不在允许名单里 → 403。
路由器按模型可用性与区域排序,取当前可用账号;结果带快照缓存。
该账号进冷却窗口并标记原因,面板上能看见「限流冷却 42s」这类状态。
401/429/502/503/504 且尚未写出字节 → 换到另一家引擎重试。
SSE 边收边发。已经向客户端写出第一个字节后绝不重发,避免同一个回答来两遍。
→ POST /v1/chat/completions model=deepseek-v3.2 key=mrg-8f2a…
· route: [wb:cn, qd:cn, trae:int] # 三家都声称能跑这个模型
· try 1 wb:cn 429 too_many_requests 180 ms # 账号进冷却 42 s
· try 2 qd:cn 200 ok · SSE 1.4k tok 2 140 ms # 已写出首字节 → 不再重试
← 200 OK engine=qd region=cn attempts=2 # 流水里 attempts 会记成 2
07 · 接入
地址只有一个:http://127.0.0.1:8817/v1;密钥用面板「网关 Key」里的合并 Key mrg-…。局域网模式会强制要求 Key。
# ~/.codex/config.toml
model = "auto"
model_provider = "wqt"
[model_providers.wqt]
name = "WQT Hub"
base_url = "http://127.0.0.1:8817/v1"
env_key = "WQT_API_KEY"
wire_api = "responses"
export WQT_API_KEY="mrg-xxxxxxxx"
门户的 /v1/responses 与 Chat、Messages 一样会做跨引擎换家;换家失败时客户端只看到最终错误或成功,看不到中间的 429。
export ANTHROPIC_BASE_URL="http://127.0.0.1:8817"
export ANTHROPIC_API_KEY="mrg-xxxxxxxx"
# 或指定某个模型的形态
claude --model deepseek-v3.2
/v1/messages 同时接受 x-api-key 与 Authorization: Bearer;流式走 SSE 透传,首字节写出后不再换家。
from openai import OpenAI
cli = OpenAI(
base_url="http://127.0.0.1:8817/v1",
api_key="mrg-xxxxxxxx",
)
r = cli.chat.completions.create(
model="auto",
messages=[{"role": "user", "content": "把三段日志合并成一句结论"}],
stream=True,
)
Node / Go SDK 同理,/api/v1/* 是 /v1/* 的等价别名;GET /v1/models 返回三家合并去重后的清单。
import anthropic
client = anthropic.Anthropic(
base_url="http://127.0.0.1:8817",
api_key="mrg-xxxxxxxx", # 或 x-api-key,门户都认
)
msg = client.messages.create(
model="claude-sonnet-4.5",
max_tokens=1024,
messages=[{"role": "user", "content": "hi"}],
)
模型名以面板「模型清单」为准 —— 清单随三家上游变化,可用性实时标注。
curl -sS http://127.0.0.1:8817/v1/chat/completions \
-H "Authorization: Bearer mrg-xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"model":"auto","stream":true,
"messages":[{"role":"user","content":"说一句话"}]}'
面板「网关 Key → 一键测试」做的是同一件事,会给出 PASS 200 · 1800 ms · qd:cn 这样的真实结果(会消耗一点点额度)。
接口地址 / Base URL : http://127.0.0.1:8817/v1
API Key : mrg-xxxxxxxx
模型 / Model : auto(或清单里任意一个名字)
只要客户端支持自定义 OpenAI 兼容地址就能接;从别的机器访问请把门户端口暴露出去,局域网模式强制要求 Key。
08 · 部署
首次启动会自建目录、起三家引擎、打印入口地址与合并 Key。面板默认密码 admin,登录后请立刻改。
| 端口 | 用途 | 对外 |
|---|---|---|
| 8817 | 门户:面板 + API | 是 |
| 8811 | WorkBuddy 引擎 | 否 |
| 8812 | Qoder 引擎 | 否 |
| 8813 | Trae 引擎 | 否 |
WorkBuddy x Qoder x Trea-hub.bat
:: 打开面板
start http://127.0.0.1:8817
需要 Python 3.10+;局域网版脚本 …-lan.bat 会强制要求 Key。
./start-hub.sh # 前台,日志直接看
./start-hub-lan.sh # 允许局域网访问(强制要 Key)
macOS 也可用 start-hub.command 双击启动。
docker run -d --name wqt-hub \
-p 18791:8817 \
-v "$PWD/data:/app/data" \
ghcr.io/shuishuipingan/workbuddy-qoder-trae-hub:latest
宿主机 18791 → 容器门户 8817;18789 / 18790 / 18792 是三家引擎的调试端口,平时不必映射。
git clone https://github.com/shuishuipingan/workbuddy-qoder-trae-hub.git
cd workbuddy-qoder-trae-hub
docker compose up -d
compose 文件里已写好端口与数据卷;升级时 docker compose pull && up -d,账号与用量在卷里不动。
09 · 工程与隐私
发布前有闸门,同步后有逐字节校验,更新时有保护名单。
账号、用量、日志、面板设置全在你自己机器上;仓库不含任何真实账号、Key 或用量。.gitignore 硬性排除 accounts/、usage/、logs/、state/、hub/settings.json。默认密码 admin,局域网模式强制 Key。
面板「设置 → 版本与更新」检查 GitHub Release 后点一次立即更新:下载 → 只覆盖代码 → 自动重启。账号 / 用量 / 日志 / 设置都在 updater.PROTECTED 里写死跳过。
python hub/tools/sync_upstream.py --wb --qd --trae 同步后由 verify_sync 逐字节比对,除 hub-patch 标记块外必须完全一致 —— 引擎逻辑改没改,逐字节对得上。
python hub/tools/release_check.py:前端 75 项 + hub 324 项判据(23 个套件)+ 上游一致性 + 重启不丢数据 + 写失败可诊断,全绿才发版。
| 引擎 | 上游仓库 | 收录方式 | 许可证 |
|---|---|---|---|
| wbWorkBuddy | ardeyouxipianyi/workbuddy2api-hub | 原样收编,补错误处理块 | 按上游原许可证 |
| qdQoder | shuishuipingan/qoder2api-hub | 原样收编,补错误处理块 | 按上游原许可证 |
| traeTrae | trae2api-hub | 原样收编,补错误处理块 | 按上游原许可证 |
| hub融合层 | 本仓库 hub/ · admin/ · docs/ | 门户、路由、聚合、面板 | MIT |
10 · FAQ
克隆就跑,MIT 开源,数据不出本机。有问题欢迎在仓库开 Issue。