MIHOMO / CONFIG.YAML

Clash 進階設定指南

先釐清流量接管、網域解析、規則比對與出口選擇,再修改對應的設定區段。使用指南說明初次安裝、匯入訂閱與連線驗證;本頁則適合已完成基本連線後,依主題調整設定與排查問題。尚未安裝的話,可前往用戶端下載頁,依作業系統選擇版本,優先考慮該平台推薦且符合系統需求的 Clash Plus。以下以 mihomo 原生欄位為準;用戶端是否允許透過介面設定特定欄位,取決於使用的核心與設定合併方式。

策略組類型與出口選擇

策略組決定「規則命中後要走哪個出口」,而不是「哪些流量應該命中這條規則」。在 Rule 模式下,核心會先依照 rules 順序比對新連線,再將連線交給規則指定的策略組。策略組可以引用節點、內建策略或其他策略組,但引用必須有效,且不能形成循環。例如,辦公策略組可以引用預設出口組,但預設出口組就不能再把辦公策略組列為候選項。排查時先確認規則指向哪個組,再查看該組目前選取的項目。

依使用情境選擇策略組類型

類型選擇依據適用情境
select使用手動選取的候選項固定出口;隔離排查變因
url-test依探測結果選擇候選項多個可互換的出口
fallback優先使用清單中順位較前且可用的項目指定主要出口與備援出口
load-balance依指定策略將不同連線分配給候選項可接受不同連線使用不同出口的情境

需要穩定出口的服務,優先使用 select。例如,某個後台可能將出口變更視為登入異常;即使另一個節點的探測速度較快,也不應自動切換。使用 fallback 設定主備連線時,候選項應依服務優先順序排列,而非依單次測速結果排序。這種設定可在主要連線無法使用時,讓新連線改走備援;已建立的長連線不會因此無縫轉移,應用程式仍可能需要重新連線或登入。

url-test 的 url 是探測目標,interval 的單位是秒,tolerance 的單位是毫秒,可減少候選項速度差異很小時頻繁切換的情況。探測成功只代表該出口能連上測試網址,不表示會議、檔案同步或特定網站也能正常使用。選擇探測目標時,請確認所有候選出口都能連線。定期探測也會消耗流量與電力,不必讓每個用途相同的策略組都重複測試同一批節點。

load-balance 分配的是連線,而不是同一個下載工作中的資料封包。使用多連線的應用程式可能同時走不同出口;即使採用雜湊類策略,也不能保證對外 IP 固定。請先確認候選項都符合可接受的範圍,再用兩個彼此獨立的新連線確認分配結果。排查網頁互動或登入狀態時,先切回固定出口,避免把應用程式的工作階段問題誤判為代理協定故障。

先用內建策略確認組別引用

以下是可單獨載入的最小範例,不需要訂閱:預設直接連線,手動切換至 REJECT 後,只會拒絕 example.com 及其子網域。此範例用來確認策略組選擇是否生效,不會建立代理出口。若現有用戶端已占用相同連接埠,請改在獨立的測試環境執行,或使用尚未占用的本機連接埠。

mixed-port: 7890
allow-lan: false
mode: rule

proxy-groups:
  - name: ExamplePolicy
    type: select
    proxies:
      - DIRECT
      - REJECT

rules:
  - DOMAIN-SUFFIX,example.com,ExamplePolicy
  - MATCH,DIRECT

測試請求必須經過範例設定所監聽的入口。先在連線紀錄中確認測試網域命中 DOMAIN-SUFFIX,再查看策略鏈是否經過 ExamplePolicy。切換策略後,請關閉相關應用程式的連線,再重新送出相同請求;瀏覽器可能重用連線池中的舊連線,因此只重新整理頁面未必能分辨新舊結果。如果紀錄中完全沒有請求,請先排查流量接管,不要繼續修改策略組名稱或探測參數。

