为什么 Clash 配置文件特别需要「可回滚」?
Clash、Mihomo(Clash Meta)以及各类图形客户端,本质上都在消费同一份心智模型:一段(或合并后的)YAML,决定 DNS、策略组与 rules 匹配顺序。你在界面里点选的节点,最后还是要落回文本;而文本最怕两件事:手滑改坏一行,以及三天前明明能用、今天却想不起当时试了什么。不少人搜索「Clash 配置文件备份」或「YAML 配置回滚」,并不是缺拷贝文件的手段——缺的是可追溯的历史与能在新机器上复现同款结构的流程。
与 Rule Providers、远程规则集、GEOIP 数据等能力叠加后,目录里往往同时存在「你亲手写的几十行」和「自动缓存下来的上万行」。若没有清晰的边界,备份会变成整盘打包,既占空间也不好 diff。把 Git 版本管理引进来,本质是把分流维护从「论坛复制粘贴」升级成小型工程:每一次有意义的调整都有说明、可对比、可撤销,这才是高阶用户真正省时间的部分。
备份范围:哪些该进仓库、哪些留在本机
不同客户端的数据目录布局略有差异,但你可以按下面四类来划界,避免把仓库撑成垃圾箱。
- 建议纳入 Git 的:你自己维护的
*.yaml片段、小型*.list、自定义rule-providers的本地路径文件、文档化的备注(例如《策略组命名约定》这类 Markdown,若你希望团队共享)。这些文本体量小、diff 有意义,是换机迁移时最想一键找回的东西。 - 可选纳入、但要谨慎的:脱敏后的「主配置骨架」——即删掉节点密码、uuid、完整订阅 URL 之后仍能描述
proxy-groups拓扑与rules顺序的文件。它适合作为多端同步的参照,但永远不要误以为「脱敏一次就永远安全」,订阅里的旁注与注释也可能泄漏习惯或内网信息。 - 不建议纳入 Git 的:订阅拉取生成的巨型合并结果(除非你明确在做审计且仓库私有)、内核下载的 GEOIP/mmdb、浏览器式缓存、日志、崩溃转储。它们体积大、噪声高,且多半可通过「重新拉订阅 + 设好 provider」重建。
- 必须拒绝入库的:含 token 的订阅链接、节点私钥、公司内网地址、任何你不敢公开到 GitHub 的内容。若需要团队共享,请使用私有远端与最小权限,而不是期待「仓库不公开就万事大吉」——误操作 push 公网的事故在社区里并不罕见。
你如果已经在用远程规则集,原理与《Rule Providers 进阶教程》一致:仓库里保存「引用与约束」,把巨型名单交给 provider 去更新。这样 Git 里的每一次提交,讨论的都是结构而不是几百万行列表差异。
git clean 时救命。.gitignore 模板思路:把密钥与缓存挡在门外
下面是一段示意性的忽略规则(按你真实目录名调整);其中注释使用英文以保留可复制性:
# Example .gitignore for Clash/Mihomo config repo — adjust paths
*.log
*.db
*.mmdb
.cache/
/subscription-cache/
/Country.mmdb
/geoip.dat
# GUI-specific runtime dirs (examples — rename to match your client)
/.runtime/
/workspace/usage
# Never commit URLs or secrets copied from providers
*secret*.yaml
*token*.txt
关键点不是背这一份列表,而是建立习惯:任何自动生成的路径,默认进 ignore,直到你明确知道「这条 diff 值得人类阅读」。对 Mihomo 用户而言,同时要区分「内核版本升级带来的字段更名」与「你真的改了分流逻辑」——前一类可以结合《Clash Meta(Mihomo)核心升级指南》里的备份清单逐条验收。
日常 Git 工作流:小步提交胜过巨无霸改动
许多人把 Git 用成「云端网盘」,两个月 commit 一次,消息写个「update」——这对YAML 配置回滚几乎没有帮助。更适合 Clash 的节奏是:
-
开工前先看当前是否能启动
确保内核能加载、无致命语法错,再动刀。若你连当前基线都不稳定,回滚目标会模糊。 -
一次只做一类改动
例如「仅调整 Discord 相关域名顺序」或「仅给 AI 业务新增策略组」,不要把十条不相关实验混在同一提交里。 -
提交说明写成「为什么」而不是「改了啥」
Git 自己会告诉你 diff;提交标题应写动机,例如 fix: move GEOIP after office split,未来你搜索历史时是在搜意图。 -
与客户端的「生成目录」解耦
若 GUI 每次覆盖整个config.yaml,可考虑把稳定片段放在独立文件,由script或上游合并(视客户端能力而定);否则你会在每次导入订阅后与仓库疯狂冲突。
如果你还不太熟悉 rules 的匹配顺序,可先对照《零基础入门:如何为 Clash 编写自定义分流规则》把「自上而下首次命中」刻进肌肉记忆,再开 Git 分支做试验——否则历史记录里全是「修复又修复」的无效往返。
回滚与标签:把「昨天能用」变成可检出的指针
所谓 YAML 配置回滚,在 Git 里通常有三种层级:
- 丢弃工作区未提交改动:适合「刚才试错了但还没 commit」;命令因 Git 版本与别名而异,动手前请确认没有夹杂你想保留的手改文件。
- 检出某一提交或标签:适合「我知道上周那个展会现场配置最稳」;可打附注 tag,例如
stable-20260503-home,比记哈希友好得多。 - 反向提交(revert):适合已 push 到多人协作分支的历史,保留「翻过车」的记录,而不是改写公共时间线。
对单人维护的配置仓库,最常见的生产力组合是:main 分支始终可启动,试验走短生命周期分支;验收通过后 fast-forward 合并,并打一个带日期的 tag。这样你在换机或重装时,只需告诉新手「克隆后 checkout 这个 tag」,就能对齐已知好配置,而不是在聊天里传 zip。
换机迁移:克隆之后还要补哪几步?
换机迁移的常见目标是:新电脑上十分钟内恢复同一套策略拓扑与规则顺序,而不是重新点灯熬夜。建议流程:
-
克隆私有仓库到固定路径
路径尽量短、无空格,减少某些 GUI 在 Windows 上的历史包袱问题。 -
在客户端里把配置目录指向该路径
若客户端不支持直接指定,可读文档或使用符号链接(权限与平台差异需自行评估)。 -
重新填入私密订阅与节点信息
这正是我们坚持不把 token 入库的原因:克隆是安全的,补密钥是显式操作,不会无意泄露。 -
拉取或重建 provider 缓存
给内核一点时间下载 GEOIP 与远程规则集;首次启动的日志比桌面图标更能说明是否成功。 -
按场景验收清单自检
浏览器、终端、需要 TUN 的游戏或 IDE,各抽一条路径验证;与「升级内核」类文章的验收思路相通,可交叉阅读本站文档索引中相关条目。
多端同步:台式机写规则、笔记本消费
「多端同步」容易退化成网盘式复制,结果两台机器在不同时间覆盖彼此。用 Git 时,更稳妥的唯一真相源策略是:
- 只有主设备直接改 main,其他设备只 pull;若两边都要实验,用分支名表达 ownership,例如
laptop/wip-dns。 - 合并前在本地跑一遍启动与冒烟,别把「启动不了」的冲突暴力推上去。
- 移动端往往没有完整 Git 工具体验,可只消费「导出的 release/main 快照」;手机不必当维护机,避免在触控键盘上改 YAML。
若团队有合规要求,可在私有 Git 服务上开启双因素认证与只读成员,配合审计日志——这比把 zip 丢在即时通讯文件里可追溯得多。
与 Mihomo、Rule Providers 共存的目录习惯
当你使用 rule-providers 或 Mihomo 的 ruleset 风格条目时,仓库里最值钱的是声明与插入位置:URL、更新间隔、behavior、以及在主 rules 里挂载的顺序。缓存文件随网络重建,不应霸占历史。若你发现合并后的规则总行数爆炸,与其在 Git 里打架,不如回到《Rule Providers 进阶教程》拆解 provider,把「容易变的名单」和「你亲自斟酌的业务例外」分层。
此外,DNS、fake-ip 与 TUN 相关段落往往决定「规则看似正确却全都不生效」。把它们与分流规则放在同一认知框架下维护——改 DNS 的那次提交,就别顺手混进十七条流媒体域名,否则两周后你回看历史会想哭。
常见问题(速查)
我只用 GUI,不会命令行,还需要 Git 吗?若你几乎不改规则,未必需要;一旦开始写自定义分流、或多机共用一套逻辑,图形化 Git 客户端同样能完成 add/commit/tag/clone,关键是流程而不是敲什么命令。
能不能用网盘代替 Git?网盘解决的是「有一份拷贝」,不解决 diff、分支与合并语义。网盘还容易产生冲突副本(「config (1).yaml」),长期更难维护。
仓库要不要加密?脱敏与权限优先于玄学加密。若必须上云且极度敏感,用系统盘加密 + 私有 Git + 不入库密钥,通常比自制加密方案更可靠。
回滚后发现订阅全空了?多为 GUI 重新生成主配置时覆盖了手工段落——考虑把稳定段落拆到独立文件或改用可控的合并流程,并把「导入订阅」与「手写段」的分工写进 README。
结语:可维护的分流,从可回滚开始
相比之下,部分同类代理客户端要么把配置锁在私有格式里,难以用 diff 讲清楚每次改动;要么只提供「全局开关」式体验,缺少像 Clash 这样成熟的YAML 规则与多策略组协作。传统「找一份别人配置全盘复制」的做法,在 2026 年依然流行,却很难支撑你在真实业务域名演化下长期迭代。
Clash 与 Mihomo 路线真正的工程红利在于:同一套文本配置可在不同 GUI、不同操作系统间迁移,配合 Git 版本管理 又能把试错成本压到一次 checkout。把它当作基础设施,而不是一次性脚本,你的换机迁移与多端同步会从未审查的焦虑,变成可预期的几分钟流程。
若希望先把客户端来源统一到可核验渠道,再按本文把配置纳入仓库,可到本站客户端下载页获取当前平台构建。