mihomo
代理核心負責處理代理協定、DNS、規則比對與連線轉送的核心程式；Clash Nyanpasu 則提供設定管理與圖形介面。介面上出現某個設定項目，不代表目前執行的核心一定支援該欄位，仍須確認核心能力。排查問題時應分別記錄用戶端版本、核心類型與生效設定，避免只憑用戶端名稱判斷行為。
REFERENCE / CLASH TERMINOLOGY
Clash 術語指南
從介面名稱找到對應的設定概念。依核心、欄位、規則、網路與用戶端五類查閱，釐清設定來源、執行參數與請求處理路徑。
首次設定可先閱讀 快速入門；需要完整欄位說明與 YAML 範例時，請參閱 YAML 手冊。本頁說明概念適用範圍，不應將某個開關的狀態直接視為實際連線結果。
TERMS / 01
核心與協定
用戶端負責設定管理與介面操作，核心負責執行網路邏輯。應用程式連線本機代理所用的協定，與節點連線遠端伺服器所用的協定，不一定相同。
代理節點
Proxy／出口定義一筆節點設定會描述遠端伺服器位址、連接埠、協定與驗證參數，通常位於 proxies 或代理集合中。節點不等於訂閱：前者是連線設定，後者是設定發佈方式。匯入節點後，請求仍須經過模式、規則與策略組選擇，不能只因節點存在就認定流量已經經由該出口。
HTTP 代理
應用程式接入協定應用程式明確連線至代理介面並提交請求，或透過 CONNECT 建立通道。此處的 HTTP 描述應用程式與本機代理之間的互動方式，不代表遠端節點只能處理網頁，也不表示所有連線都以明文傳輸。設定應用程式時，請填入本機實際監聽的位址與連接埠；HTTPS 目標的憑證驗證通常仍由應用程式負責。
SOCKS5
目標位址轉送協定應用程式透過 SOCKS5 將目標位址提交給代理並建立連線。此協定支援 TCP，也定義了 UDP 轉送機制。是否實際使用 UDP，須由應用程式、代理介面與後續連線路徑共同支援。網域名稱在哪裡解析，取決於應用程式提交的是網域名稱還是預先解析的 IP；不能只看代理類型就認定 DNS 解析路徑。
TLS
傳輸安全協定TLS 提供對端身分驗證、傳輸加密與完整性保護，可用於網頁連線，也可作為代理協定的傳輸保護層。交握失敗時，請檢查憑證、伺服器名稱、系統時間與連線可達性。略過憑證驗證會降低身分確認能力，應先找出憑證或名稱不符的原因，不要將略過驗證當成一般設定。
TERMS / 02
設定檔欄位
欄位名稱、層級與資料型別共同決定設定的意義。閱讀範例時，先確認欄位位於頂層、DNS 設定、節點定義或策略組內。
YAML
設定文字格式YAML 以縮排表示映射與清單，Clash 設定通常以 .yaml 或 .yml 儲存。縮排請使用空格，同一層級的欄位應對齊，清單項目則以連字號開頭。語法解析成功只表示結構可讀；欄位是否受支援、值是否有效，以及引用目標是否存在，仍須由實際執行的核心檢查。
mixed-port
HTTP 與 SOCKS 共用連接埠此欄位讓 HTTP 與 SOCKS 代理介面共用同一個本機監聽連接埠，方便不同應用程式連線至同一服務。它與遠端節點的 port 意義不同，也不會自動變更所有應用程式的代理設定。啟動時若顯示連接埠已被占用，請先確認占用中的程序，再修改監聽值，並同步更新依賴該連接埠的系統或應用程式設定。
mode
rule / global / direct通用欄位 mode 決定請求採用規則、全域或直連等處理模式。規則模式依據 rules 選擇策略，全域模式使用全域策略，直連模式則直接連線至目標。模式決定請求進入核心後的處理邏輯；系統代理與 TUN 則決定請求如何進入核心，因此切換全域模式不等於接管所有應用程式。
Fake-IP
DNS 合成位址映射在此 DNS 模式下，核心會向應用程式回傳合成位址，並維護位址與原始網域名稱的映射，讓後續連線仍可依網域名稱處理。合成位址並非目標網站的真實公網位址。少數依賴真實解析結果的應用程式可能需要設定過濾規則；調整後也應留意系統、瀏覽器與應用程式快取，避免舊結果影響判斷。
proxy-providers
代理集合來源此欄位定義可重複使用的代理集合來源，策略組可透過 use 引用其名稱。代理集合與完整 Profile 用途不同，不能假定集合檔案包含 DNS、規則或通用監聽欄位。更新失敗時，請分別檢查來源格式、取得路徑與策略組引用，再確認集合內容是否已納入最終執行設定。
TERMS / 03
策略組與規則
規則決定使用哪個策略，策略組則決定如何選擇出口。排查請求路徑時，應依序檢查命中的規則、目標策略與最終出口。
規則分流
Rules／請求分類規則分流依據網域名稱、IP 或其他請求屬性，選擇直連、拒絕或某個代理策略。規則通常由上而下檢查，命中第一條後便採用其目標，後續項目不會再為這次請求重新選擇。較精確的條件通常應排在較寬泛的條件之前；修改規則後，請查看新連線的命中記錄驗證，不要只看網頁是否開啟。
策略組
proxy-groups／出口組織策略組會將節點、其他策略組或內建策略整理成可供規則引用的目標。select 主要供手動選擇，url-test 依測試結果自動選擇，fallback 則著重依序切換至可用節點。名稱相同不代表行為相同；排查時也須檢查群組類型、成員來源與巢狀引用是否形成循環。
GeoIP
IP 地區資料庫GeoIP 依據本機資料庫為 IP 位址標示地區，用於 GEOIP 等規則比對。位址所屬地區不等於訪客所在地，也無法精確代表網站內容或法律管轄範圍。資料庫更新、內容傳遞網路與共用基礎設施都可能改變結果；若請求仍只有網域名稱，部分 IP 規則也可能觸發解析。
RULE-SET
引用外部規則集合RULE-SET 可在規則序列中引用由 rule-providers 定義的集合，讓較長的規則清單能獨立維護。集合的行為類型與檔案格式必須符合 provider 宣告，不能直接混用網域清單與完整規則清單。它在主要規則中的位置仍會影響優先順序；拆分至外部檔案並不會改變首條命中的規則順序。
MATCH
後備規則MATCH 是無條件命中的規則，通常放在 rules 最後，為尚未命中的請求指定預設策略。若放在前面，後續規則就沒有機會處理請求。目標可以是策略組或內建策略，但必須確認引用有效；後備採用直連或代理，應依設定目的明確決定。
TERMS / 04
網路與代理模式
流量接管、網域解析與出口選擇是不同環節。開關已啟用只能說明設定狀態，實際路徑仍須搭配連線記錄與系統網路設定確認。
系統代理
作業系統代理設定系統代理會將本機代理位址寫入作業系統設定，讓遵循該設定的應用程式將請求交由用戶端處理。自行實作網路堆疊的程式、部分命令列工具，或設定了獨立代理的應用程式，可能不會使用這條路徑。關閉用戶端後仍無法連網時，請檢查系統是否保留失效的代理位址，再判斷是代理設定還是網路本身出了問題。
TUN 模式
虛擬網路介面接管TUN 透過虛擬網路介面與路由設定，將符合條件的網路流量交由核心處理，常用於不遵循系統代理設定的應用程式。通常需要額外的系統權限，接管範圍也會受路由排除項目、協定支援與網路環境影響。啟用後仍須檢查 DNS 與規則，TUN 並非能自動修復所有網路問題的開關。
DNS 外洩
解析路徑偏離預期DNS 外洩是指查詢未經預期的解析路徑，而是送至其他解析器；是否構成問題，取決於事先設定的隱私與分流目標。瀏覽器安全 DNS、應用程式內建解析與系統 DNS 都可能形成獨立路徑。使用加密 DNS 只代表查詢傳輸受到保護，並不能證明查詢經由預期的代理出口；應一併檢查解析策略與路由。
allow-lan
區域網路代理存取allow-lan 控制是否允許區域網路裝置存取代理監聽服務，但實際連線能力仍取決於綁定位址、防火牆與無線網路隔離。其他裝置應填入執行用戶端那台裝置的區域網路位址，而不是自己的迴圈位址。開放存取前，請確認使用範圍並設定適當的驗證或存取控制，避免代理介面暴露範圍過大。
連線延遲
取決於測試目標與方式介面顯示的連線延遲通常是對特定測試位址發出請求所得，結果會受到 DNS、交握、目標回應與目前網路狀況影響。這不等於檔案下載速度，也不能代表所有網站的連線表現。比較時應使用相同的測試方式與目標；單次測試失敗時，也須搭配日誌判斷是測試網站無法連線、驗證失敗還是連線路徑異常。
TERMS / 05
用戶端介面
介面中的設定記錄不一定等同於磁碟上的最終執行檔。若遇到訂閱更新後設定還原、切換設定後未生效等情況，請先釐清設定來源與產生流程。
Profile
設定檔Profile 是用戶端管理的一份本機設定或遠端設定記錄，通常包含名稱、來源與更新設定等資訊。切換 Profile 會更換使用中的設定來源，但最終內容仍可能經過用戶端覆寫與合併。備份時應區分原始檔案、遠端來源記錄與覆寫內容；只複製產生後的執行檔，未必能還原原本的管理方式。
訂閱
遠端設定發佈訂閱透過 URL 發佈並更新設定或節點集合，回傳內容可能是 Clash YAML，也可能是其他用戶端格式。連結可以存取，不代表目前的用戶端能直接解析內容；匯入前須確認格式與用途。訂閱網址通常包含存取憑證，請視為敏感資訊妥善保存；排查問題或分享截圖時應遮蔽完整 URL，避免將來源資訊公開在網頁上。
覆寫與合併
從來源設定到執行設定覆寫是在來源設定上調整欄位；合併則是組合多個設定層，產生最終執行內容，常用於保留本機 DNS、監聽或規則設定。純量覆蓋、映射合併與清單取代的方式取決於用戶端實作，不能假設所有清單都會附加內容。修改後應檢視最終設定；直接編輯暫存產生的檔案，可能在下次更新或切換時被重新產生。
連線檢視
觀察請求路徑連線檢視可查看請求目標、命中規則與出口路徑，協助判斷應用程式是否進入核心，以及規則是否依預期執行。切換策略通常會先影響新連線，既有的長連線可能繼續沿用原有路徑。驗證修改時，請重新發出請求，或確認影響後關閉相關連線，再搭配網域名稱與規則記錄判斷，不必只憑存取結果猜測。
日誌層級
log-level／排查詳細程度log-level 控制輸出的詳細程度，常見值包括 info、warning、error 和 debug。啟動訊息不等於故障，單次連線錯誤也不代表整份設定失效；應依發生時間與目標請求一併判斷。暫時提高詳細程度後，請留意日誌可能包含存取網域或路徑；分享前先移除敏感內容，排查完成後再恢復常用層級。