MIHOMO CORE · RULE ROUTING

Clash Meta官網
全平台客戶端與規則分流

圍繞 mihomo 核心整理 Windows、macOS、Android、iOS 與 Linux 客戶端入口,並記錄訂閱匯入規則分流與網路診斷的實際設定路徑。

  • 永久免費
  • 原始碼開放
  • 中文文件

TEST BENCH / ROUTING

mihomo 核心能力紀錄

以下內容依照一條連線從進入本機連接埠到決定出口的順序整理。切換實驗項目即可查看規則、DNS、TUN 與訂閱設定分別處理哪些問題,以及設定時應觀察哪些結果。

RULE-SET / GEOIP / MATCH

連線出口由規則順序決定

規則模式會由上而下檢查網域、IP、程序與獨立規則集,第一個符合的結果會決定連線採用直連、代理或拒絕策略。使用時應先放置範圍較窄、意圖明確的規則,再將通用規則與 MATCH 留在末尾。相較於只提供全域開關的客戶端,mihomo 可分別處理區域網路、工作系統、媒體服務與一般網頁;排查時也能透過連線紀錄確認具體命中的規則,不必只憑頁面是否開啟來判斷。

PLATFORM ACCESS

依作業系統選擇客戶端

下載頁依平台列出可用的圖形客戶端、系統需求與安裝入口。這裡不直接提供安裝檔,平台連結會開啟對應分類,方便比較同一系統下的不同客戶端。

P-01 / DESKTOP

Windows

適合需要常駐系統匣、切換系統代理與 TUN 接管的桌面環境。下載頁同時列出 Clash Plus、Clash Verge Rev、FlClash、Clash Nyanpasu 與封存客戶端,方便依維護狀態與介面習慣選擇。安裝後先匯入訂閱,再確認系統代理開關與監聽連接埠。

前往下載

P-02 / DESKTOP

macOS

適合 Apple Silicon 與 Intel Mac。安裝前應核對處理器架構,首次執行時依照系統提示完成網路延伸功能或輔助服務授權。若只需要瀏覽器流量,可先使用系統代理;終端機與其他不讀取代理設定的應用程式,再視需要啟用 TUN。

前往下載

P-03 / MOBILE

Android

Android 客戶端透過系統 VPN 介面接管應用程式連線,匯入設定後需要明確授予連線權限。不同裝置的背景限制會影響長時間執行,遇到鎖定螢幕後中斷時,應檢查電池策略、背景活動權限與系統 VPN 狀態,而不是先修改節點或規則。

前往下載

P-04 / MOBILE

iOS

iPhone 與 iPad 使用系統網路延伸功能建立代理連線。設定工作集中在訂閱匯入、策略組選擇與系統 VPN 授權,連線後可從客戶端紀錄核對網域命中結果。下載頁提供 Clash Plus 的 App Store 入口與官方網站 clashplus.io,方便確認產品資訊。

前往下載

P-05 / DESKTOP

Linux

桌面使用者可選擇具備圖形介面的客戶端,伺服器、軟路由或容器環境則更適合直接執行 mihomo 核心。設定前要確定服務使用者、設定目錄與啟動方式,並將日誌交由系統服務管理。圖形客戶端與核心套件用途不同,一般桌面環境優先選擇前者。

前往下載

THREE-STAGE SETUP

從訂閱匯入到連線驗證

首次設定不需要同時修改所有進階選項。先建立一條可重複的基本流程:確認訂閱能被客戶端解析,選擇規則模式與策略組,最後透過連線紀錄驗證命中結果。基本鏈路穩定後,再處理 TUN、DNS 或自訂規則。

依照這個順序,可以將問題限制在單一階段。若匯入時已經報錯,就不必檢查系統代理;若設定載入正常但應用程式沒有流量,再轉向檢查權限、連接埠與接管方式。完整教學包含各介面入口與常見狀態說明。

查看完整教學 →
  1. 01

    匯入訂閱或設定檔

    在客戶端的設定或訂閱頁面新增服務提供方給出的連結,執行更新後檢查是否出現策略組、節點與規則。若只有空白設定或顯示解析失敗,應先確認連結回傳的是客戶端支援的內容,不要繼續開啟系統代理。

  2. 02

    選擇規則模式與策略

    日常使用通常選擇規則模式,再到主要代理群組中指定可用策略。全域模式會讓大多數連線統一經過目前策略,直連模式則略過代理;兩者更適合臨時測試。切換後應重新建立目前使用中的連線。

  3. 03

    啟用接管並核對紀錄

    先啟用系統代理並開啟測試頁面,觀察客戶端連線清單是否出現新紀錄、規則欄是否符合預期。若目標程式不讀取系統代理,再評估 TUN。驗證時同時檢查網頁存取、區域網路裝置與常用應用程式,避免只憑單一頁面下結論。

