备份恢复配置规则YAML

Clash Verge如何一键备份并恢复配置文件?

clash verge官方团队2026/5/7配置管理
Clash Verge如何一键备份并恢复配置文件?

功能定位:为什么备份不是“复制文件夹”

Clash Verge 把配置拆成三类:① clash-meta 内核 YAML、② 本地规则片段、③ 前端 UI 快照(主题、托盘、快捷键)。手动拷走 config.yaml 只能还原节点,却丢掉「本地规则」与「UI 快照」,升级后常出现“节点在但分流失效”。v2.2.5 起官方把「归档」做成原子级打包,解决“漏文件”与“路径错位”两大坑。

功能定位:为什么备份不是“复制文件夹”
功能定位:为什么备份不是“复制文件夹”

一键备份的最短路径(分平台)

Windows / macOS 桌面端

  1. 主界面左上角 ≡ 图标 → Settings → Backup & Restore。
  2. 点击「Create Full Backup」;弹窗中可勾选的子项已经默认全选,保持即可。
  3. 选择保存目录,文件名自动生成:clash-verge-backup-日期@时间.zip。
  4. 等待进度条 100 %,托盘提示「Archive completed」。整个过程在 SSD 上约 5–8 秒,机械盘约 15 秒(经验性观察)。

Linux 桌面端

路径与 Windows 相同,但默认弹出 GTK 文件选择器;若最小化到托盘,进度通知由 libnotify 推送。无 X11 的纯 CLI 环境可在安装目录执行 clash-verge --backup ~/cv-backup.zip,等命令行返回码 0 即完成。

一键恢复:如何把归档完整还原

  1. 在目标机器安装同大版本号的 Clash Verge(跨大版本可能提示 schema 不兼容)。
  2. Settings → Backup & Restore →「Import Archive」选中先前生成的 zip。
  3. 弹窗会显示包内清单:profiles、rules、ui、logs 四项大小与修改时间,确认无误点「Restore」。
  4. 软件自动重启内核并加载新配置,托盘图标恢复绿色即代表成功。
提示:恢复时若检测到已有同名 profile,默认「时间较新的保留」;可在弹窗手动切换为「全覆盖」或「跳过」。

例外与取舍:哪些内容不会被归档

  • 运行时日志(logs 目录)默认排除,避免压缩包膨胀。
  • 缓存的节点延迟数据库(latency.db)大于 50 MB 时自动跳过,如需带走上层菜单可手动勾选。
  • 系统代理开关状态属于「运行时标记」,恢复后仍需手动打开,防止在陌生网络直接全局代理。

经验性观察:多数用户只关心“节点+规则”,因此官方把「延迟缓存」做成可选项;若你经常换机测试节点,建议临时勾选,能节省 10 min 的重复测速时间。

与第三方订阅转换的协同

不少用户用自建 sub-web-docker 把「机场原始订阅」转 Clash YAML。备份时建议把「远程订阅地址」保存到 profile 描述栏,恢复后点击「Update」即可重新拉取,无需再次粘贴。若机场已强制校验 User-Agent,可在 Settings → Network 把 UA 改为 clash.meta/1.19,降低 409 冲突概率。

故障排查:恢复后节点全红怎么办

现象最可能原因验证步骤处置
所有节点 timeout系统 DNS 被旧配置覆盖nslookup google.com 超时Settings → DNS 改为 223.5.5.5
仅 WireGuard 节点红内核补丁未随备份带走About 显示内核 1.18.x手动升级至 1.19.2
托盘图标空白图标缓存未随包携带%APPDATA%\clash-verge\icons 为空删除 icons 目录重启即可
故障排查:恢复后节点全红怎么办
故障排查:恢复后节点全红怎么办

适用/不适用场景清单

  • ✅ 个人双机办公:公司电脑与家用笔电每周互换,备份+恢复 5 分钟完成。
  • ✅ 小团队统一规则:把归档放内网 nextcloud,新人入职一键导入,省去逐条解释分流策略。
  • ❌ 多人共用单配置且节点带 Token:归档里包含私人 Token,传网盘有泄露风险。
  • ❌ 需要审计日志的企业场景:日志默认排除,无法满足合规留痕。

最佳实践 5 条

  1. 升级大版本前先做一次「升级前归档」,失败可秒回滚。
  2. 给归档文件加日期+用途后缀,例如 2026-05-07-StarlinkTest.zip,方便肉眼识别。
  3. 若用 iCloud/Drive 同步,务必关闭「按需下载」,否则恢复时可能读到占位符 zip 导致 CRC 错误。
  4. 归档里不含运行时密码,若 profile 加密,请另行记录密码管理器。
  5. 每月清理 %APPDATA%\clash-verge\backup-cache,防止旧缓存堆积占用数百兆。

验证与观测方法

恢复完成后,打开「Connections」面板,访问 https://ip.skk.moe 观测出口 IP 是否符合预期;再打开「Rule」面板,搜索「网易云音乐」,确认走直连而非代理,即可验证分流加载成功。若 IP 与规则均命中,说明 YAML 与本地规则均已生效。

版本差异与迁移建议

v2.1.x 及更早版本没有归档功能,只能手动复制 config.yaml + profiles 目录;若从旧版迁来,建议先升级到 v2.2.5,再执行一次「导入旧数据」→「生成新归档」,后续即可享受一键备份。跨大版本(如 2.x→3.x)恢复时,官方提示 schema 可能不兼容,届时需等待新版提供迁移脚本。

FAQ(FAQPage Schema)

备份包可以在不同系统间混用吗?

可以。zip 内路径使用相对目录,Windows 做的包在 macOS 恢复后,仅托盘图标缓存会重建,其余配置无差异。

归档提示“Profile 已加密”却找不到输入框?

恢复时不会自动解锁加密 profile,需手动在 Profiles 页输入密码;这是故意设计,防止把加密包直接扩散。

能否定时自动备份?

截至当前版本 GUI 无计划任务,可用系统 crontab 或任务计划调用 clash-verge --backup 实现;注意加锁避免并发。

备份包体积突然变大到 200 MB?

大概率是 logs 目录被勾选,且开启了 debug 级日志;重新打包时取消 logs 即可降到 2–3 MB。

收尾:下一步行动

读完本文,你只需打开 Clash Verge → Settings → Backup & Restore,点一次「Create Full Backup」就能生成完整快照;把它和密码管理器放在一起,下次换机或重装系统,3 分钟就能完整还原节点、规则与界面。记得每月清一次旧缓存,升级前再手动备份,配置管理从此告别“复制粘贴猜路径”的原始时代。