mihomo
mihomo 是延續 Clash.Meta 專案的代理核心,負責讀取設定、監聽本機入口、比對規則並建立出站連線。Clash Verge Rev 等用戶端提供操作介面,實際的網路處理則由核心執行。診斷設定相容性時,請區分用戶端版本與核心版本:介面上看得到某個選項,不代表所有行為都相同,實際效果仍取決於核心的實作方式。
設定參考 / macOS
系統代理決定哪些 App 會將連線交給核心,規則分流則決定交給核心的連線要走哪條路。依分類查閱設定項目、設定欄位與日誌術語。
區分介面、核心與遠端連線。
mihomo 是延續 Clash.Meta 專案的代理核心,負責讀取設定、監聽本機入口、比對規則並建立出站連線。Clash Verge Rev 等用戶端提供操作介面,實際的網路處理則由核心執行。診斷設定相容性時,請區分用戶端版本與核心版本:介面上看得到某個選項,不代表所有行為都相同,實際效果仍取決於核心的實作方式。
代理協定規範如何建立連線、驗證身分及傳輸資料,例如 Shadowsocks 和 Trojan。設定節點時,協定及其參數必須與伺服器相符,只有伺服器位址和連接埠並不足以建立連線。瀏覽器連到本機代理時使用的 HTTP 或 SOCKS5 入站協定,與核心連接遠端節點時使用的協定,是兩項不同設定。
節點是設定中的一筆代理出站定義,通常包含名稱、協定、伺服器位址、連接埠及連線參數。代理群組可列出多個節點,也能包含直連等其他策略。即使兩個節點顯示相同地區名稱,也可能使用不同協定或線路;切換節點後,請用原本發生問題的 App 重新測試。
用戶端顯示的節點延遲,通常是透過該節點存取指定測試位址所測得的時間,單位為毫秒。測試位址、測試時間或連線狀態不同,數值也可能改變。延遲低不代表頻寬高;若檔案下載速度慢,應檢查實際傳輸速度,而不是只看單次測試結果。
先確認連線如何進入核心,再看核心如何處理。
啟用系統代理後,Clash 用戶端會將本機代理位址與連接埠寫入 macOS 的網路代理設定。只有會讀取並遵循該設定的 App,才會將適用的要求傳給核心;自行建立連線的程式可能不受影響。若瀏覽器能正常連線、終端機卻不行,請先確認命令列工具是否會讀取系統設定,再決定是否要為它另外設定代理。
TUN 模式透過虛擬網路介面與系統路由,將符合條件的流量送入代理核心,不需要 App 主動讀取系統代理。啟用時可能需要系統授權,接管範圍也會受路由設定與排除項目影響。如果同時執行其他 VPN 或虛擬網卡工具,遇到連線異常時可逐一停用比對,避免將路由衝突誤判為節點故障。
出站模式只決定已交給核心的連線如何處理。規則模式會依設定順序比對;全域模式通常使用全域群組目前選取的策略;直連模式則讓已接管的連線直接存取目標。切換到全域模式不會讓未被接管的 App 自動使用代理;切換到直連也不等於關閉 TUN 或清除系統代理。
混合連接埠是核心的本機監聽連接埠,對應 mihomo 設定欄位 mixed-port,可同時接收 HTTP 代理與 SOCKS5 要求。App 仍須依支援的協定填寫代理類型,不能只填連接埠。連接埠號碼以用戶端目前的設定為準;照著教學輸入數值前,請先確認本機實際監聽的連接埠。
從日誌中的命中規則判斷連線走向。
在規則模式下,核心會依設定順序檢查連線的網域、目的 IP 等特徵,通常採用第一條符合的規則。該規則可以將連線交給代理群組,也可以指定直連或拒絕。新增規則沒有生效時,先查看連線日誌命中了哪一條,再確認是否需要將新規則移到適用範圍更廣的規則之前。
這是依網域後綴比對的規則類型。DOMAIN-SUFFIX,example.com,DIRECT 會在取得相應網域時比對 example.com 及其子網域 www.example.com,但不會比對 notexample.com。如果只要比對完整網域,請使用 DOMAIN。
GeoIP 會依目的 IP 在歸屬資料中的分類結果比對連線,不會根據網頁使用的語言、網域後綴或 Mac 所在位置判斷。如果目標原本是網域,而核心尚未得知其位址,比對 IP 規則時可能會觸發解析。同一個網站若由不同地區的 CDN 節點回應,命中結果也可能隨目的位址而改變。
MATCH 是無條件比對規則,通常放在規則清單最後,用來處理未符合前面任何規則的連線。例如 MATCH,DIRECT 代表其餘連線直連。若將它放在特定網域規則之前,連線會先符合 MATCH,後面的網域規則便不會生效。
分清設定來源、檔案格式與可供引用的策略。
訂閱是用戶端透過遠端網址取得並更新設定或節點清單的方式。能在瀏覽器中開啟連結,不代表就能匯入:回傳內容可能是登入頁面,也可能採用用戶端不支援的格式。更新失敗時,先確認連結是否仍有效、回傳內容是否符合目前用戶端的格式;向他人描述錯誤時,請勿附上完整訂閱網址。
YAML 是一種文字資料格式,Clash 生態系常用來表示連接埠、代理群組與規則清單。縮排代表階層,應使用一致的空格而非定位字元;清單項目通常以連字號開頭。檔案能通過 YAML 語法解析,不代表核心支援其中每個欄位;遇到錯誤時,也要確認欄位名稱與設定值。
代理群組由設定中的 proxy-groups 定義,讓規則引用固定的策略名稱,不必綁定特定節點。手動選擇群組由使用者指定成員;自動測速群組則依其測試機制選擇成員。修改策略前,先確認連線命中哪個群組;在其他群組切換節點,不會改變這條連線使用的策略。
規則集將一組網域、位址或其他比對條件放在獨立來源中,方便個別更新。在 mihomo 設定中,可透過 rule-providers 定義規則集來源,再於規則清單中使用 RULE-SET 引用。符合規則後採用的出站策略由引用它的那一行指定;即使規則集更新成功,也不會改變該行在清單中的優先順序。
確認設定適用於本機、目前的網路服務,還是單一 App。
127.0.0.1 是常用的 IPv4 迴圈位址,指向發出連線的裝置本身。macOS 代理設定填入此位址時,App 連接的是 Mac 上監聽的連接埠,而不是遠端節點伺服器。將相同位址填入手機的代理設定,指向的會是手機本身;如果 Mac 上的核心未在指定連接埠監聽,Mac 也無法建立連線。
macOS 透過網路服務管理 Wi-Fi、乙太網路等連線,各服務可有獨立的代理與 DNS 設定。檢查系統代理時,請在「系統設定 → 網路」中開啟目前使用的服務,再查看其代理設定。改用網路線或擴充基座後,別只依先前的 Wi-Fi 設定判斷系統代理是否仍然生效。
系統網路設定中的略過清單會告訴遵循該設定的 App,存取哪些主機或網域時不要使用系統代理,例如本機服務 localhost。略過發生在 App 將要求傳給本機代理之前,與核心收到連線後執行 DIRECT 並非同一個階段。啟用 TUN 時,不應將略過清單視為路由排除項目。
部分命令列程式會讀取 https_proxy、all_proxy 或 no_proxy,據此決定是否使用代理;實際支援情況請參閱工具文件。在終端機工作階段匯出的變數會傳給從該工作階段啟動的子程序,不會自動修改系統設定。若要排查終端機與瀏覽器行為不同的情況,應分別確認兩者使用的代理來源。
分開檢查查詢交給誰,以及連線從哪裡出去。
DNS 解析用來查詢網域對應的位址等紀錄。解析成功只代表取得了紀錄,不能證明 App 能連上該位址,也無法說明連線採用哪條代理規則。排查時,先分清楚「沒有傳回位址」與「有位址但連線失敗」:前者檢查解析路徑,後者則查看連線日誌、命中策略及節點狀態。
核心可以在 DNS 回應中傳回合成位址,並在本機記錄該位址與原網域的對應關係。後續連線進入核心時,核心可還原網域以供規則比對,因此看到合成位址不代表解析故障。若某項區域網路服務需要真實位址,請先確認是否與此模式衝突,再考慮針對網域設定 fake-ip-filter。
原本預期由指定路徑處理的 DNS 查詢,若被送往其他解析服務,就可能發生 DNS 洩漏。網頁連線走代理,不代表網域查詢也走相同路徑。排查時請確認用戶端的 DNS 設定、系統目前使用的解析器,以及瀏覽器是否啟用了獨立的安全 DNS;並將測試結果與預期的解析策略比對。
分流 DNS 會依網域或指定條件選擇上游解析器,例如將內部服務網域交給能解析該網域的組織內部解析器。mihomo 可使用 nameserver-policy 為符合條件的網域指定解析器。它解決的是「要向誰查詢位址」,而非「連線到該位址時要走哪個出口」;這兩個階段的判斷條件應分開確認。