codex-lb 是自托管的 ChatGPT/Codex 账号池、反向代理和用量控制台。它把多个上游账号汇成 OpenAI 兼容接口,再给下游客户端发本地 API key、设置配额并记录成本。它位于用户提示词、文件引用、OAuth 凭据和上游响应的中间位置,安全责任远高于普通用量面板。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/ 查看 GitHub 仓库 → 📘 使用教程 →多账号的额度窗口、continuation state 和实时连接不能简单轮询;codex-lb 因此实现账号健康、sticky routing、API key 限额、WebSocket/Responses 兼容和控制台审计。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/routing/按额度、临时负载、错误状态和 sticky/continuation 关系选择账号;需要同一上游账号的请求不会被随意迁移。官方文档明确说路由策略不能保证账号安全结果。
来源:soju06.github.io/codex-lb/routing/为 Codex、OpenCode、OpenClaw 和 SDK 提供 /backend-api/codex 与 /v1 等入口,覆盖 Responses、WebSocket 和部分兼容转换。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/client-s…可限制模型、reasoning effort、tokens、成本和时间窗口,并把 key 绑定到指定上游账号。远程客户端必须启用代理 API key 鉴权。
来源:soju06.github.io/codex-lb/api-keys/默认支持密码、可选 TOTP、角色、邀请、step-up、trusted header 和审计事件;也存在 disabled 认证模式,官方仅建议放在网络限制或外部认证之后。
来源:soju06.github.io/codex-lb/authentication/FastAPI/Python 服务接收下游 OpenAI/Codex 请求,从 SQLite 或 PostgreSQL 读取账号、key、路由与请求日志,再向上游发起 OAuth 认证请求。React 控制台管理账号、用量、安全设置与数据保留。单机数据默认位于 ~/.codex-lb,Docker 位于 /var/lib/codex-lb。远程部署通常还需要反向代理、WebSocket upgrade、可信代理 CIDR、dashboard 认证和下游 API key;多副本需共享数据库、加密 key 与协调状态。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/database…aiohttp、httpx2 与 websockets 上游通信bcrypt、PyJWT、cryptography 与 pyotp 认证组件可选 Docker、Helm/Kubernetes、Prometheus…适合能独立审计和运维身份、数据库、反向代理与日志保留的个人实验或受控环境,用来研究兼容层、观察额度和限制下游 key。把个人订阅账号池化后供多人或服务调用会扩大凭据共享、异常流量、内容留存和账号条款风险;不能因为代理自托管就认定上游允许该用法。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/routing/…2026-09-23 核对时,最新稳定版为 v1.24.0;v1.25.0-beta.9 是 2026-09-14 发布的预发布版,不能与稳定版混为一谈。main 当前 pyproject 仍为 1.25.0-beta.9,并包含后续提交,因此部署应固定 release tag 或容器 digest。
来源:github.com/Soju06/codex-lb/releases;https://github.com/Soju06/codex-l…status: docs_and_source_checked_not_installed | checked_at: 2026-09-23 | environment: 阅读官方 README、稳定版与 beta Releases、Getting Started、Authentication、API Keys、Routing、Remote Access、Telemetry、Configuration、pyproject 和许可证;浅克隆 main 提交 3d23d53。未启动代理。 | limitations: 没有验证 OAuth 导入、加密 key、路由正确性、跨账号连续性、API 兼容、内容保留、遥测、数据库迁移、反向代理、故障恢复、Kubernetes 或上游账号处置。 | observed_output: 最新稳定版为 v1.24.0,最新预发布为 v1.25.0-beta.9;main pyproject 标为 beta.9 且要求 Python 3.13。文档说明 API key auth 默认关闭、远程请求需鉴权,遥测采用 opt-out 且服务端保留期未说明。
来源:github.com/Soju06/codex-lb;https://github.com/Soju06/codex-lb/release…相比 Codex Switcher,codex-lb 是长期运行的网络代理:能让多个客户端通过本地 API key 消耗账号池,并保存更完整的请求、路由和成本状态。Codex Switcher 是单机桌面切换器,核心动作是更换 ~/.codex/auth.json。只需本人手动切账号时,桌面切换器的网络面更小;需要集中代理时才考虑 codex-lb,并按高敏感身份服务运维。
来源:github.com/Soju06/codex-lb;https://github.com/Lampese/codex-switchercodex-lb 功能完整,但不适合作为零配置工具直接接主账号。只有在能够管理 OAuth 凭据、数据库加密、API key、TOTP、反向代理、内容保留与上游条款时才值得试用;第一次必须固定稳定版、回环绑定、关闭遥测、使用测试账号和无敏感内容请求。
来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/deployme…不会。它能做路由和配额控制,但官方 routing 文档也说策略不能保证账号安全结果。账号池、下游共享和流量形态仍需按当前套餐与条款单独判断。
代理 API key 鉴权默认关闭,本地受保护路由可在无 key 时通过;非本地请求会被拒绝。即使只在本机,也建议启用 key,并确认端口只绑定回环地址。
不是。官方称首次保存选择前采用 opt-out,启动及每 24 小时发送聚合快照。可在首次运行前设 CODEX_LB_TELEMETRY_ENABLED=false;文档同时说 collector 保留期尚未公布。
latest 会随发布移动,数据库迁移、路由和认证行为都可能变化。测试与生产应固定稳定版 tag 或 digest,并先备份数据目录、阅读升级说明。
不可以直接暴露。官方远程部署要求 dashboard bootstrap、下游 API key、反向代理、WebSocket、可信代理 CIDR 和 Origin/Host 配置;还应增加 TLS、最小权限、日志保留和独立安全测试。