CCR 配置备份与恢复的完整实战笔记【免费下载链接】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凌晨两点发现配置库缩水成了 512 字节02:14Claude Code Router 的网关突然拒绝所有请求你打开管理页面Provider 列表空了。cd ~/.claude-code-router一看config.sqlite从 1.2 MB 缩成了 512 字节config.sqlite-wal和config.sqlite-shm直接消失。你调了一周的路由规则、一个个填进去的 API Key一夜归零。CCR 配置备份真正保护的是什么一个 SQLite 库CCR 的全部运行配置都在~/.claude-code-router/config.sqlite里Windows 在%APPDATA%\claude-code-router\config.sqliteSQLite 还在同目录维护config.sqlite-wal和config.sqlite-shm两个辅助文件。Provider 凭据、路由规则、客户端 API Key、Agent Profile 全部存这个库中旧版config.json只是无库时的一次性迁移来源迁移完成后编辑它不再生效。同目录的app-data子目录还放着请求日志和用量统计。如果这一组文件丢了后果是你要从零重建全部 Provider、密钥和路由规则请求日志与用量统计也一并消失。3 分钟活下来先停服务再拷三个文件⚠️ 不要在 CCR 运行时直接拷config.sqliteWAL 未 checkpoint 时单拷主文件会得到一个缺最后几分钟写入的坏备份。最低门槛的保底操作就三条命令3 分钟内可完成ccr stop TS$(date %Y%m%d-%H%M%S) mkdir -p ~/ccr-backups/$TS cp ~/.claude-code-router/config.sqlite* ~/ccr-backups/$TS/config.sqlite*这个通配符会连 wal、shm 两个辅助文件一起拷走三件套齐了恢复才有意义。但手动拷贝的前提是你记得做偏偏出事的当晚你最容易忘。把这件事交给脚本让它自己跑。把活儿交给脚本一份能直接跑的 CCR 配置备份脚本下面这份脚本解决定时自动备份 旧备份自动清理两个问题存成~/backup-ccr.sh即可#!/bin/bash # CCR 配置备份脚本 | 作者: 你的名字 | 日期: 2026-08-31 DEST$HOME/claude-code-router-backups/$(date %Y%m%d-%H%M%S) mkdir -p $DEST ccr stop || exit 1 cp $HOME/.claude-code-router/config.sqlite* $DEST/ tar -czf $DEST/app-data.tgz -C $HOME/.claude-code-router app-data ccr start ls -dt $HOME/claude-code-router-backups/*/ | tail -n 31 | xargs -r rm -rf echo CCR 配置备份完成: $DEST先 stop 再 cp 再 start是为了保证主文件与 WAL 处于一致状态tail -n 31一行则只保留最近 30 份备份防止磁盘被备份撑满。要让它全自动往 crontab 里加一行每天凌晨 3 点执行crontab -e # 0 3 * * * /home/你的用户名/backup-ccr.sh /home/你的用户名/ccr-backup.log 21日志路径固定在 crontab 里哪次备份失败翻日志就能定位不用现场找。故障已发生按时间线走一遍恢复场景一单机配置损坏。09:12 发现管理页面加载不出 Provider09:15ls -lt ~/claude-code-router-backups/确认昨晚 03:00 那份备份还在09:18ccr stop后把config.sqlite*三个文件拷回~/.claude-code-router/再ccr start09:21 验证恢复是否真实生效sqlite3 ~/.claude-code-router/config.sqlite SELECT key FROM app_config;返回default说明配置表完整再打开管理页面核对 Provider 列表与你记忆一致本次恢复才算结束。场景二整机迁移。10:02 新机器到手10:20 把旧机器的~/.claude-code-router整个目录拷到新机器配置库 app-data不能只拷单个文件10:45ccr ui起来管理页面里 Provider、路由规则、密钥原样都在。⚠️ 两台机器上都要在ccr stop之后再做拷贝运行中直接编辑config.sqlite是恢复失败的常见来源。CCR 配置备份方案怎么选看这张表方案上手成本维护负担适用规模手动三条命令零成本全靠记性人为失误风险高改大配置前偶尔备一次脚本 cron本文方案一次性 10 分钟配好即零自动清理旧份长期在线的单机部署首选桌面 UI Settings 导出点一下无自动化靠手动触发重大变更前留一份交叉核对如果你的 CCR 长期跑在固定机器上直接用脚本 cronUI 导出只在大改动前顺手点一下。一句话原则备份的价值不在于备份本身而在于出事当天你能在 10 分钟内恢复。配置数据库的位置与生效机制详见配置数据库位置ccr各子命令用法见CLI 命令参考。【免费下载链接】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），仅供参考