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

全平台 Docker 部署 CPA(CLIProxyAPI Plus) 灵活定制指南 (Linux/Windows)——接入Codexsvg xmlns http www w3 org 2000 svg style display none svg

大家好,我是讯享网,很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



 
  
    
     
      
     

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

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


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



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

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

懂了这个,你就可以彻底放飞自我了!准备好了吗?开始操作!


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

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

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

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

Win 键,搜索 PowerShell,右键选择“以管理员身份运行”。复制以下命令按回车创建文件夹:

# 这里的 D:AI-Proxy 你可以改成任何你想放的路径! New-Item -ItemType Directory -Force -Path D:AI-Proxyauths New-Item -ItemType Directory -Force -Path D:AI-Proxylogs 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" -OutFile "config.yaml"

# 用记事本打开它 notepad D:AI-Proxyconfig.yaml

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

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

5.保存之后回到PowerShell运行

docker compose pull && docker compose up -d 

在 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 

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


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.可以快乐的进行使用了


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

无论在 WindowsPowerShell 还是 Linux 的终端,运行以下命令查看程序的实时运行日志:

docker logs cli-proxy-api-plus -f 

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

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

 

转载自CSDN-专业IT技术社区

原文链接:https://blog.csdn.net/weixin_/article/details/

小讯
上一篇 2026-04-30 09:46
下一篇 2026-04-30 09:44

相关推荐

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/282358.html