快速开始

这页带你从一套最小 Docker 环境跑起：先启动 CPA 网关运行时，再启动 CPAMP 面板，最后确认监控数据能进来。已经有 CPA 在运行的用户，可以直接跳到 仅部署 CPAMP。

推荐部署方式

第一次部署建议用 Docker Compose。它会同时创建 CPA 和 CPAMP 的持久化 volume：

services:
  cli-proxy-api:
    image: eceasy/cli-proxy-api:latest
    restart: unless-stopped
    ports:
      - "8317:8317"
    volumes:
      - cpa-data:/app/data

  cpa-manager-plus:
    image: seakee/cpa-manager-plus:latest
    restart: unless-stopped
    ports:
      - "18317:18317"
    volumes:
      - cpa-manager-plus-data:/data

volumes:
  cpa-data:
  cpa-manager-plus-data:

启动服务：

docker compose up -d

打开管理面板：

http://<host>:18317/management.html

第一次登录需要 CPAMP 管理员密钥。没有显式设置时，Manager Server 会在启动日志里输出一次：

docker compose logs cpa-manager-plus

首次配置

进入 setup 后按顺序填写：

1. CPAMP 管理员密钥。
2. CPA 地址，例如 http://cli-proxy-api:8317。
3. CPA Management Key。
4. 请求监控采集方式。新部署保持默认 auto 即可。

推荐 CPA 版本：v7.1.39+。HTTP 用量队列至少需要 v6.10.8+。

配好后应该看到什么

• 仪表盘能打开，并显示 Manager Server / CPA 连接状态。
• 请求监控在有真实请求后出现实时请求记录。
• 用量分析能按模型、账号、项目和时间范围拆解成本与 Token。
• Codex 账号巡检能看到配额、重置时间、凭证状态和账号健康。

如果面板打开了但监控为空，先看 请求监控排障，通常是用量发布、CPA URL、队列保留时间或采集器路径问题。

下一步

• 还没决定部署形态：阅读 运行模型。
• 要配置提供商或客户端：阅读 网关配置。
• 要理解每个面板页面：从 仪表盘 开始。
• 使用原生包：阅读 原生包部署。
• 从旧项目迁移：阅读 从 CPA-Manager 迁移。