開源專案mihomo 生態系

Clash 開源用戶端下載

依作業系統選擇用戶端,參考 mihomo 設定範例匯入訂閱、設定規則分流,再按需求調整 DNS 與網路接管方式。

  • 安裝套件選擇
  • YAML 範例
  • 中文文件
config.yaml 設定摘錄
mixed-port: 7890mode: ruledns:  enable: true  enhanced-mode: fake-iprules:  - GEOIP,CN,DIRECT  - MATCH,Proxy
核心 mihomo
瀏覽開源儲存庫與發布紀錄

MIHOMO / CONFIG SCENES

從設定片段查找手冊章節

查看進階設定手冊

CONFIG REFERENCE

mihomo 設定
與執行行為

策略群組決定出口,規則決定哪些連線使用該出口。先檢查這兩層的分流,再確認 DNS 是否回傳預期結果,以及流量是否進入核心。

config.yaml

策略群組名稱與出口選擇

將規則指向策略群組,就能更換出口,不必重寫網域清單。select 由使用者選擇成員;url-test 依探測結果選取成員;fallback 則優先使用清單中排序較前且可用的成員。範例僅以內建策略說明引用關係。匯入訂閱後,先確認群組名稱與成員名稱,再從連線紀錄確認命中的規則群組及最終出口。用戶端介面可能隱藏部分欄位,排除問題時請以實際生效的設定為準。

proxy-groups:
  - name: Proxy
    type: select
    proxies: [DIRECT, REJECT]
rules:
  - MATCH,Proxy
查看策略群組類型與實例

PLATFORM PACKAGES

依平台選擇 Clash 用戶端

先確認作業系統與處理器架構,再比較用戶端。圖形用戶端適合透過介面管理設定;單獨執行 mihomo 則需自行處理設定目錄、程序管理及系統網路設定。若要替換既有用戶端,請先保存本機覆寫與策略群組選擇,再退出舊用戶端。遇到連接埠被占用時,先確認舊程序是否已結束,不要直接修改訂閱中的連接埠來繞過問題。

Windows

適合偏好圖形介面、需要依應用程式排查代理行為的桌面環境。請在系統的「關於」頁面確認處理器架構,再對照下載頁上的套件類型。首次連線可先開啟系統代理測試瀏覽器;只有目標應用程式不讀取系統代理時,再考慮使用 TUN。升級前請退出舊用戶端,並確認背景服務也已停止。若退出用戶端後瀏覽器仍無法連線,先檢查系統代理是否仍指向本機連接埠。公司設備的管理員授權與防火牆設定,請遵守設備管理規範。

前往下載

macOS

在「關於這台 Mac」查看晶片資訊,分辨 Apple Silicon 與 Intel。請以下載頁實際列出的架構為準,不要根據系統介面或設備年份猜測。若透過選單列切換代理,可前往系統網路設定確認代理狀態。若啟動後立即退出,先檢查安裝套件架構與系統需求;若只有特定應用程式無法連線,先排除應用程式本身的代理設定。移轉舊設定時,請分別確認訂閱網址、本機檔案及策略選擇,不要假設新用戶端會讀取其他用戶端的工作目錄。

前往下載

Android

依裝置架構選擇 APK;若下載頁提供通用套件,使用通用套件可降低選錯架構的機率。首次連線通常需要確認系統 VPN 請求。若裝置上已有其他 VPN,先確認系統目前允許哪個應用程式建立連線。先保留預設電池策略,進行前景與鎖定螢幕測試,再決定是否調整背景權限。鎖定螢幕後斷線與切換無線網路後斷線可能是不同問題:前者先檢查程序是否遭暫停,後者先確認系統 VPN 是否已在新網路重新連線。

前往下載

iOS

從下載頁前往用戶端的 App Store 頁面,先確認系統需求。安裝後依應用程式提示加入 VPN 設定,再匯入既有訂閱。若訂閱在桌面端可用、在行動裝置上卻無法匯入,應先檢查用戶端支援的設定格式與欄位,而不是直接修改伺服器位址。測試時可分別使用 Wi-Fi 與行動網路,確認問題是否只出現在某種連線方式。若裝置由公司或學校管理,VPN 設定項目可能受到管理政策限制,請先確認允許的使用範圍。

前往下載

Linux

桌面系統優先依發行版的套件管理方式與處理器架構選擇安裝套件。桌面代理設定不一定會同步至終端機,命令列工具應另外確認是否讀取相應的代理環境變數。伺服器或路由器通常較適合單獨執行核心,並明確指定設定目錄、執行使用者與記錄位置。啟動失敗時,先分辨套件不相容、缺少相依套件或服務權限不足;連線失敗時,再檢查監聽位址與路由。這兩類問題的排查方向不同,不必為了測試而同時修改防火牆與系統路由。

前往下載

查看所有用戶端 →

FIRST CONNECTION

Clash 首次連線:匯入、接管與驗證

