CLIENT ROUTES
先確認作業系統與處理器架構，再查看安裝套件及使用說明。
同一平台的安裝套件不一定可以互換。桌面裝置需確認處理器架構，行動裝置則要核對系統需求；安裝套件格式也應符合作業系統的安裝方式。初次使用可先選擇圖形介面用戶端，從設定頁匯入訂閱、在代理頁選擇策略，再查看記錄確認連線結果。只下載獨立核心，不會同時取得設定編輯器、系統匣選單或系統代理開關。
用戶端負責讀取設定並處理連線，訂閱內容則由設定提供者維護。安裝完成後，仍需準備可用的訂閱連結或本機設定檔。不要將任意網頁網址當成訂閱網址，也不必為了處理同一個設定錯誤而反覆安裝多個用戶端。原有設定能否遷移，取決於目標核心支援的欄位、協定及用戶端的覆寫機制，而非軟體名稱是否相似。
系統代理、行動裝置 VPN 與 TUN 是不同的流量接管方式。桌面系統代理通常只影響遵循該設定的應用程式；終端工具可能還需要另外設定代理環境變數。TUN 涉及虛擬網卡、路由與權限，建議基礎連線正常後再啟用。下載頁集中列出各平台入口與安裝說明，選擇差異可繼續查閱選型指南。
查看所有用戶端 →CONFIG ROUTEBOOK
從流量路徑理解欄位關係，按需查閱設定片段。
規則模式會依檔案順序檢查連線，符合條件後套用對應策略，不再繼續比對後續規則。網域規則適合明確的網站需求，位址規則適合已知網段；混用時要留意解析方式與涵蓋範圍。先列出優先處理的具體條件，再安排較寬泛的地區規則，最後以 MATCH 作為預設規則。規則目標可以是 DIRECT、REJECT，也可以是已定義的策略組名稱。排查時搭配連線記錄查看命中項目，比一再切換節點更容易找出問題。
設定側欄rules:
- DOMAIN-SUFFIX,local,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- DOMAIN-KEYWORD,github,Proxy
- GEOIP,CN,DIRECT
- MATCH,Proxy策略組可將節點或其他策略整理成可供規則引用的目標，讓規則保持穩定，也能個別調整出口。select 用於手動選擇，url-test 則依設定的測試條件挑選可用代理，兩者用途不同。範例中的 Proxy 是自訂名稱，規則引用時必須完全相同；大小寫或空格不同，都可能導致設定載入失敗。下方僅以內建策略展示引用結構；實際連線時，必須將設定中確實存在的節點或代理提供者加入策略組，不能只複製組名就當作完成設定。
proxy-groups:
- name: Proxy
type: select
proxies:
- DIRECT
- REJECT
rules:
- DOMAIN-KEYWORD,github,Proxy
- MATCH,ProxyDNS 負責將網域對應至位址，分流規則則決定連線的處理目標；兩者會互相影響，但並不相同。Fake-IP 透過映射位址保留網域關聯，Redir-Host 則以實際解析的位址為基礎。選擇方式時，應考量用戶端功能、流量接管方式與區域網路裝置相容性，不宜直接照搬整段設定。nameserver 是上游解析設定的一部分，不代表所有解析請求都必定走相同出口。若只有網域無法連線，先查看解析記錄，再判斷是上游連線、過濾清單還是路由問題。
dns:
enable: true
enhanced-mode: fake-ip
fake-ip-range: 198.18.0.1/16
fake-ip-filter:
- "*.lan"
- "*.local"
nameserver:
- 1.1.1.1
- 8.8.8.8上方範例分別展示規則、策略組與 DNS 的局部結構，並未包含實際代理伺服器。將片段加入既有設定前，先確認檔案中是否已有同名的頂層欄位：重複加入兩段 rules 或 dns，可能造成解析結果不同，也可能讓後面的內容覆蓋前面的內容。YAML 使用空格縮排，同一層級應保持一致，也要保留清單項目與上層欄位的關係。
用戶端介面中的開關不一定會直接修改原始訂閱檔案。有些設定會在執行時合併，有些則透過覆寫檔生效，因此應以目前的執行設定與記錄為準。需要長期保留的規則，優先使用用戶端明確支援的覆寫入口；直接編輯會自動更新的訂閱檔案，下一次更新時可能被取代。完整欄位關係與合併範圍請見設定完整指南。
SOURCE & MAINTENANCE
分清核心、用戶端與設定來源，確認資料是否適用於目前環境。
Clash 最初以規則式代理專案廣為人知，之後逐漸發展出涵蓋設定格式、圖形介面與不同核心的生態系。原始專案與部分早期用戶端停止維護後，社群仍沿著各自方向持續開發。搜尋結果中的舊教學可能對應舊版介面、過時核心或已封存的安裝套件，不能只憑標題中的 Clash 判斷是否適用。查閱時應一併確認用戶端名稱、使用的核心，以及說明所涉及的功能。
本站將舊版用戶端與目前可選方案分開說明，不以下載次數、評分或未經查證的社群規模作為選擇依據。已停止維護的用戶端可用於了解舊環境或遷移資料；日常安裝則建議優先選擇仍在維護且符合系統需求的方案。遷移前先保留原有設定與覆寫內容，再檢查代理協定、策略組引用、規則集路徑及啟動設定，避免只搬移訂閱連結而遺漏本機自訂內容。
mihomo 是 Clash 生態系中持續發展的開源代理核心，延續 Clash Meta 的發展路線。核心負責協定處理、規則比對、DNS 與網路連線等工作；圖形介面用戶端則提供訂閱管理、策略選擇、記錄檢視、系統代理與服務管理等操作入口。兩者的更新時程不一定一致。欄位是否可用，應查閱目前的核心文件與用戶端整合方式，而非推測所有名稱含 Clash 的用戶端都支援。
不同介面也可能以不同方式實作同一項功能。例如，開機自動啟動可能只開啟介面，也可能同時啟動背景服務；關閉主視窗可能只是將視窗收起，並不代表停止代理。判斷時應確認實際執行狀態，而不只看開關名稱。行動裝置還要分清系統 VPN 狀態與節點連線結果：系統顯示 VPN 已建立，只能表示流量接管通道已啟用，不能單獨證明目標網站可以連線。
mihomo 的程式碼與授權可在公開儲存庫中查閱。GPL-3.0 說明的是該專案的開源授權條件，不應據此推斷所有圖形介面用戶端或訂閱服務也採用相同條款。閱讀原始碼、發行說明與問題討論，有助於了解功能範圍與已知問題；使用軟體仍須遵守所在地法律、所屬網路的管理規定及相關服務條款。公開程式碼與實際執行設定是不同層面，仍應仔細確認設定來源。
本站提供用戶端與文件導覽，不代表所列出的所有專案，也不提供代理伺服器帳號或訂閱服務。訂閱連結可能包含存取憑證，分享記錄或螢幕截圖時，請遮蔽連結參數、帳號、伺服器位址等敏感資訊。遇到問題時，可說明作業系統、用戶端名稱、操作步驟與錯誤訊息片段，盡量保留診斷資訊，但不要將完整訂閱內容貼到討論區公開。
用戶端更新通常涉及介面與整合元件；核心更新可能改變協定支援或欄位行為；訂閱更新則會替換設定提供者發布的節點與規則內容。這三類操作應分開理解。訂閱更新成功，不代表用戶端也已更新；安裝新版用戶端，也不代表舊訂閱自動支援新功能。升級前先閱讀變更說明、備份目前可用的設定，並記下本機覆寫的位置，發生差異時才能逐項比對。
排查更新後的異常時，先確認設定是否成功載入，再檢查規則目標與策略組引用，最後比對 DNS、連接埠及流量接管方式是否有變化。不要同時修改所有設定，否則難以判斷是哪一步造成結果不同。下載頁集中列出用戶端入口，教學頁說明首次連線流程，設定完整指南則解釋欄位；依此順序查閱，能將安裝、設定與網路問題分開處理。
git clone https://github.com/MetaCubeX/mihomo.git先在設定頁確認訂閱已下載，且已選為目前使用的設定；不能只確認清單中有一筆記錄。接著在代理頁確認規則引用的策略組有可用目標，再選擇規則模式，並啟用適合目前裝置的流量接管方式。開啟一個明確的目標網站，查看連線記錄中的網域、命中規則與最終出口；若記錄中完全沒有這筆連線，應先檢查應用程式是否經過用戶端，而非直接判定節點失效。
如果只有部分網站能連線，可比較失敗與成功請求的差異：錯誤發生在解析階段，還是建立連線後逾時；是同一個策略組失敗，還是只有某條規則指向錯誤目標。延遲測試僅反映特定條件下的連線狀況，不能取代實際的服務請求。依照快速入門完成基本流程後，再逐項啟用 TUN、自訂 DNS、開機自動啟動等功能，排查時更容易掌握問題脈絡。
先確認設定已啟用，再檢查策略組選項、執行模式與系統代理；匯入成功僅表示設定已讀取。查看首次連線步驟 →
先確認請求是否進入用戶端，再判斷是解析失敗還是連線失敗，避免一次修改多個欄位。查看疑難排解問答 →
規則模式依規則選擇流量去向，全域模式使用全域策略，直連模式則直接連線；切換模式不等於切換流量接管方式。閱讀模式比較 →
使用用戶端支援的覆寫或合併機制，並檢查產生後的執行設定；不要只修改自動下載的原始檔案。查看覆寫與合併說明 →
READING NOTES
從設定結構、介面入口與代理模式繼續查閱。
依檔案由上而下解析通用欄位、dns、proxies、proxy-groups、rules 五大區段，說明縮排規則與區段間的引用關係。
閱讀設定結構 →逐一認識用戶端主介面各區塊：代理頁可選擇節點與測速，設定頁管理訂閱與更新，記錄頁則依級別檢視連線記錄與錯誤訊息。
閱讀介面導覽 →從 mode 欄位談起，說明三種模式下流量的處理方式、切換時機，以及規則模式中 MATCH 預設規則的用途。
閱讀模式說明 →