匯入訂閱後,策略組可以使用 proxies 指定節點名稱,也可以用 use 引用節點提供器。前者適合少量固定候選項,後者適合會定期更新的訂閱。若為策略組新增名稱篩選條件,更新後請確認篩選結果不是空的。策略組名稱應描述用途,而不是供應商當天提供的節點名稱;這樣更換訂閱時只需調整候選來源,不必逐條修改服務規則。

切回設定後,如果選項與預期不同,請確認用戶端是否儲存了上次選取的策略,以及目前讀取的是哪個設定檔。清單順序與執行時的選擇是兩回事,不能只看候選項排列就推斷實際出口。正式使用前,請分別測試明確命中的網域、走預設規則的網域,以及需要備援出口的連線。若仍不確定規則順序,可接著閱讀GEOIP、GEOSITE 與 RULE-SET 分流實作。

以規則集管理規則

若一批網域或網段需要獨立維護,可將規則內容放入 rule-providers,再於 rules 中使用 RULE-SET 引用。提供器負責取得並解析規則項目;最終使用哪個出口,仍由引用該規則集的規則決定。維護者可以更新清單而不必修改主設定,但主設定中的引用名稱、比對順序與出口名稱必須保持穩定。建議先從範圍明確、涵蓋對象有限的規則集開始,避免第一次調整就把所有服務集中到同一個來源。

選擇比對方式與檔案格式

behavior: domain 適用於網域比對項目,ipcidr 適用於 IP 網段;classical 則以規則類型和比對內容描述對象,例如 DOMAIN-SUFFIX,example.org。傳統規則集的項目不包含出口名稱,出口需寫在主設定的 RULE-SET 規則中。只改副檔名不會改變檔案實際格式;使用 format: yaml 時,規則檔會以 payload 陣列存放項目。

先用本機檔案確認比對結果,再切換至遠端來源。以下範例會將示例網域導向 DIRECT,其他連線也會直接連線,因此應透過連線紀錄區分兩條規則,而不是根據出口是否相同來判斷。請將規則檔放在 mihomo 工作目錄中對應的相對路徑下。桌面用戶端產生執行設定時,工作目錄可能不是訂閱檔所在目錄,可從啟動資訊確認。

# 合併至 config.yaml;若已有 rules,只合併規則清單。
rule-providers:
  documentation:
    type: file
    behavior: classical
    format: yaml
    path: ./rules/documentation.yaml

rules:
  - RULE-SET,documentation,DIRECT
  - MATCH,DIRECT
# rules/documentation.yaml
payload:
  - DOMAIN-SUFFIX,example.org
  - DOMAIN-SUFFIX,example.net

遠端更新與規則順序

改用遠端維護時,將提供器的 type 改為 http,填入維護者提供的規則檔 url,保留獨立的本機 path,並以 interval 設定更新間隔,單位為秒。請勿讓多個提供器共用同一個快取路徑,否則無法可靠判斷檔案是由哪個來源寫入。更新後請檢查實際載入的項目與更新時間;網頁能在瀏覽器中開啟,不代表核心下載到的是預期格式,回應內容也可能是登入頁面或錯誤訊息。

首次啟動時若沒有可用快取,請特別確認規則來源的網路是否可連線。若規則檔只能透過特定出口存取,而該出口又仰賴同一批規則或尚未初始化的節點,就會形成無法啟動的循環依賴。請先使用現有可用設定取得並檢查規則,或以本機檔案建立初始設定,再決定遠端更新要走哪條可用路徑。縮短更新間隔並不能解決首次載入失敗。

規則會由上往下比對,並採用第一條符合的規則。某個網域同時符合精確例外規則與範圍較廣的規則集時,順序就會決定結果。先放服務例外,再放範圍較窄的網域集,接著處理涵蓋較廣的 IP 網段或地理規則,並將 MATCH 留在最後。規則集更新後新增的項目也會依照原有順序比對,不能只檢查主設定是否有變更;每個遠端規則集都應有明確且可預期的涵蓋範圍。

