从CPA-Manager迁移到Plus：历史数据保留与配置无缝过渡

从CPA-Manager迁移到Plus历史数据保留与配置无缝过渡【免费下载链接】CPA-Manager-PlusA self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashboard for requests, usage, cost, quota, failures, and account health.项目地址: https://gitcode.com/gh_mirrors/cp/CPA-Manager-PlusCPA-Manager-Plus是一款自托管的CPA/CLIProxyAPI管理面板和AI网关可观测性仪表板专为请求、使用量、成本、配额、故障和账户健康状况设计。本指南将帮助您从旧版CPA-Manager平滑迁移到Plus版本确保历史数据和配置的无缝过渡。迁移前的关键准备工作在开始迁移之前做好充分的准备工作至关重要。首先确认您的CPA本体版本是否符合要求 - 推荐使用v7.1.0及以上版本HTTP用量队列至少需要v6.10.8。其次确定旧Manager Server的数据位置这取决于您的部署方式Docker卷通常命名为cpa-manager-data宿主机目录挂载通常映射到容器的/data目录原生包默认数据存储在程序目录下的data/usage.sqlite最重要的一步是停止旧容器或进程并备份整个数据目录包括usage.sqlite、usage.sqlite-wal和usage.sqlite-shm文件。不要只备份单个数据库文件完整的备份可以在迁移过程中出现问题时提供安全保障。不同部署方式的迁移步骤Docker卷迁移如果您使用Docker卷部署旧版CPA-Manager迁移过程相对简单。旧的compose文件结构通常如下services: cpa-manager: image: seakee/cpa-manager:latest volumes: - cpa-manager-data:/data volumes: cpa-manager-data:迁移时只需让Plus直接挂载旧卷services: cpa-manager-plus: image: seakee/cpa-manager-plus:latest restart: unless-stopped ports: - 18317:18317 environment: HTTP_ADDR: 0.0.0.0:18317 USAGE_DB_PATH: /data/usage.sqlite CPA_MANAGER_DATA_KEY_PATH: /data/data.key CPA_MANAGER_ADMIN_KEY: replace-with-a-long-random-admin-key USAGE_COLLECTOR_MODE: auto volumes: - cpa-manager-data:/data volumes: cpa-manager-data: external: true⚠️ 注意Plus版本的示例compose文件默认会创建新的cpa-manager-plus-data卷。如果直接使用默认配置您将获得一个全新的安装不会包含任何旧数据。宿主机目录迁移如果您的旧容器使用宿主机目录挂载迁移命令如下docker stop cpa-manager cp -a /srv/cpa-manager-data /srv/cpa-manager-data.backup docker run -d \ --name cpa-manager-plus \ --restart unless-stopped \ -p 18317:18317 \ -v /srv/cpa-manager-data:/data \ -e CPA_MANAGER_ADMIN_KEYreplace-with-a-long-random-admin-key \ seakee/cpa-manager-plus:latest启动后您可以通过http://host:18317/management.html使用管理员密钥登录新的Plus面板。原生包迁移对于原生包部署迁移步骤如下停止旧的cpa-manager进程备份旧程序目录尤其是data/usage.sqlite*文件解压新的cpa-manager-plus_version_os_arch包将旧的data目录复制到新包目录或设置环境变量指向旧数据目录首次启动时设置管理员密钥CPA_MANAGER_ADMIN_KEYreplace-with-a-long-random-admin-key ./cpa-manager-plus如果未设置管理员密钥服务会生成一个cpamp_...格式的密钥并只在首次启动日志中输出一次请注意保存。迁移后的验证与检查成功启动Plus版本后您需要进行一系列验证以确保迁移成功查看启动日志确认没有出现decrypt secret、open sqlite或bootstrap manager server等错误信息访问管理面板检查已绑定的CPA地址、请求监控开关、采集模式和轮询间隔等配置打开仪表盘或监控页面确认历史数据是否正常显示请求/status端点检查collector状态、lastConsumedAt、lastInsertedAt和lastError等指标备份迁移后的/data目录此时应包含新生成的data.key文件数据安全与备份策略Plus版本引入了新的数据加密机制将CPA Management Key加密存储在SQLite数据库中。默认的数据密钥位于/data/data.key请务必了解以下安全规则仅泄露usage.sqlite文件时攻击者无法直接获取CPA Management Key同时泄露usage.sqlite和data.key时CPA Management Key可能被解密丢失data.key时已加密的CPA Management Key无法恢复只能重新配置因此进行灾备时务必同时备份SQLite文件和data.key而在共享排查材料时不要上传data.key文件。常见问题与解决方案迁移过程中可能会遇到一些常见问题以下是解决方案迁移后没有旧数据通常是因为挂载了新的cpa-manager-plus-data空卷而不是旧的cpa-manager-data卷登录一直401请记住Manager Server接口需要管理员密钥而CPA Management Key仅用于登录CPA控制面板监控页面为空确认CPA用量发布已开启USAGE_COLLECTOR_MODE与网络路径匹配并且同一个CPA实例只有一个Manager Server消费用量队列解密失败检查是否在迁移后丢失或替换了/data/data.key文件如果您遇到管理员密钥丢失的情况可以参考重置Manager Server管理员密钥文档进行处理。总结从CPA-Manager迁移到Plus版本是一个相对简单的过程只需正确挂载旧数据目录并设置管理员密钥即可。迁移后您将获得更强大的功能和更好的用户体验同时保留所有宝贵的历史数据。迁移完成后建议彻底测试所有功能确保一切正常运行。如有任何问题可以查阅项目的官方文档或寻求社区支持。【免费下载链接】CPA-Manager-PlusA self-hosted CPA / CLIProxyAPI management panel and AI gateway observability dashboard for requests, usage, cost, quota, failures, and account health.项目地址: https://gitcode.com/gh_mirrors/cp/CPA-Manager-Plus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考