用 CLIProxyAPI 搭建多账号 Codex 代理池

背景#

有多个 OpenAI / Codex 订阅账号时，在不同客户端之间手动切换又麻烦又浪费——每个账号有独立的使用频率限制，但单个客户端固定用某一个账号时，其余的额度就闲置了。

理想状态是：多个账号的额度合在一起，对外暴露成一个统一的 API 端点，自动做负载均衡和故障转移。任何时候任何客户端接入，都只用一个 API key，后端自动把请求分配到有余量的账号上。

CLIProxyAPI（以下称 CPA）正是干这个的。它把 Codex、Claude Code、Gemini CLI、Grok Build 等 CLI 工具的 OAuth 凭证转换成标准 OpenAI/Gemini/Claude 兼容 API，内置多账号轮询和 token 自动刷新。

本文记录在一台 Debian VPS 上的完整部署过程。

目标与约束#

• 多个 Codex 账号聚合：每个账号独立 OAuth 凭证，支持自动 token 刷新
• 统一 API 端点：对外暴露标准 /v1/chat/completions，所有客户端共用
• 自动轮询：CPA 内置 round-robin，请求自动分配到可用账号
• 无头服务器友好：VPS 没有桌面环境，OAuth 登录需要通过 SSH 端口转发或管理面板完成
• systemd 部署：不使用 Docker，以节省磁盘空间
• 最小配置：只做 Codex 通道，其他 provider 按需再开

安装#

CPA 官方提供了一键安装脚本，自动检测架构、下载二进制、创建目录结构：

1
curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

安装后目录结构：

1
~/cliproxyapi/
2
├── cli-proxy-api          # 主程序二进制
3
├── config.yaml            # 配置文件
4
├── cliproxyapi.service    # systemd 服务文件
5
├── static/                # 管理面板前端资源
6
└── 7.1.19/                # 版本目录（旧版本保留最近 2 个）

配置#

核心文件是 ~/cliproxyapi/config.yaml，最小可用配置如下：

1
host: "0.0.0.0"       # 监听所有网络接口
2
port: 8317             # 主 API 端口
3
auth-dir: "~/.cli-proxy-api"   # OAuth 凭证存储目录
4
api-keys:
5
  - "sk-your-secret-api-key"   # 对外统一 API 密钥
6
debug: false
7

8
remote-management:
9
  allow-remote: true           # 允许远程访问管理面板
10
  secret-key: "your-password"  # 管理面板登录密钥（启动时自动 hash）

说明：

• api-keys 是客户端连接 CPA 时使用的 API key，格式随意（sk- 前缀是 OpenAI 惯例）
• secret-key 是管理面板的登录密码，明文写入即可，CPA 启动后自动哈希
• auth-dir 下的文件是各账号的 OAuth 凭证 JSON

添加 Codex 账号（OAuth 登录）#

CPA 的 OAuth 回调地址固定为 http://localhost:1455/auth/callback。VPS 没有桌面环境，需要借助 SSH 端口转发完成回调。

1
cd ~/cliproxyapi
2
./cli-proxy-api --codex-login

1
ssh -L 1455:localhost:1455 root@你的VPS_IP -i "C:\Users\xxx\.ssh\id_ed25519"

1
{
2
  "id_token": "eyJ...",
3
  "access_token": "eyJ...",
4
  "refresh_token": "eyJ...",
5
  "account_id": "user-xxx",
6
  "email": "someone@example.com",
7
  "last_refresh": "2026-05-23T20:00:00+08:00",
8
  "type": "codex",
9
  "expired": "2026-05-23T21:00:00+08:00"
10
}

systemd 部署#

安装脚本已经生成了 cliproxyapi.service 文件，但默认是 user 级别。推荐设为系统级，确保开机自启：

1
sudo cp ~/cliproxyapi/cliproxyapi.service /etc/systemd/system/
2
sudo systemctl daemon-reload
3
sudo systemctl enable --now cli-proxy-api
4

5
# 确认运行状态
6
sudo systemctl status cli-proxy-api
7

8
# 查看日志
9
journalctl -u cli-proxy-api -f

此时 API 端点 http://VPS_IP:8317/v1 和管理面板 http://VPS_IP:8317/admin 已经可用。

客户端对接#

1
[model_providers.openai]
2
base_url = "http://VPS_IP:8317/v1"
3
api_key = "sk-your-secret-api-key"

1
server {
2
    listen 443 ssl;
3
    server_name cpa.example.com;
4

5
    ssl_certificate     /etc/ssl/certs/cpa.pem;
6
    ssl_certificate_key /etc/ssl/private/cpa.key;
7

8
    location / {
9
        proxy_pass http://127.0.0.1:8317;
10
        proxy_http_version 1.1;
11
        proxy_set_header Host $host;
12
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
13
        proxy_read_timeout 300s;  # 流式响应可能需要较长时间
14
    }
15
}

管理面板#

启用 remote-management 后，浏览器打开 http://VPS_IP:8317/admin，用配置中的 secret-key 登录。

面板提供：

• 各账号状态与额度概览
• 在线添加 / 删除 OAuth 账号（远程浏览器模式）
• API key 管理
• 实时请求日志

在线添加账号时，面板会生成授权 URL，在本地浏览器完成登录后，把回调 URL 粘贴回面板即可，无需 SSH 隧道。

关键决策#

1. 选 systemd 而非 Docker：VPS 磁盘空间有限，直接安装二进制比 Docker 镜像省几百 MB
2. SSH 正向隧道做 OAuth：比管理面板的远程浏览器模式更可靠，回调不会卡在浏览器跳转
3. 最小化配置：先只开 Codex 通道、关闭 debug 和 usage-statistics，按需再扩展其他 provider
4. 凭证可迁移：所有 OAuth 文件集中在 ~/.cli-proxy-api/，迁移机器时直接 scp 目录即可

相关项目#

• CLIProxyAPI — 主项目，35k+ stars
• codex-register — 批量注册 OpenAI 账号并生成 CPA 兼容授权文件
• CPA-Manager — 满血管理面板，支持账号巡检、配额检测、用量统计
• cliproxyapi-installer — 一键安装与升级脚本