建議先保留一份可正常啟動的設定,再逐步調整分流規則與網路接管方式。每次只變更一項設定,並測試同一個目標,確認是哪個開關造成差異。

  1. 匯入並啟用設定

    安裝後前往「設定」或「訂閱」頁面,選擇從 URL 匯入既有訂閱,或從檔案匯入本機 YAML。清單出現新項目後,手動選取並確認已套用。看得到設定名稱只代表項目已儲存,不一定表示核心已成功載入。若套用失敗,先查看錯誤訊息指出的欄位或行號,再確認縮排、引用名稱及用戶端支援的欄位。向他人求助時,提供相關欄位與錯誤訊息即可,不要將訂閱網址或完整設定貼到公開討論區。

  2. 選擇規則模式與接管方式

    將執行模式設為「規則」,保留設定中的分流邏輯。桌面端先透過系統代理測試支援此設定的應用程式;行動裝置則依系統提示建立 VPN 連線。若目標程式未出現在連線清單中,再考慮應用程式專屬代理或 TUN。系統代理決定應用程式是否將請求交給用戶端,執行模式則決定核心收到請求後如何處理,兩項設定不能互相取代。若裝置上已有其他網路接管工具,先停用舊工具進行測試,避免將路由衝突誤判為訂閱失效。

  3. 透過連線紀錄驗證命中結果

    選擇一個預期直連的目標,以及一個應走代理的目標,分別發出新請求。在連線紀錄中查看目標網域、命中規則及最終出口,不要只以網頁能否開啟判斷分流結果。若有紀錄但出口不符預期,先檢查規則順序及策略群組目前選取的成員;若沒有紀錄,先確認應用程式的連線是否已被接管。調整規則後,請建立新連線再比較;應用程式若重複使用既有連線,觀察到的結果可能仍是修改前的設定。

查看完整教學 →

SOURCE / RELEASES

mihomo 原始碼與發布紀錄

原版 Clash 與後續分支

原版 Clash 停止維護後,相關用戶端與核心專案各自在自己的程式碼儲存庫中持續發展。mihomo 源自 Clash.Meta 分支,仍採用讀者熟悉的規則、策略群組與 YAML 設定結構,但也發展出自己的欄位與行為。專案名稱包含 Clash,不代表它們由同一位維護者維護或採用相同發布週期。閱讀舊教學時,應先辨認內容談的是原版核心、後續分支,還是某款圖形用戶端,尤其要留意安裝方式、服務模式與 DNS 設定的差異。

移轉已封存用戶端的設定時,先匯入一份副本,查看核心啟動記錄及用戶端產生的實際設定。舊欄位即使能解析,也不代表原有網路行為會完全保留;系統權限、路由與 DNS 預設值也可能不同。

用戶端與核心的分工

mihomo 負責解析執行設定、接收連線、執行規則並選擇出口。Clash Verge Rev、FlClash 等圖形用戶端則提供設定管理、選單開關及連線檢視。系統匣操作、訂閱更新入口與覆寫編輯器通常屬於介面層;規則比對失敗及模組初始化錯誤則應查看核心記錄。兩個介面即使都有名為「系統代理」的開關,也可能以不同方式管理系統設定。排查時先確認問題屬於哪一層,不必為了解決介面問題而重寫整份 YAML。

同一份訂閱在不同用戶端上的表現若有差異,請查看各自套用了哪些本機覆寫、啟用了哪些代理入口。若能匯出生效設定,將相關欄位並列比較,比起逐項對照整個設定頁面更容易找出差異。

儲存庫、議題與問題歸屬

上游儲存庫可用來查閱原始碼、變更內容及公開議題。遇到設定問題,可先搜尋錯誤訊息原文或欄位名稱;若只是某個用戶端的安裝程式無法啟動,應從該用戶端的發布紀錄與議題查起。回報問題時,請說明系統架構、接管方式、重現步驟及實際結果。以最小設定重現問題,有助判斷原因是欄位關係、網路環境還是介面設定,不必附上完整訂閱內容。本網站提供用戶端下載入口與中文文件;專案功能及維護狀態請以上游專案紀錄為準。

若相同問題只在連線到特定網路後出現,也請註明問題何時開始,以及切回原網路後是否恢復。這有助維護者分辨環境限制與穩定重現的軟體回歸問題。

讀完變更說明再更新

圖形用戶端與 mihomo 核心各自有獨立的發布週期。介面更新不一定包含核心更新,單獨替換核心也可能超出用戶端的支援範圍。安裝前先分辨正式版與預發布版,確認套件適用的系統與架構,再閱讀 DNS、TUN、權限或設定移轉相關的變更說明。更新完成後,以現有設定驗證核心啟動、訂閱載入、直連及代理出口。若出現異常,請保留舊設定及更新前正常運作的紀錄,以便還原或逐項確認變更。

更新用戶端時,不必同時更換規則集、重設上游 DNS 或啟用新模式。將升級與設定修改分開進行,即使發生網路問題,也能清楚判斷應先還原哪一項變更。

取得 mihomo 原始碼

此命令用於閱讀原始碼。安裝現成用戶端請前往下載頁;編譯核心則請依儲存庫說明準備環境。

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

TECHNICAL NOTES

最新設定與平台文章

查看所有文章 →

Clash下載