二言目乐园

外观

开往主站前往留言喝杯咖啡

使用 Docker Compose 同时部署 CPAMP 和 CPA

复制页面

约 1342 字大约 4 分钟

Docker ComposeNginxCLI Proxy APICPA Manager Plus

 次阅读

2026-07-07

本文讲解如何使用 Docker Compose 同时部署 CLI Proxy API（简称 CPA）与其增强管理面板 CPA Manager Plus（简称 CPAMP），并通过 Nginx 统一反代，对外仅暴露一个端口。

  • CPA（CLI Proxy API）：统一代理转发 Claude Code、Codex、Gemini 等 CLI 工具的请求，支持多模型与 OAuth 账号管理。
  • CPAMP（CPA Manager Plus）：CPA 的增强管理面板，提供用量统计、模型价格管理、API 密钥别名、请求监控、Codex 账号巡检与导入导出等功能。

部署后共三个容器协同工作，最终目录结构如下：

项目目录

`config.yaml` CPA 配置文件

`docker-compose.yaml` 编排文件

nginx

conf.d

`default.conf` Nginx 反代配置

`auths/` CPA 认证数据（运行后自动生成）

`logs/` CPA 日志（运行后自动生成）

`cpa-manager-plus-data/` CPAMP 数据（运行后自动生成）

1. 下载默认配置文件

wget https://raw.githubusercontent.com/router-for-me/CLIProxyAPI/main/config.example.yaml
cp config.example.yaml config.yaml

2. 修改配置文件 config.yaml

# Management API settings
remote-management:
  # Whether to allow remote (non-localhost) management access.
  # When false, only localhost can access management endpoints (a key is still required).
  allow-remote: true # 允许远程访问

  # Management key. If a plaintext value is provided here, it will be hashed on startup.
  # All management requests (even from localhost) require this key.
  # Leave empty to disable the Management API entirely (404 for all /v0/management routes).
  secret-key: "123321" # 设置一个自己的密钥 key，如果不设置，会自动生成

  # Disable the bundled management control panel asset download and HTTP route when true.
  disable-control-panel: false

  # Disable automatic periodic background updates of the management panel from GitHub (default: false).
  # When enabled, the panel is only downloaded on first access if missing, and never auto-updated afterward.
  # disable-auto-update-panel: false

  # GitHub repository for the management control panel. Accepts a repository URL or releases API URL.
  panel-github-repository: "https://github.com/router-for-me/Cli-Proxy-API-Management-Center"

# Authentication directory (supports ~ for home directory)
auth-dir: "~/.cli-proxy-api"

# API keys for authentication
# 这里最好不使用默认的 不然可能会进不去
api-keys:
  - "123"

密钥说明

  • config.yaml 中的 remote-management.secret-key 是 CPA 管理 API 的访问密钥。
  • docker-compose.yaml 中的 CPA_MANAGER_ADMIN_KEY 是 CPAMP 面板 的登录密钥。
  • 两者用途不同，示例中均为 123321 仅为演示，生产环境请使用不同的强随机密钥。

3. 创建 Nginx 配置文件

mkdir -p ./nginx/conf.d
touch ./nginx/conf.d/default.conf
vim ./nginx/conf.d/default.conf
# 编辑内容如下
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

upstream cpa_api {
    server cli-proxy-api:8317;
}

upstream cpamp {
    server cpa-manager-plus:18317;
}

