CFW 停止更新後的遷移範圍

Clash for Windows，簡稱 CFW，是用來管理設定、節點與系統代理的桌面用戶端，並不等同於 Clash 核心本身。CFW 已停止維護，常見的最後期版本為 0.20.39。舊版程式仍能啟動，不代表後續會取得系統相容性修正，也不代表舊核心能辨識新訂閱使用的所有協定與欄位。

遷移不必一次重寫所有設定。先移轉訂閱與規則，再恢復系統代理，最後處理 TUN、DNS 與自動啟動，比較容易判斷問題出在哪個步驟。既有訂閱服務通常不必因更換用戶端而重新購買；需要確認的是服務商是否提供目標核心能讀取的設定。

先分清三種設定

  • 訂閱內容：節點、策略組、規則及部分 DNS 設定，通常由遠端訂閱產生。
  • 本機修改：手動新增的規則、訂閱前處理、指令碼與覆寫設定，需要另外整理。
  • 用戶端設定：系統代理開關、服務安裝、開機啟動與介面偏好，無法只靠複製一份 YAML 完整還原。

備份訂閱連結、自訂規則與本機設定

記下目前使用的設定

  1. 在舊版 CFW 的 Profiles 頁面確認目前選用的設定，記下名稱、訂閱來源，以及最近一次更新是否成功。
  2. 查看 General 頁面，記下實際代理連接埠、目前模式，以及 System Proxy、TUN Mode 的開關狀態。常見的 HTTP 代理連接埠是 7890，但請以本機顯示為準。
  3. 找到實際設定目錄，並複製到本機備份資料夾。Windows 常見位置為 %USERPROFILE%\.config\clash；可攜版或自訂目錄可能不同，請勿只憑預設路徑判斷。
  4. 將自行編輯過的 YAML、規則檔、訂閱前處理設定與指令碼另存一份，並記下哪些是手動修改、哪些是由訂閱更新產生。

設定目錄可能同時包含用戶端設定、訂閱快取與核心執行時檔案。完整備份有助於日後查核，但不建議直接將整個目錄覆蓋到新用戶端：不同專案的設定索引、資料庫與檔名並不相同。

訂閱連結與設定快照都要保留

訂閱連結可供日後更新，目前的 YAML 則可用來核對節點與規則。若只有設定快照、沒有原始訂閱連結，匯入後或許暫時能連線，卻無法繼續取得服務商更新的節點資訊。反過來說，只保留訂閱連結，也可能漏掉本機規則與分流習慣。

訂閱 URL 中的權杖常出現在查詢參數或路徑裡。向他人求助時，只分享錯誤訊息與必要欄位，請勿貼出完整連結。若完整連結已公開，請先到服務商後台重設訂閱權杖，再更新新用戶端。

替代用戶端怎麼選：先看平台，再看核心

挑選替代方案時，請優先確認專案近期的發布紀錄、系統架構與核心類型。安裝套件版本和核心版本是兩回事；要判斷某個欄位是否可用，應查看實際執行的核心版本，而非只看用戶端介面上的版本號。

使用環境可參考的用戶端遷移檢查重點
Windows 桌面Clash Verge Rev、Clash Nyanpasu確認維護狀態、mihomo 核心版本與服務模式權限。
macOS 桌面Clash Verge Rev、ClashX Meta確認使用的是 Apple Silicon 還是 Intel，並重新授權網路接管功能。
Linux 桌面Clash Verge Rev依發行版選擇 DEB 或 RPM 套件，並確認桌面代理設定。
僅需背景執行核心mihomo自行管理設定路徑、服務啟動方式與控制器存取權限。

上述名稱可作為篩選參考，並不保證未來仍會維護。安裝前請前往下載頁面確認目前支援的平台與專案來源；若要比較管理方式，可參考用戶端比較評測。請勿將名稱相近的舊版 CFW 重新封裝版，誤認為原專案已恢復更新。

如果原本依賴 CFW 的 Parsers 或指令碼處理訂閱，也要確認目標用戶端是否提供相應的覆寫機制。能匯入 Clash YAML，不代表支援 CFW 的介面設定或所有前處理語法。

遷移訂閱與規則：先恢復基本連線

第一輪只匯入訂閱，不啟用 TUN

  1. 先在舊用戶端關閉 System Proxy 和 TUN Mode，再結束舊用戶端；同時停用其開機啟動。
  2. 安裝新用戶端，並在訂閱或設定管理頁面匯入原本的訂閱 URL。不同版本的選單名稱可能不同，請依頁面上的「匯入」或「訂閱」入口操作。
  3. 等待更新完成，確認節點數量與策略組大致符合預期，再將該設定設為目前使用的設定。
  4. 切換至規則模式，手動選擇一個已知可用的節點，只啟用系統代理，再用瀏覽器測試連線。

匯入失敗時，先查看記錄：回傳 401 或 403 通常表示需要檢查授權或服務商限制；若回傳的是網頁而非 YAML，請確認複製的是不是訂閱入口。若提示欄位或協定不受支援，應核對核心與訂閱格式，不要先刪除所有規則碰運氣。

