面向 CPA / CLIProxyAPI 的自托管管理面板与可观测性仪表盘，覆盖请求、用量、成本、配额、失败诊断和账号健康。
在一个本地面板中管理 Provider、认证文件、OAuth、插件和配置，并持久化请求历史、成本分析与账号自动化状态。
CPA / CLIProxyAPI 可以在 :8317 直接托管官方 Management Center，也可以换成 CPAMP 轻量面板。轻量面板不增加额外服务，只用更清晰的 CPAMP WebUI 替代官方界面；需要持久化可观测性和长期运维时，再部署 CPAMP 完整模式。
| 需求 | 推荐选择 |
|---|---|
| 继续使用 CPA 项目维护的上游原生 UI | 官方 CLI Proxy API Management Center |
| 不部署额外服务，用更清晰的 CPA 托管 WebUI 替代官方界面 | CPAMP 轻量面板 |
| CPA 队列过期后仍需保留请求历史并排查失败 | CPAMP 完整模式 |
| 按模型、账号、API Key、项目和时间范围分析成本 | CPAMP 完整模式 |
| 需要服务端账号巡检、自动化、SQLite 备份和可恢复迁移 | CPAMP 完整模式 |
详细区别见 如何选择 CPA 面板，也可以直接查看 CPAMP 轻量面板安装指南。
- 管理 Gemini、Codex、Claude、Vertex、xAI、OpenAI-compatible 等 CPA Provider 配置。
- 维护认证文件、OAuth 登录、API Key、模型别名、优先级、插件、日志和系统配置。
- 导入官方 Sub2API OpenAI OAuth 导出，并把多账号拆分为独立的 CPA Codex 认证文件。
- 从 latest、指定 GitHub Release、prerelease 或手动 tag 安装插件。
- 将 CPA usage queue 中的请求持久化到本地 SQLite。
- 通过账号、调用方 API Key 和实时请求视图查看状态、延迟、Token、缓存、Trace 和脱敏失败证据。
- 使用 JSONL 导入或导出请求历史，不暴露原始失败体。
- 打开 请求监控演示。
- 按模型、Provider、账号、认证文件、API Key、项目、渠道和时间范围拆解请求、Token、成本、延迟和失败。
- 识别 input、output、reasoning、cache read/write/creation、service tier 和长上下文计费语义。
- 从 LiteLLM 和 OpenRouter 同步模型价格，并为别名或内部模型保留本地覆盖。
- 打开 用量分析演示。
- 在浏览器本地或 Manager Server 定时巡检 Codex 和 xAI 账号。
- 在 Provider 可提供信息时展示 Codex 窗口、Claude 周额度/模型级额度、xAI/Grok billing、凭证状态、工作区状态和 reset 证据。
- 对明确额度耗尽执行受控冷却，并且只恢复由同一自动化来源禁用的凭证。
- 将认证故障汇总到账号处理队列，用于重新授权、人工复核、启用、解决或安全删除。
- 打开 账号巡检演示 和 认证文件演示。
- 使用单 Docker 容器，或 Linux、macOS、Windows 的 amd64/arm64 原生包运行。
- 请求历史、Manager 配置、账号自动化和模型价格都保存在本地文件，不需要注册账号，也不包含遥测 SDK。
- 使用受控 SQLite 连接、流式导入导出、增量汇总、可恢复后台迁移和仅本机开放的 pprof 诊断。
- 备份 SQLite 时同时保存
data.key，才能恢复加密后的 CPA Management Key。
仪表盘
|
请求监控
|
用量分析
|
账号健康
|
| 选择 | 适合谁 | 入口 |
|---|---|---|
| CPAMP 轻量面板 | 已有 CPA，只想替换官方管理界面 | CPA :8317/management.html |
| CPAMP 完整模式 | 需要请求历史、成本分析、账号巡检和自动化 | Manager Server :18317/management.html |
完整模式可以通过 Docker（推荐）或原生包安装。
想先了解界面？可以打开在线演示。演示站只使用虚构数据，不是部署或运行模式，不能连接、管理或监控真实 CPA。
CPAMP 管理和观测经过 CPA / CLIProxyAPI 的流量，本身不是模型代理，也不会独立转发模型请求。
按向导执行完整安装或仅安装 CPAMP：
curl -fsSLO https://raw.githubusercontent.com/seakee/CPA-Manager-Plus/main/bin/install-cpamp.sh
bash install-cpamp.sh只预览操作：
CPAMP_DRY_RUN=1 bash install-cpamp.sh升级、修复和管理员密钥恢复行为见 一键安装脚本。
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，从 Manager Server 日志取得 CPAMP 管理员密钥，然后在 setup 填写 CPA 地址和 CPA Management Key。
CPA 已经在运行时：
docker run -d \
--name cpa-manager-plus \
--restart unless-stopped \
-p 18317:18317 \
-v cpa-manager-plus-data:/data \
seakee/cpa-manager-plus:latest推荐 CPA 版本：v7.1.39+，HTTP usage queue 至少需要 v6.10.8+。
| 任务 | 文档 |
|---|---|
| 选择面板和部署模式 | 如何选择 CPA 面板 |
| 不部署额外服务，直接替换官方 UI | CPAMP 轻量面板 |
| 安装并完成首次配置 | 快速开始 |
| 查看功能、Provider 和模式边界 | 能力矩阵 |
| 配置 Provider、认证文件、配额和插件 | 面板手册 |
| 运维 Manager Server、备份、升级与迁移 | Manager Server 指南 |
| 排查监控为空或队列问题 | 请求监控排障 |
- CPAMP 不会回传遥测，不包含分析 SDK，也不要求注册账号。
- 外部请求只限于 CPA Gateway 及你明确配置或主动触发的 OAuth、Provider 检查、插件 Release 和模型价格同步。
- 请求历史、配置、模型价格、巡检历史和自动化状态都保存在本地文件。
- CPA Management Key 入库前会加密；备份需要同时保存 SQLite 文件和
data.key。 - 普通 API 和 JSONL 导出只暴露脱敏失败摘要，不返回原始失败体或保存的原始 JSON。
- CPAMP 只应用于你有权管理的流量和凭证。
npm install
npm run dev
npm run type-check
npm run lint
npm run test
npm run build
npm run docs:buildManager Server：
cd apps/manager-server
go test ./...
go test -race ./...
go vet ./...
go run ./cmd/cpa-manager-plus本地构建 Docker stack：
docker compose -f docker-compose.manager.yml up --buildnpm run build生成单文件apps/web/dist/index.html。bin/release/package-native.sh将面板内置到原生包。- 推送
vX.Y.Ztag 会触发.github/workflows/release.yml。 - 发布产物包括
management.html、原生包及linux/amd64、linux/arm64Docker 镜像。
- 感谢 CLIProxyAPI 和官方 CLI Proxy API Management Center 提供运行时与 WebUI 基础。
- 感谢 Linux.do 社区对项目推广与反馈的支持。
- Telegram：https://t.me/cpa_mp
MIT — Copyright 2026 Seakee。