IP 類比對還要考慮解析所帶來的影響。若連線原本帶有網域,排在前面的 IP 規則可能會觸發 DNS 查詢,讓遠端解析或後續網域規則的排查更複雜。如果只想比對已知的目標 IP,可評估在適用的 IP 類規則或 IP 類規則集引用中使用 no-resolve;它不會自動把網域當成 IP 比對,也不等於關閉整個核心的 DNS。請先分別用網域和純 IP 測試,再決定是否加入此參數。

發生分流錯誤時,記錄一次失敗連線的目標、命中規則、規則集名稱與出口。若命中較前面的規則,請修正順序或涵蓋範圍;若完全沒有命中規則集,則檢查載入狀態、項目類型與網域是否可見。若命中正確但連線失敗,應改查策略組與出口。回復設定時,請一併保留上次可用的主設定與相應規則檔,避免只還原引用,卻仍載入新版清單。

DNS 上游與解析路徑

排查 DNS 時,先確認查詢由哪一方送出,再確認交給哪個解析器。應用程式可能使用系統解析,也可能啟用自己的加密 DNS;核心在必要時也會送出查詢,例如解析代理伺服器的網域,或為某些 IP 規則取得目標位址。設定 mihomo 的 dns 區段,不代表每個應用程式都會使用這個入口。釐清解析路徑時,應分別列出瀏覽器、系統、核心與上游,而不是將所有查詢都歸到系統設定中顯示的位址。

區分一般查詢、上游引導與節點解析

欄位用途常見混淆
default-nameserver為以網域名稱設定的 DNS 上游提供引導解析不是一般網域查詢的優先清單
nameserver處理未套用專用策略的一般查詢不會決定服務連線最後使用哪個出口
nameserver-policy依網域等比對條件指定解析上游比對 DNS 查詢,與 rules 不同
proxy-server-nameserver專門解析代理節點的伺服器網域代理出口尚未建立時也應能連線

初期可先使用可直接連線的 IP 上游,減少因網域上游需要先解析而產生的依賴,再逐步加入加密上游或網域專用策略。若節點位址使用網域名稱,而解析該網域又必須依靠尚未連線的節點,錯誤便會發生在出口建立之前。啟用 respect-rules 前,應依 mihomo 的要求設定 proxy-server-nameserver,並確認它與底層出口不會形成循環依賴。

以下範例只監聽回環位址,用來單獨測試核心 DNS,並使用可直接查詢的公用解析器。它不會修改系統 DNS,也不會將本機變成區域網路 DNS 服務。使用 redir-host 方便在確認階段查看實際位址回應。請確認網路允許連線至範例上游;若公司網路只允許使用內部解析器,請改用管理員提供的位址,不要額外新增無法連線的公用備用上游。

dns:
  enable: true
  listen: 127.0.0.1:1053
  enhanced-mode: redir-host
  nameserver:
    - 223.5.5.5
  proxy-server-nameserver:
    - 223.5.5.5
dig @127.0.0.1 -p 1053 example.org A

依網域指定解析器,並確認接管範圍

若內網主機記錄只存在於組織的解析器,請使用 nameserver-policy,將對應的網域後綴交給內部上游,並確認連往該解析器的流量經過正確介面。把內部與公用解析器放在同一份清單中,無法達到區分內外網查詢的效果,還可能把內部名稱送至不相關的上游。測試時分別查詢一筆確實存在的內部記錄與一筆公用記錄,不要只根據後台是否載入成功來判斷解析是否正確。

診斷時比較三種結果:直接向核心的監聽位址查詢、使用作業系統預設解析器查詢,以及在出問題的應用程式中重新連線。第一種可確認監聽與上游基本可用;第二種能看出系統是否將查詢轉交過來;第三種才能反映應用程式是否使用自己的解析機制或快取。三種結果不同不一定代表錯誤,關鍵在於差異能否由預期的解析路徑說明。瀏覽器內建的加密 DNS 通常無法只靠接管一般的 TCP 或 UDP 53 埠查詢來改寫。

