開源專案 · mihomo 核心用戶端持續更新

Clash 用戶端全平台下載

下載Clash 查看教學

依作業系統選擇用戶端，以 mihomo 核心處理代理連線，透過規則分流管理請求，搭配中文文件完成設定。

  • 統一入口 HTTP 與 SOCKS 共用混合連接埠
  • 依需求接管 分別設定系統代理與 TUN
  • 設定清楚易讀 分層管理訂閱、代理群組與規則

MIHOMO 核心 · GPL-3.0 開源 · 規則分流

規則分流TUN 模式訂閱管理
PLATFORMS 依作業系統選擇安裝套件
Windows Android iOS macOS Linux
COREmihomo通訊協定與規則引擎
LICENSEGPL-3.0核心程式碼開源
CONFIGURATIONYAML 設定入口 / 代理群組 / 規則
PROTOCOLS / CORE

通訊協定與核心支援先確認相容性，再做選擇

通訊協定名稱描述連線方式，不代表固定速度。伺服器參數、網路路徑與用戶端核心必須相互配合；匯入訂閱後，先確認目前核心能辨識其中的協定欄位。

已有訂閱

沿用伺服器提供的通訊協定與傳輸參數。用戶端能解析設定只是第一步；還要確認 TLS、傳輸層與代理群組引用是否完整。

行動網路

留意網路切換後的恢復情況與背景執行限制。採用 QUIC 的協定仰賴 UDP 是否可用，不能只看協定名稱判斷耗電量或連線穩定度。

桌面與伺服器部署

桌面端著重圖形介面操作與系統整合，伺服器端則著重服務管理與設定維護性。查看協定與核心技術參考 →

01 / CLIENT SELECTION

Clash 全平台用戶端依作業系統與處理器選擇

圖形介面負責訂閱管理、代理切換與系統整合，核心則負責解析規則並建立連線。先選擇適合裝置的安裝套件，再確認核心支援設定所需的通訊協定。

Windows

可選擇 Clash Plus、Clash Verge Rev、FlClash 等圖形介面用戶端。先在系統資訊中確認處理器架構，安裝後從系統代理開始測試；若需接管不讀取系統代理設定的程式，再依教學設定 TUN 服務。

前往下載 Windows 用戶端→

macOS

依 Apple Silicon 或 Intel 選擇對應版本。系統代理與網路延伸功能的授權位置不同，首次啟動時依系統提示操作。更新用戶端前請先備份設定；不要以重新安裝取代訂閱或規則問題的排查。

前往下載 macOS 用戶端→

Android

可選擇 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard。確認裝置架構與設定格式，首次連線時需允許建立 VPN。切換應用程式後若連線中斷，請檢查系統對用戶端背景執行與電池管理的限制。

前往下載 Android 用戶端→

iOS

透過 App Store 安裝 Clash Plus，官方網站為 clashplus.io。匯入設定後，允許新增 VPN 設定，再選擇代理群組。App 介面與桌面版不盡相同，排查時請依據連線狀態、啟用中的設定與規則命中情況判斷。

前往下載 iOS 用戶端→

Linux

桌面環境可選擇 Clash Verge Rev 或 FlClash，並依 Linux 發行版選擇套件。沒有圖形介面的主機可直接執行 mihomo，並由服務管理器維持程序運作；同時確認設定目錄權限、監聽位址與服務記錄。

前往下載 Linux 用戶端→
02 / CONFIGURATION WORKBENCH

入口、規則與代理群組從連線路徑理解設定

每個請求依序經過本機入口、規則比對與出口選擇。沿著這條路徑設定，比同時切換多個開關更容易確認結果。

規則分流
TUN 模式
混合連接埠 · 區域網路共用
mixed-port: 7890
allow-lan: false
訂閱更新
節點測速
外部控制
檢視記錄
設定覆寫 · 規則順序
DOMAIN-SUFFIX,github.com,PROXY
GEOIP,CN,DIRECT
MATCH,DIRECT
DNS 設定
代理群組
切換多份設定

規則依序比對，代理群組決定出口

規則模式並不是把所有連線都交給同一個節點。核心會由上而下檢查網域、位址或規則集，符合條件後便將請求交由對應策略處理。策略可以是直連，也可以是代理群組。調整設定時，請把具體條件放在前面，兜底規則 MATCH 放在最後，並確認規則引用的群組名稱確實存在。相較於全域模式，規則模式可保留不同服務各自的連線路徑；實際結果仍取決於規則內容。遇到某個應用程式走錯出口，先在連線清單查看命中的規則，再修改相應條件，不必反覆切換所有節點。

rules:
  - DOMAIN-SUFFIX,github.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,DIRECT

測速結果與實際下載速度應分開看

