配置中心
配置中心用于修改连接、请求监控和 CPA 系统设置。添加模型服务请去 AI 提供商，添加账号请去 OAuth 登录或凭证管理。
| 你想做什么 | 使用哪个区域 |
|---|---|
| 修改常见 CPA 设置 | 可视化配置 |
查看或编辑完整 config.yaml | 源文件配置 |
| 连接 CPA、开启请求监控 | Manager Server 配置（完整模式） |
页面入口
配置中心通常包含三类编辑方式：
- 可视化配置：适合日常调整。字段分组展示，保存前可以检查变更。
- 源文件配置：适合熟悉
config.yaml的用户。改动更直接，但也更容易写错格式。 - Manager Server 配置：只在 Manager Server 托管面板时可用，用于绑定 CPA、启停采集器和保存 CPAMP 自己的运行设置。
如果某个 Tab 不可用，先确认当前使用的是 CPAMP 轻量面板还是完整模式。轻量面板下不会出现 Manager Server 专属能力；完整模式可以通过 Docker 或原生包安装。在线演示只显示虚构数据，不能用于配置真实 CPA 或验证真实运行状态。
Manager Server 配置
大多数用户只需要确认三个字段：
- CPA 地址：Manager Server 访问 CPA 的地址。容器部署时通常是 Docker 网络里的服务名，不一定是浏览器访问地址。
- CPA Management Key：只用于 CPAMP 调用 CPA 管理接口，不是客户端请求模型时使用的 API Key。
- 请求监控：开启后会启用 CPA 用量统计，并启动 CPAMP 采集器。
保存后回到仪表盘确认 CPA 已连接，再发送一条真实请求检查请求监控。
高级采集设置
- 采集模式：自动、RESP 或 HTTP。RESP 需要直连 CPA API 端口，不能走普通 HTTP 反向代理。
- 轮询间隔、批量大小、查询上限：影响采集延迟和单次读取量。不要把轮询间隔设置得比 CPA 队列保留时间还长。
- 配置来源：环境变量、SQLite 或未保存。环境变量优先级最高，面板保存不能覆盖环境变量。
没有明确网络限制时保持自动模式和默认数值。只有监控为空或特殊代理环境才需要修改这些字段。
可视化配置与源文件配置
日常建议优先用可视化配置，因为它会按功能分组并减少 YAML 格式错误。源文件配置适合这些场景：
- 需要一次性调整多段配置。
- 需要复制已有
config.yaml。 - 需要检查可视化配置没有覆盖的字段。
- 需要和部署环境中的配置做差异比对。
保存源文件前，先确认缩进、数组和字符串引号正确。保存后如果页面没有刷新，检查 CPA 是否支持热重载，或是否需要重启运行时。
加权轮询路由
需要让同一优先级内的多份凭证按比例承接请求时，在可视化配置中把路由策略设为“加权轮询”，对应的源文件配置是：
routing:
strategy: weighted-round-robinCPA 会先筛选当前最高且可用的 priority 层级，再在该层级内按凭证 weight 执行加权轮询。未设置 weight 时默认为 1；权重必须是整数，最大为 1,000,000；非正数会让该凭证在加权轮询策略下不参与分配。清空 CPAMP 中的权重输入会移除显式 weight，恢复默认值 1。
此策略和权重字段需要 CPA 本身支持 weighted routing。旧版 CPA 可能忽略或拒绝这些配置；升级到包含该能力的 CPA 构建后，再到 AI 提供商或凭证管理设置各凭证权重。验证比例时应使用多个独立请求；启用会话亲和性后，同一会话可能持续绑定既有凭证。
保存后怎么验证
常见误区
- CPAMP 管理员密钥、CPA Management Key、客户端 API Key 和提供商 API Key 是四类不同密钥。
- 关闭 CPAMP 请求监控采集器，不等于清空 CPA 用量队列。
- 模型价格只影响 CPAMP 成本估算，不会改变提供商实际计费。
- 环境变量来源的配置要改部署环境并重启，不能只在面板里保存。