Windows
在系統資訊中確認裝置架構。初次使用可先啟用系統代理,檢查瀏覽器是否產生連線紀錄;若需讓不讀取系統代理的應用程式連線,再查看用戶端的 TUN 支援與權限提示。遷移舊設定前,請先關閉原有程式,避免兩款用戶端同時修改代理設定或搶用監聽連接埠。
前往下載整份訂閱由用戶端匯入;節點來源則由核心依設定讀取。
在設定清單中貼上相容的訂閱網址,等候下載與解析完成,再將該設定設為目前使用項目。與手動輸入不同,遠端訂閱可以更新,節點重新命名也可能影響既有選擇。若手上只有節點來源,可用 proxy-providers 個別載入,再由策略組引用。兩種連結即使都回傳 YAML,也不一定能互換。更新成功卻沒有節點時,先確認回傳內容的類型,再檢查策略組是否引用正確的來源。
proxy-providers: office: type: file path: ./providers/office.yamlproxy-groups: - name: PROXY type: select use: [office]具體規則放前面,預設規則放在最後。
規則模式會依清單順序檢查請求,通常採用第一條符合的規則。網域後綴規則適合分類一組子網域,位址範圍規則則適合描述已知網段。不同於全域模式,規則模式可為不同目標指定不同出口。設定時先列出範圍較小的例外,再列出範圍較大的規則,最後以 MATCH 作為預設規則。流量走錯出口時,先查看連線紀錄中的實際命中項目,以及策略組目前選用的出口,不必急著更換節點。
mode: rulerules: - DOMAIN,docs.example.com,DIRECT - DOMAIN-SUFFIX,example.com,PROXY - MATCH,DIRECTDNS 接入方式會影響解析請求是否經過核心。
fake-ip 模式會先回傳虛擬 IP 給應用程式,再由核心依據對應關係辨識目標網域。不同於直接回傳實際 IP 的方式,後續連線也必須經過能辨識對應關係的核心。設定時請確認系統與應用程式使用的 DNS 解析入口;依賴實際 IP 的區域網路服務,可視需要加入 fake-ip-filter。修改後請用同一個應用程式重新連線,避免將舊的解析快取或應用程式內建解析造成的差異,誤判為規則失效。
dns: enable: true enhanced-mode: fake-ip fake-ip-filter: - '+.lan' nameserver: - system保留上游訂閱內容,本機差異另外放在覆寫設定中。
直接編輯遠端訂閱產生的副本,更新後可能會遺失修改。支援覆寫的用戶端可將連接埠、記錄等級或本機例外個別保存,並在啟動前合併。不同用戶端處理映射與清單的方式不盡相同:映射可能依鍵值更新,清單可能整份取代,也可能支援插入前端或附加至末端。請勿將某款用戶端的合併語法直接套用到另一款。保存後請開啟最終設定,確認規則順序、策略組引用與監聽位址是否符合預期。
mixed-port: 7890allow-lan: falselog-level: info切換核心須由用戶端支援,設定欄位不會自動變得相容。
安裝介面與負責執行設定的核心可能分開更新。支援切換核心的用戶端,應先保留舊設定,再以目標核心載入副本,確認是否有協定、規則集或 DNS 欄位無法辨識。若用戶端使用固定核心,則需更新應用程式或改用其他用戶端。右側提供一段最小化直連設定,方便區分啟動問題與訂閱問題。先確認核心能讀取設定並監聽連接埠,再逐段還原代理群組與規則,更容易找出不相容的部分。
mixed-port: 7890mode: rulerules: - MATCH,DIRECT先依作業系統篩選,再確認處理器架構、安裝方式與維護狀態。若要從舊用戶端轉移,建議先匯入訂閱或設定檔,避免直接覆蓋新用戶端的應用程式資料目錄。
在系統資訊中確認裝置架構。初次使用可先啟用系統代理,檢查瀏覽器是否產生連線紀錄;若需讓不讀取系統代理的應用程式連線,再查看用戶端的 TUN 支援與權限提示。遷移舊設定前,請先關閉原有程式,避免兩款用戶端同時修改代理設定或搶用監聽連接埠。
前往下載透過「關於這台 Mac」確認裝置使用 Apple Silicon 或 Intel,再選擇對應的安裝檔。首次啟用代理後,可在系統網路設定中確認目前的網路服務是否套用相應設定。若關閉用戶端後,應用程式仍嘗試連線至本機代理連接埠,請檢查系統代理是否已還原,不必反覆重新匯入訂閱。
前往下載依系統支援的 ABI 選擇安裝檔;處理器支援某種指令集,不代表目前的系統就能安裝對應套件。首次連線時,請依系統提示授予 VPN 權限。若鎖定螢幕後連線中斷,請記下通知列狀態,並檢查應用程式的背景執行限制,以及是否有其他 VPN 服務接管連線。
前往下載請在 App Store 查看用戶端與系統的相容性要求。匯入設定並授權新增 VPN 設定後,返回用戶端確認目前選用的設定與策略組。若狀態列顯示 VPN 已連線,但目標應用程式仍無法使用,先用瀏覽器測試同一目標,再查看該應用程式的連線紀錄,以區分通道啟動與請求轉送問題。
前往下載桌面環境可依 Linux 發行版選擇套件格式,例如 Debian 系使用的 DEB,或適用於特定發行版的 RPM。部署在無桌面環境的裝置時,核心可獨立執行,但需自行管理設定目錄、服務權限與記錄。啟動成功後,也要確認應用程式已透過系統設定、環境變數或其他方式將請求送往核心。
前往下載在訂閱或設定頁面新增服務提供者給的相容連結,也可選擇本機 YAML 檔。看到檔案出現在清單後,還要將它設為目前使用的設定。若匯入失敗,先確認回應內容是設定檔,而非登入頁面或服務提示頁。請勿在截圖、記錄或問題回報中公開訂閱網址。
選擇規則模式,並在策略組中確認要使用的出口。桌面版先使用系統代理;行動裝置則依提示授權 VPN。先確認一種接入方式可正常運作,再考慮是否需要 TUN。核心正在執行只代表已啟動,不代表應用程式的流量已進入核心;請分別確認這兩種狀態。
選一個預期直連的目標和一個預期經代理的目標,依序連線並查看連線紀錄。核對目標網域、命中規則與最終出口。若沒有紀錄,先檢查代理接入;若有紀錄但出口錯誤,再檢查規則順序。只有命中規則與出口都符合預期後,才繼續排查遠端連線問題。
原版 Clash 的設定主要由代理節點、策略組與規則構成。後續不同專案延續或擴充了這套寫法,但名稱相近不代表共用發布管道或維護週期。舊教學中的操作介面可能已經改變;閱讀時請先確認內容討論的是核心欄位、用戶端操作,還是特定訂閱服務提供者的轉換規則。
用戶端負責管理設定、接入系統與顯示連線資訊;核心負責解析設定、比對規則並建立連線;訂閱服務提供者則負責維護下發內容。同一份訂閱在兩款用戶端上的結果可能不同,例如其中一款可能額外加入 DNS 或監聽設定。排查時請分別保留訂閱原文與最終生效設定,比較兩者差異,會比只看介面開關更可靠。
mihomo 延續 Clash Meta 核心的發展,在代理協定、規則集與網路堆疊設定方面增加了更多選項。原版設定中常見的基本欄位仍可作為遷移起點,但同名欄位的可用值與相依條件,應以目標核心為準。若解析失敗,先依錯誤訊息找出第一個出問題的欄位,再查閱設定參考;若不熟悉術語,可對照名詞解釋。
用戶端發布紀錄與核心變更紀錄應分開查看。升級前請保留可用設定與必要的本機覆寫;升級後先確認設定可載入,再檢查系統代理、解析路徑與規則命中情況。回報可重現的問題時,請說明使用的平台、接入方式與最小重現設定,並移除個人網域、訂閱參數及節點憑證。先描述實際結果,再補充預期結果,方便維護者判斷問題所在的層級。
核心以 GPL-3.0 授權發布。以下指令用於取得原始碼,不是安裝桌面用戶端的指令。若要安裝圖形介面用戶端,請返回安裝檔頁面,依作業系統選擇。
git clone https://github.com/MetaCubeX/mihomo.git
從平台支援、核心版本、介面操作、TUN 支援與設定覆寫能力等面向比較主流 Clash 用戶端,並依不同使用情境提供選擇建議。
所有節點逾時或個別節點無法連線時,可依序檢查訂閱是否有效、本機連接埠、DNS 解析、系統時間與規則比對,找出原因並採取相應的修正方式。
依序完成 Windows 版 Clash 用戶端的安裝、訂閱匯入、系統代理與 TUN 模式設定,並整理防火牆封鎖、連接埠衝突及服務模式授權等常見問題。