Codex Proxy RS

基于 Rust 的多 Provider 透明 AI 网关

快速开始 · 客户端接入 · 运维 · 部署文档 · 架构

Note

只支持 OpenAI Responses API，不提供 /v1/chat/completions。

能力

领域	实现
协议	OpenAI Responses JSON/SSE 与模型目录
Provider	Codex OAuth、xAI/Grok OAuth session
路由	Provider instance、能力过滤、显式 fallback 与多 credential
延续	Provider 原生 continuation 与加密 portable transcript
管理	Client Key、Provider、模型、Route、Target、价格与 OAuth
计量	Request/Attempt usage、版本价格、预算、聚合与恢复

快速开始

需要 Docker Engine 与 Docker Compose Plugin。

1. 准备

git clone https://github.com/zyycn/codex-proxy-rs.git
cd codex-proxy-rs

mkdir -p .runtime/data .runtime/logs
install -d -m 0750 .runtime/postgres .runtime/redis
cp deploy/config.example.yaml deploy/config.yaml
sudo chown "$(id -u):10001" deploy/config.yaml
chmod 0640 deploy/config.yaml

分别执行三次：

openssl rand -hex 24

将结果写入 deploy/config.yaml：

配置	约束
x-cpr.database.password	48 位十六进制
x-cpr.redis.password	48 位十六进制
x-cpr.admin.default_password	至少 12 位，不能包含 $

Linux 需要允许容器组写入运行目录：

sudo chown -R "$(id -u):10001" .runtime/data .runtime/logs
chmod 0770 .runtime/data .runtime/logs

2. 启动

docker compose -f deploy/compose.yaml config --quiet
docker compose -f deploy/compose.yaml pull
docker compose -f deploy/compose.yaml up -d --no-build
curl -i http://127.0.0.1:8080/healthz

204 No Content 表示应用、PostgreSQL 与 Redis 均可用。管理端地址： http://127.0.0.1:8080。

3. 初始化

1. 使用 admin@cpr.local 与初始密码登录。
2. 创建 Provider instance，并通过 OAuth 导入 Codex 或 xAI credential。
3. 配置 Provider model、对外 Route/Target；严格预算场景同时发布价格版本。
4. 创建 sk_... 客户端 Key，并设置模型 allowlist、速率、并发和预算策略。

Important

xAI 使用 OAuth session，不支持把 xAI API Key 作为上游 credential。

Note

admin.default_password 只在首次创建管理员时生效。

完整部署、权限和密码轮换规则见 deploy/README.md。

客户端接入

配置	值
Base URL	http://127.0.0.1:8080/v1
API Key	管理端创建的 sk_...
鉴权	Authorization: Bearer <client-api-key>

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

curl http://127.0.0.1:8080/v1/responses \
  -H 'Authorization: Bearer <client-api-key>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "<model-id>",
    "input": "Reply with pong.",
    "stream": false
  }'

API 路由

路由	用途
POST /v1/responses	JSON 或 SSE 透明代理
GET /v1/models	启用的公开模型列表
GET /v1/models/{model_id}	公开模型详情

所有 /v1/* 路由都需要客户端 API Key。

运维

# 升级
docker compose -f deploy/compose.yaml pull codex-proxy-rs
docker compose -f deploy/compose.yaml up -d --no-build

# 日志
docker compose -f deploy/compose.yaml logs -f codex-proxy-rs

# 从源码构建
docker compose -f deploy/compose.yaml build codex-proxy-rs
docker compose -f deploy/compose.yaml up -d

Important

.runtime/ 保存数据库、Redis、身份密钥和日志。删除该目录会永久清除运行状态。

Compose 默认只绑定 127.0.0.1。公网接入应使用 HTTPS 反向代理，转发 WebSocket upgrade 与真实客户端 IP；不要暴露 PostgreSQL 或 Redis。

文档

• 部署
• 架构
• 多 Provider 目标架构
• 终态数据模型
• Release
• 容器镜像