CCR 配置备份怎么做3 个步骤守住你的路由规则和 API 密钥【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router上周有个同事的笔记本硬盘坏了装好的 Claude Code Router 跟着没了——路由规则、上游 Provider 的密钥、Agent 配置全丢重新配了半天还差一个找不回来的密钥。CCR 配置备份这件事平时没人想起来真出事时它就是你唯一的活路。先说结论CCR 的全部核心配置都在一个目录里备份就是把停服务 打包目录做成习惯。你的数据到底存在哪这一步解决备份什么、备份到哪里找的问题。CCR 把配置放在用户主目录下的.claude-code-router文件夹里不同系统位置略有差异macOS / Linux~/.claude-code-router/Windows%APPDATA%\claude-code-router\目录里真正值钱的是这几样config.sqlite当前全部应用配置Provider、路由、Agent 配置它是主数据库app-data/API 密钥、用量统计、请求日志、证书等运行时数据profiles/各 Agent 配置的隔离文件gateway.config.json网关运行配置可再生但留着不亏⚠️ 风险config.sqlite运行时不要直接复制。SQLite 有-wal和-shm两个伴随文件服务运行中拷贝出来大概率是一个坏库。文件级备份前先停掉 CLI 和桌面端。老版本用config.json存配置现在只会在首次启动时作为迁移源读一次之后改了它也不生效。别照着网上老教程去备份一个config.json。场景一配置丢了或坏了怎么快速恢复假设某天~/.claude-code-router被误删或者数据库损坏导致 UI 打不开。处置顺序是找快照 → 停服务 → 解包 → 起服务。找到最近一份备份假设放在~/ccr-backups/下ls -lt ~/ccr-backups/这条命令按时间倒序列出所有备份包第一行就是最新的。停掉可能残留的 CCR 进程避免恢复后两个状态打架ccr stop用备份包覆盖配置目录tar xzf ~/ccr-backups/ccr-20260901.tgz -C ~/.claude-code-router/这条命令把快照解包回原目录-C参数指定解压目标路径写错会解到别的文件夹。启动并验证ccr start管理界面能打开、Provider 列表还在就恢复成功了。 提示如果你习惯 Docker 部署恢复方式类似——把备份复制到一个空的/data目录容器保持停止状态。千万别把旧备份直接盖在还有新数据的目录上旧的 WAL/SHM 文件和新的运行时文件混在一起数据库照样废。场景二换新设备CCR 数据迁移换电脑、换服务器时CCR 数据迁移的本质就是旧机器打包 → 传文件 → 新机器解包中间不依赖网络同步。旧设备上停服务并打包这就是你平时该留着的快照ccr stop tar czf ccr-backup.tgz -C ~ .claude-code-router这条命令停掉后台服务后把整个配置目录压缩成一个ccr-backup.tgz。通过 U 盘、网盘或scp把文件传到新设备。新设备装好 CCR 后先不要启动它直接解包到主目录tar xzf ccr-backup.tgz -C ~解完后~/.claude-code-router就完整出现了再执行ccr start路由规则和密钥原地复活。⚠️ 注意备份包里包含上游 API 密钥和 CCR 客户端密钥传输走加密通道落到网盘后别设公开权限。这份目录按机密文件级别对待就行。场景三Provider 密钥过期或丢失密钥找不回来时先想清楚它存在哪。CCR 的上游 Provider 凭证不在config.sqlite里裸存而是落在app-data/目录下的密钥数据库中所以恢复密钥也靠同一份快照而不是手工改某个 JSON 字段。处置分三条路有快照按场景一的步骤恢复整个目录密钥随库一起回来前提是该快照拍摄于密钥仍然有效的时段。快照里也没有去 Provider 官网重置密钥然后打开 CCR 管理界面的 Provider 页面把新密钥粘贴进去保存即可。怀疑密钥泄露直接吊销并重置恢复旧快照前先在 UI 里确认一下密钥是否还需要换。顺带一提CCR 的设置页提供导出数据入口那是官方推荐的应用级备份方式导出的快照就是给这个场景用的。把备份变成定时任务一次配置长期生效前三节都假设你有备份这一节解决怎么保证你总有备份。用系统自带的定时任务加一条打包命令即可不需要写脚本。在 crontab 里加一行每天凌晨 3 点打包一次0 3 * * * tar czf ~/ccr-backups/ccr-$(date \%Y\%m\%d).tgz -C ~ .claude-code-router这条命令到点后自动把配置目录压缩进~/ccr-backups/文件名带日期方便按天回溯。再补两条习惯保留最近 14 天就够用find ~/ccr-backups -mtime 14 -delete挂在同一行任务后面自动清理Docker 部署的用户把docker compose cp ccr:/data/. ./backups/停容器后执行一次效果等同最后备份这件事没什么技术含量难的是让它发生在灾难之前。CCR 的全部家当就集中在一个目录里这让CCR 数据恢复退化成了一次 tar 操作——只要你接受升级前、换机前、改完路由后各打一次包将来无论是误删、坏盘还是密钥过期你花在恢复上的时间不会超过十分钟。可参考的仓库内资料配置库位置说明见 docs/src/content/docs/en/configuration/configuration-file.mdCLI 各命令与数据目录对照表见 docs/src/content/docs/en/guides/cli.mdDocker 部署下的备份恢复细节见 docs/src/content/docs/en/guides/docker.md。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考