全平台 Docker 部署 CPA(CLIProxyAPI Plus) 灵活定制指南 (Linux/Windows)——接入Codex

菜喵007
0 阅读6分钟

对于经常折腾 AI 工具的朋友来说，搭建一个专属的 API 中转代理（如 CLIProxyAPI Plus）是必不可少的技能。它可以帮你解决网络连通性问题、集中管理多个 OpenAI 账号。

网上很多教程喜欢把路径和端口“写死”，导致新手一旦想换个硬盘或者换个端口就频繁报错。今天这篇“保姆级 + 原理级”教程，不仅带你用最简单的 Docker 一次性部署成功，还会把“哪些可以改，哪些不能改”给你扒得明明白白！

💡 核心必读：Docker 的“左与右”法则

在开始敲命令之前，请先记住 Docker 配置中的一个绝对真理：冒号法则 (:)。 在 docker-compose.yml 文件中，无论是端口（ports）还是文件目录（volumes），都是用冒号隔开的：

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

  • 端口（Ports）：比如 "8317:8317" 或 "9000:8317"。左边是你自己电脑对外开放的端口，想用哪个用哪个；右边的 8317 是代理程序写死在代码里的，千万别改。
  • 目录（Volumes）：比如 "D:\my-proxy\logs:/CLIProxyAPI/logs"。左边是你自己电脑上的硬盘路径，放 C 盘、D 盘还是移动硬盘随你心意；右边的是容器内部的虚拟路径，千万别改。

懂了这个，你就可以彻底放飞自我了！准备好了吗？开始操作！

🛠️ 第一部分：基石 —— 安装 Docker 环境

Docker 就像是一个虚拟的“集装箱”，它把代理程序和运行所需的一切都打包好了。

  • Linux 云服务器：直接运行 curl -fsSL https://get.docker.com | bash 一键安装。
  • Windows 本地电脑：前往官网下载 Docker Desktop，一路下一步安装并重启。打开软件看到左下角亮起绿灯即准备就绪。

🪟 第二部分：Windows 本地灵活部署实战

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

1. 创建属于你的专属目录

按 Win 键，搜索 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 配置文件

在 PowerShell 中继续运行以下命令，生成 docker-compose.yml：

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"  # 👈 左侧端口可改成你喜欢的，比如 "9999:8317"
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml  # 👈 左边的 ./ 代表当前目录 (D:\AI-Proxy)，右边不要动
      - ./auths:/root/.cli-proxy-api            # 👈 同上
      - ./logs:/CLIProxyAPI/logs                # 👈 同上
    restart: unless-stopped
"@

3. 下载并修改密码配置

# 下载官方配置模板
Invoke-WebRequest -Uri "[https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml](https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml)" -OutFile "config.yaml"

# 用记事本打开它
notepad D:\AI-Proxy\config.yaml

4.下载完成后修改远程访问配置

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

5.保存之后回到PowerShell运行

docker compose pull && docker compose up -d

🐧 第三部分：Linux 云服务器灵活部署实战

在 Linux 上，我们通常把自定义服务放在自己的根目录（~/）或者 /opt/ 下。这里我们以 ~/my-api-proxy 为例（你可以随意更改名称）。

1. 创建目录与配置文件

通过 SSH 连上服务器，运行：

# 创建目录，~/my-api-proxy 这个名字随你定
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" # 👈 左侧端口可改成你喜欢的，比如 "9999:8317"
    volumes:
      - ./config.yaml:/CLIProxyAPI/config.yaml
      - ./auths:/root/.cli-proxy-api
      - ./logs:/CLIProxyAPI/logs
    restart: unless-stopped
EOF

2. 下载并修改密码配置

# 下载配置
curl -o config.yaml [https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml](https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml)

# 编辑主配置（改密码）
nano config.yaml 

# 👉 找到 secret-key，填入你的专属密码，保存退出 (Ctrl+O, Enter, Ctrl+X)
allow-remote: true
secret-key: '你的访问密码'

3. 一键启动

在 ~/my-api-proxy 目录下运行：

docker compose pull && docker compose up -d

完工！记得去云服务器控制台（如阿里云/腾讯云）的防火墙/安全组放行你刚才设置的左侧端口哦！

🎯第四部分：效果展示（以Windows为例）

1.Docker运行图

docker启动成功！

2.在浏览器输入地址http://localhost:9999/management.html#/login会看到下面这样的页面，输入刚才设置的密码进行登录

在这里插入图片描述

3.登录成功之后会看到如下界面

在这里插入图片描述

4.点击左侧“认证文件”菜单，点击“上传文件”传入提前准备好的json文件

在这里插入图片描述

5.上传成功之后会多一个配置文件（可传入多个json，一个账号的额度用完会自动切换到有可用额度的账号，这里以一个为例）

在这里插入图片描述

6.切换到“配额管理”菜单，找到“Codex 额度”，点击右侧刷新，会展示出当前剩余额度

在这里插入图片描述

7.配置API密钥，点击左侧“配置面板”菜单，找到“认证配置”，可删除默认配置，点击“添加 API 密钥”，点击“生成”，点击“添加”。注意：操作完之后需要点击底部的保存图标进行保存。

在这里插入图片描述 在这里插入图片描述

7.本地配置使用

打开文件目录：C:\Users\用户名\.codex。如果没有该文件目录，需要先在使用的编译器中下载Codex插件或者下载Codex独立软件，随便找一个账号进行登录即可。

7.1 修改 auth.json 文件，可复制进行替换：
{
  "OPENAI_API_KEY": "填入刚才在页面生成的API密钥"
}
7.2 修改 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"

8.可以快乐的进行使用了

需要JSON文件或者Codex注册机的私聊我！！！

需要JSON文件或者Codex注册机的私聊我！！！

需要JSON文件或者Codex注册机的私聊我！！！

🚑 附录：小白排错指南

如果部署后发现连不上，或者客户端报错，不要慌，让 Docker 自己告诉你问题出在哪。

无论在 Windows 的 PowerShell 还是 Linux 的终端，运行以下命令查看程序的实时运行日志：

docker logs cli-proxy-api-plus -f

看到 Ready to accept connections：说明代理运行完美，检查一下你的防火墙有没有放行端口，或者客户端的 IP 地址有没有填错。

按 Ctrl+C 即可退出日志查看模式。尽情享受你的专属 AI 节点吧！🎉

avatar
文章
阅读
粉丝