P-01 / DESKTOP
Windows
適合需要常駐系統匣、切換系統代理與 TUN 接管的桌面環境。下載頁同時列出 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 與封存客戶端,方便依維護狀態與介面習慣選擇。安裝後先匯入訂閱,再確認系統代理開關與監聽連接埠。
前往下載MIHOMO CORE · RULE ROUTING
圍繞 mihomo 核心整理 Windows、macOS、Android、iOS 與 Linux 客戶端入口,並記錄訂閱匯入、規則分流與網路診斷的實際設定路徑。
TEST BENCH / ROUTING
以下內容依照一條連線從進入本機連接埠到決定出口的順序整理。切換實驗項目即可查看規則、DNS、TUN 與訂閱設定分別處理哪些問題,以及設定時應觀察哪些結果。
規則模式會由上而下檢查網域、IP、程序與獨立規則集,第一個符合的結果會決定連線採用直連、代理或拒絕策略。使用時應先放置範圍較窄、意圖明確的規則,再將通用規則與 MATCH 留在末尾。相較於只提供全域開關的客戶端,mihomo 可分別處理區域網路、工作系統、媒體服務與一般網頁;排查時也能透過連線紀錄確認具體命中的規則,不必只憑頁面是否開啟來判斷。
DNS 模組可分別指定預設解析器、代理端解析器與網域策略,並透過 fake-ip 或 redir-host 模式銜接系統請求。設定重點不是堆疊位址,而是確認解析請求由哪個介面送出、規則匹配需要真實 IP 還是映射位址,以及區域網路網域是否應排除。mihomo 的策略功能允許特定網域使用獨立 nameserver,讓解析路徑與存取出口保持一致,減少解析結果與實際連線路線不相符所造成的失敗。
TUN 模式透過虛擬網路介面接收系統流量,適合命令列工具、部分應用程式與遊戲等不遵循系統代理設定的程式。啟用前要確認作業系統權限、路由自動設定、DNS 劫持範圍與本機網段排除項目;啟用後則應重新建立連線,再觀察預設路由與區域網路存取是否正常。它與一般系統代理並非單純的強弱關係:瀏覽器情境通常先使用系統代理,只有涵蓋範圍不足時再啟用 TUN,排查路徑會更清楚。
訂閱通常負責節點與策略組,規則提供器則負責可獨立更新的匹配集合。匯入後應先查看設定是否能正常解析,再確認策略組引用的節點名稱與規則引用的 provider 都已載入。更新失敗時,依序檢查連結可達性、回應格式、欄位相容性與代理迴圈,比反覆刪除後重新匯入更容易定位問題。mihomo 支援分開維護節點來源與規則來源,日常更新時不必頻繁修改整份主要設定。
Windows、macOS、Android、iOS 與 Linux 客戶端在介面入口、系統服務和權限模型上各不相同,但核心工作仍是載入設定、選擇策略、接管流量並顯示連線紀錄。桌面端更適合長時間常駐系統匣與編輯設定,行動端重點在系統 VPN 權限與背景行為,Linux 則可直接執行核心。選擇時應先查看平台維護狀態與所需功能,再決定介面偏好,不必只按名稱相似程度判斷。
PLATFORM ACCESS
下載頁依平台列出可用的圖形客戶端、系統需求與安裝入口。這裡不直接提供安裝檔,平台連結會開啟對應分類,方便比較同一系統下的不同客戶端。
P-01 / DESKTOP
適合需要常駐系統匣、切換系統代理與 TUN 接管的桌面環境。下載頁同時列出 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 與封存客戶端,方便依維護狀態與介面習慣選擇。安裝後先匯入訂閱,再確認系統代理開關與監聽連接埠。
前往下載P-02 / DESKTOP
適合 Apple Silicon 與 Intel Mac。安裝前應核對處理器架構,首次執行時依照系統提示完成網路延伸功能或輔助服務授權。若只需要瀏覽器流量,可先使用系統代理;終端機與其他不讀取代理設定的應用程式,再視需要啟用 TUN。
前往下載P-03 / MOBILE
Android 客戶端透過系統 VPN 介面接管應用程式連線,匯入設定後需要明確授予連線權限。不同裝置的背景限制會影響長時間執行,遇到鎖定螢幕後中斷時,應檢查電池策略、背景活動權限與系統 VPN 狀態,而不是先修改節點或規則。
前往下載P-04 / MOBILE
iPhone 與 iPad 使用系統網路延伸功能建立代理連線。設定工作集中在訂閱匯入、策略組選擇與系統 VPN 授權,連線後可從客戶端紀錄核對網域命中結果。下載頁提供 Clash Plus 的 App Store 入口與官方網站 clashplus.io,方便確認產品資訊。
前往下載P-05 / DESKTOP
桌面使用者可選擇具備圖形介面的客戶端,伺服器、軟路由或容器環境則更適合直接執行 mihomo 核心。設定前要確定服務使用者、設定目錄與啟動方式,並將日誌交由系統服務管理。圖形客戶端與核心套件用途不同,一般桌面環境優先選擇前者。
前往下載THREE-STAGE SETUP
首次設定不需要同時修改所有進階選項。先建立一條可重複的基本流程:確認訂閱能被客戶端解析,選擇規則模式與策略組,最後透過連線紀錄驗證命中結果。基本鏈路穩定後,再處理 TUN、DNS 或自訂規則。
依照這個順序,可以將問題限制在單一階段。若匯入時已經報錯,就不必檢查系統代理;若設定載入正常但應用程式沒有流量,再轉向檢查權限、連接埠與接管方式。完整教學包含各介面入口與常見狀態說明。
查看完整教學 →在客戶端的設定或訂閱頁面新增服務提供方給出的連結,執行更新後檢查是否出現策略組、節點與規則。若只有空白設定或顯示解析失敗,應先確認連結回傳的是客戶端支援的內容,不要繼續開啟系統代理。
日常使用通常選擇規則模式,再到主要代理群組中指定可用策略。全域模式會讓大多數連線統一經過目前策略,直連模式則略過代理;兩者更適合臨時測試。切換後應重新建立目前使用中的連線。
先啟用系統代理並開啟測試頁面,觀察客戶端連線清單是否出現新紀錄、規則欄是否符合預期。若目標程式不讀取系統代理,再評估 TUN。驗證時同時檢查網頁存取、區域網路裝置與常用應用程式,避免只憑單一頁面下結論。
OPEN SOURCE RECORD
專案關係。Clash Meta 這個名稱通常用來指稱 Meta 分支形成的功能生態,目前核心專案以 mihomo 名稱持續開發。圖形客戶端負責設定管理、系統服務、系統匣互動與日誌顯示,mihomo 核心負責協定處理、規則匹配、DNS、入站與出站連線。理解這層關係,有助於判斷問題發生在介面、系統權限、設定檔還是核心執行階段。
公開協作。mihomo 的原始碼、提交紀錄、議題討論與發布說明均在公開儲存庫中維護。使用者可以查看設定欄位的實作變化,客戶端維護者也能在相同核心基礎上建立不同平台的前端。本網站依據這些公開資料與實際設定行為整理中文說明,不將某個介面名稱直接視為核心能力,也不把第三方客戶端的操作差異混寫成統一結論。
更新方式。核心、圖形客戶端、訂閱內容與規則集是四條不同的更新鏈路。客戶端更新可能改變介面與系統服務,核心更新可能調整設定欄位或網路行為,訂閱更新主要影響節點與策略,規則集更新則會改變連線命中範圍。排查時應記錄最近變動的是哪一層,並先恢復單一變數,避免同時更新所有內容後無法確定原因。
文件原則。設定紀錄優先說明可觀察的結果:檔案是否載入、連接埠是否監聽、系統代理是否指向正確位址、連線命中了哪條規則、DNS 請求由哪個解析器處理。不同作業系統的權限與網路堆疊並不相同,因此同一個開關在各平台可能有不同的前置條件。涉及平台差異時,文件會分別列出步驟,而不是用一組截圖概括所有環境。
SOURCE COMMAND
以下指令會複製公開儲存庫,適合需要閱讀設定實作、追蹤議題或參與開發的使用者。一般客戶端安裝不需要執行此指令。
git clone https://github.com/MetaCubeX/mihomo.git
OBS-01
確認 YAML 能正常解析、外部規則集可讀取,且策略組引用名稱一致。解析階段失敗時,網路接管尚未開始,應先處理縮排、欄位相容性或遠端內容可達性。
OBS-02
系統代理適用於遵循代理設定的程式,TUN 用於涵蓋更廣的網路流量。兩者都涉及系統權限與路由,切換後應重新建立連線並檢查區域網路存取。
OBS-03
連線成功不代表分流正確。應查看目標網域、最終 IP、命中規則與所選策略,區分代理無法使用、規則順序錯誤與 DNS 結果異常。
OBS-04
調整設定時一次只修改一類項目,並保留上一份可正常運作的設定。發生異常後即可快速還原,也能明確判斷是規則、DNS、訂閱還是客戶端設定造成變化。
SHORT ANSWERS
這些問題用來確定排查方向。涉及設定欄位含義時,可繼續查看術語表;需要完整操作流程時,請前往使用指南。
Clash Meta 是這個分支及其生態中廣泛使用的名稱,核心專案目前以 mihomo 名稱維護。不同圖形客戶端可以呼叫 mihomo 核心,但客戶端介面、系統服務與發布節奏由各自專案負責。可在術語表的核心與架構分類查看進一步說明。
日常設定通常使用規則模式,讓連線依網域、IP 與規則集進入不同策略。全域模式適合臨時確認某個代理策略是否能運作,直連模式適合排除代理因素。切換模式後,既有連線可能繼續沿用舊路徑,應關閉目標應用程式的連線後重新測試。
部分應用程式不會讀取系統代理,也可能自行實作網路堆疊。先確認瀏覽器流量能進入客戶端,再檢查目標應用程式是否支援代理設定;確有涵蓋需求時再啟用 TUN,並核對管理員權限、虛擬網卡、路由與 DNS 接管狀態。
先檢查訂閱網址是否能存取,以及回傳內容是否仍為有效設定,再查看客戶端日誌中的 HTTP 狀態、解析提示與欄位錯誤。若手動存取正常但客戶端更新失敗,還需檢查更新請求是否因目前代理規則形成迴圈。詳細步驟請見訂閱更新故障排查紀錄。
FIELD NOTES
文章依具體問題編排,記錄觸發條件、檢查順序與修改後的驗證方法。日期用來標記內容整理時間,設定前仍應配合目前的客戶端介面與核心文件核對欄位。