ClashX 設定備份與還原完整指南【2026】換機/重裝前必看
在更換新 Mac、重裝系統或進行重大軟體更新前,備份 ClashX 的核心設定檔是確保網路環境無縫遷移的關鍵步驟。
為什麼要備份 ClashX 設定
對於資深的 Mac 使用者來說,ClashX 不只是一個代理用戶端,它承載了我們精心調校的規則系統、分流策略以及各種自動化的網路加速方案。許多使用者在日常工作中,為了提升 GitHub、Slack、Figma 等工具的存取速度,會手動編輯複雜的 YAML 設定檔。這些個人化的設定一旦遺失,重新建置的成本極高。
當你計畫更換一台新的 MacBook 時,完美的遷移不只是搬移檔案,更是要實現軟體設定的「零成本」銜接。透過備份 ClashX 設定,你可以在幾分鐘內在新裝置上還原原有的網路邏輯,避免在關鍵時刻因為網路設定問題而中斷工作流。
此外,備份也是一種防呆機制。在嘗試新的實驗性規則或更改核心引擎設定之前,保留一份已知的穩定版備份,可以讓你在設定出錯導致斷網時快速回滾,確保系統的持續可用性。
ClashX 設定檔存放位置
不同於一般的 Mac App 將資料存放在 ~/Library/Application Support/ 下,ClashX 遵循 Linux 傳統的設定習慣。它的核心資料檔案存放在使用者目錄下的一個隱藏資料夾中。
~/.config/clash/
你可以透過以下方式找到它:
- 方法一:在 Finder 中按下快捷鍵
Command + Shift + G,在彈出的視窗中輸入~/.config/clash/並按下 Enter。 - 方法二:在終端機(Terminal)中使用指令直接進入:
cd ~/.config/clash/ && ls -la
在這個目錄下,你通常會看到以下關鍵檔案與資料夾:
- config.yaml:這是主要設定檔。如果你在 ClashX 選單中選擇了「手動編輯設定」,編輯的就是這個檔案。它包含了所有基礎設定、策略群組和規則定義。
- Country.mmdb:這是 GeoIP 資料庫。Clash 會用它來辨識 IP 位址的地理位置,進而實現像是「國內 IP 直連,國外 IP 走代理」的自動化分流。
- profiles 資料夾:如果你使用 ClashX 的訂閱功能,下載的訂閱設定檔通常會存放在這個子目錄下。這些檔案通常以 UUID 或訂閱名稱命名。
- logs 資料夾:存放執行日誌。雖然不是還原所必需,但在排查連線問題時非常有用。
- cache.db:快取檔案,記錄了各個節點的延遲測試歷史和連線狀態。
手動備份方法
手動備份是最可靠的方式,建議在每次對設定檔進行重大修改後,或在系統大版本更新前執行一次。手動備份可以確保你完全掌握備份內容。
方法 A:終端機指令快速備份
這種方法最有效率,適合習慣使用命令列的使用者。你可以將整個目錄打包並加上時間戳:
tar -czvf ~/Desktop/clash_backup_$(date +%Y%m%d).tar.gz -C ~/.config clash
執行完這個指令後,你的桌面上會生成一個名為 clash_backup_2026xxxx.tar.gz 的壓縮檔。你可以將其上傳到 iCloud Drive、Google Drive 或存放在離線 USB 隨身碟中。
方法 B:Finder 介面手動備份
如果你更喜歡圖形介面,可以按照以下步驟操作:
- 前往
~/.config/目錄。 - 找到名為
clash的資料夾。 - 右鍵點選該資料夾,選擇「壓縮 'clash'」。
- 將生成的
clash.zip重新命名並移動到安全的備份位置。
- 確認
config.yaml已經儲存(建議在備份前先退出 ClashX)。 - 檢查
profiles資料夾內是否有你需要的訂閱檔案。 - 如果你有自訂的 JS 腳本或規則集檔案,確認它們也在備份範圍內。
自動化備份方案
靠記憶的手動備份往往會在最需要它的時候缺席。將備份自動化是保護資料的長久之計。在 macOS 上,我們有多種成熟的方案可供選擇。
Time Machine(時間機器):官方首選
這是最簡單的方案。只要你開啟了 Time Machine 並連接外接硬碟,系統會自動備份使用者目錄下的所有資料,包括隱藏的 .config 資料夾。當你想找回幾週前的某個設定版本時,只需進入 Time Machine 的時光隧道,導覽到該目錄即可實現單一檔案層級的還原。
Acronis True Image:進階映像方案
對於需要頻繁在多台 Mac 之間同步環境,或對資料安全性有極高要求的專業使用者,Acronis True Image 提供了一套更為強大的工具。它不只能備份檔案,還能建立整個系統的映像。當你更換新 Mac 時,可以直接利用 Acronis 的雲端還原功能,將包含 ClashX 在內的所有 App 設定一次性還原到新機器上,無需重新安裝與設定。
全盤映像備份 + 雲端同步,換機時一鍵還原所有設定與資料
了解 Acronis True Image →披露:此按鈕為聯盟推廣連結,我們可能從符合條件的訂單中獲得佣金。詳情見 廣告披露。
對比這兩種方案,Time Machine 勝在免費和整合,但對雲端支援較弱;Acronis 則在還原速度、加密安全以及跨平台同步方面表現卓越。無論選擇哪一種,關鍵是要確保備份任務處於「運作中」狀態。
設定還原步驟
當你在新機器上準備就緒後,按照以下標準流程還原你的 ClashX 環境。順序很重要,建議嚴格遵守。
第一步:安裝基礎環境
在新 Mac 上下載並安裝 ClashX 或 ClashX Pro。安裝完成後,先執行一次軟體。此時系統會彈出安裝輔助工具的請求,請點選允許並輸入開機密碼。首次執行會自動建立 ~/.config/clash/ 目錄結構。完成後,完全退出 App(確保選單列圖示已消失)。
第二步:覆寫設定檔
將你備份的 clash 資料夾(或解壓後的檔案)準備好。開啟終端機執行覆寫操作,或在 Finder 中手動拖曳:
cp -rf ~/Downloads/my_backup/clash/* ~/.config/clash/
如果你在 Finder 中操作,系統會詢問是否合併或取代。由於新安裝生成的資料夾是空的,選擇「全部取代」即可。
第三步:驗證與啟動
重新啟動 ClashX。點選選單列圖示,查看「設定」選單。你應該能看到熟悉的設定檔名稱。點選「更新訂閱」確保所有節點資訊同步到最新版本。
第四步:權限修復(可選)
如果在還原後發現軟體報錯或無法儲存設定,可能是因為檔案權限在遷移過程中發生了變化。你可以在終端機執行以下指令來重設權限:
sudo chown -R $(whoami) ~/.config/clash
常見問題 FAQ
Q1: 備份後換機,原本的訂閱連結會自動更新嗎?
只要你還原了 profiles 資料夾和主要設定檔,ClashX 會保留你的訂閱 URL。在還原後,你只需點選一次「更新訂閱」,軟體就會自動從伺服器抓取最新的節點資訊。如果訂閱連結本身未過期,它完全可以繼續使用。
Q2: Time Machine 備份時,我需要手動排除哪些檔案以節省空間?
通常 clash 資料夾的容量很小,不需要刻意排除。但如果你經常查看大量日誌,logs 資料夾可能會佔用幾百 MB。你可以在 Time Machine 的設定中將 ~/.config/clash/logs/ 加入排除清單。至於 Country.mmdb,它是分流的核心,建議保留備份。
Q3: 為什麼還原設定後,節點清單是空的?
這通常是因為 profiles 資料夾中的檔案沒有被正確複製,或主要設定檔中的路徑引用在新機器上不一致。請檢查 config.yaml 中的 proxies 或 proxy-providers 區段。另外,請確保你的系統時間已設定為「自動設定」,時間偏差會導致連線驗證失敗。
Q4: 我可以將設定資料夾用符號連結(symlink)連到 iCloud 嗎?
從技術上來說,你可以使用 ln -s 指令將 ~/.config/clash 連結到 iCloud Drive。但強烈不建議這樣做。Clash 核心在執行時會頻繁修改 cache.db 和 logs,這會導致 iCloud 頻繁同步,造成 CPU 使用率過高,甚至因同步卡死導致設定損毀。
Q5: 還原後 ClashX 提示「核心啟動失敗」,怎麼辦?
這通常是權限問題。請按照上文提到的「第四步」使用終端機修復權限。另外,請確認你還原的設定版本是否與新安裝的 ClashX 版本相容。如果你從很舊版本的 Clash 遷移到 2026 年最新版本,可能需要依新的 YAML 語法微調設定。