1. Business (Team) 号池#

适用于对稳定性要求较高，且有一定预算的场景。

• 闲鱼拼车：购买 Team 账号的车位。
• 母子号策略：购买母号并拉起多个子号组成 Team 池。
• ⚠️ 注意：母子号策略近期风控较严，存在一定的不稳定性，建议搭配备用池使用。

2. Free 号池#

适用于零成本/低成本白嫖的场景，依赖批量注册。

• 域名邮箱：使用自定义域名邮箱（开启 Catch-All 功能）来批量接收注册验证码。如果不知道如何设置域名邮箱，可以参考域名邮箱教程的这篇教程。
• 自动化注册：借助注册机批量产出 Free 账号。例如开源工具 codex-register,可以使用docker部署。
• 导入 CPA：建议通过”账号管理页面”打包账号的token并导出为cpa格式,最后统一复制粘贴到CPA 的./auth/。

环境准备#

• 确保你的服务器已安装 Git 和 Go 语言环境。
• 若没有安装windows用户推荐使用scoop包管理工具进行安装,link
• 若使用docker部署请参见详细文档,在此仅给出本地部署的步骤。

首次克隆与编译部署#

1
# 1. 克隆项目
2
git clone https://github.com/router-for-me/CLIProxyAPI.git
3
cd CLIProxyAPI
4

5
# 2. 重命名远端以便后续平滑更新
6
git remote rename origin upstream
7

8
# 3. 编译出可执行文件
9
go build -o cli-proxy-api.exe ./cmd/server

日常维护与更新#

当上游项目有代码更新时，无需重新克隆，执行以下命令即可同步并重新编译：

1
git fetch upstream
2
git merge upstream/main
3
go build -o cli-proxy-api.exe ./cmd/server

开启管理面板#

要在 CPA 中启用 Web UI，需要在配置文件中放开控制权限。你可以直接在项目根目录创建或编辑 config.yaml。 配置完成后，在浏览器打开 http://localhost:8317/management.html 即可访问后台。

核心配置文件 (config.yaml) 参考#

以下是一份经过验证的基础配置文件，你可以直接复制并根据自己的需求修改：

1
host: "127.0.0.1"
2
port: 8317
3
auth-dir: "auths"         # 账号凭证存储目录
4
api-keys:
5
  - "123456"              # 客户端调用你这个聚合 API 时的鉴权 Key
6

7
debug: false              # 生产环境建议关闭 debug
8
logging-to-file: false    # 是否将日志输出到文件
9
usage-statistics-enabled: true # 开启使用统计
10

11
# ⚠️ 代理设置 (非常重要)
12
# proxy-url: "http://127.0.0.1:7897"
13

14
request-retry: 3          # 请求失败重试次数
15
max-retry-interval: 30    # 最大重试间隔(秒)
16

17
routing:
18
  strategy: "round-robin" # 路由策略：轮询
19

20
quota-exceeded:
21
  switch-project: true    # 额度耗尽时自动切换项目
22
  switch-preview-model: true
23

24
codex-instructions-enabled: false
25

26
remote-management:
27
  allow-remote: false     # 是否允许非本地 IP 访问管理面板
28
  secret-key: "123456"    # 面板登录密钥
29
  disable-control-panel: false # 不要禁用面板

🔐 避坑指南：OAuth 验证与网络代理#

将 GPT 账号导入 CPA 时，系统会进行 OAuth 验证以获取 Refresh Token。 由于 OpenAI 的网络限制，OAuth 验证过程必须处于科学网络环境下。你有两种解决方案：

1. 开启系统级别的 TUN 模式（如 Clash/V2ray 的全局虚拟网卡）。
2. 在上述的 config.yaml 中，取消 proxy-url 的注释，并将其指向你的本地 HTTP 代理端口。