Shell / BashAI
Docker 部署 CLIProxyAPI Plus 指南：Linux/Windows 接入 Codex
介绍如何使用 Docker 在 Windows 和 Linux 系统上灵活部署 CLIProxyAPI Plus 代理服务。内容涵盖 Docker 环境安装、端口与卷挂载规则说明、配置文件生成与修改、以及 Codex 客户端的配置连接方法。通过命令行脚本实现快速部署，支持自定义路径与端口，并包含故障排查日志查看指南。
介绍如何使用 Docker 在 Windows 和 Linux 系统上灵活部署 CLIProxyAPI Plus 代理服务。内容涵盖 Docker 环境安装、端口与卷挂载规则说明、配置文件生成与修改、以及 Codex 客户端的配置连接方法。通过命令行脚本实现快速部署，支持自定义路径与端口，并包含故障排查日志查看指南。
搭建专属 API 中转代理（如 CLIProxyAPI Plus）可解决网络连通性及多账号管理问题。本文介绍基于 Docker 的灵活部署方案，详解端口与目录映射规则。
在 docker-compose.yml 文件中，端口（ports）和文件目录（volumes）均使用冒号分隔：
本地端口：容器端口。左侧为本地开放端口，右侧为程序内部固定端口（如 8317），切勿修改右侧。本地路径：容器路径。左侧为本地存储路径，右侧为容器内虚拟路径，切勿修改右侧。curl -fsSL https://get.docker.com | bash 一键安装。以 D:\AI-Proxy 目录为例（可替换为任意路径）。
以管理员身份运行 PowerShell，执行以下命令：
New-Item -ItemType Directory -Force -Path D:\AI-Proxy\auths
New-Item -ItemType Directory -Force -Path D:\AI-Proxy\logs
cd D:\AI-Proxy
继续运行以下命令生成 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"
volumes:
- ./config.yaml:/CLIProxyAPI/config.yaml
- ./auths:/root/.cli-proxy-api
- ./logs:/CLIProxyAPI/logs
restart: unless-stopped
"@
Invoke-WebRequest -Uri "https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml" -OutFile "config.yaml"
notepad D:\AI-Proxy\config.yaml
编辑 config.yaml，确保包含以下内容：
allow-remote: true
secret-key: '你的访问密码'
docker compose pull && docker compose up -d
以 ~/my-api-proxy 为例。
通过 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"
volumes:
- ./config.yaml:/CLIProxyAPI/config.yaml
- ./auths:/root/.cli-proxy-api
- ./logs:/CLIProxyAPI/logs
restart: unless-stopped
EOF
curl -o config.yaml https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml
nano config.yaml
找到 secret-key 填入密码并保存。
docker compose pull && docker compose up -d
注意在云服务器控制台放行对应端口。
浏览器访问 http://localhost:9999/management.html#/login，输入设置的密码登录。
点击左侧'认证文件'菜单，上传提前准备好的 JSON 文件。
切换到'配额管理'菜单，刷新 Codex 额度。
点击'配置面板' -> '认证配置'，添加 API 密钥并保存。
打开文件目录 C:\Users\用户名\.codex。若无该目录，需先安装 Codex 插件或软件并登录一次。
{
"OPENAI_API_KEY": "填入刚才在页面生成的 API 密钥"
}
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://xxx.xxx.xxx.xxx:port/v1"
wire_api = "responses"
如果部署后无法连接，运行以下命令查看日志：
docker logs cli-proxy-api-plus -f
看到 Ready to accept connections: 说明代理运行正常。请检查防火墙是否放行端口或客户端 IP 是否正确。按 Ctrl+C 退出日志查看。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online