將本機規則放在穩定的覆寫層

規則通常由上往下比對，越前面的匹配結果優先。以下三條僅示範順序：先處理指定網域，再處理內網位址，最後套用預設規則。DIRECT 是內建的直連策略；若改用策略組名稱，該名稱必須已存在於設定中。

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

請勿將這段範例當成完整訂閱覆蓋匯入，也不要直接在原有的 rules 下再複製一個同名頂層欄位。實際遷移時，應使用目標用戶端提供的規則合併或覆寫功能，將自訂規則插入適當位置，同時保留訂閱原有的預設策略。

舊設定遷移至 mihomo 的相容性檢查

Clash.Meta 後續以 mihomo 的名稱持續發展，許多基本的 Clash YAML 欄位仍可使用，但舊用戶端專屬功能不能直接照搬同名設定。遷移時請優先保留 proxies、proxy-groups、rules 等核心結構，再逐項確認擴充功能。

  • 舊指令碼與前處理：不要假設 CFW Parsers、JavaScript 處理流程或舊核心的指令碼模式能在目標用戶端原樣執行；先確認功能由哪個元件提供，再依目標用戶端的實作方式改寫。
  • 規則檔路徑：rule-providers 中的相對路徑會受新設定目錄影響。複製本機規則檔後，請確認路徑與讀取權限。
  • 策略組參照：規則引用的組名必須完全相符，也要確認空格與大小寫。若組名不存在，可能導致設定載入失敗或規則無法如預期運作。
  • 控制器權限：若不需要遠端管理，external-controller 應限制在迴路位址；請勿照搬監聽所有網卡、卻未設定存取金鑰的舊設定。
  • DNS 設定：先保留原本的運作基準，再調整 fake-ip、上游解析器與網域策略。同時更換核心與解析方案，會增加問題排查的難度。

若使用獨立 mihomo 核心，可透過 mihomo -t -f config.yaml 檢查指定設定是否通過驗證；執行時請使用實際檔案路徑。圖形介面用戶端則優先查看設定檢查結果與核心記錄。檢查通過只代表設定可載入，不代表訂閱連結、規則來源與所有節點都能正常連線。

系統代理、TUN 與連接埠衝突排查

瀏覽器能用，其他程式卻不行

系統代理主要適用於遵循系統代理設定的應用程式，無法保證所有程式都會使用。請先確認目標程式是否有獨立的代理選項；若確實需要接管不遵循系統代理的流量，再依新用戶端的說明啟用 TUN，並完成服務或管理員權限設定。

舊版 CFW 的服務安裝狀態不會自動轉移到新用戶端。新用戶端提示權限不足時，請使用該用戶端自己的服務安裝入口；不要直接搬移舊服務檔案，也不要讓兩個代理用戶端同時建立虛擬網卡與路由。

連接埠被占用，或退出後無法連線

若新用戶端記錄顯示 address already in use，請先確認舊程序是否仍在背景執行。Windows 使用者可在終端機執行以下命令，查看監聽 7890 的程序編號，再到工作管理員確認程式名稱。

netstat -ano | findstr :7890

尚未確認程序用途前，請勿直接強制結束。也可以替新用戶端選擇尚未使用的連接埠，但瀏覽器擴充功能、終端機環境變數及其他手動代理設定都必須一併修改。特別留意 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 是否仍指向舊連接埠。

若用戶端結束後，瀏覽器仍嘗試連線至本機代理，請在 Windows 11 開啟「設定」→「網路和網際網路」→「Proxy」，檢查「使用 Proxy 伺服器」。只有在確認沒有組織原則或其他軟體需要此設定時，才將它關閉。停用 TUN 後仍有連線異常，請繼續檢查其他 VPN、虛擬網卡與 DNS 設定。

遷移驗收與舊用戶端回復

遷移完成與否，不應只看「是否出現延遲數字」。延遲測試只涵蓋特定要求，無法證明所有流量都依規則走到正確出口。建議依照下方清單完成實際驗收，再決定是否解除安裝舊用戶端。

  1. 訂閱更新：手動更新成功，節點與自訂規則沒有意外遺失。
  2. 規則比對：分別前往一個應直連與一個應走代理的目標，在連線記錄中確認匹配規則與實際策略。
  3. 日常應用程式：測試瀏覽器、終端機與一個常用桌面應用程式，避免只測試瀏覽器。
  4. 區域網路存取：確認仍能依原計畫存取路由器管理頁面、印表機或 NAS。
  5. 重新啟動與恢復：重新啟動電腦並測試一次睡眠與喚醒，確認開機啟動、服務權限與代理狀態正常。

若遇到訂閱更新或節點連線問題，可進一步查看訂閱更新問題排除與延遲測試說明。遷移的關鍵是分開處理訂閱、規則與網路接管，每完成一層就驗證一層，而不是直接覆蓋整個舊目錄。