Codex Proxy RS

ChatGPT / Codex 账号池网关，提供 OpenAI 兼容接口和本地管理控制台。

/v1/responses · /v1/chat/completions · /v1/models · /api/admin

✦ 功能清单

部分	内容
⚡ OpenAI 兼容接口	responses、chat completions、模型列表、流式输出
🔐 账号池	OAuth、refresh token、CPR / Sub2API 导入、状态管理
🧭 调度	账号轮转、并发限制、请求间隔、会话亲和性
📡 上游传输	Codex Desktop 风格 headers、HTTP SSE、WebSocket、连接池
📊 记录	使用记录、Token、成本、延迟、失败原因、请求轨迹
🛠 管理端	账号、API Key、仪表盘、使用记录、运行时设置
💾 本地持久化	SQLite 数据库，运行数据默认写入 .runtime

✦ 快速启动

cargo run

默认监听：

http://0.0.0.0:8080

默认配置文件：

config.yaml

首次启动会初始化管理端账号。默认账号来自 config.yaml：

admin:
  default_username: admin
  default_password: admin

正式使用前请改掉默认密码。

✦ 管理控制台

前端代码在 web/。

开发模式：

pnpm --dir web dev

生产构建：

pnpm --dir web build
cargo run

构建后的控制台由后端直接提供，API 路由优先于静态资源。

✦ OpenAI 兼容入口

POST /v1/responses
POST /v1/chat/completions
GET  /v1/models
GET  /v1/models/catalog

示例：

curl http://127.0.0.1:8080/v1/responses \
  -H 'Authorization: Bearer <client-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-5.5",
    "input": "Say hello",
    "stream": true
  }'

✦ config.yaml

示例：

server:
  host: '0.0.0.0'
  port: 8080

api:
  base_url: 'https://chatgpt.com/backend-api'

database:
  url: 'sqlite://.runtime/data/codex-proxy-rs.sqlite'

logging:
  directory: .runtime/logs
  retention_days: 14

运行数据：

.runtime/data/
.runtime/logs/

账号、API Key、模型路由和运行时设置在管理端修改，不写进 YAML。

✦ 项目结构

src/
  admin/      管理端 API、账号、密钥、监控、设置
  config/     配置加载与运行时设置
  http/       路由、中间件、静态资源
  infra/      SQLite、时间、格式化、日志
  proxy/      OpenAI 兼容接口与请求分发
  runtime/    服务装配和后台任务
  upstream/   Codex 协议、账号、模型、传输
  web/        管理控制台静态资源挂载

web/          Vue 管理控制台
tests/        集成测试与 fixture

✦ 开发命令

cargo fmt --check
cargo clippy --all-targets --all-features --locked -- -D warnings
cargo test --test main
pnpm --dir web build

✦ License

MIT