適合桌面工作與需要圖形介面設定的使用者。下載前請前往系統的「關於」確認裝置資訊，安裝後再檢查服務模式與系統代理。
Clash Plus、Clash Verge Rev 等客戶端的下載入口集中於同一個平台頁面。遇到視窗閃退時，先記下錯誤訊息，再檢查執行環境與連接埠是否被占用；反覆覆蓋安裝通常無法找出故障原因。初次測試時只啟用一個代理客戶端，避免多個程式互相修改系統代理設定。
前往下載Clash 設定檔與常用功能
從一項設定開始，釐清訂閱、核心與系統網路各自的用途。
網頁可以開啟，但某個應用程式一直連線失敗，通常應先確認該應用程式的流量是否經過客戶端。訂閱可以匯入，但啟用時出現錯誤，則應先檢查設定欄位與核心支援情況。以下整理五類功能的操作入口；範例僅呈現部分設定，不能取代包含代理與策略群組的完整檔案。
規則分流
依目標比對，不必反覆切換全域模式
需要讓內網位址直連、其他請求依策略處理時，先將代理模式設為「規則」。核心會由上而下檢查規則，符合第一條後便停止，因此具體網域應放在較廣泛的規則之前，MATCH 則放在最後。相較於只靠全域開關，規則可以為不同用途保留各自的連線路徑。修改後前往「連線」查看符合的規則與策略；如果更新訂閱會覆蓋本機修改，建議使用客戶端的覆寫功能儲存自訂內容。
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,DIRECT此片段僅示範語法，三條規則皆為直連；實際代理策略須參照設定中既有的策略群組。
查看規則順序與 MATCH 說明 →mihomo 核心
先確認核心，再檢查欄位支援情況
設定提示不支援某種協定或出現 unknown field 時，先查看客戶端使用的核心。mihomo 延續 Clash Meta 專案，擴充了協定、規則集與流量嗅探等功能；桌面視窗只是操作入口，不代表所有客戶端都支援相同欄位。與原版核心設定相比，遷移時應逐項確認擴充欄位，而非只更改檔名。先執行最小可用設定，再逐步啟用擴充功能，有助於縮小錯誤範圍，也方便復原。
mode: rule
log-level: info
ipv6: false基本欄位範例。是否需要 IPv6，應依目前的網路與訂閱狀況判斷。
查看 mihomo 與原版核心的差異 →訂閱管理
分清下載成功與設定啟用成功
匯入連結後，先確認訂閱卡片已出現，再選取它作為目前設定。清單中看得到訂閱，不代表核心已載入；也應檢查記錄中是否有解析錯誤。相較於直接編輯下載的檔案，使用客戶端覆寫功能更適合保留連接埠、規則等本機設定，避免更新後遺失。更新失敗時，先確認連結有效期限、回傳內容與擷取路徑，再判斷是否需要透過代理更新。訂閱網址可能包含存取憑證，請勿將完整連結貼到公開討論區。
profile:
store-selected: true
store-fake-ip: true此設定用於儲存策略選擇與 Fake-IP 對應，不負責下載訂閱，也不包含訂閱網址。
查看匯入訂閱的操作方式 →TUN 模式
處理不遵循系統代理設定的應用程式
瀏覽器正常，但終端機或其他應用程式無法連線時，可先確認應用程式是否支援手動代理。系統代理只會影響遵循相關設定的程式；TUN 則透過虛擬網路介面接管符合路由條件的流量。啟用前請確認客戶端的服務模式或管理員權限，並暫停其他 VPN，以免路由衝突。TUN 不是解決連線問題的萬用開關：如果節點本身無法使用，啟用後仍會失敗。變更設定後，也請檢查 DNS、連線記錄與區域網路存取。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: truemihomo 局部設定範例；實際權限與 DNS 接管方式取決於平台及客戶端。
查看 TUN 與系統代理故障排除 →跨平台設定
沿用規則，分別設定系統選項
同一份訂閱在電腦上可用，手機卻載入失敗時，別直接認定連結已失效。先比較兩端的核心、協定支援與設定格式，再檢查本機檔案路徑等平台相關欄位。規則與策略群組通常較容易沿用；TUN、系統代理與啟動服務則須依裝置設定。比起複製整個客戶端資料目錄，移轉訂閱並重新設定本機選項更容易排除問題。請使用空格縮排 YAML；匯入後先確認基本連線，再逐步還原自訂規則。
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info連接埠僅供示範，客戶端實際監聽的連接埠可能會被介面設定覆寫。
查看設定移轉與連線驗證 →Clash 全平台下載入口
先確認作業系統與處理器架構，再選擇客戶端。
Clash 是一套客戶端生態系，並非所有裝置都安裝同一個程式。下載頁依作業系統列出可選客戶端，並標示推薦項目與已停止維護的封存版本。初次使用可從 Clash Plus 開始；熟悉特定客戶端的使用者，則可依設定相容性繼續選用。安裝客戶端不會自動產生訂閱，連線所需的設定須由你有權使用的服務提供。
先在蘋果選單的「關於這台 Mac」確認裝置使用 Apple Silicon 還是 Intel，再下載相符架構的安裝檔，以免安裝錯誤而無法啟動。
Clash Plus、Clash Verge Rev 與 FlClash 提供不同的操作介面。首次開啟時，請依系統提示完成授權；若涉及網路延伸功能或輔助服務，請先閱讀相關說明。若瀏覽器仍使用舊的代理設定，請檢查系統網路設定，不要同時開啟多個客戶端。移轉設定時也要重新確認本機路徑。
前往下載手機與平板使用者請先確認處理器架構，再選擇相容的安裝套件。首次建立連線時，系統會要求授權 VPN 連線。
Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 支援的設定各有差異，不能只憑檔案副檔名判斷是否相容。若螢幕關閉後連線中斷，請檢查電池最佳化、背景執行權限與網路切換記錄。應用程式分流也可能決定哪些程式會經過代理，請一併檢查目前客戶端的相關設定。
前往下載iPhone 與 iPad 使用者可在下載頁前往 Clash Plus 的 App Store 頁面，安裝後依應用程式提示新增設定並授權 VPN。
初次使用前，請確認 App Store 頁面的系統需求，再確認是否支援你的訂閱格式。Clash Plus 官方網站為 clashplus.io，可供查閱產品資訊。若切換網路後連線異常，先確認應用程式狀態與系統 VPN 狀態是否一致，再重新測試；避免同時修改訂閱、DNS 與路由。
前往下載桌面使用者請依發行版選擇合適的套件格式。下載頁提供 Clash Verge Rev 與 FlClash，使用前請確認桌面環境與所需相依套件。
伺服器或路由器使用者可另行查看核心專區，但命令列核心不包含圖形介面，也不會自動為所有程序設定代理。終端機程式可能需要另外指定代理參數。使用服務管理工具執行時，請留意執行使用者、工作目錄與設定檔讀取權限；先在前景確認啟動成功，再設定背景執行。
前往下載Linux 企鵝圖示：Font Awesome，CC BY 4.0。
安裝前後常見問題
先判斷問題發生在安裝、載入設定，還是實際發出請求的階段。每次只調整一項設定並記錄測試結果，比一次切換所有開關更容易找出原因。
安裝完成後，為什麼還是無法上網？
先確認關閉代理時原本的網路可以正常使用，再檢查客戶端是否已選取並成功載入訂閱。接著確認代理模式、策略群組選擇與系統代理狀態。如果只有某個應用程式失敗，請查看它是否遵循系統代理；若所有請求都失敗，再到記錄中確認具體錯誤。安裝完成不代表已建立連線；安裝檔、訂閱設定與可用的出站連線是不同環節。詳細操作請參閱訂閱設定教學。
Clash 訂閱更新失敗，需要重新安裝嗎？
通常應先檢查連結是否過期、是否完整複製，以及伺服器回傳的是設定檔還是網頁。若成功下載卻無法載入，應改為檢查設定格式與協定支援。重新安裝無法修復失效的訂閱連結；請保留目前可用的設定，記下更新時的錯誤，再依照故障排除說明判斷是網路請求還是解析失敗。
系統代理和 TUN 模式需要同時啟用嗎？
不必預設兩者都要啟用。先使用系統代理確認瀏覽器能否連線；需要接管其他應用程式時，再依客戶端說明啟用 TUN。兩者處理流量的入口不同，是否搭配使用取決於平台實作與實際需求。啟用 TUN 後，請檢查路由、DNS 與其他 VPN 是否衝突，不能只看開關狀態。可依照基本設定步驟逐項確認。
設定開機時啟動後，為什麼代理沒有自動恢復？
開機時啟動通常只決定客戶端是否啟動，不保證訂閱載入、服務啟動與系統代理恢復都能成功。先登入系統，查看客戶端狀態與記錄，再確認啟動項目是否遭系統封鎖。若使用 TUN，也要確認服務是否正在執行。先手動完成一次正常連線，再排查自動啟動流程，避免混淆訂閱錯誤與啟動權限問題。設定入口請見客戶端使用教學。
專案來源與維護範圍
Clash、Clash Meta 與 mihomo 的關係
釐清客戶端介面、代理核心與訂閱來源，再判斷需要更新哪個部分。
本站整理安裝入口與中文操作資料，並非所有客戶端的開發者，也不提供代理節點。下載與故障說明應搭配上游專案資訊及裝置環境參考。遇到不支援的欄位、服務無法啟動或訂閱回傳錯誤時，先確認負責該環節的元件，才能找出明確的處理方向。
專案沿革：名稱相近，維護路線不同
原版 Clash 建立了以 YAML 設定、策略群組與規則分流為核心的使用方式，後續也出現多種衍生核心與圖形介面客戶端。mihomo 延續 Clash Meta 的開發路線，因此舊教學中的 Clash Meta 與目前文件中的 mihomo，通常屬於同一條演進脈絡；不過，具體欄位仍應以目前使用的核心文件為準。
部分舊客戶端已停止維護，安裝入口會保留封存標示。封存程式能啟動，不代表支援新協定或適用於新的系統環境。新裝置建議優先選擇仍在維護的客戶端；舊裝置移轉時先備份設定，再確認協定與規則的相容性，不要只依熟悉的名稱選擇。
開源生態系：透過原始碼與文件確認運作方式
mihomo 的原始碼、問題討論與發佈紀錄可在公開程式碼儲存庫中查閱，專案採用 GPL-3.0 授權。公開程式碼有助於了解設定與執行行為，但不代表不同圖形介面客戶端的選單、授權方式或更新週期完全相同。客戶端本身的授權條款與使用說明，請分別參閱各專案文件。
遇到疑似錯誤時，先保存可重現問題的最小設定、系統資訊與相關記錄。分享前請移除訂閱網址、驗證資訊及其他個人資料。清楚的重現步驟比只描述「連線失敗」更有助於討論，也能避免將伺服器端問題誤認為客戶端錯誤。
核心關係：介面負責操作，核心負責執行設定
Clash Verge Rev、FlClash 等圖形介面客戶端提供訂閱管理、開關與記錄視窗；核心則負責解析設定、比對規則及建立出站連線。客戶端可能會合併或覆寫設定，因此編輯本機檔案後，應確認最後生效的內容，而不能只看原始訂閱中的某一行。
若介面顯示已連線，但請求仍然失敗，請查看連線記錄中是否出現目標請求、符合哪條規則，以及最後採用哪個策略。若請求根本沒有進入核心，先檢查系統代理或 TUN 路由；若已進入核心，再檢查 DNS 與出站錯誤。如此可將排查範圍縮小至具體的連線環節。
更新機制：安裝檔與訂閱分別維護
客戶端更新通常涉及介面、系統整合與核心功能；訂閱更新則會變更設定中的代理、策略或規則來源。兩者並非同一項操作。訂閱更新成功不代表客戶端已更新，安裝新版客戶端也不會讓失效的訂閱恢復使用。更新前請先閱讀說明，並保留一份可用的設定。
升級後先確認基本網頁瀏覽、區域網路存取與常用應用程式正常，再恢復複雜的覆寫設定。若出現新問題，記錄修改前後的狀況，必要時還原至已知可用的設定。長期使用時建議簡要記錄修改內容，尤其是 DNS、TUN 與自訂規則，避免多次更新後無法還原原本的設定邏輯。
查看 mihomo 上游原始碼
以下命令僅用於取得原始碼，不會安裝客戶端，也不會自動啟用代理。一般使用者可直接使用上方的安裝入口；若要研究設定實作或回報問題，再查閱程式碼儲存庫文件。
開啟 MetaCubeX / mihomo 儲存庫 →git clone https://github.com/MetaCubeX/mihomo.git請先安裝 Git；複製後在終端機執行。
Clash 故障排除與規則相關文章
依症狀選擇入口，保留原始錯誤訊息再繼續排查。
記錄、規則與啟動故障屬於不同的問題脈絡。客戶端無法啟動時，先處理執行環境；視窗可以開啟但無法連線時，再檢查設定與請求記錄；只有特定網站連線路徑不正確時，則優先確認規則順序。以下文章分別詳述相關問題，方便完成基本設定後繼續查閱，不必每次都從重新安裝開始。
Clash Verge 一開啟就閃退：啟動崩潰的排查順序與修復方式
按兩下後視窗一閃即關，或卡在啟動畫面沒有回應？本文依排查順序檢查 WebView2 執行階段、連接埠占用、損毀的設定檔、殘留的服務模式與防毒軟體封鎖，並提供各平台的清理與重新安裝步驟。
查看啟動崩潰處理方式 →Clash 規則寫法詳解：DOMAIN-SUFFIX、IP-CIDR 比對順序與 MATCH 後備規則
規則會依書寫順序由上而下比對，符合第一條後即停止。本文解析 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR、GEOIP、MATCH 的語法，並說明 no-resolve 的用途與規則排序原則。
查看自訂規則說明 →mihomo 核心與原版 Clash 有何不同：協定支援、規則集與設定欄位對照
mihomo（原 Clash Meta）在原版核心的基礎上擴充 VLESS、Hysteria2、TUIC 等協定，並新增 rule-providers 擴充語法與 sniffer 等欄位。本文逐項比較兩者差異，並整理移轉設定時的注意事項。
查看核心與欄位對照 →