CCR 配置备份与恢复完整指南：从一键导出到文件级备份

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-routerCCRClaude Code Router当前的运行配置——提供商、路由规则、API 密钥——全部存放在~/.claude-code-router下的 SQLite 数据库config.sqlite里。文件损坏或换机器这些东西就全没了。下面按首次备份、定时自动备份、损坏应急恢复、迁移新机器、Docker 部署五个场景给出操作直接跳到你需要的那一节。注意早期版本用config.json存配置现在它只在首次启动且没有 SQLite 配置时作为迁移来源读取一次迁移完成后再编辑它不会影响当前配置详见 configuration-file.md。刚配完 CCR先存一份备份刚加完提供商、路由规则和 API 密钥的时候先存一份副本之后任何一次改错都能回到这个点。值得备份的是整个~/.claude-code-router目录核心是config.sqliteapp-data/里还有密钥和用量数据~/.claude-code-router/ ├── config.sqlite # 当前应用配置提供商、路由规则 ├── app-data/ # API 密钥、用量、请求日志 ├── gateway.config.json # 生成的网关运行配置 ├── profiles/ # 各 Agent 的配置文件 └── bin/ # Agent 启动包装器方式一UI 一键导出仅桌面应用。打开 CCR 桌面应用在Settings里点Export data会把当前配置和 SQLite 数据导出成单个 JSON 备份文件。 导出文件里包含 API 密钥按敏感数据处理别提交到代码仓库或发到群里。方式二文件级备份纯 CLI 用户适用。config.sqlite是活跃的数据库CCR 运行中直接复制可能得到损坏文件所以顺序必须是先停、再拷、后启ccr stop mkdir -p ~/ccr-backup cp -a ~/.claude-code-router ~/cr-backup/$(date %Y%m%d)cp -a会保留文件权限和时间戳。Windows 上配置目录在%APPDATA%\claude-code-router在资源管理器里复制整个目录即可。不想每次手动跑配置 CCR 定时自动备份每天用 CCR 且经常改配置的话把备份交给 cronLinux/macOS 自带的定时任务机制Windows 用任务计划程序设置同样的脚本。思路是停服务 → 复制目录 → 自动清掉旧备份只保留最近若干份。创建备份脚本保留最近 13 份、更早的自动删除mkdir -p ~/.ccr-backups cat ~/.ccr-backup.sh EOF #!/bin/bash DEST~/.ccr-backups/$(date %Y%m%d_%H%M%S) ccr stop cp -a ~/.claude-code-router $DEST ccr start ls -1t ~/.ccr-backups | tail -n 14 | xargs -I{} rm -rf ~/.ccr-backups/{} EOF chmod x ~/.ccr-backup.sh先手动跑一次~/.ccr-backup.sh验证能生成备份。验证通过后注册定时任务crontab -e打开编辑器追加一行让脚本每天凌晨 3 点执行并把日志写到文件里crontab -e 0 3 * * * /bin/bash ~/.ccr-backup.sh ~/.ccr-backups/backup.log 21⚠️ 脚本为保证文件完整会短暂停掉 CCR把执行时间选在没人用的时段比如凌晨。config.sqlite 损坏或丢失后如何恢复症状是ccr start报错、管理页面里提供商列表为空。只要前面存过备份恢复就三步ccr stop mv ~/.claude-code-router ~/.claude-code-router.broken cp -a ~/ccr-backup/20250830 ~/.claude-code-router ccr start把20250830换成你要恢复的备份日期。损坏的目录先挪开而不是直接删方便之后对比定位是哪次改动出的问题。启动后打开管理页面核对提供商和路由规则还在再发一条模型请求确认密钥有效。如果手里的备份是桌面应用导出的 JSON 文件它适合用来核对配置内容比如提供商地址和模型列表密钥需要重新录入请求日志、用量这类运行数据它恢复不了。密钥本身丢失或忘记的话去提供商官网重置再更新到 CCR 里。⚠️ 不要把备份覆盖到还有新数据的目录上旧备份的 SQLite WAL/SHM 辅助文件和新运行文件混在一起会直接弄坏配置要恢复到干净的目录。换电脑或迁移到新环境新机器装 CCR 之前把旧机器的备份整体拷过来再第一次启动提供商、密钥、路由规则一次到位npm install -g musistudio/claude-code-router scp -r userold-machine:~/ccr-backup/20250830 ~/.claude-code-router ccr start第一条先装 CCR 但别启动服务。scp换成 U 盘拷贝也一样Windows 之间迁移就是复制%APPDATA%\claude-code-router整个目录该路径跟用户账号走新机器换了用户名就要拷到新用户目录下。Docker 部署的 CCR 如何备份docker compose 部署的 CCR数据都在容器的/data目录容器内 HOME 被设为/data备份要先停容器再把数据拷出来详见 docker.mddocker compose stop ccr docker compose cp ccr:/data/. ./ccr-data-backup/ docker compose start ccr恢复反向操作停掉容器把./ccr-data-backup拷回容器/data再启动。目标要是一个空卷或空的/data目录别往还在用的数据目录上覆盖。 Docker 持久化时挂载整个/data目录只挂子目录会把配置和运行文件割裂开。容易踩的坑不停 CCR 就复制 SQLite 数据库备份文件可能打不开WAL 未提交停服务是第一步而不是可选项。用旧备份覆盖还有新数据的目录WAL/SHM 混在一起导致整个配置损坏恢复前先清空目标目录。把桌面应用导出的 JSON 当完整备份请求日志、用量等运行数据它恢复不了文件级目录备份才是兜底。备份里有 API 密钥等同密码别提交 git、别发到群聊。Docker 部署时只挂载~/.claude-code-router路径忘了容器内 HOME 是/data挂载位置直接差一层。【免费下载链接】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），仅供参考