檢查 DNS 是否外洩時,先定義允許的解析路徑。例如,內網網域使用組織解析器,一般外部網域使用指定的公用上游,而應用程式的加密解析則另有規範。檢測網站通常顯示遞迴解析鏈的出口,不一定會顯示裝置直接連線的伺服器位址。結果不一致時,請搭配系統或用戶端的查詢紀錄,以一筆可控制的請求確認來源,不要只是不斷更換檢測網站重看結果。

查詢逾時與查詢成功但回應不正確,應分開處理。逾時時先檢查監聽是否啟動、上游是否可連線,以及路由是否繞回核心本身;回應不符時則檢查專用策略、快取、位址族,以及應用程式是否使用其他解析管道。若只有單一應用程式出問題,應優先重現該應用程式的解析路徑。仍在確認各區段設定關係時,可參考config.yaml 檔案結構詳解,確認 DNS 區段與出口規則沒有設定顛倒。

分別使用 A 與 AAAA 查詢,確認兩種位址族的結果。只停用 DNS 的 IPv6 回應,不會改變所有應用程式既有的 IPv6 連線或系統路由;反過來說,單獨停用介面的 IPv6 也無法修復上游解析失敗。修改後請從相同入口重新送出請求,並記錄網域、查詢類型與結果;不要同時修改 DNS 上游、TUN 和瀏覽器設定,否則即使恢復設定,也無法判斷是哪項改動造成影響。

TUN 流量接管與 Fake-IP 對應

TUN 決定哪些裝置流量會送進核心,Fake-IP 則決定核心如何回應被接管的網域查詢。兩者可以搭配使用,但處理的問題不同。系統代理通常只影響遵循系統設定的應用程式;TUN 則可透過虛擬介面接管更多流量。Fake-IP 會為網域配置對應位址,連線進入同一個核心執行個體後再還原網域,以便套用網域規則。若只啟用 Fake-IP,卻讓使用對應位址的連線繞過核心,通常會遇到解析成功但連線失敗。

依序啟用介面、DNS 接管與對應

先用舊設定確認核心與出口正常,再記錄目前的預設路由,以及既有的 VPN 或虛擬網卡。桌面用戶端通常需要具備建立介面與調整路由的權限;行動裝置則透過系統 VPN 機制接管流量,請使用用戶端提供的選項。不要直接把桌面版 YAML 當成行動版的設定指南。若同時執行另一個 VPN,先依使用情境決定哪個服務負責預設路由,再測試能否並行,不要只靠啟動順序碰運氣。

以下是桌面環境的初始設定片段,請合併至已能正常運作的設定。mixed 是 TUN 協定堆疊的選擇,與 mixed-port 不同;auto-route 會安裝接管流量所需的路由,auto-detect-interface 則用於選擇出口介面。dns-hijack 分別列出一般 UDP 與 TCP DNS 查詢,不會自動將加密 DNS 轉換成核心可解析的一般查詢。

tun:
  enable: true
  stack: mixed
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53
    - tcp://any:53

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  fake-ip-filter:
    - '+.lan'
  nameserver:
    - 223.5.5.5

範例中的篩選項只決定相應網域是否回傳 Fake-IP。對環境中確實存在的內部名稱,應回傳實際位址,並透過專用解析策略交由能解析該名稱的上游處理。篩選項本身不會新增直連規則,也不會為實際位址建立繞過虛擬網卡的路由。內部列印、檔案分享或服務探索異常時,請分別檢查名稱是否能解析、目標位址的實際路由,以及應用程式使用的探索協定。

沿著流量路徑找出中斷點

啟用後請用三類目標驗收:可確認網域規則的公用網站、確實可連線的本機資源,以及不使用系統代理設定的應用程式。公用網站應符合預期規則;本機資源應依需求保持可連線;獨立應用程式的連線應能在核心中查看。測試前先停用該應用程式自行設定的代理,避免它經由另一個本機連接埠接入,造成 TUN 已完成接管的錯覺。

