CLASH / CONFIG DICTIONARY
Clash 術語與設定欄位
從 mihomo 核心到 DNS 接管，依設定所在層級查找術語。先釐清概念再修改欄位，避免把協定問題當成縮排問題處理。
01 / CORE & CLIENT
核心與用戶端
介面負責管理，核心處理連線；訂閱與節點則是輸入資料。發生問題時，應分別檢查這幾個層面。
- mihomo 核心 core / Clash Meta 技術路線
- mihomo 是處理代理連線、規則比對與 DNS 請求的網路核心，延續 Clash Meta 的技術路線。圖形化用戶端通常會將它作為背景程序呼叫，因此介面版本與核心版本是兩回事。遇到欄位不支援或協定無法載入時，請先確認實際執行的核心版本，而不只是查看應用程式名稱。
- 圖形化用戶端 GUI / 設定管理與系統整合
- 圖形化用戶端將訂閱管理、策略選擇、檢視記錄與系統代理操作整合在可互動的介面中。能否提供某項功能，不只取決於核心，也取決於應用程式是否提供操作入口，以及系統是否授予權限。更換用戶端時，應分別確認設定內容與應用程式設定；後者通常不會隨訂閱一併移轉。
- 節點 proxy / 遠端連線參數
- 節點包含連線至代理服務所需的參數，常見項目有伺服器位址、連接埠、協定、驗證與傳輸設定。節點名稱只是清單中的顯示標籤，名稱標示某個地區，不代表實際出口一定位於該地區。排查時要區分網域解析失敗、連接埠無法連線與驗證失敗，反覆切換模式無法解決這些不同問題。
- 訂閱 subscription / 設定分發
- 訂閱透過網址分發並更新節點或完整設定檔；不同格式可能只包含節點，也可能包含策略群組與規則。更新成功表示取得及解析程序已完成，並不保證每個節點都能建立連線。連結參數可能含有帳戶憑證；提交記錄、截圖或使用訂閱轉換服務前，請先確認是否會將連結交給第三方。
- 延遲測試 latency / 指定目標請求耗時
- 用戶端通常會透過一次經過節點的測試請求顯示耗時，結果會受到測試網址、逾時設定與連線重用等條件影響。這不是單純測量伺服器 ping，也不是下載頻寬測試。若某個節點測試逾時，但部分網站仍可使用，請確認測試目標是否可連線；比較節點前，先統一測試條件。
02 / PROXY PROTOCOLS
代理協定
協定定義連線的建立方式，傳輸方式與 TLS 則屬於其他設定層。名稱相近不代表參數可以互換。
- Shadowsocks SS / 加密代理協定
- Shadowsocks 是常見的加密代理協定，連線時須確認伺服器位址、連接埠、加密方法與密碼一致。某些設定還需要特定協定版本或外掛支援，不能只複製位址和密碼。若匯入後顯示不支援該加密方法，請確認核心能力與原始設定；不要任意更換方法名稱，因為伺服器設定不會隨之改變。
- VMess 使用者識別碼 / 傳輸設定
- VMess 使用使用者識別碼等參數建立代理連線，並可搭配不同的底層傳輸方式。協定驗證、WebSocket 等傳輸設定與 TLS 憑證驗證屬於不同環節，任何一層不符都可能導致失敗。排查時請依原始設定確認使用者識別碼、傳輸類型、路徑與伺服器名稱；若系統時間明顯不正確，也應先修正。
- VLESS 輕量協定 / 安全層組合
- VLESS 是輕量代理協定，通常搭配 TLS 或 REALITY 等安全機制使用；協定名稱本身不代表完整的加密連線。用戶端必須同時支援所使用的傳輸方式、安全機制及其參數組合。匯入失敗時應查看核心回報的具體欄位；不能因為介面提供 VLESS 選項，就認定所有相關設定都受支援。
- Trojan TLS / 密碼驗證
- Trojan 通常透過 TLS 傳送代理流量，連線時須確認密碼正確，並符合憑證驗證條件。伺服器名稱、憑證鏈或系統時間異常，都可能造成連接埠可連線但交握失敗。遇到憑證錯誤時，請先確認名稱與憑證狀態；略過驗證會降低身分驗證的安全性，不應作為一般修復方式。
- Hysteria 2 QUIC / UDP 網路條件
- Hysteria 2 是以 QUIC 為基礎的代理協定，網路路徑必須允許相關 UDP 流量通過。網路能存取一般 HTTPS，不代表也允許這類連線；同一伺服器的 TCP 連接埠可連線，也不能取代 UDP 連通性檢查。若只有這類節點失敗，請先比較不同網路下的結果，再檢查驗證、憑證與伺服器參數。
03 / RULES & ROUTING
規則與分流
先確認流量已進入核心，再查看符合哪條規則。未被接管的連線，不會因新增規則而自動進入核心。
- 規則分流 mode: rule / 依序比對
- 流量進入核心後，規則分流會依網域、IP 等條件決定直連、拒絕或交由某個代理策略處理。規則模式通常由上往下比對，符合後便停止，因此具體網域規則應排在適用範圍較廣的規則之前。修改後請查看連線詳細資料中的符合規則與最終策略；只確認設定已儲存，無法證明分流結果符合預期。
- GeoIP GEOIP / IP 地理資料庫
- GeoIP 依據目標 IP 在地理資料庫中的歸屬紀錄進行比對，例如
GEOIP,CN,DIRECT。判斷依據不是網域後綴，CDN 位址變更與資料庫更新都可能影響結果。部分 IP 規則會觸發網域解析；排查時應一併查看解析結果、資料庫狀態，以及是否使用no-resolve參數。
- GeoSite GEOSITE / 分類網域集合
- GeoSite 依服務或主題整理網域集合，規則可直接引用集合名稱，不必逐一列出所有網域。實際提供哪些分類、各分類包含哪些網域，取決於所用資料檔與版本。規則載入失敗時，先確認該分類是否存在；若網站只有部分資源套用了錯誤策略，再檢查相關子網域是否收錄其中。
- 策略群組 proxy-groups / 節點選擇邏輯
- 策略群組可組合多個節點或其他策略，提供手動選擇、依測試結果選擇或故障切換等功能。規則中的目標群組名稱必須與設定定義完全一致；更名後也要同步修改引用。自動選擇取決於測試目標與檢測週期，不代表系統能即時掌握每個網站的使用體驗；了解群組類型，比看到「自動」就放心更重要。
- MATCH 預設規則 / 最後一條
MATCH用來處理前面規則都未符合的連線，通常放在規則清單末尾，例如MATCH,PROXY。其中的PROXY必須是實際存在的策略名稱，不能把它當成可直接套用的保留群組名稱。預設規則只處理已進入核心的流量，不能取代系統代理或 TUN 的流量接管功能。
04 / DNS & NETWORK STACK
DNS 與網路堆疊
流量接管與網域解析是彼此相關的兩條路徑。啟用一項設定，不代表另一條路徑也已設定完成。
- TUN 模式 虛擬網路介面 / 路由接管
- TUN 模式透過虛擬網路介面與路由，將符合條件的流量送進核心，可涵蓋部分不使用系統代理的應用程式。能否接管仍受系統權限、路由、排除項目與其他 VPN 軟體影響，不代表所有連線都一定經過代理。啟用失敗時，先檢查服務權限與啟動記錄；啟用後再確認路由與 DNS，不要只看開關狀態。
- Fake-IP enhanced-mode: fake-ip / 網域映射
- Fake-IP 模式會回傳映射位址給應用程式，並由核心保存映射關係，讓後續連線仍能對應原始網域並比對規則。應用程式顯示映射網段位址通常是正常設計，不代表解析器故障。依賴真實 IP 的應用程式可能需要加入
fake-ip-filter；過濾條件應只針對有問題的網域，不宜直接排除所有網域。
- DNS 洩漏 解析路徑 / 預期路徑之外的請求
- DNS 洩漏是指解析請求繞過預期路徑，例如原本應經由指定解析路徑的請求，卻直接送往其他解析器。檢測網站顯示某地區的解析器，不能單獨作為洩漏判斷；還須考量直連規則與上游設計。排查時一併檢查系統 DNS、瀏覽器安全 DNS、其他 VPN 及加密解析設定，修改後再以相同條件重新測試。
- dns-hijack tun.dns-hijack / DNS 接管入口
dns-hijack是 TUN 設定中的接管選項，用來將符合條件的 DNS 流量交由核心內建解析器處理。接管傳統 DNS 連接埠，不代表能自動辨識並攔截瀏覽器發出的所有加密 DNS 請求。若規則設定完成後仍發現解析繞行，請確認請求是否經過 TUN，以及應用程式是否另行使用 DoH 或 DoT。
- nameserver 與 fallback DNS 上游 / 結果選擇條件
nameserver指定內建 DNS 使用的上游解析器；fallback則配合過濾條件參與解析結果的選擇。不能單純將它理解為「主要解析器逾時後才啟用的備用位址」，還須查看fallback-filter等設定。若啟用了網域策略或依規則解析的選項，也應一併確認，避免將複雜的解析路徑誤判為單一上游故障。
繼續排查：DNS 洩漏檢測與 Fake-IP 修正，或查看mihomo DNS 欄位逐項說明。
05 / YAML & CONFIG FIELDS
設定檔欄位
欄位值、所在層級與最終生效的檔案都需要一併確認。用戶端表單上的名稱不一定等同 YAML 欄位名稱。
- YAML 設定格式 / 以縮排表示階層
- YAML 是 Clash 系列常用的設定格式，以縮排表示階層關係，以連字號表示清單項目。縮排請使用空格而非定位字元，並保持同一層級一致；含特殊字元的字串須依語法正確加上引號。解析成功只代表格式正確，不代表目前的核心支援所有欄位，仍須查看載入記錄與最終設定。
- mixed-port HTTP + SOCKS / 代理監聽連接埠
mixed-port讓同一個連接埠同時接收 HTTP 與 SOCKS 代理請求，常見範例值為7890，實際設定請以目前執行的設定檔為準。應用程式填入的代理位址與連接埠，必須對應核心實際監聽的位置。若記錄顯示連接埠已被占用，請關閉衝突程序或更換連接埠，並同步修改使用該連接埠的系統與應用程式設定。
- allow-lan 區域網路存取 / 監聽範圍
allow-lan控制是否允許區域網路裝置存取用戶端的代理監聽服務，不會啟用目前裝置本身的代理。設為true後能否連線，仍取決於綁定位址、防火牆與無線網路隔離等條件。確實需要分享代理時，請限制可信任的來源並視需要設定驗證，不要將代理監聽連接埠直接轉發至公用網路。
- external-controller 控制 API / 非代理連接埠
external-controller定義管理介面的監聽位址，控制面板透過它查詢連線、切換策略或執行其他管理操作。它與mixed-port用途不同；將管理連接埠填入瀏覽器的代理設定，無法正常代理網頁。請優先限制為本機存取，並設定控制介面驗證；開放遠端存取前，也要確認防火牆與網路暴露範圍。
- 覆寫 override / 用戶端設定合併機制
- 覆寫通常是指用戶端以訂閱為基礎，合併本機欄位、追加規則或執行設定修改指令碼的機制，並非所有用戶端通用的頂層欄位。這可用來保留本機 DNS、連接埠或分流調整，減少訂閱更新後重複修改的工作。不同實作可能會追加或取代清單；修改後務必檢查產生的最終設定，不能只看覆寫編輯器中的內容。