為什麼「Clash 設定檔備份」值得你上升到 Git?
多數人用圖形介面時,對YAML 組態的改動發生在零碎的操作裡:拖一組規則、貼一小段 snippet、或是在訂閱更新後發現順序又被模板洗回去。問題往往不在於「會不會寫」,而在於沒有可追溯的版本狀態——一旦某日分流怪掉,你只能憑印象猜「是不是有某條 GEOIP」或「RULE-SET 是不是被排到後面」,卻拿不出上一個工作日的檔案做逐行比對。
Git 版本管理本質是一套「對文字檔做小步提交、可查歷史、可切換快照」的流程,與 Mihomo/Clash Meta 這類以YAML 設定檔為核心的用戶端非常合拍。它不取代 GUI 的自動合併,而是讓你每天真正送進核心的那份結果(或你親手維護的片段)有被記錄下來——這才是真正意義上的可回復備份,不只是複製資料夾到隨身碟而已。
本文假設你已能讓 Clash 系列用戶端正常載入設定;若你希望先把規則集訂閱從巨型 rules 陣列中拆出去,可先搭配閱讀Rule Providers 進階教學——與本稿互補:Rule Providers 管「資料來源怎麼掛」,本文管「掛上去之後,你的整份結構如何在時間軸上不斷進化而又能YAML 組態回滾」。
先釐清:什麼值得進 Git,什麼永遠不要推上遠端
實務上可以把檔案分三層:(1) 你撰寫的規則骨架與段落(proxy-groups 結構、rules 順序骨架、DNS 策略方針、rule-providers 區塊的 URL 佔位或內網來源);(2) Mihomo 與多端同步時常被複製但目前機器才有的執行期狀態——快取下來的規則集、mmdb、日誌、以及某些 GUI 自動產生的工作檔;(3) 高敏感資訊——完整節點訂閱網址若含令牌,等同把帳戶能力交給任何能讀庫的人。
因此:公開倉儲/團隊可見倉儲裡請只保留「可被任何人看到也不會替你付帳」的片段;真正把出口節點灌進來的檔案,請留在本機、私密庫,或透過環境特定的覆寫流程注入。許多換機卡住案例並非規則寫錯,而是複製骨架後忘記補上訂閱憑證,或新路徑讓 path 指到錯誤資料夾。
git revert無法抹去他人已複製出去的內容。建議目錄:把「可再生的規則」與「不可再生的機密」物理分開
你可以在任意位置建立資料夾,例如 ~/clash-config-repo。常見分拆方式如下:
profiles/base/:放共用骨架,例如不包含真實proxies清單的樣板,或僅保留proxy-providers佔位條目。profiles/overrides/:放「每台機都可能不同但仍可進版控」的片段,像是公司區網規則、本機PROCESS-NAME特例。secrets/:放不進 Git的活躍訂閱與令牌檔——用.gitignore整包忽略;換機時以加密通道或用戶端內建的匯出/匯入另行搬運。ruleset-cache/:若你不想追蹤下載結果,請整段忽略;僅在上游離線環境需要自己托管規則集時,才把「確定可追溯的靜態檔」視情況納版本庫。
對 Mihomo/Clash Meta 使用者而言,欄位名稱與舊版核心的差異,會讓你以為「複製過去就一定能跑」,實際上只差一個新版才支援的策略型別就足以讓載入失敗。核心升級與遷移指南裡對備份語意與欄位的提醒,適合在完成第一次 Git commit 前先掃過一輪。
請從這份忽略清單開始(含英文註解方便沿用)
底下範例示範常見換機遷移時不該被推進紀錄的檔類,可依你實際 GUI 資料目錄再增刪。請勿將註解改成中文檔頭,以免與專案發佈管線對齊困難;正文中理解即可。
# Local secrets — never push
secrets/
**/active-subscription.yaml
*.token
# Client download cache — reproducible via URL
ruleset-cache/
**/Provider/
# Logs and databases
*.log
*.db
*.sqlite
# OS noise
.DS_Store
Thumbs.db
Git 日常使用節奏:小步提交、清楚訊息、必要時標籤
與軟體開發相同,對Clash 設定檔備份最有用的心法是:每次只改動一種意圖——例如本次提交只做「把工作用 GitHub CDN 規則提前到 GEOIP 前」,下一次才處理「新增追蹤清單 rule-provider」。如此當你發現異常時,能以 git bisect 或直接回退上一次提交完成YAML 組態回滾,而不會面對一包混了十種主題的巨型 diff。
對「已確認工作正常」的版本,請養成打附註標籤(annotated tag)的習慣,例如在節前有 2026-national-day-stable。這比腦中的「上上禮拜那個可以」更具體;回滾時只要切到對應 tag,再讓用戶端指到新路徑,或將檔案覆寫進 GUI 讀取的 profile 目錄即可。
若你與家庭成員或小團隊要多端同步「規則邏輯」而非節點帳號,私有伺服器或企業 Git 服務比公開剪貼服務更符合稽核;對外分享教學稿時請用脫敏範例,並在 README 明示佔位符要如何替換成各自的訂閱。
三種最常見的回滾手法(選你記得住的那種)
情境 A——剛發現十分鐘內這包改錯了:若尚未推到共享遠端,可用 git reset --hard HEAD~1 退回上一個提交(前提是確定要退回上一個快照)。這是最直接的 YAML 組態回滾 捷徑。
情境 B——已推到遠端但希望保留犯錯軌跡:用 git revert <壞提交的 hash> 產生反向修補,歷史仍可追溯發生過什麼。教學或小團隊較適合這種可追溯敘述。
情境 C——只想對照某一檔過去長相,而不是整個倉瞬間跳版本:git show <hash>:path/to/file.yaml 把舊檔印在終端機,再手動挑出需要的區塊貼回。這很適配「你只動到 rules 裡中段十行」的局部救回。
換機遷移:除 clone 以外你還要做的六件事
(1) 確認新機安裝的核心種類與 ABI與你在舊機使用的功能相符,尤其涉及 TUN、ebpf、mixin 等進階能力時。(2) 將 profiles 或 GUI 對應的 config 根目錄對應好:從 Linux 換到 macOS/Windows,或磁碟機代號不同,都可能讓 path: ./something 失效。(3) 依序回填訂閱憑證,不要指望 Git 會自動替你帶上可連線完備的 proxies 清單。(4) 重新檢視DNS/fake-ip 區塊——新環境的路由器或 systemd-resolved 行為會改寫解析鏈。(5) 藉連線與規則日誌對照日常會用的數個網域,確認多端同步後規則順序仍一致。(6) 公司裝置須確認 WPAD/PAC/MDM Profile 是否改寫系統 Proxy——這與規則寫對與否是兩個層次的問題。
若你希望把第一組 DOMAIN 規則寫清楚語意,可先讀零基礎自訂分流規則入門對齊語法與命中順序,再把本文所述的備份節奏接在後面,讓創作期與維護期都落在同一套紀律裡。
「多端同步」與自動化時多踩的坑
許多人希望手機、筆電、桌機的規則長得一模一樣,但請記住並非每台裝置都能套用同一組 TUN 或同一批 PROCESS/進程規則。較穩的路線是 Git 只做與平台無關的骨架,各端再以極短的本地覆寫補齊差異。iOS/Android 若受 GUI 合併功能所限,可以改為週期性匯出 YAML 再以 Git diff 對照,而不必在行動裝置上跑完整 CLI 工作流程。
若你把倉儲接上 CI 並對外部 rule URL 做離線快照,請確認授權與抓取頻率是否合理——與前文 Rule Providers 一樣,對上游溫和你的自動更新與備份流水線才跑得久。
常見問題
問題一:訂閱網址能不能放公開庫以便同事同步?
強烈否定。同事若要同步,請用私密組織倉儲並搭配存取管控,或由每人本機留存 secrets。**Clash 設定檔備份**的優先級裡「不洩露憑證」永遠高於方便。
問題二:若完全不想學 CLI,只靠時間戳備份行不行?
可行,但請固定排程:例如每次大改前先把資料夾複製到 backup/YYYYMMDD-HH/。缺點是很難快速看出兩版差在哪、也不容易對「誰改了什麼」做團隊歸因;長期仍建議挑一款圖像化 Git 用戶端(各作業系統都有)以降低門檻。
問題三:圖形端的「套用覆寫」會打亂 Git diff 嗎?
會。請把「最後真被核心讀取」的出口固定為單一檔或由腳本拼出的結果,並只對該產物執行 git add;否則容易在 IDE 存檔與 GUI merge 之間疲於奔命。若客戶端支援預覽完整 YAML,建議在大提交前先匯出對照一次。
問題四:換機後 rule-providers 全是紅字怎麼辦?
多數為路徑或權限問題:http 類可先確認瀏覽器或 curl 能否取得內容;file 類請確認 path 是否對齊 checkout 後的目錄。網路正常卻仍失敗時,刪掉對應快取請核心重抓,往往能排除半成品快取。
寫在最後:為什麼「可紀錄的 YAML」比一鍵黑箱更耐得住長期使用
相較於部份主打傻瓜一鍵的傳統方案,痛點常是「只知連得上、不知何故突然連不上」——尤其在 QUIC、細緻國別分流或多套 rule-providers 同時競合時,若缺乏規則命中紀錄與可追溯版本差分,很容易就變成反覆試節點的儀式。
Clash/Mihomo 路線的好處,是把 YAML 當成可閱讀、可對照 diff、可被還原的設定物件;而 Git 版本管理只是把這份物件在換機或協作時的敘述變清楚:Clash 設定檔備份在進階使用者心中,往往不是「複製資料夾」而是要能說得出哪一次變更把環境弄壞。
把規則骨架收進私有化或本機紀律的同時,你仍可仰賴視覺化日誌、連線表與設定重載來驗證每次提交;對需要多端同步規則意圖的人而言,這套做法也比將整包含憑證的檔案丟進即時通訊軟體更經得起稽核。Mihomo 與相容 GUI 對現代協定的支援,會讓規則越寫越豐富——此刻備份便不再是順手複製,而是總維護成本的一部份。若你已把客戶端來源對齊,並把本文的流程摺進例行節奏,就能把「怕被改壞」轉成「改了也有退路」。若想先統整各平台的安裝入口再回頭細調分流,可至本站客戶端下載頁鎖定符合裝置的構建資訊。