Skip to content

Home

Jump to bottom
seakee edited this page Jun 5, 2026 · 5 revisions

CPA Manager Plus Wiki

CPA Manager Plus, also known as CPAMP, is a management panel and Manager Server for CLI Proxy API. It provides CPA management UI, request monitoring, SQLite-backed usage analytics, model pricing, API key aliases, usage import/export, and Codex account inspection.

This wiki is rebuilt from the old CPA-Manager wiki with the parts that still apply to CPA Manager Plus. Some old CPA-Manager pages described an external Usage Service used by a CPA-hosted panel. That mode is not the Plus architecture anymore.

Start Here

Scenario Recommended guide
New deployment Docker Deployment
Deploy without Docker Native Binary Deployment
Understand Manager Server behavior Manager Server Guide
Migrate from old CPA-Manager Migration from CPA-Manager
Use one domain for CPAMP and CPA API Reverse Proxy CPA and CPA Manager Plus with the Same Domain
Admin key is lost Reset Admin Key
Something is broken FAQ and Troubleshooting

Chinese guides:

场景 推荐文档
新部署 Docker 部署 CPA Manager Plus
不使用 Docker 部署 二进制部署 CPA Manager Plus
理解 Manager Server Manager Server 使用指南
从旧 CPA-Manager 迁移 从 CPA-Manager 迁移
同域名反代 CPAMP 与 CPA 用同一个域名反代 CPA 与 CPA Manager Plus
管理员密钥丢失 重置管理员密钥
排查问题 CPA Manager Plus 常见问题与解决方案

Choose a Deployment Mode

Mode Entry URL What you enter Best for
Full Docker / Manager Server mode http://<host>:18317/management.html CPAMP admin key, CPA URL, CPA Management Key New deployments, monitoring, historical analytics, one entry point
Native Manager Server mode http://<host>:18317/management.html CPAMP admin key, CPA URL, CPA Management Key VPS or bare-metal deployments without Docker
CPA panel mode http://<cpa-host>:8317/management.html CPA Management Key Existing CPA panel usage without Manager Server analytics
Frontend development Vite dev server or built index.html CPA URL Local UI development

Important boundary:

  • Full Docker/native mode is where CPAMP Manager Server stores analytics in SQLite and serves the full panel.
  • CPA panel mode is a pure CPA panel. It does not configure Manager Server, does not read Manager Server SQLite, and does not provide request monitoring, model prices, API key aliases, imports/exports, or server-side inspection.
  • The old CPA-Manager "CPA panel + external Usage Service URL" workflow is not supported in Plus. Use the Manager Server-hosted /management.html entry for Manager Server features.

Feature Boundary

Capability Full Docker / native Manager Server CPA panel mode
CPA config, providers, auth files, logs, quota views Yes Yes
Local Codex account inspection in the browser Yes Yes
Manager Server setup and admin-key login Yes No
Encrypted CPA Management Key storage Yes No
Request monitoring and historical usage analytics Yes No
Dashboard usage cards, model pricing, API key aliases Yes No
Usage import/export Yes No
Server Codex inspection and persisted inspection history Yes No

Manager Server Highlights

Manager Server is the long-running backend in CPA Manager Plus. It:

  • Serves the embedded management.html panel
  • Stores usage events in SQLite
  • Consumes CPA usage records through RESP Pub/Sub, HTTP usage queue, or RESP pop fallback
  • Provides compatible /v0/management/usage APIs
  • Stores model prices and API key aliases
  • Proxies CPA Management API calls after setup
  • Encrypts the saved CPA Management Key with data.key
  • Uses a CPAMP admin key for panel login and Manager Server-only APIs

Recommended CPA version:

CPA v7.1.39+

Minimum CPA version for HTTP usage queue:

CPA v6.10.8+

Only one Manager Server should consume the usage queue for a CPA instance.

Recommended Reading Order

For new users:

  1. Read Docker Deployment.
  2. Start CPA separately.
  3. Start CPA Manager Plus.
  4. Open /management.html.
  5. Complete setup with the CPAMP admin key, CPA URL, and CPA Management Key.
  6. Use FAQ and Troubleshooting if monitoring is empty.

For existing CPA-Manager users:

  1. Read Migration from CPA-Manager.
  2. Stop the old backend before backup.
  3. Preserve the old /data volume or directory.
  4. Start Plus with the same data path.
  5. Save the generated or configured CPAMP admin key.

For reverse proxy deployments:

  1. Read Reverse Proxy CPA and CPA Manager Plus with the Same Domain.
  2. Route CPAMP-owned management paths to CPAMP.
  3. Route CPA API, OAuth callbacks, Codex API, and fallback paths to CPA.
  4. Use the CPAMP admin key for Manager Server management paths.

Project Links

CPA Manager Plus Wiki

English

Start

Operations

中文

开始

运维

Links

Clone this wiki locally