Docker 部署 CLIProxyAPI Plus 教程：全平台接入 Codex-智扬星海

用 Docker 把 CLIProxyAPI Plus 跑成 API 中转节点，聚合多个 OpenAI 账号，给 Codex 一个能用的接口

折腾 AI 编程工具的人，早晚会碰上一个问题：Codex 直连不稳、账号额度有限、想统一管理几个 OpenAI 账号。这时候一个自建的 API 中转代理就很香，而 CLIProxyAPI Plus（社区简称 CPA）就是干这个的。它能把多个账号聚合成一个 API 地址，额度用完自动切换，还能顺手解决网络连通性。今天这篇就手把手带你用 Docker 在 Windows 和 Linux 上把它部署起来，重点是——哪些参数能改、哪些绝对不能碰，一次讲透，省得你换个硬盘、换个端口就报错。

CLIProxyAPI 是干嘛的？

简单说，它是一个开源的 API 中转/聚合程序。你把它跑在服务器或者本地电脑上，它对外暴露一个兼容 OpenAI 格式的接口，对内则帮你管理一批账号的登录凭证。好处很直接：

多账号聚合：一个账号额度用完了，自动切到还有额度的账号，Codex 用起来不断档。

集中管理：所有凭证、密钥在一个网页后台里看，比到处翻文件强。

解决连通性：本地或服务器跑一层中转，客户端不用再直连那些不稳定的线路。

对重度使用 Codex 的人来说，这套方案基本是刚需。

Docker 部署前，先记住”冒号法则”

这是整篇教程里最重要的一条，看懂它，后面所有参数你自己就会改了。

在 `docker-compose.yml` 里，无论端口（ports）还是目录（volumes），都是用冒号 `:` 隔开的，格式固定是：

你的电脑 (随便改) : Docker 容器内部 (绝对不能动)

端口：比如 `”9999:8317″`。左边 `9999` 是你自己对外开的端口，想用哪个用哪个；右边 `8317` 是程序写死在代码里的，**千万别改**。

目录：比如 `”D:\my-proxy\logs:/CLIProxyAPI/logs”`。左边是你本机的路径，放 C 盘、D 盘、移动硬盘都随你；右边是容器里的虚拟路径，同样别改。

记住这条，你就能放飞自我地改路径和端口了。

第一步：装好 Docker 环境

Docker 就像个”集装箱”，把程序运行需要的东西全打包好了。

Linux 云服务器：直接运行 curl -fsSL https://get.docker.com | bash 一键安装。

Windows 本地电脑：前往官网下载 Docker Desktop，一路下一步安装并重启。打开软件看到左下角亮起绿灯即准备就绪。

第二步：Windows 本地部署 CLIProxyAPI

如果你想在自己的 Windows 电脑上跑代理，这里我们以 D盘的 D:\AI-Proxy 目录为例（你可以替换成任意你喜欢的路径，比如 E:\MyTools）。

1. 创建专属目录

在开始菜单搜 PowerShell，右键”以管理员身份运行”，执行：

# 这里的 D:\AI-Proxy 你可以改成任何你想放的路径！
New-Item -ItemType Directory -Force -Path D:\AI-Proxy\auths
New-Item -ItemType Directory -Force -Path D:\AI-Proxy\logs
cd D:\AI-Proxy

2. 生成 docker-compose.yml

在 PowerShell 里继续运行，生成配置文件：

Set-Content -Path docker-compose.yml -Value @"
services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api-plus:latest
    container_name: cli-proxy-api-plus
    ports:
      - "9999:8317"  # 左边端口随便改，右边 8317 别动
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
      - ./logs:/CLIProxyAPI/logs
    restart: unless-stopped
"@

3. 下载配置模板并改密码

先从项目的官方仓库拿到 `config.example.yaml`，存成 `config.yaml`，再用记事本打开：

notepad D:\AI-Proxy\config.yaml

找到这两行，打开远程访问并填上你自己的密码：

allow-remote: true
secret-key: '你的访问密码'

4. 启动

保存后回到 PowerShell：

docker compose pull && docker compose up -d

第三步：Linux 云服务器部署 CLIProxyAPI

Linux 上一般把自定义服务放在家目录 `~/` 或者 `/opt/` 下，这里以 `~/my-api-proxy` 为例。

1. 建目录 + 写配置

SSH 连上服务器，执行：

mkdir -p ~/my-api-proxy/auths ~/my-api-proxy/logs && cd ~/my-api-proxy

cat > docker-compose.yml << 'EOF'
services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api-plus:latest
    container_name: cli-proxy-api-plus
    ports:
      - "9999:8317" # 左边端口可改，右边 8317 别动
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
      - ./logs:/CLIProxyAPI/logs
    restart: unless-stopped
EOF

2. 下载配置并改密码

从官方仓库拿到配置模板存为 `config.yaml`，然后编辑：

nano config.yaml   # 找到 secret-key，填入你的密码，Ctrl+O 保存、Ctrl+X 退出

同样把 `allow-remote` 设为 `true`。

3. 一键启动

docker compose pull && docker compose up -d

别忘了去云服务商控制台（阿里云、腾讯云等）的**防火墙/安全组**里，放行你设置的左侧端口，否则外网访问不进来。

第四步：进管理面板，把账号和密钥配好

以 Windows 为例，浏览器打开 `http://localhost:9999/management.html#/login`（端口换成你设的），输入刚才的密码登录。

1. **上传凭证**：点左侧”认证文件”，上传你提前准备好的 json 凭证。可以传多个，某个账号额度用尽会自动切到有额度的那个。

2. **看额度**：切到”配额管理”，找到”Codex 额度”，点右侧刷新就能看到当前剩余额度。

3. **生成密钥**：进”配置面板” → “认证配置”，可以删掉默认项，点”添加 API 密钥” → “生成” → “添加”。**记得点底部的保存图标**，否则白改。

第五步：本地让 Codex 用上这个中转

打开目录 `C:\Users\你的用户名\.codex`（没有的话，先在编辑器里装好 Codex 插件或独立客户端，随便登录一次就会生成）。

改 `auth.json`：

{
  "OPENAI_API_KEY": "填入刚才在页面生成的API密钥"
}

修改 config.toml 文件，可复制进行替换：

model_provider = "mycodex"
personality = "pragmatic"
model = "gpt-5.2-codex"
model_reasoning_effort = "medium"
preferred_auth_method = "apikey"

[model_providers.mycodex]
name = "mycodex"
# 修改base_url，格式为：http://本机IP:端口/v1 (例如：http://192.168.1.168:9999/v1)
base_url = "http://xxx.xxx.xxx.xxx:port/v1" 
wire_api = "responses"

然后可以快乐的进行使用了

文章版权归作者所有，未经允许请勿转载。

THE END