本文最后更新于41 天前，其中的信息可能已经过时，如有错误请发送邮件到2275012286@qq.com，或者在下方留言。

2026 年 9 月 23 日更新：用量检测已改用 CPA Usage Keeper 插件，本文第二节已更新为 Keeper 部署与接入说明。原有截图保留作历史参考，实际界面请以当前版本为准。

想了解更多技术分享请搜索“技术”标签，本人水平有限，内容可能不严谨或存在错误，如有发现错误请在评论区处留言，欢迎批评指正。

一、前言

1.什么是CPAMC中转站

CPAMC中转站是一个能够把各个大语言模型厂商的coding plan 和上游提供商的API进行统一管理的API中转站之一，对于有多个账号想要方便的切换和多账号均衡使用API额度的人很方便，也有其他类似的API中转站，如newapi（市面上商业的API中转站大多是用的这个）、sub2api等。

2.关于CPAMC中转站搭建内容

CPAMC中转站搭建包含的主要内容：CLIProxyAPI后端、CPAMC管理前端、Keeper用量检测插件、OAuth 登录、CC Switch等，同时会推荐一个非常强大的多Agent协同工作的平台HagiCode。

二、过程

1.CLIProxyAPI后端

想要了解建议先访问 CLIProxyAPI 里面有详细的介绍，也有快速入门方法，同时有很多详细的配置方法。下面我只大致讲一件安装过程和其中的坑。

网络允许的话建议用源码编译方式，这样你和我的路径是一样的是在”C:\Users\%User_name%\CLIProxyAPI”。

执行构建程序后后端其实就已经在运行了，因为是后端所以是不会弹出任何界面的，当前窗口不能关闭。每次开机都要命令行运行一下，长期使用可以按部署环境配置开机启动；Keeper 也需要单独保持运行。

将目录中的 config.example.yaml 复制为 config.yaml，再按自己的环境修改配置。

把 secret-key 设置为自己的管理员密钥，保存后重启 CLIProxyAPI 服务使配置生效。

2.CPAMC 管理前端与 Keeper 用量检测插件

现在我的用量检测已经改用 CPA Usage Keeper，并通过插件嵌入 CPAMC。之前介绍的第三方统计前端、CLIProxyAPI-Web-Dashboard 和对应的一键启动脚本属于旧方案，这一节按当前方案更新。

这里先分清三个部分：CLIProxyAPI（CPA）负责 API 中转；CPAMC负责管理配置、账号和密钥；Keeper负责用量持久化、统计分析以及账号健康与限额查看。Keeper 本身需要单独运行，安装前端插件只是把它的面板接入 CPAMC。

项目地址：Willxup/cpa-usage-keeper。安装和配置说明请参考项目的中文文档，下载请到 Releases。后续版本的菜单和配置可能变化，以对应版本文档为准。

2.1 先准备好 CPA 与管理界面

先确认 CLIProxyAPI 已正常运行，能够打开管理界面并完成登录。使用带管理页面的版本时，本机默认地址通常是 http://127.0.0.1:8317/management.html；如果改了端口、域名或部署方式，请使用自己的地址。需要嵌入 Keeper 时，使用支持 CPA 插件的 CPAMC 版本。

在 CPA 的 config.yaml 中启用用量统计，修改后重启 CPA 服务：

usage-statistics-enabled: true

2.2 安装并连接 Keeper

已经部署 CPA 的朋友，只需要再部署 Keeper。项目支持 Docker / Docker Compose、Linux 二进制和 Windows 二进制等方式。下面沿用本文的 Windows 本机环境举例：下载适合自己系统架构的 Windows ZIP，解压后在该目录打开 PowerShell。

Copy-Item .env.example .env
notepad .env

在 .env 中设置连接地址、CPA 管理密钥以及 Keeper 登录密码。本机独立访问的示例配置如下，两个中文占位值都需要替换：

CPA_BASE_URL=http://127.0.0.1:8317
CPA_MANAGEMENT_KEY=替换为你的CPA管理密钥
AUTH_ENABLED=true
LOGIN_PASSWORD=替换为你的Keeper登录密码
APP_HOST=127.0.0.1
APP_PORT=8080
TZ=Asia/Shanghai

CPA_MANAGEMENT_KEY 填 CPA 的管理员密钥，不是给客户端调用模型用的 API Key；LOGIN_PASSWORD 是 Keeper 自己的登录密码。配置完成后运行：

.\cpa-usage-keeper.exe

打开 http://127.0.0.1:8080，使用刚设置的 Keeper 登录密码进入面板。Keeper 需要持续运行才能持续采集，关闭它的运行进程会中断采集；长期使用可以按自己的部署环境配置开机启动，Linux 可以使用项目提供的 systemd 方式。

Docker 用户建议直接参考官方 Keeper-only Compose 模板。容器里的 127.0.0.1 指向容器自身，不能直接照搬上面的本机地址；请填写容器能访问到的 CPA 地址。数据目录也要持久化挂载，升级时保留数据库。

2.3 把 Keeper 接入 CPAMC 插件

确认 Keeper 独立页面可以正常使用后，再按当前 CPAMC 版本的插件接入方式嵌入 Keeper Dashboard。插件配置使用浏览器能够访问的 Keeper 地址；页面入口和安装方式以对应版本说明为准。

如果 CPA 与 Keeper 使用不同域名或端口，需要在 Keeper 中把 CPA_PUBLIC_URL 设置为浏览器访问 CPA / CPAMC 的完整公开地址，以配置嵌入信任来源。CPA_BASE_URL 则是 Keeper 服务端连接 CPA 的地址，两者用途不同。

服务器通过 /keeper/ 子路径提供面板时，设置 APP_BASE_PATH=/keeper，并让反向代理保留这个路径前缀。使用 HTTPS 的管理页面时，Keeper 也应通过 HTTPS 访问。具体反向代理配置可以参考官方中文文档，不需要把本文的本机端口原样照搬到公网。

2.4 检查是否正常采集

通过 CPA 发起一次正常的模型请求，再到 Keeper 查看请求数、Token 和请求明细是否更新。Keeper 会将采集到的用量保存到 SQLite，可查看用量趋势、模型和 API Key 统计、成功率、延迟及按模型价格估算的成本。成本估算不等同于实际账单。

请求用量和账号剩余额度要分开看。请求与 Token 统计反映已经经过 CPA 的调用；账号的限额和健康状态可在 Keeper 的 Auth Files / AI Providers 相关页面查看，能否查询以及刷新结果取决于对应提供商与当前凭证。

如果没有新数据，优先检查 CPA 是否开启用量统计、管理密钥是否正确、Keeper 能否连接 CPA，以及 Keeper 日志中的采集错误。当前版本还涉及 CPA 的 Redis/RESP 用量队列；使用非默认地址时需按文档配置 REDIS_QUEUE_ADDR。同一 CPA 接入多个用量采集服务时，应按文档统一使用订阅模式，避免数据不完整。

Keeper 保存的是实际采集到的数据，部署前已经丢失的历史记录不能凭空恢复。需要长期留存时，请保留工作目录和数据库备份。下面的 OAuth 登录、创建 API Key 和客户端接入流程仍可继续参考，旧截图中的界面以当前版本为准。