mihomo
代理核心・原 Clash Meta
mihomo 是由 Clash Meta 演進而來的代理核心，負責讀取設定、比對規則、處理 DNS 與轉送連線。Clash Verge Rev 等圖形用戶端提供操作介面；介面上出現某個選項，不代表所有核心版本都支援相同寫法。遇到欄位錯誤時，先確認用戶端實際使用的核心及其文件，再判斷是否需要調整設定。
Clash 術語表
核心、代理模式、規則與 DNS，依概念分類查閱。先釐清各欄位的用途，再調整設定。
本頁是用戶端選擇與設定資料的概念入口。每張卡片都有專屬錨點，可直接分享；初次設定請依快速入門操作，參數組合與實作方式可參考進階設定。
核心與協定
介面負責操作，核心負責連線。節點是遠端連線參數，連接埠則是本機或遠端的監聽入口，兩者不可混為一談。
圖形用戶端
GUI client
圖形用戶端將訂閱匯入、代理選擇、記錄檢視及系統代理設定等功能做成操作介面，底層連線通常由核心處理。不同用戶端可能採用相同核心，但覆寫方式、服務安裝及權限申請入口各不相同。選擇時也要考量作業系統支援與設定管理方式，詳細資訊請參閱用戶端比較。
代理節點
proxy・遠端連線參數
節點是一組描述遠端代理連線的參數，通常包含協定類型、伺服器位址、連接埠及驗證資訊；有些協定還需要傳輸層或 TLS 參數。節點不是用戶端本身，安裝應用程式後仍須匯入可用設定。連線失敗時，應分別檢查參數錯誤、伺服器無法連線及本機網路問題，不要只憑節點名稱或測試結果判斷服務狀態。
混合連接埠
mixed-port
混合連接埠會在同一個本機監聽連接埠接收 HTTP 代理與 SOCKS 代理請求，方便不同應用程式共用同一入口。這不是遠端節點的伺服器連接埠；若僅供本機使用，應用程式通常會連線至迴路位址與該連接埠。變更數值後，也要同步更新系統代理及手動設定代理的應用程式；操作細節請參閱Clash 連接埠設定。
延遲測試
latency・請求耗時
用戶端通常會透過代理連線至指定測試網址，記錄請求耗時，以比較特定條件下的回應速度。結果會受到測試網站、交握流程、連線重用及當下網路狀態影響，並不等於下載頻寬或影片播放能力。若要排查實際使用體驗，應以目標應用程式進行測試，再搭配記錄檢查連線失敗、封包遺失或壅塞，不要只挑延遲最低的節點。
代理模式
規則、全域與直連決定流量的去向；系統代理與 TUN 則決定流量如何進入核心。這是兩組不同的設定。
規則模式
mode: rule
規則模式會依設定中的規則選擇出口，讓不同網域或位址分別直連、使用代理或遭到拒絕。規則通常依序比對，符合後便執行對應動作，因此條件較具體的規則應放在較廣泛的規則之前。日常使用可先選擇規則模式，但實際效果取決於規則內容與策略組定義，不會自動補上缺少的分流邏輯。
全域模式
mode: global
全域模式會將進入核心的連線統一交由全域策略選擇出口，方便暫時測試某個代理的連線能力。此處的「全域」是指出口選擇，並非接管系統所有流量：未使用系統代理的程式仍可能繞過用戶端。切換前請確認全域策略實際選取的目標，排查完成後再恢復原模式，避免將模式變更誤認為規則已修復。
直連模式
mode: direct · DIRECT
直連模式會讓進入核心的連線不經遠端代理伺服器，直接連線至目標；規則中的 DIRECT 則是可供單條規則引用的直連目標。兩者影響範圍不同，不應將單條直連規則理解為整份設定都已直連。直連模式也不等於退出應用程式，系統代理、TUN 與核心 DNS 仍可能保持運作。
系統代理
system proxy
系統代理會在作業系統設定中登記代理位址與連接埠，讓遵循這些設定的應用程式將請求交給本機用戶端。瀏覽器通常會使用系統代理，但部分遊戲、命令列程式或採用自有網路堆疊的應用程式可能不會讀取這項設定。初次連線可先啟用系統代理並用瀏覽器測試；若應用程式仍無法連線，再檢查其代理選項或考慮使用 TUN。
TUN 模式
tun・虛擬網路介面
TUN 透過虛擬網路介面與路由設定，將流量送入代理核心，可涵蓋部分不使用系統代理的程式。通常需要相應的系統權限或用戶端服務支援；啟用後的涵蓋範圍也取決於路由、排除項目及其他網路軟體。TUN 不會決定連線一定使用代理，流量進入核心後仍會依目前模式選擇出口；啟用步驟請參閱TUN 設定。
規則與策略組
規則判斷「這條連線屬於哪一類」，策略組決定「這類連線使用哪個出口」。引用的名稱必須與完整設定中的定義一致。
規則分流
rules・條件比對
規則分流會依網域、目標 IP 或其他條件，將連線交由指定策略組、直連目標或拒絕目標處理。常見網域規則包括 DOMAIN 與 DOMAIN-SUFFIX，最後通常以 MATCH 處理其餘連線。調整規則時，除了確認條件是否正確，也要檢查前面是否有較寬泛的規則先行符合，以及引用的策略名稱是否存在。
策略組
proxy-groups
策略組會整理多個節點或其他策略目標，讓規則引用固定名稱，而不必逐一綁定特定節點。select 用於手動選擇，url-test 用於依測試結果選擇較佳出口，fallback 則用於依序切換至可用目標。各類型用途不同，設定時也應確認成員來源、測試條件及組間引用關係。
url-test
自動測試策略組
url-test 會定期透過組內代理連線至指定 URL，再依測試結果及相關參數選擇出口。測試網址會決定比較哪條連線路徑；測試間隔與容差則會影響切換頻率，過於頻繁地切換不一定適合需要維持的連線。此功能可減少手動選擇，但無法保證大型檔案的傳輸速度，也不能確保所選代理對每個網站都同樣適用。
GeoIP
GEOIP・位址地區比對
GeoIP 會依 IP 位址所屬地區或資料庫分類比對連線，常用於位址層級的分流。比對結果來自資料庫，不代表使用者所在地；雲端服務搬遷、共用基礎架構及資料庫更新都可能影響分類。若將這類規則套用於網域連線，可能需要先解析位址；規則若帶有 no-resolve，則不會為該規則額外觸發解析。
規則集
rule-providers · RULE-SET
規則集會將一批比對條件拆成獨立資源，透過 rule-providers 定義，再由 RULE-SET 引用，方便集中更新與重複使用。資源格式必須符合 behavior 設定，網域清單、位址清單與傳統規則不可任意混用。規則集本身不會替你選擇出口，最終動作仍由引用它的規則決定；更新後也要確認資源已成功載入。
DNS 與網路堆疊
網域解析與連線轉送是彼此相關、但不同的流程。網頁無法開啟，可能是解析階段出問題，也可能是路由或遠端連線受阻。
DNS
Domain Name System
DNS 會將網域名稱解析為位址等記錄，讓應用程式知道要連線至哪個目標。作業系統、瀏覽器與代理核心可能各自使用不同的解析服務，因此修改核心 DNS 不一定會改變所有程式的查詢路徑。排查時先確認實際由誰負責解析，再檢查查詢是否成功、回傳位址是否符合預期，以及代理伺服器的網域是否也能正常解析。
Fake-IP
enhanced-mode: fake-ip
Fake-IP 會回傳供映射使用的虛擬位址給應用程式，核心再利用位址與網域的對應關係處理後續連線，保留網域資訊並配合分流。這個位址不是網站的真實伺服器位址，不能只憑它判斷解析錯誤。若應用程式需要真實位址，或不相容於這種映射方式，可視需求設定 fake-ip-filter，但例外範圍應盡量明確。
DNS 洩漏
DNS leak・非預期查詢路徑
DNS 洩漏是指網域查詢未沿預期路徑送出，而交由其他解析服務處理，可能因此暴露查詢的網域。瀏覽器加密 DNS、作業系統回退機制及未被接管的查詢都須分別檢查；測試網站顯示某個解析服務商，也不足以證明完整的查詢路徑。加密 DNS 可保護傳輸過程，但是否符合預期，仍取決於解析服務的選擇與流量路由。
網域嗅探
sniffer
網域嗅探會嘗試從連線中可見的協定中繼資料擷取網域，例如部分 HTTP 請求或 TLS 交握資訊，以補充規則判斷。這不等於解密 TLS 內容，也無法從所有連線還原網域；遇到加密中繼資料或不支援的協定時，可能無法取得結果。啟用後若有相容性問題，應依需求縮小嗅探範圍，而非假設所有 IP 連線都能被準確識別。
IPv6
Internet Protocol version 6
IPv6 使用 128 位元位址，網域的 AAAA 記錄通常會提供這類位址。能否正常連線取決於本機網路、DNS 回傳結果、TUN 路由涵蓋範圍及代理出口能力，不能只看用戶端中的 IPv6 開關。若只有部分網站異常，可比較 IPv4 與 IPv6 的解析及連線路徑，再決定要調整哪一層，避免用單一開關掩蓋真正的路由問題。
訂閱與設定檔
訂閱提供遠端資源，設定檔定義運作方式，覆寫則保留本機調整。更新前，先確認目前匯入的是完整設定，還是單獨的代理清單。
訂閱連結
subscription URL
訂閱連結是取得遠端設定或代理清單的網址，用戶端可透過它定期更新資源，省去逐一輸入節點的步驟。不同服務回傳的內容可能是完整 YAML、代理清單或其他格式，匯入前請確認用戶端支援的格式。連結通常包含存取憑證，不應放入公開截圖、記錄或分享訊息；匯入方式請參閱Clash 訂閱連結匯入。
YAML
config.yaml・結構化設定文字
YAML 以縮排表示物件與清單的層級，是常見的 Clash 設定文字格式；編輯時請讓同層欄位對齊，並使用空格縮排。語法解析成功只代表文字結構可讀，不代表策略組引用、欄位名稱及核心相容性都正確。複製片段時應放入正確層級，避免重複頂層鍵；完整結構說明請參閱Clash 設定檔。
代理集合
proxy-providers
代理集合透過 proxy-providers 管理獨立的代理清單資源，再由策略組的 use 等設定引用。這適合將代理資源更新與本機規則維護分開，但資源內容必須符合所用核心的要求，不能將任意完整設定直接當成代理集合使用。代理集合也不同於規則集：前者提供可用的連線目標，後者提供比對條件。
本機覆寫
override · merge · patch
本機覆寫可在訂閱內容之外保留自訂調整，例如追加規則或修改監聽連接埠，避免遠端更新覆蓋手動編輯的內容。各用戶端對合併、取代、規則插入及指令碼執行的順序可能不同，名稱相似也不代表運作方式相同。修改後應檢查最終生效的設定，並確認重新啟動或更新訂閱後仍符合預期，而不只是查看編輯器中的原始文字。
外部控制介面
external-controller・管理 API
外部控制介面可讓控制面板或用戶端讀取核心狀態、切換策略及管理連線，並由 external-controller 指定監聽位址。這是管理入口，不是供瀏覽器上網使用的混合連接埠，兩者不可互相取代。若僅供本機管理，建議限制在迴路位址、設定驗證並檢查防火牆；若要開放給區域網路，應先確認哪些裝置能存取此介面。