如何选择 CPA / CLIProxyAPI 管理面板

CPA / CLIProxyAPI 用户不只有“官方面板或部署一套完整系统”两个选择。CPAMP 同时提供由 CPA 直接托管的轻量面板，以及带 Manager Server 的完整模式。

快速结论

目标	推荐选择
使用 CPA 项目维护的上游原生 UI	官方 Management Center
不增加服务，用更清晰的 WebUI 替换官方界面	CPAMP 轻量面板
持久化请求历史、排查失败并分析成本	CPAMP 完整模式
运行服务端账号巡检、配额冷却和账号处理自动化	CPAMP 完整模式
先低成本使用，后续再决定是否部署 SQLite 和采集器	先用 CPAMP 轻量面板

官方 Management Center

官方面板是 CPA 项目维护的基准 WebUI，直接调用 CPA Management API，适合希望跟随上游默认界面的用户。

• 不需要额外服务。
• 从 CPA :8317/management.html 访问。
• 使用 CPA Management Key 登录。
• 管理配置、Provider、认证文件、OAuth、API Key、Quota 和日志。

官方项目：router-for-me/Cli-Proxy-API-Management-Center。

CPAMP 轻量面板

CPAMP 轻量面板使用同一个 CPA 端口和 Management API，用 CPAMP 的导航、表单、卡片与信息组织替代官方界面。

• 同样不需要 Manager Server、SQLite 或额外容器。
• 只需把 CPA 的 panel-github-repository 指向 CPA Manager Plus。
• 保留 CPA 原生的配置管理、认证文件、OAuth、Quota、日志和插件工作流。
• 适合不喜欢官方 UI，但仍希望保持单进程、单端口部署的用户。

查看 CPAMP 轻量面板安装指南。

CPAMP 完整模式

完整模式增加 Manager Server 和本地 SQLite，用于轻量面板无法提供的服务端能力：

• 持久化 CPA usage queue 中的请求事件。
• 按账号、模型、Provider、API Key、项目和时间范围分析请求、成本、Token、延迟与失败。
• 保存模型价格、API Key 别名、巡检历史和自动化状态。
• 运行服务端 Codex/xAI 巡检、配额冷却和账号处理队列。
• 提供备份、后台迁移、性能诊断和独立 CPAMP 管理员登录。

入口与能力边界

使用方式	面板入口	适合谁
官方 Management Center	http://<cpa-host>:8317/management.html	希望继续使用上游原生 UI
CPAMP 轻量面板	http://<cpa-host>:8317/management.html	只想替换 UI，不增加服务
CPAMP 完整模式	http://<cpamp-host>:18317/management.html	需要监控、成本、巡检和自动化

CPA 托管的 :8317 面板不会连接或读取 Manager Server。即使另外启动了 Manager Server，也必须打开它自己的 :18317/management.html 才能使用请求历史、成本分析、模型价格和服务端巡检。

完整模式的安装方式

完整模式只有一套产品能力，可以选择两种安装方式：

• Docker 部署（推荐）：适合大多数新用户和服务器部署。
• 原生包部署：适合不使用 Docker 的 Linux、macOS 或 Windows 主机。

两种方式都从 :18317/management.html 进入，并使用 CPAMP Admin Key 登录。

先体验再决定

在线演示可以帮助你预览界面和操作结构，但它只使用虚构数据。演示站不是面板、部署方式或运行模式，不能连接、管理或监控真实 CPA，也不能用于验证实际功能是否正常。

推荐升级路径

1. 已有 CPA，只想更换 UI：安装 CPAMP 轻量面板。
2. 需要历史监控或成本分析：部署 Manager Server。
3. 改为访问 :18317/management.html，完成 CPA 连接和采集配置。
4. CPA 端口仍可保留轻量面板，但两个入口的能力相互独立。

下一步

• 安装 CPAMP 轻量面板。
• 查看 能力矩阵。
• 使用推荐的 Docker 部署。
• 不使用 Docker 时安装 原生包。