对于经常折腾 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运行图

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