核心與用戶端
用戶端提供操作介面，核心負責處理連線。排查時請分別記下用戶端名稱、核心名稱與執行中的設定。
- mihomo代理核心 / Clash.Meta
- mihomo 是 Clash 生態系中的代理核心，曾以 Clash.Meta 為名，負責協定連線、DNS 處理、規則比對與流量轉發。Clash Verge Rev 等圖形化用戶端可整合此核心，但介面版本與核心版本是兩回事。確認特定欄位是否可用時，應以目前執行中的核心及其文件為準，而非只看用戶端名稱。
- 圖形化用戶端GUI / 設定與系統整合
- 圖形化用戶端提供訂閱管理、策略選擇、連線記錄與系統代理開關等操作介面，再將設定交由核心執行。部分用戶端會把介面選項、範本與覆寫片段合併成執行設定，因此修改訂閱原文不一定會改變最終行為。若設定在重新啟動後還原，先確認修改的是原始訂閱、持久化覆寫，還是暫時的執行副本。
- 節點proxies / 出站連線參數
- 節點通常是指一組代理伺服器位址、連接埠、協定與驗證參數，在完整設定中常對應
proxies底下的一個項目。清單中的名稱只是標籤，無法證明伺服器位置、實際出口地區或服務是否可用。節點與策略組也不同：節點描述具體連線，策略組則負責從多個連線或其他策略組中選擇出站。
- 延遲測試測試 URL / timeout
- 用戶端通常會透過指定代理存取測試網址，再記錄請求所花時間；不同實作對連線重用與計時範圍的處理可能不同。結果會受測試 URL、目標網站、網路路徑與逾時設定影響，不等於下載頻寬，也無法代表所有網站的存取速度。測試逾時只表示這次探測未能在期限內完成，應搭配實際連線情況與記錄判斷。
- 外部控制器external-controller / 管理 API
external-controller用來指定核心管理 API 的監聽位址，介面可透過它讀取連線記錄、查詢狀態或切換策略。範例127.0.0.1:9090是本機管理入口，不可填入瀏覽器的 HTTP 代理連接埠欄位。除非已明確設定存取控制與網路隔離，否則不要將管理介面綁定至外部可存取的位址。
代理協定
請區分應用程式連線至本機代理所用的協定，以及核心連線至遠端伺服器所用的協定。名稱相似，不代表參數或傳輸行為相同。
- HTTP 代理HTTP / CONNECT
- HTTP 代理是由應用程式主動將請求傳送至代理監聽位址的方式；存取 HTTPS 時通常透過
CONNECT建立通道，再由應用程式與目標網站協商 TLS。應用程式連線至本機 HTTP 代理，不代表遠端節點也使用 HTTP 協定，更不代表所有連線都會自動加密。是否經過代理，取決於應用程式有沒有使用這項設定。
- SOCKS5TCP / UDP ASSOCIATE
- SOCKS5 是通用代理協定，可傳輸 TCP；應用程式與代理都支援時，也能轉送 UDP。網域名稱由本機解析或交由代理端解析，取決於應用程式的呼叫方式；部分命令列工具會以不同的 URL scheme 區分兩者。只填入 SOCKS5 位址，無法保證所有 DNS 查詢都交由代理處理，也無法替不支援代理的應用程式接管流量。
- Shadowsockstype: ss
- Shadowsocks 用於在用戶端與代理伺服器之間加密轉送，在 mihomo 節點設定中常寫為
type: ss。伺服器位址、連接埠、加密方式、驗證參數及選用外掛程式都必須與伺服器端相符，不能只憑顯示名稱還原連線。不同協定版本與加密方式的支援範圍可能不同，匯入失敗時應檢查核心支援情況與相關欄位。
- Trojantype: trojan / TLS
- Trojan 通常透過 TLS 傳輸代理流量；除了伺服器位址與驗證參數，憑證相關的網域設定也必須正確。伺服器連線位址與憑證驗證網域用途不同，不可任意互換。遇到憑證錯誤時，請檢查系統時間、憑證鏈與網域；略過憑證驗證會降低對伺服器身分的確認能力。
- Hysteria 2type: hysteria2 / QUIC
- Hysteria 2 是以 QUIC 為基礎的代理協定，仰賴底層 UDP 連線；若網路限制 UDP，即使同一台伺服器的 TCP 服務正常，也可能無法建立此協定的連線。它與第一代 Hysteria 的設定名稱不能直接互換。協定本身不保證傳輸速率，實際表現仍受線路品質、伺服器資源與壅塞狀況影響。
規則與分流
先確認連線已進入核心，再檢查比對順序、目標策略與規則資料。規則使用的名稱必須已有對應定義。
- 規則分流mode: rule / rules
- 在規則模式下，核心依
rules的排列順序比對連線，再交由命中規則指定的出口或策略組處理。例如DOMAIN-SUFFIX,github.com,PROXY會將符合該網域及其子網域的連線交給名為PROXY的目標。調整順序會改變比對結果，卻無法解決應用程式根本沒有經過核心的問題；排查時請查看連線記錄中的命中規則。
- 策略組proxy-groups / select / url-test
- 策略組會將代理或其他策略組組成可供規則引用的出站名稱。
select用於手動選擇，url-test依定期探測結果選擇，fallback則依成員順序與可用性切換。自動選擇仰賴測試網址與檢查間隔，不代表每個網站都會使用各自最快的線路。
- GeoIPGEOIP,CN,DIRECT
- GeoIP 透過 IP 位址資料庫判斷目標位址所屬地區，常用來決定直連或代理。它不是依公司所在地或網域後綴分類；CDN 調度與資料庫更新都可能改變比對結果。若需依網域取得 IP，可能會觸發解析；
no-resolve可避免該 IP 規則主動觸發解析，但不代表整個連線過程不需要 DNS。
- 規則集rule-providers / RULE-SET
- 規則集會將一組網域、IP 或其他規則獨立存放，透過
rule-providers宣告，再於rules中使用RULE-SET引用。載荷格式須符合behavior、format等宣告，規則集名稱也必須一致。成功下載只代表取得內容，不代表格式可用或相關連線一定會命中。
- MATCH預設規則 / 最後比對
MATCH會接收此前未命中的連線，通常應放在規則清單最後。若將MATCH,PROXY放在開頭，後續規則就無法處理已被它接收的連線。此處的PROXY是自訂目標名稱，不是預設存在的保留名稱；使用前必須有同名代理或策略組。DIRECT與REJECT則是內建出站。
延伸閱讀：設定檔與規則說明 →
網路流量接管模式
流量入口、DNS 解析與出站規則需要互相配合。只看單一開關的狀態，不足以確認整條連線路徑是否正常。
- 系統代理作業系統代理設定
- 系統代理會向作業系統登記代理監聽位址，讓遵循此設定的應用程式主動連線至本機代理。部分命令列工具、遊戲或使用自有網路堆疊的應用程式不會讀取這項設定，因此瀏覽器可用不代表所有軟體都已接管。關閉用戶端前，請確認系統代理已還原，否則應用程式可能仍會連線至已停止監聽的本機連接埠。
- TUN 模式tun.enable / 虛擬網路介面
- TUN 透過虛擬網路介面與相關路由設定接管 IP 流量，可涵蓋部分不遵循系統代理設定的應用程式。實際接管範圍取決於自動路由、排除項目、系統權限與 DNS 設定；啟用
tun.enable不代表一定涵蓋所有連線。stack指定網路堆疊的實作，不是規則模式開關；啟用後仍可依規則選擇直連或代理。
- mixed-port本機 HTTP + SOCKS 混合連接埠
mixed-port讓同一個本機連接埠接受 HTTP 與 SOCKS 代理連線，例如mixed-port: 7890。它與遠端節點連接埠及管理 API 連接埠用途不同，不可互相替代。應用程式使用時還需指定正確的代理類型與監聽位址；若要讓其他裝置存取，也須評估監聽範圍、區域網路權限與防火牆設定。
- Fake-IPdns.enhanced-mode: fake-ip
- Fake-IP 模式會回傳合成位址給應用程式，並維護位址與網域的對應關係，讓核心能在後續連線階段還原目標網域以進行分流。合成位址並非目標伺服器的真實公網位址；DNS 查詢與後續連線都須進入相應的處理路徑。部分仰賴真實解析結果的應用程式可能需要加入
fake-ip-filter，但沒有明確依據時，不應大量新增排除項目。
- DNS 洩漏解析路徑 / 非預期解析器
- DNS 洩漏通常是指查詢經由非預期的網路路徑或解析器傳送，讓網域查詢資訊暴露給非預期對象。瀏覽器安全 DNS、系統解析服務與核心 DNS 設定都可能參與；僅發現解析器所在地區不同，無法單獨證明有洩漏。排查時應先釐清預期路徑，再確認查詢是否經過核心、上游解析如何出站，以及應用程式是否使用獨立的加密 DNS。
機制比較：TUN 模式與系統代理的差異 →
訂閱與設定檔
先辨識輸入內容，再選擇匯入方式。完整設定、代理集合與分享連結是不同類型的資料。
- 訂閱連結遠端設定 / 定期更新入口
- 訂閱連結是用來取得代理清單或完整設定的遠端網址，常包含可辨識帳戶的存取憑證，應視為敏感資訊妥善保存。相同形式的 HTTPS 網址可能回傳 YAML、編碼後的分享連結清單或其他格式，不能只憑副檔名判斷是否相容。匯入後，先確認設定已啟用、策略組已出現，再測試連線；更新成功與節點可用是兩個不同的結果。
- YAML縮排層級 / 鍵值與清單
- YAML 是 mihomo 常用的設定資料序列化格式，以空格縮排表示層級，並以
-表示清單項目。使用 Tab 縮排、重複鍵，或未正確引用含特殊字元的值，都可能造成解析錯誤或改變內容意義。YAML 可成功解析不代表設定一定有效；還須檢查欄位型別、核心支援情況，以及規則引用的策略名稱。
- 設定檔config.yaml / 執行參數集合
- 設定檔描述本機監聽連接埠、DNS、代理、策略組與分流規則等執行參數；
config.yaml是常見檔名，但副檔名本身不決定內容是否可用。圖形化用戶端可能在啟動前合併範本與覆寫設定，因此訂閱原文不一定等同於最終執行設定。修改前請保留可還原的副本，修改後檢查啟動記錄，避免將載入失敗誤判為線路故障。
- 代理集合proxy-providers / use
- 代理集合透過
proxy-providers從遠端或本機載入代理項目，再由策略組使用use引用。它通常只提供節點資料，不負責完整設定中的 DNS、監聽連接埠與分流規則，因此不能預設為可直接啟用的獨立設定。集合的更新間隔也可能與用戶端完整訂閱的更新排程分開管理，請分別檢查對應設定。
- 訂閱轉換載荷轉換 / 目標格式
- 訂閱轉換會將一種輸入載荷整理成目標用戶端可辨識的格式，有些轉換服務也會套用策略組與規則範本。轉換無法補上缺少的驗證參數，也不能讓核心支援原本不支援的協定欄位。第三方轉換服務通常可存取完整訂閱連結，使用前應評估憑證暴露風險；建議先確認用戶端是否能直接匯入原始格式。