ghcr.io/soju06/codex-lb:1
ghcr.iolinux/amd641大小: 95.08 MB更新于 2026年9月7日
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
codex-lb
English | 简体中文
***账号负载均衡器。汇聚多个账号，跟踪使用情况，管理API密钥，通过仪表板查看所有信息。
文档： — 入门指南、客户端设置、配置、部署、故障排除以及更多截图。
特性
账号池化 跨多个***账号进行负载均衡
使用跟踪 按账号统计令牌、成本、28天趋势
API密钥 按令牌、成本、时间窗口、模型设置每密钥速率限制
仪表板认证 密码 + 可选TOTP
OpenAI兼容 Codex CLI、OpenCode及任何OpenAI客户端
模型自动同步 从上游获取可用模型
|:---:|:---:|
快速开始
# Docker（推荐）
docker volume create codex-lb-data
docker network inspect codex-lb-net >/dev/null 2>&1 || docker network create codex-lb-net
docker run -d --name codex-lb \
--network codex-lb-net \
-p 2455:2455 -p 1455:1455 \
-v codex-lb-data:/var/lib/codex-lb \
ghcr.io/soju06/codex-lb:latest
# 或使用uvx
uvx codex-lb
# 或使用nix
nix run github:Soju06/codex-lb
打开 http://localhost:2455 → 添加账号 → 完成。
首次远程访问仪表板？您需要一次性引导令牌 — 参见 https://soju06.github.io/codex-lb/getting-started/。
客户端设置
将任何与OpenAI兼容的客户端指向codex-lb。对于Codex CLI，配置文件~/.codex/config.toml如下：
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"
model_provider = "codex-lb"
[model_providers.codex-lb]
name = "openai" # 必需 — 启用远程/responses/compact。自Codex 2026-05-23起需小写；旧版"OpenAI"将无法解析gpt-5.5
base_url = "http://127.0.0.1:2455/backend-api/codex"
wire_api = "responses"
supports_websockets = true
requires_openai_auth = true # codex应用必需
| Logo | 客户端 | 端点 | 指南 |
|---|---|---|---|
| Codex CLI / IDE | http://127.0.0.1:2455/backend-api/codex | https://soju06.github.io/codex-lb/client-setup/#codex-cli-ide-extension | |
| OpenCode | http://127.0.0.1:2455/v1 | https://soju06.github.io/codex-lb/client-setup/#opencode | |
| OpenClaw | http://127.0.0.1:2455/v1 | https://soju06.github.io/codex-lb/client-setup/#openclaw | |
| Hermes Agent | http://127.0.0.1:2455/v1 | https://soju06.github.io/codex-lb/client-setup/#hermes-agent | |
| OpenAI Python SDK | http://127.0.0.1:2455/v1 | https://soju06.github.io/codex-lb/client-setup/#openai-python-sdk |
远程客户端需要从仪表板创建的https://soju06.github.io/codex-lb/api-keys/。
配置
使用带有CODEX_LB_前缀的环境变量或.env.local文件 — 参见 .env.example 和 https://soju06.github.io/codex-lb/configuration/。默认数据库后端为SQLite；可通过`CODEX_LB_DATABASE_URL`选择使用PostgreSQL。
数据
| 环境 | 路径 |
|---|---|
| 本地 / uvx | ~/.codex-lb/ |
| Docker | /var/lib/codex-lb/ |
备份此目录以保留您的数据。
文档
完整文档位于 ** **：
- https://soju06.github.io/codex-lb/getting-started/ — 快速开始、远程引导令牌
- https://soju06.github.io/codex-lb/client-setup/ — Codex CLI、OpenCode、OpenClaw、Python SDK
- https://soju06.github.io/codex-lb/configuration/ — 关键设置说明
- https://soju06.github.io/codex-lb/authentication/ — 仪表板认证模式
- https://soju06.github.io/codex-lb/api-keys/ — 保护代理路由
- https://soju06.github.io/codex-lb/routing/ — 策略指南
- https://soju06.github.io/codex-lb/database/ — SQLite / PostgreSQL、Postgres 16 → 18升级
- https://soju06.github.io/codex-lb/troubleshooting/
社区配套工具
使用仪表板API的独立项目，在codex-lb外部维护（访问指南参见 https://soju06.github.io/codex-lb/#community-companions）：
- https://github.com/sm1ee/codex-lb-statusbar — 原生macOS应用：账号状态、配额详情、账号控制
- https://github.com/joschi655/codex-lb-swiftbar — 只读SwiftBar/Bun监控工具，用于查看池状态和配额余量
开发
# Docker
docker compose watch
# 本地开发
uv sync && cd frontend && bun install && cd ..
uv run codex-lb # 后端运行于 :2455
cd frontend && bun run dev # 前端运行于 :5173
# Nix
nix run .
nix develop # 进入开发环境
贡献者 ✨
感谢以下杰出人士（表情符号说明）：
Soju06 💻 ⚠️ 🚧 🚇 Jonas Kamsker 💻 🐛 🚧 Quack 💻 🐛 🚧 🎨 Jill Kok, San Mou 💻 ⚠️ 🚧 🐛 PARK CHANYOUNG 📖 💻 ⚠️ Choi138 💻 🐛 ⚠️ LYA⚚CAP⚚OCEAN 💻 ⚠️
Eugene Korekin 💻 🐛 ⚠️ jordan 💻 🐛 ⚠️ DOCaCola 🐛 ⚠️ 📖 JoeBlack2k 💻 🐛 ⚠️ Peter A. 📖 💻 🐛 Hannah Markfort 💻 ⚠️ mws-weekend-projects 💻 ⚠️
Quang Do 💻 ⚠️ Anand Aiyer 🐛 💻 ⚠️ defin85 💻 🐛 ⚠️ Jacky Fong 💻 🐛 💬 🚧 ⚠️ flokosti96 💻 ⚠️ Woonggi Min 💻 ⚠️ Yigit Konur 🐛 💻
Ruben 💻 ⚠️ 🐛 Steve Santacroce 💻 ⚠️ 🐛 Hugh Do 💻 ⚠️ Hubert Salwin 💻 ⚠️ Teemu Koskinen 📖 Yu Peng Zheng 📖 💻 embogomolov 💻 ⚠️
Renat Sharipov 💻 ⚠️ Liu Rui 📖 💻 ⚠️ 🐛 OverHash 💻 ⚠️ Kazet 💻 ⚠️ Bala Kumar 💻 ⚠️ 🤔 ihazgithub 💻 ⚠️ Temirkhan 💻 ⚠️ 📖 🐛
tobwen 💻 ⚠️ 🐛 Rio 💻 🐛 ⚠️ Mika 💻 📖 ⚠️ Darafei Praliaskouski 💻 📖 ⚠️ 🐛 Maxim Feofilov 💻 ⚠️ klaascommerce 💻 ⚠️ JeffKandt ⚠️ 👀
ozpool 🤔 📖 💻 ⚠️ Manu ⚠️ 👀 Wojtek Majewski ⚠️ Andrew Noble 💻 ⚠️ Josu Gorostegui 💻 ⚠️ Linus Mixson 💻 ⚠️ timefox 💻 ⚠️
Lotfree 💻 ⚠️ 📖 🐛 hikki 💻 🎨 Miha Orazem 💻 ⚠️ Nikhil 💻 ⚠️ onlysdesign-ui 💻 ⚠️ Steven (Minh) Dang 📖 Nataprom 💻 ⚠️
Iweisc 💻 ⚠️ Mahir Taha Özdin 🤔 💻 ⚠️ ram/haidar 💻 Rudra Tiwari 💻 Wu Chao 💻 zwd0313 💻 mastertyko 💻 ⚠️
Diógenes Castro 💻 ⚠️ jhordanjw123 💻 ⚠️ abarsegov 💻 Akshay Kakatkar 💻 ⚠️ NeoClaw 💻 plastictaste 💻 ⚠️ 📖 softkleenex 💻 ⚠️
n3crosis 💻 ⚠️ geoHeil 💻 ⚠️ copilot 💻 mercenarioZ 💻 ⚠️ Rubén Pérez Bachiller 💻 ⚠️ 🐛 Guanwei Chen 💻 ⚠️ Jonáš Sivek 💻 ⚠️
落叶 💻 📖 ⚠️ 🌍 jawwadfirdousi 💻 ⚠️ Quang Do 💻 ⚠️ zvladru 💻 ⚠️ Hwanmoo Yong 💻 ⚠️ Abdullah Alzeiby 💻 ⚠️ anime girl 💻 ⚠️
evaldass 💻 ⚠️ Claude 💻 luawl 💻 ⚠️ Shawn 💻 Hafiy 💻 ⚠️ 📖 Choong Jun Jin 💻 ⚠️ knightcn1983 💻 ⚠️
Kevin van Zonneveld 💻 Roman Leventov 💻 AliReza Tofighi 📖 DOMANHDUC 💻 Kwan Perry 💻 James 💻 ⚠️ SSY 💻 ⚠️ 📖
Fatih Özbek 💻 ⚠️ Kushida 💻 ⚠️ Aidid Haiqal 💻 ⚠️ yshishenya 💻 alchemistkiv 💻 ⚠️ mhooooo 💻 ⚠️ crowscc 💻
Syakur Rahman 💻 ⚠️ cigro-manager 💻 Paul Eipper 💻 ⚠️ 📖 ret2basic.eth 💻 ⚠️ 유영준 💻 ⚠️ mrnaturalmonopoly-prog 💻 ⚠️ mrunnaturalmonopoly-svg 💻 ⚠️
HulianBuligon 💻 ⚠️ joschi655 💻 ⚠️ daydreamer.jin 💻 ⚠️ 📖 rknightion 💻 ⚠️ glopyglerky 💻 ⚠️ Ahmad Maulana Iqbal 💻 ⚠️ Dvredin 💻
DuyBui 💻 ⚠️ Kevin Lin 💻 ⚠️ Borealin 💻 ⚠️ BrenticusMaximus 💻 ⚠️ Sakthimaran 💻 ⚠️ Evan 💻 Chao Xu 💻 ⚠️
zenasharp 💻 ⚠️ 📖 HanSu Lee 💻 ⚠️ Derek Pearson 💻 JustYannicc 💻 ⚠️ 📖 ygx 💻 ⚠️ Aarav 💻 Evan Haug 💻 ⚠️
Jason HONG 💻 Mohammad Saleh Mahdinejad 💻 ⚠️ 🐛 📖 Muhammad Ilham Dedi 💻 🐛 ⚠️
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"