網域查詢回傳映射範圍內的位址,但連線清單沒有相應紀錄時,請檢查目標位址的路由與介面歸屬,尤其要確認裝置是否存在重疊網段。只有在連上另一個 VPN 或區域網路後才出問題,表示更應檢查路由優先順序、介面選擇或位址範圍衝突。若連線已進入核心卻無法辨識網域,請確認產生映射與處理連線的是同一個執行個體,並排除應用程式仍使用舊映射結果的可能。

切換網路介面後,自動選擇不一定符合實際需求。使用雙網卡、外接網卡或公司 VPN 時,先記錄切換前後的實際出口,並確認預設路由是否改變。有些應用程式會在原介面保留舊連線一段時間,因此不適合用已建立的長連線驗收。若要限制接管範圍,請先確認哪些網段應保留在原介面,再依核心與平台支援情況調整路由設定;不要大範圍排除可能與目標流量重疊的網段。

整台裝置無法連線時,先從用戶端關閉 TUN,確認預設路由與 DNS 狀態是否恢復。若沒有恢復,請檢查是否有殘留服務重新安裝路由,或另一個 VPN 已接管流量。基本網路恢復後,再單獨啟用 TUN 重現問題。測試途中不要同時啟用系統代理、切換協定堆疊或調整網段;這些變更影響不同層,全部疊在一起容易掩蓋真正的故障點。

若要切回 redir-host 進行比較,請重新發起查詢與連線,避免應用程式繼續使用先前快取的 Fake-IP。比較時應記錄具體變化:是 DNS 回應、規則命中,還是只有預設路由改變。若只有特定平台發生接管問題,先確認權限與 VPN 狀態,再參考常見使用問題;不要直接套用其他平台的系統設定。

網域嗅探與比對範圍

網域嗅探可為只有目標位址的連線補上網域線索。啟用前請先確認流量確實進入核心,而且連線缺少網域才導致規則比對錯誤。若已有可靠的代理請求網域或 Fake-IP 對應,通常可直接依網域比對;若應用程式實際上只連線至純 IP,且協定沒有攜帶可辨識的名稱,即使啟用嗅探也無法取得可用網域。

限制要識別的協定與連接埠

明文 HTTP 可從請求標頭中的主機欄位取得名稱;TLS 有機會從交握資訊中的 SNI 取得名稱;QUIC 則需要相應的協定識別能力,且會受交握資料與實際網路狀況限制。連接埠只能縮小嘗試範圍,不能證明流量一定使用指定協定。不要把辦公軟體的自訂連接埠整段加入嗅探範圍;請先觀察故障流量使用的協定與連接埠,再針對少量連線啟用識別。啟用 TLS 嗅探不代表會讀取 HTTPS 頁面內容,也不需要匯入憑證。

sniffer:
  enable: true
  parse-pure-ip: true
  override-destination: false
  sniff:
    HTTP:
      ports: [80, 8080]
    TLS:
      ports: [443]
    QUIC:
      ports: [443]
  skip-domain:
    - '+.lan'

此處使用 parse-pure-ip,允許嘗試識別缺少網域的連線,並關閉 override-destination,避免用嗅探取得的網域改寫原始連線目標。如此可先觀察規則是否因此改善,再判斷是否有必要變更連線方式。不要把這段設定視為強制修復方案:若服務透過固定位址提供連線,即使交握資訊帶有名稱,也可能應繼續連線至原位址,而非改用名稱重新解析。

skip-domain 用來排除已知不適合嗅探的網域,不是用來排除任意 IP 網段。若應用程式使用純 IP,核心在處理前未必能取得可供此欄位比對的名稱。遇到這類問題,請先縮小協定或連接埠範圍;必要時依實際核心支援設定目標位址排除項。不要填入從未出現的網域,期待它能跳過整個網段;也不要把網域排除清單與 DNS 的 Fake-IP 篩選清單視為同一份設定。

用連線紀錄比較啟用前後的差異

