開源 mihomo 核心 · 全平台用戶端

ClashX官網 · Clash 用戶端
下載與安裝設定

依平台完成安裝,逐項設定訂閱匯入、規則分流與系統代理。

程式碼開源YAML 設定中文安裝指南

以開源 Clash 生態系為基礎

  • mihomo
  • Clash Verge Rev
  • ClashX Meta
  • FlClash
  • Clash Meta for Android

規則分流與
訂閱管理

先分清設定來源、連線規則與流量入口。用戶端介面負責操作,核心負責執行;不同用戶端的選單名稱可能不同,但設定概念可以互相參照。

設定易讀

YAML 保留明確的鍵名與層級,方便逐項查找設定。

連線狀態可追蹤

透過規則命中資訊與執行記錄,確認實際連線路徑。

config.yaml / 依序比對規則
mode: rule
rules:
  - DOMAIN-SUFFIX,apple.com,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

規則分流會由上而下檢查連線,第一條符合的規則決定連線策略。範例先讓指定網域直連,再依目標 IP 所屬地區判斷,最後由 MATCH 處理其餘連線。PROXY 不是內建的萬用出口,必須對應設定中已有的節點或策略組。匯入訂閱後,先選擇規則模式,再開啟連線記錄,確認命中規則與實際出口。若只有特定網站異常,優先檢查規則順序、網域識別與 DNS 結果,不要直接把整份設定改成全域模式。

平台與安裝入口

Clash 用戶端下載

查看所有用戶端 →

先確認作業系統與處理器架構,再選擇適用的用戶端。安裝程式能啟動,只代表應用程式已安裝;要建立可用連線,還需要有效設定、可用的連線節點與正確的流量入口。下載頁整理各平台可選用戶端、安裝需求與封存狀態,初次使用不必同時安裝多個用戶端。

Windows

建議先查看 Clash Plus,也可比較 Clash Verge Rev、FlClash 等用戶端。安裝前確認系統架構,首次啟動時檢查混合連接埠是否被其他程式占用。可先用系統代理進行基本驗證;需要 TUN 時,再依用戶端提示安裝服務或授予相應權限。

瀏覽器可以連線,但特定應用程式無法使用時,先確認該應用程式是否讀取系統代理。商店應用程式的迴路存取問題與節點故障不同,應參照 UWP 迴路存取說明另行處理。

前往下載 Windows 用戶端→

macOS

在「關於這台 Mac」確認是 Apple Silicon 或 Intel,再選擇相應安裝檔。將應用程式移至「應用程式」資料夾後啟動,並依需求完成代理輔助服務或網路相關授權。不同用戶端要求的權限不同,不要預設每款應用程式都需要系統擴充功能。

遇到授權提示時,請確認應用程式名稱、來源與目前操作。若曾拒絕授權而需要恢復,請至系統設定的「隱私權與安全性」及相關網路設定檢查,不要一再重裝來取代權限排查。

前往下載 macOS 用戶端→

Android

可選擇 Clash Plus、Clash Meta for Android、FlClash 等用戶端。先確認裝置架構與安裝需求,匯入訂閱並選取設定後,再確認系統 VPN 連線要求。這項授權用於建立本機流量入口,不代表訂閱服務已可使用。

鎖定螢幕後連線中斷時,請檢查電池最佳化、背景執行限制及其他 VPN 的占用情況。不同品牌的系統設定位置各異,建議每次只調整一項,再觀察連線是否恢復。

前往下載 Android 用戶端→

iOS

下載頁提供 Clash Plus 的 App Store 連結,並列出官方網站 clashplus.io。安裝後先確認是否支援訂閱格式,再完成匯入、選擇節點及系統 VPN 設定授權。出現連線圖示後,仍應透過實際連線測試確認規則與出口。

從 Wi-Fi 切換至行動網路後若連線異常,先確認應用程式的網路存取權限與設定狀態。用戶端提供連線管理功能;訂閱內容、節點效期與服務範圍則由設定來源決定。

前往下載 iOS 用戶端→

Linux

桌面使用者可查看 Clash Verge Rev 與 FlClash,並依發行版選擇適用的套件格式。桌面環境中的系統代理、終端機代理環境變數與 TUN 是不同的流量入口;瀏覽器可以連線,不代表命令列工具也採用相同設定。

伺服器或路由器使用者可進一步閱讀 mihomo 核心說明。部署時請分別檢查監聽位址、檔案權限、服務管理與防火牆,不要將僅供本機使用的控制介面直接暴露於公共網路。

前往下載 Linux 用戶端→

初次連線步驟

Clash 快速入門

查看完整教學 →

依序確認「設定可載入、節點可連線、應用程式可存取」,就能將問題限縮至特定環節。初次設定先保留預設連接埠與規則模式,不必急著修改 DNS、增加大量規則或同時啟用多種接管方式。以下三個步驟可作為安裝後的檢查清單,完整教學則提供各步驟的操作說明。

01 / CONFIG

匯入並選取訂閱

