Docker 部署 CLIProxyAPI Plus 指南：Linux/Windows 接入 Codex

通过 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

2. 下载并修改密码配置

curl -o config.yaml https://raw.githubusercontent.com/router-for-me/CLIProxyAPIPlus/main/config.example.yaml
nano config.yaml

找到 secret-key 填入密码并保存。

3. 启动服务

docker compose pull && docker compose up -d

注意在云服务器控制台放行对应端口。

效果展示与配置

1. 登录管理界面

浏览器访问 http://localhost:9999/management.html#/login，输入设置的密码登录。

2. 上传认证文件

点击左侧'认证文件'菜单，上传提前准备好的 JSON 文件。

3. 查看配额

切换到'配额管理'菜单，刷新 Codex 额度。

4. 配置 API 密钥

点击'配置面板' -> '认证配置'，添加 API 密钥并保存。

5. 本地客户端配置

打开文件目录 C:\Users\用户名\.codex。若无该目录，需先安装 Codex 插件或软件并登录一次。

5.1 修改 auth.json

{
  "OPENAI_API_KEY": "填入刚才在页面生成的 API 密钥"
}

5.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://xxx.xxx.xxx.xxx:port/v1"
wire_api = "responses"

故障排查

如果部署后无法连接，运行以下命令查看日志：

docker logs cli-proxy-api-plus -f

看到 Ready to accept connections: 说明代理运行正常。请检查防火墙是否放行端口或客户端 IP 是否正确。按 Ctrl+C 退出日志查看。