先為測試網域新增一條位置明確的精確規則,並暫時將出口固定在結果可預期的策略組。關閉嗅探後建立新連線,記錄目標位址與命中規則;啟用嗅探後,再從相同應用程式建立新連線,觀察是否出現網域、規則是否改變,以及最後是否成功連線。若紀錄只是多出名稱,但規則仍走原路徑,請先確認該名稱的比對條件;不能只看到 SNI 就認定網域分流已符合預期。

同一個 IP 位址可能承載多個網站。連線中顯示的網域應來自該連線本身,不應把先前在同一位址觀察到的其他網域填入規則。即使取得外層名稱,它也可能只對應交握時看到的對象,不等於使用者最後連線的服務主機。需要精確識別的應用程式,優先採用能保留原始請求網域的接入方式;若解析與連線都能掌控,也可使用 Fake-IP 對應。

加密的用戶端交握可能隱藏實際伺服器名稱;有些 TCP 或 UDP 應用程式從一開始就不會攜帶可用網域。遇到這種情況,請依實際目標位址與連接埠設計範圍明確的規則,或將該應用程式的流量導向指定出口。繼續擴大嗅探連接埠範圍,無法找回從未出現的名稱,反而會增加誤判機率。應將此情境標記為網域不可觀測,而不是認定規則集維護失敗。

若問題只在 UDP 流量下重現,請分別確認瀏覽器使用 QUIC 時是否取得網域、出口能否處理這類流量,以及應用程式失敗後是否改用 TCP。每次對照測試只變更一項條件,並在每次切換後建立新連線。TCP 成功而 UDP 失敗,不能直接證明嗅探模組異常;出口協定、路由與防火牆也都是這條路徑的必要條件。反過來說,嗅探取得名稱也不代表封包已成功經過出口。

需要分享紀錄時,請保留規則類型、協定、連接埠與問題發生順序,並移除內部網域及其他可能洩露服務環境的資訊。確認設定有效後,只保留測試證明有用的協定與連接埠。若實際效益只涵蓋單一應用程式,請記下重現條件與復原方式;日後用戶端升級或設定覆寫改變時,才能用相同測試分辨是識別能力變化,還是原始流量的接入方式已改變。

本機覆寫與多訂閱合併

將會更新的訂閱與需要長期維護的本機規則分開管理。訂閱負責提供會隨來源變動的節點;本地主設定則管理連接埠、策略組、規則順序與記錄設定。直接在已匯入的遠端訂閱內容中追加欄位,下一次更新時可能會被遠端內容覆蓋。使用用戶端的覆寫功能前,請先確認它套用於單一訂閱、所有設定,還是產生後的執行設定,並了解清單採用取代、插入前方或其他合併方式。

用提供器區隔節點來源

若來源是符合 mihomo 節點提供器格式的 proxies 檔案,可使用 proxy-providers 整合多個來源。完整訂閱通常包含 rules、dns 與自己的策略組,不能假設用戶端會自動將其拆成適合提供器使用的節點檔。匯入前請檢查頂層結構與實際回應內容。若用戶端只支援匯入完整設定,請使用它明確提供的合併入口,再檢查匯出的最終設定;不要把用戶端專屬的覆寫語法當成核心原生欄位。

# 兩個檔案都必須存在,且每個檔案都要包含 proxies 清單。
proxy-providers:
  office:
    type: file
    path: ./providers/office.yaml
  personal:
    type: file
    path: ./providers/personal.yaml

proxy-groups:
  - name: Office
    type: select
    use: [office]
  - name: Personal
    type: select
    use: [personal]

rules:
  - DOMAIN-SUFFIX,example.org,Office
  - DOMAIN-SUFFIX,example.net,Personal
  - MATCH,DIRECT

