Skip to content

配置与数据目录

CPAMP 的核心数据都在本地。部署时先搞清楚三件事:SQLite 放在哪里,data.key 怎么保存,管理员密钥从哪里来。

关键文件

文件说明
usage.sqliteSQLite 数据库,保存请求事件、配置、价格、别名等数据。
usage.sqlite-walSQLite WAL 文件,存在时必须一起备份。
usage.sqlite-shmSQLite SHM 文件,存在时必须一起备份。
data.key数据密钥,用于加密保存 CPA Management Key。

Docker 默认路径:

text
/data/usage.sqlite
/data/data.key

原生包默认路径:

text
./data/usage.sqlite
./data/data.key

管理员密钥

完整 Docker / 原生 Manager Server 模式使用 cmp_admin_... 管理员密钥登录。

可通过以下方式配置:

变量说明
CPA_MANAGER_ADMIN_KEY直接传入管理员密钥。
CPA_MANAGER_ADMIN_KEY_FILE从文件读取管理员密钥。

如果未配置,首次启动会生成随机管理员密钥并输出到日志。该值不会再次显示。

CPA Management Key

CPA Management Key 用于访问 CPA 管理接口。

完整 Docker / 原生 Manager Server 模式下,CPAMP 会使用 data.key 加密后保存 CPA Management Key。

CPA Panel 模式下,浏览器持有 CPA Management Key,符合 CPA 托管面板访问方式。

采集配置

推荐使用:

text
USAGE_COLLECTOR_MODE=auto

自动模式会依次尝试 RESP Pub/Sub、HTTP queue 和 RESP pop。

约束:

  • RESP 连接必须直连 CPA API 端口,通常是 8317
  • HTTP queue 可以经过 HTTP proxy。
  • pollIntervalMs 不应超过 CPA 用量队列保留时间。
  • CPA retention 默认 60s,最大 3600s。
  • 同一个 CPA queue 只应由一个 Manager Server 消费。

Released under the MIT License.