DESKTOP / 01
Windows
適合日常桌面環境。下載前先在「設定 → 系統 → 系統資訊」確認 x64 架構，再從 Clash Plus、Clash Verge Rev、FlClash 等圖形用戶端中選擇。安裝完成後，需在設定頁匯入訂閱，並另外開啟系統代理或 TUN 模式；用戶端正在執行不代表流量已經接管。
前往下載SUBSCRIPTION CONFIG MANUAL
Clash 訂閱教學
用戶端設定與訂閱匯入
依裝置選擇用戶端，依序完成訂閱連結匯入、策略組檢查與流量接管。每個步驟都對應用戶端中的實際入口與可核對狀態。
設定流程可檢查
永久免費
程式碼開源
多平台用戶端
中文操作文件
訂閱網址只負責提供設定。匯入後仍需確認目前設定、策略組、代理模式與系統接管狀態。遇到連線問題時，依這條流程逐段檢查，比反覆重新安裝用戶端更容易找出原因。
PLATFORM OUTPUT
依裝置前往用戶端下載頁
先確認作業系統，再選擇仍在維護且適合目前裝置架構的用戶端。首頁入口只負責切換至對應平台，安裝套件、系統需求與用戶端差異統一在下載頁核對。
DESKTOP / 02
macOS
先透過「關於這台 Mac」區分 Apple 晶片與 Intel 處理器，兩類安裝套件不能混用。首次啟動時，系統可能要求確認開啟應用程式、網路延伸功能或管理員權限。訂閱匯入成功後，先使用系統代理驗證瀏覽器流量，再根據終端機、開發工具與其他應用程式的覆蓋需求決定是否啟用 TUN。
前往下載MOBILE / 03
Android
多數近年裝置可使用 ARM64 安裝套件；無法確認架構時，可在下載頁查看通用套件與其他架構說明。Android 用戶端通常透過系統 VPN 介面接管流量，首次連線會出現 VPN 授權提示。匯入訂閱後應檢查目前設定、策略組選擇與背景執行權限，避免系統省電策略提前中斷連線。
前往下載MOBILE / 04
iOS
iPhone 與 iPad 透過 App Store 安裝 Clash Plus。匯入訂閱時可複製完整連結後在應用程式內新增，也可使用服務提供者提供的跳轉入口。首次連線需要允許新增 VPN 設定。若設定已更新但策略沒有變化，應返回應用程式確認目前使用的設定檔與策略組，而不是只查看系統狀態列中的 VPN 標記。
前往下載DESKTOP / 05
Linux
桌面環境可選擇 Clash Verge Rev 或 FlClash；伺服器、軟路由與自動化環境則更適合直接執行 Mihomo 核心。使用圖形用戶端時仍要確認軟體套件格式與發行版相符；使用核心時還需自行管理設定檔路徑、啟動參數、服務權限與日誌。兩種使用方式的操作入口不同，不應混用教學步驟。
前往下載SELECTION CHECK
平台相同，用戶端也需要依維護狀態與使用方式選擇
圖形用戶端適合需要系統匣選單、策略組選擇、系統代理開關與設定更新介面的桌面使用者；核心程式更適合熟悉命令列、服務管理與 YAML 設定的伺服器或路由器環境。舊用戶端仍可能可以啟動，但停止維護後不會繼續支援新的核心欄位與作業系統變化。遷移時應優先保留訂閱網址、覆寫內容與自訂規則，再在新用戶端中重新檢查接管方式。
裝置架構是另一個獨立條件。Windows 常見為 x64，macOS 需要區分 Apple Silicon 與 Intel，Android 則可能出現 ARM64、ARM 或通用套件。安裝套件名稱中的架構標記必須與裝置相符。若下載後無法安裝，先核對架構與系統版本，不要連續嘗試不同來源的同名安裝套件。
查看所有用戶端與系統需求 →RECEIVE CHAIN
從訂閱輸入到流量輸出
Clash 設定不是單一開關。訂閱解析、策略分流、DNS 處理與自動更新會依序作用於同一條流程。左側頻道用於切換檢查項目，朱紅色標記表示目前說明位置。
CONFIG INPUT / CHANNEL 01
訂閱連結會先轉換為本機設定
用戶端存取訂閱網址後，讀取其中的代理節點、策略組、規則與可能附帶的 DNS 欄位，再儲存為本機設定。匯入成功只表示內容已寫入用戶端，不代表該設定已設為目前設定，也不代表流量已進入代理流程。操作時應核對設定名稱、更新時間與目前選取狀態，然後開啟策略組確認節點項目是否正常出現。
如果匯入後內容為空，優先檢查連結是否複製完整、訂閱是否仍然有效，以及用戶端是否能存取訂閱網址。網頁中能開啟一段文字不代表用戶端一定完成解析；回傳格式、重新導向方式與欄位相容性都會影響結果。重新匯入前可先執行一次手動更新，並查看用戶端日誌中的設定載入提示。
- 確認訂閱網址沒有缺少參數或多餘空格
- 確認新設定已切換為目前使用項目
- 確認節點、策略組與規則區段都已載入
RULE PROCESS / CHANNEL 02
策略組決定規則命中後的實際出口
規則負責判斷網域、IP、程序或網路類型應進入哪個策略組，策略組再決定使用指定節點、自動選擇、故障轉移、直連或拒絕。節點測試結果只用於輔助選擇，不會取代規則比對。排查某個網站的連線問題時，應先確認目前模式，再查看請求命中了哪條規則、進入哪個策略組，以及該組目前選擇了什麼出口。
全域模式會把大部分連線交給統一出口，規則模式依規則清單由上到下比對，直連模式則跳過代理節點。日常使用通常從規則模式開始。自訂規則需要放在正確位置，因為前面的寬泛規則可能提前命中，使後面的精確規則失效。切換節點後還應等待既有連線結束，再重新發起請求進行驗證。
- 先檢查執行模式，再檢查規則命中結果
- 確認策略組沒有誤選為直連或拒絕
- 修改規則後重新載入設定並建立新連線
NAME RESOLUTION / CHANNEL 03
DNS 設定會影響網域解析與規則判斷
Clash 可以接管 DNS 查詢，並將解析結果交給規則系統繼續處理。Fake-IP 模式透過虛擬位址建立網域對應，方便在連線階段保留網域資訊；Redir-Host 模式則更接近回傳真實解析結果。兩種模式沒有固定的通用答案，應根據系統環境、區域網路服務、遊戲程式與特殊應用程式的相容性選擇。
出現網頁網域無法開啟但直接存取 IP 正常、區域網路裝置名稱失效或應用程式反覆重新連線時，需要將 DNS 納入排查範圍。先確認 DNS 功能是否啟用、監聽連接埠是否衝突、上游伺服器是否可達，再檢查 Fake-IP 排除清單。系統、瀏覽器與用戶端可能各自快取解析結果，修改設定後應清除快取或重新啟動相關應用程式再驗證。
- 確認 DNS 監聽連接埠沒有被其他程式佔用
- 區域網路網域與特殊網域依需求加入排除項目
- 修改解析模式後清除既有連線與 DNS 快取
CONFIG REFRESH / CHANNEL 04
自動更新只會重新整理訂閱，不取代設定檢查
支援訂閱更新的用戶端可以依設定的間隔重新取得設定。更新可能帶來節點增減、策略組調整與規則變化，因此更新完成後應確認目前設定仍然有效，常用策略組的選擇沒有被重設。若用戶端支援設定覆寫，應確認覆寫發生在訂閱內容之前還是之後，避免本機修改在下一次更新時被取代。
自動更新失敗時，先執行手動更新並查看錯誤訊息。常見檢查順序是訂閱網址、網路可達性、系統時間、設定格式與儲存權限。頻繁縮短更新間隔不會改善連線品質，反而可能產生重複請求。合理做法是使用用戶端支援的常規間隔，並在服務提供者通知設定變更後執行一次手動重新整理。
- 保留原始訂閱網址並記錄必要的本機覆寫
- 更新完成後重新檢查策略組目前的選擇
- 失敗時查看日誌，不要連續重複點擊更新
OPEN SOURCE RECORD
開源核心、設定界線與更新依據
Clash 生態系由核心、圖形用戶端、設定格式與社群維護專案共同組成。判斷用戶端是否適合繼續使用，應查看程式碼、發佈紀錄、核心相容性與作業系統支援，而不是只看介面名稱。
HISTORY / 01
專案演進：用戶端名稱相近，維護狀態並不相同
Clash 最初形成了規則比對、策略組與 YAML 設定等常用操作方式，之後出現了面向不同平台的圖形用戶端。部分原有專案停止維護後，社群仍持續圍繞相容核心與新用戶端推進功能。現在搜尋「Clash 用戶端」會看到多個名稱相近的程式，它們可能使用不同核心、不同介面層與不同發佈管道。
選擇時需要分別確認三個問題：用戶端最近是否仍有維護活動、所附核心是否支援目前訂閱欄位、安裝套件是否符合裝置的系統與架構。舊教學中的選單名稱也可能與新用戶端不同，但設定流程仍可依「匯入設定—選擇策略—啟用接管—檢查日誌」的順序理解。
ECOSYSTEM / 02
開源生態：核心與圖形介面各自負責不同職責
Mihomo 等相容核心負責解析設定、建立連線、執行規則、處理 DNS 與提供控制介面；Clash Plus、Clash Verge Rev、FlClash 等用戶端則在核心外提供安裝、設定管理、系統匣操作、系統代理開關與視覺化日誌。圖形用戶端是否易用，與核心是否支援某項設定是兩個不同問題。
排查故障時也應區分界線。安裝失敗通常屬於系統與用戶端層；YAML 錯誤屬於設定解析層；網站被錯誤分流屬於規則或策略層；部分應用程式沒有進入代理則多半與系統代理、TUN 路由或應用程式本身的網路實作有關。明確問題所在層級，可以減少無關設定的變更。
CORE RELATION / 03
核心關係：介面設定最終會轉換為設定與啟動參數
用戶端中的「規則模式」「允許區域網路」「TUN 模式」「DNS 增強模式」等開關，最終會寫入設定欄位或轉換為核心啟動參數。介面隱藏了欄位細節，但不會改變底層作用。需要遷移用戶端時，訂閱網址通常可以重新匯入，自訂覆寫、腳本、規則提供器與本機 DNS 例外則需要另外整理。
直接使用核心的使用者需要自行維護設定路徑、控制連接埠、服務啟動與日誌輪替；圖形用戶端會代管其中一部分。兩種方式都使用相同或相近的設定概念，但操作路徑不能直接照搬。本網站的入門教學以圖形用戶端為主，設定欄位頁則依 YAML 層級解釋核心實際讀取的內容。
UPDATE POLICY / 04
更新機制：分別處理用戶端、核心與訂閱設定
用戶端更新用於修正介面、安裝與系統相容性問題；核心更新用於增加協定、規則、DNS 與路由能力；訂閱更新只負責重新整理服務提供者交付的設定。這三種更新互不取代。連線正常時不必為了追逐版本而頻繁變更所有元件，遇到相容性問題時則應先確定變化發生在哪一層。
執行用戶端升級前，建議記錄目前的訂閱網址、策略組選擇與本機覆寫。升級後先檢查設定能否載入，再檢查系統代理或 TUN 權限是否保留。訂閱自動更新後若出現策略變化，應對照更新時間與設定內容，而不是直接回退用戶端。日誌中的欄位錯誤、權限錯誤與網路錯誤應分別處理。
SOURCE CHECKOUT
讀取 Mihomo 原始碼與提交紀錄
需要核對核心行為時，可從公開儲存庫查看設定實作、問題紀錄與發佈說明。複製命令只用於取得原始碼，不會安裝圖形用戶端，也不會自動產生可用訂閱。一般使用者應從用戶端下載頁選擇安裝套件；開發者與路由器維護者則可配合建置文件繼續處理。
git clone https://github.com/MetaCubeX/mihomo.git
QUICK DIAGNOSIS
常見問題精選
以下問題用於快速判斷檢查方向。完整操作步驟、平台差異與故障處理可繼續前往說明中心。
訂閱匯入成功，為什麼瀏覽器仍然直連？
先確認匯入的設定已設為目前設定，再檢查用戶端是否開啟系統代理。僅啟動用戶端或選取節點，不會自動修改所有應用程式的網路入口。若瀏覽器使用獨立代理設定、擴充功能或安全 DNS，還需要檢查這些設定是否覆蓋了系統代理。
系統代理和 TUN 模式應該先用哪一個？
桌面環境建議先使用系統代理，驗證瀏覽器與遵循系統設定的應用程式。只有當遊戲、終端機、商店或其他程式不讀取系統代理時，再評估 TUN 模式。TUN 的覆蓋範圍更廣，但需要額外權限，也可能與虛擬機器、其他 VPN 或安全軟體的網路驅動程式發生衝突。
更新訂閱後，原本選擇的節點為什麼變了？
訂閱更新可能重建策略組或修改節點名稱，原本的選取項目不存在時，用戶端會回到策略組預設值。更新後應開啟常用策略組，重新確認出口。若用戶端支援覆寫，可以在了解合併順序後固定部分本機設定，但不要直接修改會在下一次更新時被覆蓋的訂閱檔案。
只有部分應用程式無法連線，應先檢查什麼？
先判斷這些應用程式是否讀取系統代理，再查看請求是否進入用戶端日誌。日誌中沒有紀錄時，問題通常出在流量入口；有紀錄但規則不符時，檢查規則與策略組；網域解析異常時，再檢查 DNS 模式、快取與排除項目。依入口、規則、出口、DNS 的順序定位。
CONFIG NOTES
近期設定文章
文章分別從設定結構、接管方式與用戶端遷移展開。需要處理單一問題時，可直接進入對應主題，不必從頭閱讀完整入門流程。
Clash 設定檔 YAML 結構解析：從基礎欄位到規則區段的完整順序
依實際載入順序拆解連接埠、DNS、代理節點、策略組與規則欄位，並說明縮排、引用與欄位覆寫關係。
適合已完成訂閱匯入、準備讀取或修改設定檔的使用者。文章重點說明各區段之間的引用關係，以及為什麼欄位存在卻仍可能沒有進入實際執行設定。
Clash TUN 模式與系統代理的差異：流量入口、覆蓋範圍與選擇方法
從工作層級、應用程式相容性、DNS 處理與權限要求比較兩種接管方式，提供常見裝置環境下的選擇依據。
適合處理「瀏覽器正常但其他應用程式沒有連線」或「TUN 開啟後網路異常」等問題。文章依流量入口解釋差異，並列出切換前需要核對的權限、路由與衝突項目。
Clash for Windows 停止維護後如何遷移：用戶端替代方案與設定轉移步驟
整理仍可繼續使用的用戶端，說明訂閱、覆寫規則與系統代理設定如何遷移，並列出切換前後的檢查項目。
遷移重點不是複製舊程式目錄，而是分離可重複使用的設定與用戶端專屬狀態。文章說明訂閱、覆寫、自訂規則與接管設定分別應如何記錄與重新建立。