範例會將兩個來源分別放入用途不同的策略組;請將網域替換為已獲授權且確實符合用途的對象,再分別測試連線。不要只為了讓清單看起來整齊,就把所有來源都加入同一個自動選擇組。個人出口與辦公室出口通常有不同的可連線範圍與使用條件,混用會讓同一網站在不同時間得到不同結果,也會增加故障判斷的難度。若多個來源有同名節點,建議在名稱中加入穩定的來源前綴,並確認介面顯示的實際候選項。

若已有可用的提供器遠端網址,可改用 type: http,為各來源設定不同的 url 與本機快取路徑,並依來源更新頻率設定 interval。訂閱連結可能含有存取憑證,應保存在受控的本機設定或用戶端儲存空間,不要發布至公開程式碼儲存庫、線上轉換服務或螢幕截圖中。單一來源失效時,先確認受影響的是哪些用途組,不要把所有組統一切換到其他出口來掩蓋來源問題。

確認合併順序與實際生效的檔案

映射與清單是兩種不同的合併對象。覆寫 dns 時,某些實作會取代整個映射,可能連原有的網域策略一併移除;另一些則會逐欄位合併,因此可能保留舊的上游。使用清單追加方式處理 rules 時,如果新增規則排在原有的 MATCH 後面,就永遠不會命中。編輯前請先確定預期操作是整體取代、插入前方,還是插在某個項目之前;產生設定後要檢查最終檔案,而不只是確認編輯器已儲存。

建議統一使用固定的策略組名稱與規則集名稱,並在不同區段間引用這些穩定名稱。若重新命名策略組,至少要檢查規則出口與其他組中的引用;若重新命名規則提供器,也要檢查 RULE-SET 以及任何使用該規則集的解析策略。遇到同名項目時,請先決定要保留哪份定義,不要依賴合併器處理重複鍵時的偶然行為。即使某個編輯器能讀取 YAML,核心取得的結構仍可能與預期不同。

使用獨立的 mihomo 執行檔時,可在載入設定前執行檢查。以下命令假設目前位於包含設定與提供器相對路徑的工作目錄,且本機已安裝核心命令。若核心由用戶端管理,請優先使用用戶端提供的檢查或記錄功能,並以相同核心檢查最終設定,避免測試的檔案與實際執行的檔案不同。

mihomo -t -d . -f ./config.yaml

設定檢查通過,只代表核心接受目前的設定,不表示遠端檔案一定能取得、每個策略組都有候選項,或服務分流已正確運作。實際載入後,請分別觸發辦公、個人與預設路由三類連線,確認提供器載入狀態、命中規則與出口。模擬一次訂閱更新,再重複相同測試;更新後本機修改與引用仍有效,才能確認覆寫位置正確。請將測試輸入與預期結果記錄在本機維運文件中。

更新後只有一個策略組失效時,先確認來源是否重新命名、內容清空或項目格式改變,再檢查組合邏輯。若所有策略組都異常,優先確認是否載入錯誤的基礎訂閱,或用戶端更新後改變了覆寫的套用範圍。回復時還原上一份可用的主設定與相應提供器檔案,確認規則目標仍存在,再逐一恢復各來源。長期維護時應能定位是哪個輸入發生變化,而不是只手動修好一次,卻失去重現問題的條件。

外部控制面板與執行狀態

外部控制器是核心的管理介面,不是代理流量入口。面板透過它讀取連線、規則與策略組狀態,也可能變更策略組選擇、關閉連線或調整設定。它的用途與 mixed-port 和 DNS 監聽連接埠不同。若用戶端內建面板已足夠,就不必額外開啟監聽。確實需要獨立管理時,請預設綁定回環位址,並使用專用且只保存在本機的高強度密鑰。

使用回環位址並設定獨立驗證

將控制器設定合併至頂層。若用戶端已管理控制連接埠,請先查看目前的監聽位址,避免同一台裝置上的多個核心執行個體爭用連接埠。以下密鑰只是明顯不可重複使用的教學範例,執行前必須換成在本機產生的獨立隨機值。allow-lan: false 可限制一般代理入口供區域網路使用,但不能取代控制器本身的回環位址綁定與驗證設定。

