
CCR 配置备份实战5 步搞定自动化备份与一键 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凌晨三点你改完 CCR 的路由规则顺手一保存终端立刻报错连接被拒绝。打开配置目录一看config.json被写坏Providers 全丢。这就是缺少 CCR 配置备份的代价——而一次完整的 CCR 恢复只需要十分钟。本文覆盖的核心操作备份对象4 个核心文件手动备份 5 步走通CCR 自动化备份脚本 定时三大 CCR 灾难恢复场景Git 与多环境加固备份对象速览CCR 的全部状态集中在配置目录~/.claude-code-routerWindows 下为%APPDATA%\claude-code-router配置读写逻辑见 config-repository.ts。备份时盯住下面这几个文件路径作用~/.claude-code-router/config.json主配置Providers、Router 规则、APIKEY~/.claude-code-router/config.sqlite新版统一配置库JSON 配置会自动迁入自定义路由脚本CUSTOM_ROUTER_PATH指向的文件自定义路由逻辑~/.claude-code-router/app-data/请求日志、用量等运行数据config.json的关键字段完整默认结构见 default-config.ts{ HOST: 127.0.0.1, PORT: 3456, APIKEY: your-gateway-key, Providers: [ { name: deepseek, models: [deepseek-chat] } ], Router: { rules: [] }, CUSTOM_ROUTER_PATH: }Providers和Router是最值钱的两段前者存着所有模型提供商与密钥后者存着你的路由规则。丢了它们CCR 恢复等于从零配置。基础备份操作第一次操作按下面 5 步走全程不超过一分钟。先停服务避免复制时 SQLite 正在写盘ccr stop建一个配置目录之外的备份存放点mkdir -p ~/ccb-backups对整个配置目录打一个带时间戳的快照tar -czf ~/ccb-backups/ccr-backup-$(date %Y%m%d_%H%M%S).tar.gz \ -C ~ .claude-code-router确认备份文件已生成ls -lh ~/ccb-backups/恢复服务运行ccr start注意备份文件里包含APIKEY和各提供商密钥务必加密或加访问控制存放不要直接丢进网盘共享目录。以后想核对配置打开ccr ui管理界面即可随时比对 Providers 与 Router 规则和备份是否一致。手动备份救得了急救不了忘了做。把这套动作交给脚本才是长期方案。自动化备份CCR 自动化备份脚本与定时策略把脚本存为~/ccr-backup.sh#!/usr/bin/env bash # CCR 配置自动备份脚本 set -euo pipefail SRC_HOME$HOME DEST$HOME/ccb-backups KEEP30 TS$(date %Y%m%d_%H%M%S) TAR$DEST/ccr-backup-$TS.tar.gz mkdir -p $DEST # 停服务快照完成后自动拉起避免复制活动数据库 ccr stop || true tar -czf $TAR -C $SRC_HOME .claude-code-router ccr start || true # 只保留最近 KEEP 份 ls -1t $DEST/ccr-backup-*.tar.gz | tail -n $((KEEP1)) | xargs -r rm -f echo 备份完成: $TAR加入定时任务每天凌晨 3 点自动执行0 3 * * * $HOME/ccr-backup.sh $HOME/ccb-backups/backup.log 21用crontab -e粘贴这一行即可建议先用~/ccr-backup.sh手动跑一次确认无误再交给 cron。场景手动备份自动化备份偶尔改配置够用动手快无需操心每天动路由规则迟早会忘cron 每天快照换机迁移前临时打一份定时快照 迁移双保险恢复场景实战CCR 灾难恢复三套方案配置文件损坏停服务先把损坏现场留档用mv而不是删除方便事后排查ccr stop mv ~/.claude-code-router ~/.claude-code-router.broken-$(date %s)找到最近一份可用备份ls -1t ~/ccb-backups/ccr-backup-*.tar.gz | head -n 3还原配置目录tar -xzf ~/ccb-backups/ccr-backup-20260830_030000.tar.gz -C ~重启服务ccr start验证恢复成功——JSON 格式校验加 UI 核对python3 -m json.tool ~/.claude-code-router/config.json /dev/null ccr ui在 UI 里确认 Providers 和 Router 规则都回来了恢复才算完成。设备迁移CCR 配置迁移四步走旧机器上停服务并打包ccr stop tar -czf ~/ccr-migrate.tar.gz -C ~ .claude-code-router把包拷到新机器U 盘或 scp 都行scp ~/ccr-migrate.tar.gz usernewhost:~/新机器装好 CCR 后先不启动服务直接还原目录tar -xzf ~/ccr-migrate.tar.gz -C ~启动并验证ccr start ccr ui提示Windows 新机的配置目录在%APPDATA%\claude-code-router把包解压到该位置再启动即可。密钥丢失停服务找一份含密钥的备份ccr stop ls -1t ~/ccb-backups/ccr-backup-*.tar.gz | head -n 3只解出配置文件不覆盖现有目录mkdir -p /tmp/ccr-restore tar -xzf ~/ccb-backups/ccr-backup-20260830_030000.tar.gz -C /tmp/ccr-restore查看备份中的密钥字段复制你需要的值python3 -m json.tool /tmp/ccr-restore/.claude-code-router/config.json | less打开 UI 更新对应提供商的密钥并保存ccr ui验证恢复成功——重启后确认密钥已生效ccr stop ccr start ccr ui如果备份里也没有密钥只能去提供商官方渠道重置再把新密钥填回配置。进阶加固CCR Git 版本管理把config.json纳入 Git每次改完规则留一次提交回滚一条命令的事。代价是仓库里会有密钥务必使用私有仓库并设置访问权限。cd ~/.claude-code-router git init git add config.json git commit -m CCR 配置基线 # 回滚到上一版 git checkout HEAD~1 -- config.json警告Git 仓库本身不含密钥之外的隐私但它包含密钥本身。切勿推送到公开远端。多环境配置CCR 支持用CCR_INTERNAL_HOME_DIR重定配置根目录给开发、生产各开一套互不干扰的环境。备份脚本多挂一个目录即可同时覆盖两套。# 启动一套独立的生产配置 CCR_INTERNAL_HOME_DIR$HOME/.ccr-prod ccr start配置验证恢复或改完配置后先做格式校验再启动服务能拦下大部分写坏 JSON的事故。三件套格式校验、文件确认、UI 核对。python3 -m json.tool ~/.claude-code-router/config.json /dev/null echo OK ls -lh ~/.claude-code-router/ ccr ui落地检查清单备份存放于配置目录外滚动保留 30 份备份备份文件加密后存储改完配置立即 git 提交每月做一次恢复演练密钥轮换同步更新备份延伸阅读配置文档 —— Claude Code Router 配置项的完整参考备份前看清每个字段故障排查 —— 恢复后服务仍异常时的排查路径项目初衷及原理 —— 理解配置如何驱动路由恢复时判断损失范围更快【免费下载链接】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),仅供参考