SuperAPI AI 工具集

codex-lb-load-balancer

部署与运维

查看项目

更新于 10-15 22:32

技能介绍

用途:codex-lb 是一个负载均衡与代理服务,用于把多个 ChatGPT/Codex 账号集中起来,对外提供兼容 OpenAI 的接口(/v1/* 与 /backend-api/codex/*),供 Codex CLI、OpenCode、OpenClaw、OpenAI SDK 等客户端使用。

主要能力:在多个 ChatGPT 账号间自动负载均衡;按账号统计 token、费用与 28 天趋势;API Key 管理并支持按 Key 的 token、费用、时间窗口、模型限制;带密码与可选 TOTP 的管理面板;自动从上游同步可用模型;支持 Codex 原生流式传输的 WebSocket。

安装与使用:Docker 方式创建数据卷并运行容器,映射 2455(面板与代理)与 1455(健康检查)端口;也可用 uvx codex-lb 运行。面板地址为 http://localhost:2455,代理端点为 /v1 与 /backend-api/codex,健康检查为 http://localhost:1455/health。远程首次访问需用 bootstrap token 设置密码,可通过 docker logs codex-lb 查看自动生成的 token,或用 CODEX_LB_DASHBOARD_BOOTSTRAP_TOKEN 指定;本地访问无需 bootstrap。在面板 Accounts 中添加账号,在 API Keys 中创建密钥并配置限额;API Key 鉴权默认关闭,远程或容器网络下建议在设置中启用以 Bearer sk-clb-... 方式传递。

适用场景:团队共享多个账号并按成员限额、CI/CD 使用独立密钥、按模型限制昂贵模型、需要用量与费用统计的代理场景。

限制:资料未提供支持的账号类型之外的信息、具体授权要求与定价;多副本部署需共享 CODEX_LB_ENCRYPTION_KEY;反向代理需转发 WebSocket 升级;若账号同步失败可更新镜像;使用数据目录与数据库重建等操作有风险,需自行评估。