Codex Proxy RS

面向 Codex 的自托管多账号 AI 网关

快速预览 · 快速开始 · 客户端接入 · 文档 · 社区 · 许可证

无需部署，打开 快速预览服务 即可体验管理端的系统概览、账号分组、代理管理与用量统计

预览服务运行已发布版本，展示的账号、代理与使用记录均为模拟数据，每天北京时间 00:00 自动生成当天数据。 这是公开共享的功能预览环境，不提供真实模型调用；请勿导入真实账号、密钥或其他敏感信息

使用 Docker Compose 部署版本固定的发布镜像，同时启动 PostgreSQL 和 Redis。 以下命令适用于 Linux amd64/arm64，需要 Docker Engine、Docker Compose Plugin、curl 和 OpenSSL。已有部署请先看 升级说明，不要覆盖原配置

请确保当前用户能访问 Docker，并可通过 sudo 或 root 设置目录权限

curl -fsSL https://raw.githubusercontent.com/zyycn/codex-proxy-rs/main/deploy/install.sh -o install.sh && bash install.sh

安装脚本 默认安装到当前目录下的 codex-proxy-rs/，下载同一正式 Release 的部署文件， 自动生成密码、设置目录权限并启动服务。完成后会显示访问地址和管理员密码，请保存密码，再按下方步骤 添加账号与客户端密钥

可在执行 bash install.sh 时传入环境变量：

例如，自定义安装目录：

INSTALL_DIR="$HOME/services/codex-proxy-rs" bash install.sh

重复运行时请使用同一安装目录。检测到 deploy/config.yaml 后，脚本保留现有配置和部署文件， 忽略传入的管理员密码，也不执行版本升级

自行下载部署文件、配置密码和启动服务的完整步骤见 部署文档

部署完成后，打开 http://127.0.0.1:8080，使用 [email protected] 和管理员密码登录。 API Key 持有者可在同一登录页切换登录身份，进入 /key-usage 查看自己的用量、趋势、请求日志、额度与健康时间线；不能访问管理员页面。 页面右上角的「密钥配置」支持复制 Codex 配置文件和导入 CCSwitch，导入时同时启用当前 Key 的日／周额度查询，默认刷新间隔为 30 分钟

默认地址只能在服务器本机访问，从其他设备使用时，需要配置 HTTPS 反向代理

1. 在「账号」中添加账号，完成授权或导入
2. 按需建立账号分组，再创建客户端密钥并选择可用分组，不选分组表示可使用全部账号
3. 打开密钥的「使用密钥」，复制客户端配置

Codex CLI / 桌面端：在「使用密钥」中按操作系统复制配置，或通过 CCSwitch 导入。 合并到客户端配置后重启 Codex。完整步骤、生图配置与排障见客户端配置

其他 Responses API 客户端：填写以下信息：

查询该密钥可见的模型目录：

curl http://127.0.0.1:8080/v1/models \
  -H 'Authorization: Bearer <client-api-key>'

欢迎到 Discussions 讨论区交流： 使用问答、 想法讨论、 实验反馈与 经验分享

感谢 LINUX DO 社区提供开放、友善的技术交流平台

本项目基于 Apache License 2.0 开源