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

对于经常折腾 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\authsNew-Item-ItemType Directory-Force-Path D:\AI-Proxy\logs cd D:\AI-Proxy2. 生成灵活的 Docker 配置文件在PowerShell中继续运行以下命令生成docker-compose.ymlSet-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)-OutFileconfig.yaml# 用记事本打开它notepad D:\AI-Proxy\config.yaml4.下载完成后修改远程访问配置allow-remote:truesecret-key:你的访问密码5.保存之后回到PowerShell运行dockercompose pulldockercompose 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 EOFservices:cli-proxy-api: image: eceasy/cli-proxy-api-plus:latest container_name:cli-proxy-api-plus ports:-9999:8317# 左侧端口可改成你喜欢的比如 9999:8317volumes:-./config.yaml:/CLIProxyAPI/config.yaml-./auths:/root/.cli-proxy-api-./logs:/CLIProxyAPI/logs restart: unless-stopped EOF2. 下载并修改密码配置# 下载配置curl-oconfig.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)# 编辑主配置改密码nanoconfig.yaml# 找到 secret-key填入你的专属密码保存退出 (CtrlO, Enter, CtrlX)allow-remote:truesecret-key:你的访问密码3. 一键启动在~/my-api-proxy目录下运行dockercompose pulldockercompose up-d完工记得去云服务器控制台如阿里云/腾讯云的防火墙/安全组放行你刚才设置的左侧端口哦第四部分效果展示以Windows为例1.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_providermycodexpersonalitypragmaticmodelgpt-5.2-codexmodel_reasoning_effortmediumpreferred_auth_methodapikey​[model_providers.mycodex]namemycodex# 修改base_url格式为http://本机IP:端口/v1 (例如http://192.168.1.168:9999/v1)base_urlhttp://xxx.xxx.xxx.xxx:port/v1wire_apiresponses8.可以快乐的进行使用了需要JSON文件或者Codex注册机的私聊我需要JSON文件或者Codex注册机的私聊我需要JSON文件或者Codex注册机的私聊我 附录小白排错指南如果部署后发现连不上或者客户端报错不要慌让Docker自己告诉你问题出在哪。无论在Windows的PowerShell还是Linux的终端运行以下命令查看程序的实时运行日志dockerlogs cli-proxy-api-plus-f看到Ready to accept connections说明代理运行完美检查一下你的防火墙有没有放行端口或者客户端的 IP 地址有没有填错。按 CtrlC 即可退出日志查看模式。尽情享受你的专属 AI 节点吧