開源核心 mihomo · 桌面與行動裝置用戶端

Clash 用戶端下載與設定指南

下載Clash 查看教學

依裝置挑選 Clash 用戶端，從匯入訂閱開始，再設定規則分流與TUN 模式。基本連線與進階設定分開查閱。

永久免費原始碼開放繁體中文文件
先選平台，再選用戶端

Clash 下載平台與安裝方式

桌面版建議優先選擇仍在維護的圖形化用戶端。行動裝置則先確認系統權限與訂閱格式。下載頁列出各平台的用戶端、處理器架構與安裝需求；此處僅提供選擇入口，不會混列不同系統的安裝檔。

Windows

日常桌面使用可先從 Clash Plus、Clash Verge Rev 開始挑選。安裝前請查看「設定 → 系統 → 系統資訊」中的系統類型，再對照下載頁的需求。首次執行時先匯入訂閱並啟用系統代理；只有部分應用程式不遵循系統代理時，再考慮使用 TUN 模式，避免一開始就同時變更權限、路由與 DNS。

前往下載

macOS

先在「關於這台 Mac」確認晶片型號：Apple 晶片與 Intel 處理器使用的安裝檔不同。安裝完成後，依照系統提示授予網路相關權限。更換用戶端時，先退出舊程式並關閉其系統代理，再啟動新程式；兩套用戶端同時變更代理設定，容易造成瀏覽器可用、其他應用程式卻連線異常。

前往下載

Android

近期多數裝置採用 ARM64，舊裝置仍須確認處理器架構。Clash Plus、Clash Meta for Android 和 FlClash 的設定入口各不相同，但都應先完成訂閱匯入。連線時請允許系統提出 VPN 連線要求；若鎖定螢幕後連線中斷，先檢查電池最佳化與背景執行限制，別將所有背景執行問題都歸咎於訂閱失效。

前往下載

iOS

下載頁提供 Clash Plus 的 App Store 連結及官方網站 clashplus.io。安裝後新增既有訂閱，首次連線時依照系統提示允許新增 VPN 設定檔。系統狀態列出現 VPN 標記，只表示網路延伸功能正在執行；仍須確認策略選擇與實際網頁連線。其他 VPN 應用程式也可能與目前連線互相干擾。

前往下載

Linux

桌面環境可選擇 Clash Verge Rev 或 FlClash，再依 Linux 發行版挑選套件。伺服器與路由器使用者可查看下載頁的 mihomo 核心專區。圖形化用戶端與命令列核心的安裝方式不同；桌面代理環境變數、瀏覽器代理與 TUN 路由也各自生效。安裝成功後，仍須確認應用程式實際使用的網路入口。

前往下載
查看所有用戶端 →

已安裝用戶端但無法上網？先記下用戶端名稱、執行模式與錯誤記錄，再查閱說明中心，避免反覆重新安裝。

規則、DNS 與連線設定

依需求查閱個別設定項目。以下 YAML 都是功能片段，並非可獨立執行的完整設定；其中的 PROXY 策略名稱必須先在實際設定中定義。不同用戶端的選單名稱可能不同，請以生效設定與核心記錄為準。

規則分流：依序比對連線目標

規則模式會由上而下比對，命中第一條規則後，就交由對應策略處理。網域規則適合指定網站，IP 規則適合明確網段，MATCH 則放在最後作為預設規則。若要讓特定網站直連，先查看連線記錄中的實際網域與命中規則，再將更明確的規則放在通用規則之前。與全域模式不同，規則模式可讓每條連線使用不同策略，而非將所有流量交給同一個策略組。需要長期保留的變更應寫入本機覆寫，避免訂閱更新後遺失。

config.yaml · 規則片段
mode: rule
rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
規則集與比對順序 →
核心 / 用戶端 / 設定

mihomo 核心與 Clash 用戶端的關係

先分清負責轉送流量的核心、負責操作的圖形介面，以及提供連線資訊的訂閱。三者各自維護，更新時程也不同。本網站整理下載入口與設定文件，不提供代理訂閱，也不代表任何用戶端的開發團隊。

專案沿革與維護範圍

Clash 最初以規則導向的代理核心為基礎，逐步發展出完整生態系；圖形化用戶端則提供設定選擇、系統代理與連線檢視等操作。原始專案及部分早期桌面用戶端停止維護後，社群持續發展不同分支。mihomo 延續 Clash Meta 的開發方向，支援規則、DNS、TUN 與多種代理協定。名稱相近不代表它們是同一套軟體，也不代表舊教學中的按鈕在目前的用戶端中仍找得到。

查閱資料時，先記下使用的圖形化用戶端及其內建核心，再對照相應文件。介面名稱相同還不夠：有些用戶端會自行產生設定，有些會合併覆寫檔案，也有些會限制可編輯欄位。直接以其他用戶端的完整設定覆蓋，可能繞過原有的訂閱管理，也可能覆蓋管理介面與監聽設定。遷移前請保留舊設定與本機修改，確認新程式能正常啟動後，再逐項移轉。

圖形介面負責操作，核心負責連線