在訂閱或設定入口新增完整 URL,也可選擇已有的本機 YAML 檔案。等待下載完成後,選取該設定並查看解析結果。清單中出現名稱不代表載入成功;若有欄位錯誤,請先依記錄中的行號處理。範例網址僅供說明格式,不能取代實際訂閱。

02 / ROUTE

選擇模式與連線出口

日常使用建議選擇規則模式,再於對應策略組中選擇可用節點。策略組中的選擇只會影響引用該策略組的規則,不會接管所有流量。延遲測試只能檢查特定探測條件下的連線狀況,不能直接代表下載速度;測試失敗時,還需配合實際連線與記錄判斷。

03 / VERIFY

啟用入口並測試

桌面端可先嘗試系統代理;行動裝置則依提示允許 VPN 設定。分別連線至預期直連與預期走代理的目標,同時查看連線紀錄中的規則命中與出口。若用戶端沒有任何新連線,優先排查流量入口;若已有記錄但仍出錯,再檢查 DNS、節點與目標網路。

完成後請保留一份可還原的設定。

遠端訂閱更新可能會覆蓋手動編輯的內容,自訂規則應使用用戶端支援的覆寫或合併機制。調整前先記錄原設定;發生異常時,先還原至已驗證的狀態,再逐項重現問題,不要一次修改多個參數。

專案關係與原始碼查閱

Clash 生態系與 mihomo 核心

Clash 是生態系名稱,不是同一個安裝套件

Clash 最初以規則導向的代理核心及其設定方式建立使用者基礎,之後陸續出現適用於不同系統的圖形化用戶端、核心分支與設定管理工具。如今搜尋 Clash,可能會看到多個名稱相近、維護狀態各異的專案。選擇時應分別確認用戶端、使用的核心與設定格式,不要只憑圖示或名稱判斷功能是否相同。

本頁的生態系標誌用於說明相關專案的關係,不代表這些專案共同發布了同一個安裝套件,也不表示第三方專案認證本站。下載頁會分別標示仍可選用的用戶端與封存專案,方便使用者在相容舊設定與採用持續維護的工具之間做出選擇。

分清介面管理與網路處理

mihomo 延續並擴展 Clash 生態系的設定與規則功能。圖形化用戶端可在核心之外加入訂閱管理、系統匣選單、連線檢視與系統服務,但這些介面功能並非全都屬於核心。遇到問題時,訂閱按鈕失效可能是用戶端管理層的問題;設定解析錯誤可能與核心欄位有關;系統代理未生效則可能出在系統整合層。

開源儲存庫可協助確認專案說明、授權條款、設定文件與公開問題紀錄。mihomo 採用 GPL-3.0 授權,其他用戶端則應以各自儲存庫的授權條款為準。查看原始碼不代表必須立刻自行編譯;對一般使用者而言,先閱讀與目前問題相關的文件和發布說明更實用。

MetaCubeX / mihomo · 原始碼入口

查閱公開實作與設定說明

若要研究規則、DNS 或核心行為,可從專案儲存庫開始。以下命令只會複製原始碼,不會安裝圖形化用戶端、提供訂閱或自動變更網路設定。

git clone https://github.com/MetaCubeX/mihomo.git

Linux 企鵝圖示來源:Font Awesome Tux,採用 CC BY 4.0 授權;本站以內嵌向量圖呈現。

更新前先確認影響範圍

用戶端更新、核心更新、訂閱更新與規則資料更新是不同操作。更新訂閱會變更設定來源的內容;更新核心可能影響欄位支援與執行行為;規則資料則用於地區或分類比對。更新後若出現異常,先記下剛才更新的是哪一層,再查看相應說明,避免把所有變化一概歸因於「節點無法使用」。

準備更換用戶端時,請保存原設定與必要的本機覆寫,並確認新用戶端支援相同規則與協定。封存專案仍能啟動,不代表能因應後續系統變化;是否繼續使用,應依實際需求、維護狀態與已知問題判斷。

只保留排查所需的記錄

一般使用時保留適當的記錄層級即可。需要定位問題時,記下失敗時間、目標類型、命中規則與錯誤訊息,再短暫提高記錄詳細程度。公開求助前,請移除訂閱網址、節點密碼、存取權杖及其他私人資訊,只提供足以重現問題的最小設定片段。

完整排查時應區分本機監聽、DNS 解析、規則選擇與遠端連線。先確認流量是否進入核心,再確認規則是否選到預期出口,最後檢查節點與目標服務。逐層定位比反覆更換用戶端更容易得到可重現的結論;詳細範例可參閱使用文件與常見問題。

依問題查閱

Clash 使用心得

查看所有文章 →

完成初次連線後,再依實際問題深入閱讀。安裝階段著重確認連接埠、模式與系統入口;應用程式相容問題則著重 DNS 與網路接管方式;訂閱匯入失敗時,先確認輸入格式。每次只處理一個可驗證的問題,並保留調整前後的差異,方便判斷是哪項設定造成影響。