節點測速通常是在指定探測網址測量連線回應時間，並非持續下載測試。回應較快的節點，也可能受頻寬、伺服器負載或目標網站限制。比較時請使用相同網路、相同測試目標與相近時間，一次只更換一個變因。若瀏覽器正常但終端機連線失敗，先確認終端機是否讀取代理環境變數，不要直接判定是節點故障。

記錄用來定位問題階段，不宜直接據此下結論

先區分訂閱下載失敗、設定解析失敗、網域名稱解析失敗與目標連線失敗，再檢查對應設定。暫時提高記錄詳細程度有助於排查，但分享記錄前應移除訂閱連結、驗證欄位與個人位址。記下目前啟用的設定、模式與重現步驟，通常比反覆重新安裝更有幫助。

03 / FIRST CONNECTION

匯入訂閱並確認連線先建立一條可重現的連線

第一次設定時先保留預設連接埠，只啟用目前需要的網路模式。每完成一步就確認狀態，再繼續下一步。

STEP 01

匯入並啟用訂閱

在用戶端的訂閱或設定頁面新增訂閱網址，下載成功後選取該設定。確認檔案可正常解析，且代理群組中有可選項目，再進行下一步。訂閱網址通常包含存取憑證，不應貼到公開討論區；若匯入時發生錯誤，先確認收到的是設定內容還是錯誤頁面。

STEP 02

選擇模式與出口

通常可先使用規則模式，並在主要代理群組中選擇一個可用節點。桌面端先啟用系統代理；行動裝置則依系統提示允許建立 VPN。暫時不要同時啟用多個代理程式，也不要在基本連線尚未確認前，一次修改 DNS、連接埠和路由等多項設定。

STEP 03

開啟目標並檢查連線

開啟要測試的應用程式，在連線清單中找到相應網域或程序，確認命中的規則與實際出口。只看到開關已啟用，不能證明請求已進入核心。若應用程式沒有產生記錄，先檢查代理入口；若有記錄但連線失敗，再檢查解析結果、節點連線與目標服務。

查看完整教學 →

訂閱更新失敗保留現有設定，檢查網址、內容格式與更新記錄。 Clash UWP 迴送桌面應用程式正常但 UWP 應用程式失敗時，檢查迴送存取限制。 確認代理是否生效透過應用程式請求、連線清單與規則出口交叉驗證。
04 / OPEN SOURCE CONTEXT

Clash 生態系與 mihomo 核心認識用戶端介面之外的專案關係

這裡所說的 Clash，指的是一系列共用設定理念的用戶端與核心生態系，並非所有應用程式都由同一個團隊開發。介面相似，不代表通訊協定支援與設定行為完全一致。

從原版設定模型到 mihomo

Clash 使用 YAML 描述代理、代理群組與規則，圖形介面用戶端則以此模型提供匯入、切換與系統整合功能。原版專案停止維護後，生態系中的不同專案仍持續演進。Clash Meta 這個名稱與後續的 mihomo 有專案沿革關係，閱讀舊教學時會看到這些不同稱呼。判斷某項功能是否可用，應查看目前執行的核心，而非只看應用程式名稱是否包含 Meta。

開源範圍與授權條款應分開看

mihomo 核心採用 GPL-3.0 授權，原始碼、議題與提交記錄都可在專案儲存庫查閱。圖形介面用戶端、系統服務元件與設定工具可能各自有不同的儲存庫與授權條款，不能把核心授權直接套用到所有軟體。若要修改、散布或整合程式碼，應閱讀個別專案的授權檔案與相依項目聲明；只需日常連線的使用者，可先從下載頁了解維護狀態與系統需求。

設定相容不代表每個項目都完全相同

舊設定中的基本規則與部分代理欄位可能仍可使用，但新通訊協定、新規則類型與進階 DNS 欄位都需要核心支援。將設定複製到另一款用戶端前，先確認它接受完整 YAML，還是只接受節點訂閱；接著確認用戶端是否會自動合併預設設定。遇到解析錯誤時，依記錄指出的欄位逐一處理，不建議為了讓檔案通過解析而大量刪除不熟悉的設定。

用戶端、核心與訂閱分別更新

更新用戶端主要會改變介面、平台整合與封裝元件；更新核心會影響通訊協定實作與規則解析；更新訂閱則會變更遠端提供的節點或設定。這三種操作要解決的問題並不相同。更新前先保留可還原的設定，更新後檢查目前啟用的設定、監聽連接埠與系統代理狀態。若現有連線出現變化，先比對更新範圍，再決定要還原設定或調整組態。

05 / TECHNICAL NOTES

Clash 設定與排查文章依據現象找出對應設定

快速入門協助解決首次連線問題，技術參考說明通訊協定與核心，專題文章則補充單一問題的驗證步驟。記錄遇到的狀況後，選擇相應類型的說明閱讀。

查看所有文章 →