Windows
先在系統資訊中確認處理器類型。安裝後匯入訂閱,確認策略組可用,再啟用系統代理。只有需要接管更多應用程式時,才設定服務模式與 TUN;防火牆提示、連接埠占用及殘留代理應分別排查。封存的舊版客戶端僅供相容舊環境使用,不建議將已停止維護的軟體作為新裝置的預設選擇。
前往下載客戶端負責匯入設定、顯示開關及管理連線;mihomo 核心負責解析規則、建立代理連線與處理 DNS。先釐清兩者的分工,再判斷需要調整哪一層。以下範例用於理解語法,並非可直接取代訂閱內容的完整設定。
規則模式會將網域、位址或規則集對應至處理策略。核心由上而下檢查規則,符合後便停止比對,因此通常應將特定網域排在較廣泛的規則之前,最後再放兜底規則。DIRECT 代表直連,REJECT 代表拒絕;代理策略則須引用設定中實際存在的節點或策略組。相較於全域模式,規則模式可為不同用途指定不同出口。若網站連線路徑不如預期,先查看連線記錄中的命中規則,再調整順序,避免一次更動多個條件。
mode: rule
rules:
- DOMAIN-SUFFIX,example.org,DIRECT
- DOMAIN,blocked.example,REJECT
- MATCH,DIRECT
閱讀規則語法與優先順序 →
策略組為規則提供固定的目標名稱,組內可加入節點,也可引用其他策略組。手動選擇適合固定業務出口;自動測試則可依測試結果挑選可連通的路徑。延遲測試只反映對指定位址發出單次請求的結果,不等於下載頻寬,也不能代表所有網站的連線速度。匯入訂閱後,先確認組內有可用選項,再檢查規則是否引用該組。範例只呈現手動組的結構;實際使用時可將直連選項替換為設定中已有的節點名稱,並確保名稱完全一致。
proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
rules:
- MATCH,PROXY
了解延遲測試的適用範圍 →
DNS 負責將網域解析為位址,規則則決定連線使用哪個出口,兩者需搭配檢查。啟用核心 DNS 不代表系統與所有應用程式都會使用它;瀏覽器的安全 DNS、系統解析快取及其他網路工具,都可能改變實際路徑。fake-ip 模式會以映射位址保留網域資訊,若遇到相容性問題,則需針對特定應用程式排查。範例僅啟用本機監聽與基本解析。調整前先記下原設定,修改後重新建立連線,確認解析請求確實送達預期入口,而不只是確認網頁能否開啟。
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
查看指南中的 DNS 設定 →
系統代理適用於遵循代理設定的應用程式;TUN 則透過虛擬網路介面與路由接管更多連線。這適合需要統一處理應用程式流量的情境,但也會牽涉系統權限、網卡及 DNS 路徑。啟用前先確認一般代理連線正常,再授予客戶端所需的服務權限。自動路由並非適用所有環境;若已有 VPN、虛擬機網路或旁路由,更要留意路由衝突。若發生斷線,先關閉 TUN,恢復原本的連線路徑,再查看記錄,不要反覆切換節點。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
dns-hijack:
- any:53
了解 TUN 模式 →
YAML 以縮排表示層級,鍵名、清單符號與策略引用都可能造成載入失敗。更新訂閱時通常會重新產生設定,直接修改產生的檔案可能在下次更新後消失;需要長期保留的規則,優先使用客戶端支援的覆寫功能。排除問題時,先記下錯誤行、目前設定與觸發操作,再逐項還原。平時保留適量記錄即可;暫時提高記錄層級後,記得及時還原。分享記錄前,請移除訂閱網址、驗證資訊與個人瀏覽記錄,只留下足以說明問題的脈絡。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false
查看設定與疑難排解 →
先確認作業系統與處理器架構,再比較客戶端介面和功能。名稱相近的客戶端,安裝檔、設定擴充方式與更新機制也可能不同。初次安裝可從 Clash Plus 開始比較;Linux 桌面使用者可優先參考 Clash Verge Rev。安裝檔資訊集中在下載頁,首頁則提供各平台入口。
先在系統資訊中確認處理器類型。安裝後匯入訂閱,確認策略組可用,再啟用系統代理。只有需要接管更多應用程式時,才設定服務模式與 TUN;防火牆提示、連接埠占用及殘留代理應分別排查。封存的舊版客戶端僅供相容舊環境使用,不建議將已停止維護的軟體作為新裝置的預設選擇。
前往下載在「關於這台 Mac」確認使用 Apple 晶片或 Intel 處理器,並下載相符的版本。首次執行時依系統提示授權網路相關功能,接著確認選單列狀態與目前設定。從睡眠喚醒或切換網路後若連線異常,先檢查代理與網路服務狀態。下載頁會分開標示 ClashX Meta 的封存版本與仍在維護的客戶端。
前往下載優先下載符合裝置架構的安裝檔。啟動連線時,請確認已授予系統 VPN 權限;同一使用者環境通常無法同時執行多個 VPN 服務。背景連線中斷時,檢查電池最佳化、背景活動與廠商的省電限制。應用程式分流與全裝置接管是不同的設定範圍,修改後請以目標應用程式實際測試。
前往下載Clash Plus 可從 App Store 安裝,產品官方網站為 clashplus.io。匯入服務提供者支援的設定後,確認系統 VPN 權限與策略選擇。連線能否建立,還取決於訂閱是否有效、節點是否可連通及目前的網路環境;系統顯示 VPN 標記只代表連線狀態,無法單獨證明所有請求都依預期分流。
前往下載桌面環境可選擇 Clash Verge Rev 或 FlClash,並確認發行版採用的套件格式。系統代理是否生效,取決於桌面環境與應用程式的支援情況;命令列工具也可能需要另行設定。伺服器與路由器使用者可查看 mihomo 核心下載入口,自行安排服務管理、設定目錄與權限,無須安裝桌面介面。
前往下載客戶端本身不是代理服務。開始前請準備有效的訂閱網址或設定檔,並確認服務提供者支援所選客戶端的設定格式。不要將訂閱網址提交至不熟悉的轉換網站;網址可能包含可存取帳戶資源的驗證資訊。
開啟客戶端的設定或訂閱頁面,選擇透過連結匯入或從本機檔案匯入。儲存後等待設定載入,確認是否出現代理群組與節點。若顯示解析錯誤,先確認下載內容是設定文字,而非登入頁面、錯誤訊息或其他客戶端格式;此時先不要啟用系統代理。
在代理群組中選擇可用出口,日常使用建議先採用規則模式。桌面版先啟用系統代理;行動裝置則依提示允許 VPN 連線。需要使用 TUN 時,再另外啟用並確認權限。每次只變更一項設定,並保留可還原的原始狀態,以便分辨是節點問題還是本機路由問題。
開啟實際需要使用的網站或應用程式,同時在連線頁查看命中規則與出口。再測試一個應直連的目標,確認流量沒有全部走同一條路徑。若延遲測試通過但頁面無法開啟,接著檢查 DNS、目標服務與應用程式的代理支援。離開客戶端前關閉系統代理,避免留下無法連線的本機入口。
選擇客戶端時,請區分專案名稱、核心功能與服務提供者。不同客戶端中的同一個開關,實際實作方式可能不同;是否支援特定設定,應以實際使用的核心與對應專案文件為準。
Clash 生態系由代理核心、圖形介面客戶端與設定工具等不同專案組成。原始 Clash 專案停止公開維護後,社群持續以相容設定及新功能為基礎開發相關實作。mihomo 延續 Clash Meta 的核心發展路線。名稱中帶有 Clash 的客戶端,不一定由同一個團隊維護,也不代表使用相同核心。判斷專案目前的維護狀態,應查看該專案的發行紀錄、問題討論與文件,而不是只比較名稱。
mihomo 程式碼以 GPL-3.0 授權發布,程式碼儲存庫提供原始碼、問題追蹤與發行紀錄。這些資料有助於了解功能變更、查找已知問題及確認設定語法。核心採用開源授權,不代表每個圖形客戶端、商店應用程式或訂閱服務都採用相同授權。使用、修改或散布程式碼前,請閱讀相關專案的授權條款;一般使用者則可參考公開文件排除問題,無須先自行編譯。
圖形客戶端負責將操作轉換為設定,並顯示記錄、連線狀態與策略選項;核心負責實際處理流量;訂閱服務則提供節點及相關參數。成功安裝客戶端,不代表訂閱已生效;節點測試通過,也不保證特定服務一定可用。遇到問題時,先判斷故障發生在下載設定、解析設定、建立網路連線,還是遠端連線這一層,避免將帳戶到期、目標網站限制與本機設定混為一談。
客戶端更新、核心更新、訂閱更新與規則資料庫更新是不同操作。更新前請備份目前可用的設定與自訂覆寫,閱讀更新說明,再測試原有規則與常用應用程式。若新設定載入失敗,先還原上一份可正常運作的設定;若只有特定網站異常,先查看命中規則,無須立刻重新安裝整個客戶端。需要長期保留的自訂設定,應放在客戶端明確支援的覆寫位置,避免訂閱更新時遭到覆蓋。
先完成基本連線,再依遇到的問題查閱相關專題。延遲數值、系統代理狀態與規則命中記錄分別反映不同環節,不能只靠單一指標判斷整條連線是否正常。
拆解 URL Test 的握手流程、測試網址選擇與逾時機制。說明低延遲不代表高頻寬,以及如何搭配網頁請求、檔案傳輸與實際用途評估節點品質。
閱讀文章 →逐步說明如何選擇安裝檔、授予服務模式權限,以及確認系統代理生效。整理安全軟體攔截、連接埠占用與 UWP 迴圈等情況,依故障發生的位置縮小檢查範圍。
閱讀文章 →介紹 geodata 檔案來源、自動更新設定項目與手動替換步驟。搭配 GEOIP、GEOSITE 的比對用途,說明資料庫載入狀態與規則順序需要分別確認。
閱讀文章 →