codex-lb 是什么?

codex-lb 是自托管的 ChatGPT/Codex 账号池、反向代理和用量控制台。它把多个上游账号汇成 OpenAI 兼容接口,再给下游客户端发本地 API key、设置配额并记录成本。它位于用户提示词、文件引用、OAuth 凭据和上游响应的中间位置,安全责任远高于普通用量面板。

⭐ 2,254 Stars 🍴 347 Forks Python MIT 作者: Soju06
来源: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/
OpenAI 兼容代理

为 Codex、OpenCode、OpenClaw 和 SDK 提供 /backend-api/codex 与 /v1 等入口,覆盖 Responses、WebSocket 和部分兼容转换。

来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/client-s…
下游 API key 与用量政策

可限制模型、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…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) aiohttp、httpx2 与 websockets 上游通信aiohttp、httpx… bcrypt、PyJWT、cryptography 与 pyotp 认证组件bcrypt、PyJWT… 可选 Docker、Helm/Kubernetes、Prometheus 与 OpenTelemetry可选 Docker、He… 多账号路由与连续性 OpenAI 兼容代理 下游 API key 与用量政策下游 API key 与用量… 控制台认证与审计 codex-lb 项目本体 核心功能 关键依赖

技术栈

语言Python 3.13 后端、React/TypeScript 前端,并含 Rust 数据面组件框架FastAPI + SQLAlchemy/Alembic + SQLite/PostgreSQL + WebSocket
aiohttp、httpx2 与 websockets 上游通信bcrypt、PyJWT、cryptography 与 pyotp 认证组件可选 Docker、Helm/Kubernetes、Prometheus…
PyPI/uvx、GHCR 镜像、Nix 与 Helm chart;MIT 许可
来源:github.com/Soju06/codex-lb/blob/main/pyproject.toml;https://github.co…

快速上手

不建议先导入真实账号。固定稳定版 1.24.0,在仅绑定 127.0.0.1 的隔离主机运行,设置 CODEX_LB_TELEMETRY_ENABLED=false,并使用临时数据目录。先建立 dashboard 密码与 TOTP,启用下游 API key,再添加一个可撤销的测试凭据。只发送无敏感内容的短请求,核对路由、日志、删除与备份。不要使用 latest 镜像、不要开放 2455/1455 到公网,也不要先开启 conversation archive、warm-up 或账号池。
来源:github.com/Soju06/codex-lb/releases/tag/v1.24.0;https://soju06.github…

使用场景

适合能独立审计和运维身份、数据库、反向代理与日志保留的个人实验或受控环境,用来研究兼容层、观察额度和限制下游 key。把个人订阅账号池化后供多人或服务调用会扩大凭据共享、异常流量、内容留存和账号条款风险;不能因为代理自托管就认定上游允许该用法。

来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/routing/…

优势与局限

优势

  • 把路由连续性、额度、下游 key 和成本记录放在同一控制面
  • 远程访问文档覆盖 bootstrap、WebSocket、可信代理 CIDR 与 Origin/Host 校验
  • 控制台具备密码、TOTP、角色、step-up、邀请和审计机制
  • 支持 SQLite 到 PostgreSQL、Docker 到 Kubernetes 的部署路径

局限

  • 代理持有多个上游 OAuth 凭据,并能读取经过它的提示词、响应、文件引用和使用元数据,失陷影响范围大
  • 账号池和下游 API key 可能把个人账号变成共享服务;是否合规取决于当前上游条款、套餐和实际使用方式
  • API key auth 默认关闭;本地请求可无 key,远程部署必须正确处理网络边界和可信代理
  • 匿名遥测在未保存选择时处于 active opt-out,collector 的服务端保留期限目前未说明
  • conversation archive、HTTP bridge spool 和请求日志可能保留内容或原始负载,需逐项设置保留期
  • 1.25.0-beta.9 是预发布版,稳定环境应避免把 beta 或 latest 镜像当固定版本
来源:soju06.github.io/codex-lb/api-keys/;https://soju06.github.io/codex-lb…

最新版本

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-switcher

总结评价

codex-lb 功能完整,但不适合作为零配置工具直接接主账号。只有在能够管理 OAuth 凭据、数据库加密、API key、TOTP、反向代理、内容保留与上游条款时才值得试用;第一次必须固定稳定版、回环绑定、关闭遥测、使用测试账号和无敏感内容请求。

来源:github.com/Soju06/codex-lb;https://soju06.github.io/codex-lb/deployme…

常见问题

codex-lb 会自动让多账号使用符合 OpenAI 条款吗?

不会。它能做路由和配额控制,但官方 routing 文档也说策略不能保证账号安全结果。账号池、下游共享和流量形态仍需按当前套餐与条款单独判断。

本机运行 codex-lb 还需要 API key 吗?

代理 API key 鉴权默认关闭,本地受保护路由可在无 key 时通过;非本地请求会被拒绝。即使只在本机,也建议启用 key,并确认端口只绑定回环地址。

codex-lb 的遥测默认关闭吗?

不是。官方称首次保存选择前采用 opt-out,启动及每 24 小时发送聚合快照。可在首次运行前设 CODEX_LB_TELEMETRY_ENABLED=false;文档同时说 collector 保留期尚未公布。

为什么教程不直接使用 ghcr.io/soju06/codex-lb:latest?

latest 会随发布移动,数据库迁移、路由和认证行为都可能变化。测试与生产应固定稳定版 tag 或 digest,并先备份数据目录、阅读升级说明。

codex-lb 可以安全地直接暴露到公网吗?

不可以直接暴露。官方远程部署要求 dashboard bootstrap、下游 API key、反向代理、WebSocket、可信代理 CIDR 和 Origin/Host 配置;还应增加 TLS、最小权限、日志保留和独立安全测试。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件