CLIProxyAPI (CPA) 部署与多账号聚合使用教程

CLIProxyAPI (CPA) 部署与使用完整指南

核心概念： CLIProxyAPI（简称 CPA）是一个开源的 AI 账号反向代理与额度聚合工具。它支持将多个 ChatGPT / Codex 网页账号通过 OAuth 授权集中托管，对外输出兼容标准 OpenAI 格式的 API 接口，从而实现额度叠加、故障自动转移以及跨设备无缝接入。

1. 服务端部署（两种方式）

方式一：Linux VPS + Docker 部署（推荐用于生产/多设备）

该方案适合长期稳定运行，支持多端跨局域网调用，且国外 VPS 自带海外原生网络环境。

拉取仓库代码：

git clone https://github.com/router-proxy/cliproxyapi.git
cd cliproxyapi

创建并修改配置文件：
```
# 复制配置模板
cp config.example.yaml config.yaml
# 编辑配置文件
nano config.yaml
```
关键配置项修改：
- 将允许远程访问开启：remote: true（若仅本机则保持 false）
- 配置管理后台的管理员密钥：admin_key: "你的强密码"

构建并运行 Docker 容器：

docker compose up -d
# 查看运行日志确认是否成功启动
docker compose logs -f

方式二：Windows 本地运行

适合个人单机使用或无 VPS 服务器的用户：

从项目 Releases 页面下载 Windows 对应架构的压缩包（通常为 AMD64 / x86_64）。
解压后，找到 config.example.yaml，复制并重命名为 config.yaml。
用文本编辑器打开 config.yaml，设置 admin_key: "你的密码" 后保存。
以管理员身份双击运行 cliproxyapi.exe，终端保持开启状态即可。

国内网络环境提示： 若在本地运行遇到 OpenAI 域名网络连接失败，需进入 CPA Web 管理后台的【网络配置】中开启 TUN 模式，或在 Proxy URL 项填入本地代理端口（如 http://127.0.0.1:7890）。

2. 访问 Web 管理后台

服务启动后，可在浏览器输入对应的管理地址：

VPS 远程访问：http://<你的VPS_IP>:端口/（需确认云服务器防火墙已放行对应端口）
本地电脑访问：http://127.0.0.1:8080/

在登录界面输入在 config.yaml 中设置的 admin_key，即可进入管理仪表盘。

3. 挂载 AI 账号与生成 API

3.1 网页 OAuth 授权导入账号

为防止多个账号因共享同一网络环境与 Cookies 引起风控，多账号用户建议在指纹浏览器中预先登录各个 ChatGPT 账号。
在 CPA 后台点击 【登录授权 / OAuth Login】，选择 Codex / ChatGPT。
系统会生成一个授权验证 URL，将其复制并在已登录目标 ChatGPT 账号的浏览器窗口中打开。
点击确认授权，页面将跳转返回一个包含回调信息的回调 URL。
将完整的回调 URL 粘贴回 CPA 后台并提交，完成该账号的绑定。若有多个账号，重复该步骤即可实现额度叠加。

3.2 创建 OpenAI 兼容 API Key

进入后台的 【API 密钥管理 (Keys)】 页面。
点击新建 API Key，系统会自动生成一段令牌（如 sk-cpa-...）。
重要：务必点击界面上的保存并确认，确保密钥持久化入库。

4. 客户端对接与使用

由于 CPA 接口完全兼容 OpenAI 规范，所有支持自定义 API 地址的客户端均可直接接入：

接口 Base URL：http://<你的服务器IP或域名>:端口/v1
API 密钥：填入在第 3 步生成的 CPA API Key
模型选择：如 gpt-4o、o1 等挂载账号支持的模型

以 Codex / ChatGPT 插件为例：打开客户端登录设置，选择“自建 API”或“OpenAI API Key”方式，填入上述 Base URL 与 API 密钥即可开始调用。

5. 卸载与清理

VPS (Docker) 环境卸载

# 进入项目目录并停止销毁容器
cd cliproxyapi
docker compose down -v

# 删除项目文件与镜像
cd ..
rm -rf cliproxyapi
docker rmi $(docker images | grep cliproxyapi | awk '{print $3}')

Windows 本地环境卸载

关闭正在运行的 cliproxyapi.exe 命令行黑窗口。
直接删除解压得到的程序文件夹即可完全清理。

6. 项目与教程来源

教程出处： YouTube 频道「二进制_Sindri」——《CLIProxyAPI（CPA）+ ChatGPT(Codex) 部署与使用指南：低价账号及短信验证攻略》
视频源地址： https://www.youtube.com/watch?v=MaUdXay8oLg
核心功能： 多 AI 账户聚合调度、Codex / ChatGPT 反向代理与标准 OpenAI 协议输出