Clash 用戶端通常負責系統匣選單、開機自動啟動、系統代理、訂閱下載與設定編輯；真正處理連線、解析網域及比對規則的是核心。介面顯示「執行中」，只表示程序正在執行，不代表訂閱有效或所有目標都能連線。排查時應拆分問題：用戶端能否啟動、設定能否載入、節點能否建立連線、規則是否命中預期策略，以及網域是否成功解析。

系統代理與 TUN 所在的網路層級也不同。系統代理會指示遵循這項設定的應用程式連線至本機連接埠，部分命令列工具則需要另外設定代理環境變數。TUN 透過虛擬介面與路由接管更多流量，但對權限與網路環境更敏感。瀏覽器能開啟網頁、某個程式卻不行，不能直接推論是節點失效。先查看該程式是否出現在連線清單，再決定要檢查代理入口還是策略規則，比一次開啟所有開關更容易找出問題。

訂閱提供設定，用戶端不會產生服務

安裝完成後，仍需要既有訂閱或自行架設的連線資訊。訂閱可能包含節點、策略組、規則與 DNS，也可能只有代理伺服器清單。匯入時若出現格式錯誤，先確認回傳內容是否為 Clash YAML；若在瀏覽器中開啟連結看到登入頁面或錯誤頁面，用戶端自然也無法將其讀取為設定。訂閱回傳空清單、驗證失敗或逾時，通常應檢查服務狀態、連結是否有效及下載路徑，而非修改本機代理連接埠。

訂閱連結中的權杖應視為憑證。分享截圖時遮住完整網址，匯出設定前刪除帳戶相關資訊，公開求助時僅保留必要的錯誤與去識別片段。第三方訂閱轉換服務會將原始連結交由另一方處理，使用前請先了解資料流向。更新訂閱不等於更新本機設定：用戶端可能重新產生規則，因此個人分流需求應寫入支援的覆寫機制，並在更新後檢查實際生效內容。

開源紀錄供查證，不取代實際測試

mihomo 採用 GPL-3.0 授權，原始碼與開發紀錄可在儲存庫中查閱。各圖形化用戶端都有自己的專案、授權與發布說明，請分別查看。開源的價值在於實作與變更可供檢視，遇到相容性問題時也能追查相關討論；但這不保證特定網路環境、訂閱或設定組合一定可用。本網站不以未經證實的下載量、評分或測速數據取代可查證的資料。

準備回報問題時，請提供作業系統、用戶端名稱、相關設定與可重現的操作步驟。記錄只截取錯誤發生前後的必要內容，並遮蔽訂閱、密鑰與個人存取目標。「address already in use」表示監聽連接埠發生衝突；「connection refused」代表目標連接埠拒絕連線；若是解析失敗，則需繼續檢查 DNS 路徑。保留原始錯誤訊息比只寫「無法上網」更有幫助，也更容易分辨是用戶端、設定或伺服器端的問題。

更新順序與可復原設定

用戶端、核心、訂閱與地理資料庫是不同的更新項目。更新用戶端可能改變介面與服務元件；更新核心可能影響協定與欄位；更新訂閱會影響連線資訊與規則；更新 GeoIP 資料則會影響依賴地理資料的比對結果。每次只變更一類項目，並記錄變更前的狀態。發生異常時還原最近一次變更，通常比重設所有設定更容易找出原因。

首次設定建議先以規則模式確認瀏覽器能正常連線，再測試其他應用程式，最後才考慮 TUN、區域網路分享與外部面板。測試時不只要確認目標網頁能否開啟，也要檢查連線清單中的網域、命中規則與最終策略是否符合預期。即使連線成功，策略不正確也需要調整。自訂設定請先另存為獨立檔案；編輯 YAML 時使用空格縮排，避免重複定義同名頂層欄位。提交給用戶端後，先檢查記錄並確認載入成功，再進行下一步。

文件入口與排查順序

初次使用請從匯入訂閱步驟開始，依序匯入訂閱、選擇設定、切換規則模式並啟用代理，完成連線。已能正常使用但想調整網站連線方式，請前往進階設定查看策略組、規則集與覆寫。遇到不熟悉的術語，可先查閱術語表，別只憑欄位名稱猜測用途。如此可保留清楚的設定脈絡，減少複製零散片段造成設定互相覆蓋。

若啟用後完全無法連線，先退出其他代理工具並確認一般網路正常，再依序檢查訂閱是否有效、目前使用的設定、策略組選擇與 DNS 記錄。只有特定網站異常時，優先查看該連線的規則與目標，而非立即重新安裝。關閉用戶端後仍無法連線，請檢查系統代理是否未還原，以及原有網路設定是否恢復。更多依症狀分類的解答請見說明中心；此處整理操作順序，不把所有故障混成一套開關建議。

設定知識與故障排查文章

訂閱格式、憑證錯誤與手機背景執行，分別涉及不同層級的設定。依照實際症狀閱讀，先了解問題發生在哪個環節，再調整相應選項。以下是最近發布的三篇文章。

查看所有文章 →