OS · 01
Windows
適合需要以圖形介面管理訂閱、策略群組與系統代理的桌面使用者。下載前應確認系統架構，並優先選擇仍在維護的 Clash Plus、Clash Verge Rev、FlClash 或 Clash Nyanpasu；Clash for Windows 僅作為歷史封存項目辨識。
前往下載Platform entry · Plate 02
依系統進入下載清單
同一套 Clash 設定可由不同圖形用戶端或 mihomo 核心讀取，但安裝方式、系統權限與維護狀態並不相同。先確認裝置系統，再於下載頁比較用戶端，有助於避開架構不相容、舊專案停止更新與設定目錄混用等問題。
OS · 02
macOS
適合 Apple Silicon 與 Intel Mac。安裝套件必須符合處理器架構，首次執行還需完成系統網路權限與代理權限確認。圖形用戶端可用於日常切換策略；需要精細控制時，再檢查設定目錄、增強模式與系統擴充功能狀態。
前往下載OS · 03
Android
適合手機、平板與部分 Android 電視裝置。用戶端通常透過系統 VPN 介面接管流量，因此同一時間不能與其他 VPN 應用程式共同占用該介面。匯入訂閱後，應先選擇策略節點，再確認應用程式的電池最佳化與背景執行限制。
前往下載OS · 04
iOS
iPhone 與 iPad 透過系統網路擴充功能建立代理連線。下載頁提供 Clash Plus 的 App Store 入口與官方網站資訊。完成安裝後，可從訂閱網址或設定檔匯入內容，並在系統顯示的權限對話框中確認加入網路設定。
前往下載OS · 05
Linux
桌面環境可使用具備圖形介面的用戶端；伺服器、軟路由與無桌面系統則更適合直接執行 mihomo。部署時應區分二進位檔架構、設定目錄與服務帳戶，並明確由 systemd、容器或目前終端機負責程序生命週期。
前往下載Rule chain atlas · Plate 03
從請求進入到出站連線
Clash 的關鍵能力不只是開啟或關閉代理，而是將網域解析、規則判斷、策略選擇與系統流量接管串成一條可檢查的執行鏈。理解每個環節的輸入與輸出，設定修改與故障定位才不必反覆試錯。
Reading order
一般代理請求通常先進入本機監聽連接埠，再依設定處理 DNS 與規則；TUN 模式則從虛擬網卡接收更多系統流量。規則依設定檔中的順序由上而下比對，第一個命中的項目會決定目標策略群組。策略群組接著依手動選擇、自動測試或故障轉移結果決定具體出站連線。若網頁無法開啟，應依接管、解析、比對、選擇、連線的順序逐層檢查，而不是同時修改所有選項。
Specimen 01 · Matching
規則順序決定流量去向
規則會從設定檔頂端往下檢查，命中後立即停止。常見類型包括網域精確比對、網域後綴、程序、IP 網段、地理資料與兜底規則。自訂規則應放在可能提前攔截流量的寬泛規則之前，否則即使語法正確也不會生效。相較於只提供全域開關的代理工具，Clash 能將不同網站、程式與位址區段分配至獨立策略，同時保留可追蹤的比對紀錄。
修改時先記錄目標網域，再到連線或日誌頁面查看實際命中的規則。若結果不如預期，依序檢查規則位置、規則集是否更新、網域是否已解析為 IP，以及目標策略群組名稱是否存在。不要一開始就更換節點，因為節點連通與規則命中屬於不同環節。
DOMAIN-SUFFIX,example.com,PROXY網域後綴 → 代理策略GEOIP,CN,DIRECT位址區域 → 直接連線MATCH,FALLBACK未命中請求 → 兜底策略Specimen 02 · Selection
策略群組將規則與具體節點分離
規則通常不會直接指向某個固定節點，而是指向 select、url-test、fallback 或 load-balance 等策略群組。如此一來，更新訂閱或替換節點時，不必重寫整套規則。手動選擇群組適合需要明確控制出口的情境；自動測試群組依探測結果選擇可用項目；故障轉移群組則依序檢查，當目前出口無法使用時切換至下一項。
排查策略問題時，應同時查看規則指向的群組名稱與群組內目前的選項。若部分網站能開啟、部分網站逾時，可能是不同規則落入不同策略，而非系統代理整體失效。策略群組名稱會區分大小寫與空格，引用名稱必須與定義完全一致。
RULE
→
SELECT
→
OUTBOUND
Specimen 03 · Resolution
DNS 設定會影響網域判斷與連線目標
DNS 不只是將網域轉換為位址，也會影響網域規則是否可見、位址規則如何判斷，以及請求最終連線至何處。mihomo 可設定監聽位址、上游解析器、備用解析器、分流策略與 Fake-IP 模式。啟用 Fake-IP 後，用戶端會先回傳保留位址，再於內部保存網域映射，讓 TUN 流量仍能依網域規則處理。
如果 IP 位址可以存取但網域解析失敗，應優先查看 DNS 日誌、上游連線能力，以及系統是否仍在使用舊解析器。修改 nameserver、fallback 或 nameserver-policy 時應逐項測試，並保留目前可用的設定，避免將解析錯誤與節點連線錯誤混為一談。
DOMAIN
RESOLVER
RULE ENGINE
TARGET IP
Specimen 04 · Capture
TUN 接管不讀取系統代理的流量
部分程式不會遵循作業系統的 HTTP 或 SOCKS 代理設定，遊戲、命令列工具與特定系統服務也可能直接建立連線。TUN 模式透過虛擬網卡接收這類流量，再交由 mihomo 的 DNS、規則與策略鏈處理。它的涵蓋範圍更廣，但也牽涉系統管理員權限、路由表、網卡驅動程式與其他網路軟體之間的相容性。
啟用前應先確認一般系統代理已可正常使用，再單獨開啟 TUN。若開啟後全域斷網，依序檢查虛擬網卡是否建立、預設路由是否寫入、DNS 是否指向核心監聽位址，以及防火牆或其他 VPN 是否占用相同路徑。分階段驗證比反覆重新安裝用戶端更容易找出原因。
APP
VIRTUAL NIC
MIHOMO
NETWORK
mixed-port
同一連接埠可同時接受 HTTP 與 SOCKS5 代理連線，適合在桌面程式中統一填寫本機代理位址。
RULE
依規則表決定請求去向的常用模式，日常使用通常比全域模式更方便控制直連與代理範圍。
Fake-IP
透過保留位址維護網域映射，讓 TUN 接管的連線仍保留網域資訊並參與規則比對。
external-controller
供控制面板讀取執行狀態與修改策略的管理介面，對區域網路公開前需要設定存取控制。
Selected questions
常見問題精選
先依現象定位執行鏈中的具體環節，再進行單項修改。完整操作步驟可在使用文件中依序查閱。
匯入訂閱後為什麼沒有節點？
先確認訂閱回應是 Clash 或 mihomo 可讀取的 YAML 設定，而不是一般網頁、登入頁面或只包含其他用戶端格式的內容。接著查看訂閱更新紀錄中的解析錯誤，重點檢查縮排、策略群組引用與節點欄位。若訂閱需要授權，也要確認連結尚未過期。可繼續查看訂閱匯入步驟。
用戶端顯示已連線，瀏覽器仍然無法上網怎麼辦？
連線狀態只代表核心程序正在執行。還應檢查系統代理是否開啟、瀏覽器是否使用獨立代理設定、目前策略群組是否選中可用出口，以及 DNS 是否能回傳結果。建議先存取一個直連網站，再查看連線日誌中是否出現請求，藉此判斷問題位於流量接管之前還是規則處理之後。
規則模式、全域模式與直連模式應該如何選擇？
日常使用通常選擇規則模式，讓設定依網域、位址或程序決定流量去向。全域模式會將可接管的請求集中交給一個策略，適合暫時驗證節點；直連模式則繞過代理，可用於判斷故障是否來自代理鏈。三種模式改變的是流量決策，不會修復訂閱或節點本身的問題。
什麼時候需要開啟 TUN 模式？
當目標程式不讀取系統代理、需要接管命令列程式，或希望統一處理更多系統流量時，再考慮 TUN。應先讓一般代理模式穩定運作，再單獨啟用 TUN 並驗證網卡、路由與 DNS。如此即使發生斷網，也能明確判斷是基礎設定問題還是虛擬網卡接管問題。詳細順序請見使用文件。
Open source record · Plate 04
Clash 生態系與mihomo 核心
用戶端名稱相近，但圖形介面、核心程式與設定格式並不屬於同一層級。理解專案之間的關係，才能正確判斷更新來源、相容範圍，以及問題應回報至何處。
專案歷史：從 Clash 設定慣例到持續演進的生態系
Clash 建立了廣泛使用的 YAML 設定結構、規則類型與策略群組概念，之後出現了面向不同平台的圖形用戶端。原始專案停止維護後，生態系並未自動成為同一個新專案：不同用戶端採用了不同核心、介面框架與發行節奏。因此，名稱中包含 Clash 並不代表它們由同一位維護者發布，也不能只憑舊教學判斷目前的相容性。
選擇用戶端時，應同時查看介面專案與所附核心的維護狀態。舊設定通常可以遷移，但增強欄位、規則集格式、DNS 行為與 TUN 實作可能存在差異。下載中心依平台列出仍在維護的選項，並將停止維護的專案明確標記為封存用途。
開源生態系：介面、核心與規則資料各自協作
完整的執行鏈通常由圖形用戶端、mihomo 核心、訂閱設定與規則資料共同組成。圖形用戶端負責匯入設定、顯示策略群組、切換系統代理與管理程序；核心負責監聽連接埠、解析 DNS、執行規則並建立出站連線；規則集則提供網域、位址或應用程式分類。任一層更新失敗，都可能表現為節點缺失、規則未命中或請求逾時。
開放原始碼讓設定行為、參數定義與變更紀錄能由社群核對。遇到問題時，先確認故障屬於介面操作還是核心執行，再查看對應專案的文件與日誌。將所有問題歸因於用戶端名稱，會忽略真正發生錯誤的元件。
核心關係：mihomo 負責實際的網路處理
mihomo 是目前 Clash 生態系中常見且持續維護的核心，擴充了規則集、DNS、TUN、網域嗅探與外部控制等功能。許多桌面與行動用戶端會將它整合在圖形介面內，使用者點擊啟動後，真正監聽本機連接埠並處理連線的是核心程序。伺服器與軟路由環境則可略過圖形介面，直接執行核心。
設定是否可用，應以目前核心支援的欄位為準。某個用戶端能匯入檔案，不代表其中每個欄位都已依預期執行；反過來，核心支援的新欄位也可能尚未由介面提供可視化開關。需要精細設定時，應搭配執行日誌與實際產生的設定檔進行核對。
更新機制：分別檢查應用程式版本、核心與訂閱
用戶端更新、核心更新與訂閱更新是三條獨立流程。更新圖形用戶端可能帶來介面修正與新的核心版本，但不會自動變更訂閱服務提供的節點與規則；更新訂閱會替換設定內容，卻不一定升級本機程式。規則集也可能依自身更新時間下載，因此排查時要記錄具體是哪一層發生變化。
升級前建議保留目前可用的設定與自訂覆寫，完成升級後先驗證訂閱讀取、策略群組顯示、系統代理與 DNS，再逐步恢復 TUN 或複雜覆寫。如此可將相容性差異縮小至明確步驟，避免一次更新後同時面對多個變數。
Repository command
取得 mihomo 原始碼
以下命令會複製公開儲存庫，適合查閱設定定義、變更紀錄與建置說明。一般用戶端使用者不需要透過原始碼完成日常安裝。
git clone https://github.com/MetaCubeX/mihomo.git
Field notes · Plate 05
設定與排查最新文章
文章依具體任務拆分操作範圍，涵蓋 Linux 部署、執行日誌閱讀與區域網路代理共享。閱讀時可搭配目前用戶端的介面名稱，將文中的核心欄位對應至相應設定項目。