external-controller: 127.0.0.1:9090
secret: "replace-with-local-random-value"
allow-lan: false

若獨立面板以本機靜態資源提供,可依所用核心的方式設定 external-ui,並填入可信且由本機維護的面板目錄。若面板由控制器提供,通常可透過同一個控制服務開啟 /ui/,減少瀏覽器跨來源問題。目錄尚未部署時,控制 API 正常不代表面板路徑可用;同樣地,面板頁面能開啟也不代表已通過 API 驗證。兩者應分開確認。

以下命令會在執行核心的同一台裝置上發起經驗證的唯讀查詢,適用於具備 Bash 與 curl 的環境。密鑰會透過互動方式輸入,不會寫入命令文字或指令碼;執行前請確認沒有啟用 shell 追蹤,也不要將終端機錄影或請求標頭提供給他人。若使用用戶端內建面板,可改用它提供的連線診斷功能。

read -rsp '控制密鑰:' controller_secret
printf '\n'
printf 'header = "Authorization: Bearer %s"\n' "$controller_secret" |
  curl --fail --silent --show-error --config - \
    http://127.0.0.1:9090/version
unset controller_secret

區分面板、監聽服務與實際設定

現象優先檢查不要先修改
連線遭拒服務是否已啟動,以及位址和連接埠是否屬於目前的執行個體規則順序與 DNS
回應未授權目前使用的密鑰是否與面板連線設定一致監聽範圍
API 正常,但面板顯示空白面板資源、瀏覽器安全限制,以及面板中的介面位址核心出口策略
面板有資料,但不是預期的執行個體實際連線位址、設定檔與後台服務的歸屬與目前模型無關的其他策略組參數

本機介面回應未授權時,先確認是否連錯後台執行個體,再重新輸入密鑰;不要為了排查而移除驗證。若命令可以連線,但瀏覽器出現跨來源或混合內容錯誤,請先透過同源的本機面板重測。網頁指令碼的安全限制是瀏覽器的防護機制,關閉限制或允許所有網站存取都不是解決方法。尤其是使用來源不明的面板時,切勿將本機管理憑證交給該頁面。

不要將控制器綁定到所有介面,也不要將該連接埠轉發至公用網路。若確實需要遠端管理,請優先使用組織現有且受控的遠端桌面或管理管道,再從裝置上的本機工作階段開啟面板。即使網路入口已有存取限制,控制器仍應保留獨立驗證。多人共用裝置時,請限制設定檔的存取權限,避免將密鑰與一般代理連接埠放在其他處理程序或帳戶也能讀取的共用目錄中。

排查服務問題時,面板應以觀察為主,不要頻繁切換選項。記錄一筆新連線的目標、協定、命中規則與實際策略鏈,再到對應章節調整單一變因。若切換策略組,請主動建立新的測試連線;舊工作階段可能仍沿用原出口。若變更只在介面上生效,重新啟動後就消失,請確認它屬於執行階段選擇、用戶端儲存的偏好,還是已寫入本地主設定的永久變更,這三者不可混為一談。

記錄功能也應依需求短暫開啟。短時間提高記錄詳細程度,有助於定位載入失敗或網域識別問題;重現問題後請恢復原有等級,避免長期累積連線目標與個人使用紀錄。對外求助時可保留錯誤類型與已移除敏感資訊的相關設定區段,不必提供完整執行設定。頁面能顯示節點與規則,只代表管理介面讀得到狀態;代理是否可用,仍須透過實際連線紀錄與可重複的請求確認。

最終驗收請依固定順序進行:確認應用程式流量已進入核心、所需網域可解析或可識別、命中預期規則,再確認該策略組選用了可用出口。最後更新一次訂閱並重新載入,確認至少一個關鍵情境仍正常。若基本連線尚未通過,請回到使用指南重新確認匯入與連線;若只是系統代理、權限或連接埠問題,先查看常見問題,不必一次修改整份設定。

下載 Clash