server {
    listen 80;
    # 如有域名请改成 your-domain.com；用 IP:20831 直连时 _ 可通配
    server_name _;

    client_max_body_size 64m;

    proxy_http_version 1.1;
    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
    proxy_buffering off;

    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_set_header Upgrade           $http_upgrade;
    proxy_set_header Connection        $connection_upgrade;

    # 默认进入 CPAMP 面板
    location = / {
        return 302 /management.html;
    }

    # ===== CPA Manager Plus =====

    location = /management.html { proxy_pass http://cpamp; }
    location = /health          { proxy_pass http://cpamp; }
    location = /status          { proxy_pass http://cpamp; }
    location = /setup           { proxy_pass http://cpamp; }

    # CPAMP 兼容接口与运行时接口
    location ^~ /usage-service/ { proxy_pass http://cpamp; }

    # /v0/management/* 先进入 CPAMP：
    # - 用量 / 模型价格 / API 密钥别名 / 仪表盘 / 请求监控 /
    #   Codex 账号巡检 / 导入导出 等由 CPAMP 自己处理
    # - 其他 CPA 管理接口由 CPAMP 使用服务端保存的 CPA Management Key 继续代理到 CPA
    #
    # 注意：不要只配置 location = /v0/management
    # 应使用带尾斜杠的前缀匹配 /v0/management/
    location ^~ /v0/management/ { proxy_pass http://cpamp; }

    # CPAMP 插件页面资源。缺少此规则时，插件页面可能打开空白或资源 404。
    location ^~ /v0/resource/plugins/ { proxy_pass http://cpamp; }

    # /models 由 CPAMP 提供兼容代理
    # 如果 CPAMP 尚未完成 setup，访问此路径可能返回 412
    location = /models          { proxy_pass http://cpamp; }

    # ===== CPA / CLI Proxy API =====

    # OpenAI / Claude Code / Codex 等实际 API 请求应直接走 CPA
    location ^~ /v1/                 { proxy_pass http://cpa_api; }
    location ^~ /v1beta/             { proxy_pass http://cpa_api; }
    location ^~ /backend-api/codex/  { proxy_pass http://cpa_api; }
    location ^~ /api/                { proxy_pass http://cpa_api; }

    # CPA 特殊路由与 OAuth 回调
    location = /v1internal:method    { proxy_pass http://cpa_api; }
    location = /healthz              { proxy_pass http://cpa_api; }
    location = /anthropic/callback   { proxy_pass http://cpa_api; }
    location = /codex/callback       { proxy_pass http://cpa_api; }
    location = /google/callback      { proxy_pass http://cpa_api; }
    location = /antigravity/callback { proxy_pass http://cpa_api; }

    # 兜底给 CPA
    # 用于 CPA 根路径、Amp 路由以及未来新增接口
    location / {
        proxy_pass http://cpa_api;
    }
}

4. 创建 docker-compose.yaml 文件

services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api:latest
    container_name: cli-proxy-api
    restart: unless-stopped
    volumes:
      - ${CLI_PROXY_CONFIG_PATH:-./config.yaml}:/CLIProxyAPI/config.yaml
      - ${CLI_PROXY_AUTH_PATH:-./auths}:/root/.cli-proxy-api
      - ${CLI_PROXY_LOG_PATH:-./logs}:/CLIProxyAPI/logs
    expose:
      - "8317"

  cpa-manager-plus:
    image: seakee/cpa-manager-plus:latest
    container_name: cpa-manager-plus
    restart: unless-stopped
    environment:
      HTTP_ADDR: "0.0.0.0:18317"
      USAGE_DB_PATH: "/data/usage.sqlite"
      CPA_MANAGER_DATA_KEY_PATH: "/data/data.key"
      # 托管部署建议显式设置 这里配置的是 CPAMP 的登录密钥
      CPA_MANAGER_ADMIN_KEY: "123321"
      USAGE_COLLECTOR_MODE: "auto"
      USAGE_BATCH_SIZE: "100"
      USAGE_POLL_INTERVAL_MS: "500"
      USAGE_QUERY_LIMIT: "50000"
    volumes:
      - ./cpa-manager-plus-data:/data
    expose:
      - "18317"
    depends_on:
      - cli-proxy-api

  nginx:
    image: nginx:alpine
    container_name: cpa-nginx
    restart: unless-stopped
    ports:
      - "10086:80"
      # 如果使用 HTTPS，可以再暴露 443。
      # - "443:443"
    volumes:
      - ./nginx/conf.d:/etc/nginx/conf.d:ro
      # 如果使用 HTTPS，挂载证书目录。
      # - ./nginx/ssl:/etc/nginx/ssl:ro
    depends_on:
      - cli-proxy-api
      - cpa-manager-plus

端口说明

Nginx 对外暴露 10086 端口，如需更改或与现有服务冲突，修改 ports: - "10086:80" 中的前半部分即可。CPA 与 CPAMP 通过 expose 仅在 Docker 网络内部通信，无需对外暴露。

5. 启动

docker compose up -d

6. 访问

浏览器打开 http://your-domain-or-ip:10086/，会自动跳转到 CPAMP 面板 management.html，按引导完成初始化即可。

初始化

首次进入面板需完成 setup，其中会要求填写 CPA 的 Management Key（即 config.yaml 中的 secret-key），填写后 CPAMP 即可代理调用 CPA 的管理接口。

版权归属：AkaChou

许可证：署名 4.0 国际 (CC-BY-4.0)

© 2026 AkaChou. Theme by plume