OPEN SOURCE RECORD

mihomo 開放原始碼生態與維護界線

專案關係。Clash Meta 這個名稱通常用來指稱 Meta 分支形成的功能生態,目前核心專案以 mihomo 名稱持續開發。圖形客戶端負責設定管理、系統服務、系統匣互動與日誌顯示,mihomo 核心負責協定處理、規則匹配、DNS、入站與出站連線。理解這層關係,有助於判斷問題發生在介面、系統權限、設定檔還是核心執行階段。

公開協作。mihomo 的原始碼、提交紀錄、議題討論與發布說明均在公開儲存庫中維護。使用者可以查看設定欄位的實作變化,客戶端維護者也能在相同核心基礎上建立不同平台的前端。本網站依據這些公開資料與實際設定行為整理中文說明,不將某個介面名稱直接視為核心能力,也不把第三方客戶端的操作差異混寫成統一結論。

更新方式。核心、圖形客戶端、訂閱內容與規則集是四條不同的更新鏈路。客戶端更新可能改變介面與系統服務,核心更新可能調整設定欄位或網路行為,訂閱更新主要影響節點與策略,規則集更新則會改變連線命中範圍。排查時應記錄最近變動的是哪一層,並先恢復單一變數,避免同時更新所有內容後無法確定原因。

文件原則。設定紀錄優先說明可觀察的結果:檔案是否載入、連接埠是否監聽、系統代理是否指向正確位址、連線命中了哪條規則、DNS 請求由哪個解析器處理。不同作業系統的權限與網路堆疊並不相同,因此同一個開關在各平台可能有不同的前置條件。涉及平台差異時,文件會分別列出步驟,而不是用一組截圖概括所有環境。

SOURCE COMMAND

查看 mihomo 原始碼

以下指令會複製公開儲存庫,適合需要閱讀設定實作、追蹤議題或參與開發的使用者。一般客戶端安裝不需要執行此指令。

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 是什麼關係?

Clash Meta 是這個分支及其生態中廣泛使用的名稱,核心專案目前以 mihomo 名稱維護。不同圖形客戶端可以呼叫 mihomo 核心,但客戶端介面、系統服務與發布節奏由各自專案負責。可在術語表的核心與架構分類查看進一步說明。

規則、全域、直連模式該如何選擇?

日常設定通常使用規則模式,讓連線依網域、IP 與規則集進入不同策略。全域模式適合臨時確認某個代理策略是否能運作,直連模式適合排除代理因素。切換模式後,既有連線可能繼續沿用舊路徑,應關閉目標應用程式的連線後重新測試。

系統代理已經開啟,為什麼部分應用程式仍沒有流量?

部分應用程式不會讀取系統代理,也可能自行實作網路堆疊。先確認瀏覽器流量能進入客戶端,再檢查目標應用程式是否支援代理設定;確有涵蓋需求時再啟用 TUN,並核對管理員權限、虛擬網卡、路由與 DNS 接管狀態。

訂閱更新失敗時,應先檢查哪一項?

先檢查訂閱網址是否能存取,以及回傳內容是否仍為有效設定,再查看客戶端日誌中的 HTTP 狀態、解析提示與欄位錯誤。若手動存取正常但客戶端更新失敗,還需檢查更新請求是否因目前代理規則形成迴圈。詳細步驟請見訂閱更新故障排查紀錄

FIELD NOTES

近期設定紀錄

文章依具體問題編排,記錄觸發條件、檢查順序與修改後的驗證方法。日期用來標記內容整理時間,設定前仍應配合目前的客戶端介面與核心文件核對欄位。

Clash 訂閱更新失敗怎麼辦:失敗原因排查與自動更新間隔設定

依序檢查連結過期、請求受阻、代理迴圈與格式變更,並說明自動更新間隔的設定位置,以及手動強制更新後應觀察的狀態。

閱讀全文

Clash 代理模式選哪個:規則、全域、直連三種模式差異詳解

從連線流向解釋三種模式的行為差異,並記錄日常存取、臨時測試與內網除錯情境下的選擇方式,以及切換後重新建立連線的必要性。

閱讀全文

Clash 訂閱連結怎麼匯入:各客戶端匯入步驟與常見訂閱格式說明

整理不同客戶端的訂閱入口,說明標準 YAML、Base64 與通用分享連結的差異,並提供匯入後確認節點、策略組與規則是否載入的方法。

閱讀全文