Clash開源社群 mihomo

Clash 用戶端下載與 設定指南

依平台選擇 Clash 用戶端,查閱 mihomo 設定欄位,再透過連線記錄確認規則分流結果。

  • 核心程式碼開源
  • 中文文件

INSTALL / PLATFORM

Clash 平台下載

先確認作業系統與處理器,再挑選用戶端。同一個專案可能會提供不同架構的安裝檔,檔名相近也不能混用。初次使用建議選擇圖形介面用戶端,匯入設定、查看連線及切換策略都能透過介面完成。若已在路由器或伺服器上管理網路服務,再考慮單獨部署核心。

Windows

在「設定 → 系統 → 關於」查看系統類型,先比對下載頁提供的架構,再選擇安裝檔。更換用戶端前,先退出舊程式,並確認系統匣中的背景程序也已結束,避免兩個執行個體同時嘗試監聽同一個連接埠。

macOS

在「關於這台 Mac」查看晶片或處理器資訊,選擇 Apple 晶片或 Intel 安裝檔。用戶端出現在選單列,通常只表示程式正在執行。匯入設定後,還要確認目前使用的設定已啟用,並視需要開啟系統代理。

Android

選擇與裝置應用程式架構相符的安裝檔,不能只憑手機型號標示「64 位元」就下定論。首次連線時,留意系統的 VPN 授權提示。若裝置原本已啟用其他本機 VPN,先確認是否需要中斷連線,再啟動新的用戶端。

iOS

從下載頁前往 Clash Plus 的 App Store 頁面,查看 App 詳細資訊中的系統需求。安裝後先確認用戶端支援的匯入格式。建立連線時依照系統提示加入 VPN 設定,接著回到用戶端確認目前使用的是哪一份設定。

Linux

先確認發行版支援的套件格式,再核對處理器架構。桌面環境可考慮使用圖形介面用戶端;純命令列環境則須自行管理設定目錄、程序啟動與記錄檔。遷移至另一台電腦時,別只複製主要設定,也要確認規則集與本機檔案引用。

舊教學中同名的按鈕,在新版用戶端裡可能已移到別的位置。尤其是從已停止維護的 Clash for Windows 遷移時,先保留自行新增的規則與覆寫設定,再於新用戶端重新匯入設定。不要直接搬移整個舊工作目錄:裡面除了設定檔,也可能包含快取及僅適用於舊介面的設定。

查看所有用戶端 → 比較用戶端功能與選型

CONFIG / INSPECTION

mihomo 核心設定

排查時將三個問題分開看:請求有沒有進入核心、進入後符合哪條規則,以及最後使用哪個出口。以下片段各自說明一個欄位,並非可直接取代整份設定的完整範例;若要查詢欄位值與相依關係,請參閱完整設定欄位參考。

具體規則在前,預設規則在後

規則模式會依清單順序由上往下判斷,符合條件後就不再檢查後續項目。若要讓某個子網域採用不同於主網域的路徑,先寫精確網域,再寫涵蓋範圍較廣的網域後綴規則,最後以預設規則收尾。有別於全域模式,規則模式可在同一份設定中指定不同出口。修改後,透過連線記錄確認實際符合的項目;若規則指向自訂策略群組,也要確認規則中的名稱與群組名稱完全一致。

config.yaml · rules
mode: rule
rules:
  - DOMAIN,blocked.example.com,REJECT
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,DIRECT

SETUP / FIRST RUN

匯入、接管與驗證

首次測試時,選一個平常能開啟的網站,先記下未啟用代理時的狀況。接下來一次只變更一項設定;若遇到問題,可以回到上一步,確認故障是在哪次變更後出現。

  1. 匯入並啟用一份設定

    進入用戶端的「設定」或「訂閱」,選擇從檔案匯入,或輸入來源可信的訂閱網址。匯入後選取該設定,確認規則與策略群組是否載入。清單中出現項目,不代表核心目前正在使用它。若發生解析錯誤,先記下提示指出的欄位或行號;保留一份原始檔,再修改副本中的縮排、清單層級或欄位型別。

  2. 選擇規則模式與一種流量接管方式

    先使用規則模式測試,再於相關策略群組中選定一個出口。桌面版可先透過系統代理測試會讀取系統設定的應用程式;行動版則依照用戶端提示建立系統 VPN。暫時不要同時更換模式、節點與接管方式。若只想讓單一終端機工具透過代理連線,可先依照該工具的文件設定代理位址,不必立刻更改整台裝置的路由。

  3. 透過連線記錄確認是否符合規則

    開啟測試頁面後,在用戶端的連線清單中找出目標網域,核對規則與出口。若完全沒有連線記錄,先確認應用程式是否已接入;若有記錄但符合預設規則,回頭檢查規則順序與網域寫法;若規則符合正確仍逾時,再檢查目標網站與所選出口是否連通。回報錯誤時,記下時間、模式與錯誤訊息;分享記錄前,請刪除訂閱網址及驗證資訊。

查看完整教學 →

新手常見問題排查

節點延遲有數值,為什麼網頁還是打不開?

測速要求與網頁要求可能套用不同規則,目標位址也可能不同。先確認網頁要求是否出現在連線清單,再核對實際出口。延遲數值只能說明該次探測的結果。相關名詞請參閱術語手冊。

訂閱更新失敗,需要刪除舊設定嗎?

先保留可正常使用的設定。確認更新錯誤是要求逾時、授權失敗還是格式解析失敗,再依原因處理;遠端內容無法讀取時,反覆重新安裝用戶端通常無法解決。可先參閱術語手冊,了解訂閱與本機設定的差異。

瀏覽器能上網,終端機為什麼沒有走同一條路?

命令列程式不一定會讀取系統代理設定。有些會讀取環境變數,有些則需另外設定;先查閱該工具的說明,再到用戶端確認是否有連入記錄。網路流量接管方式可參閱術語手冊。

SOURCE / MAINTENANCE

mihomo 原始碼與維護分工

專案名稱、用戶端名稱與訂閱來源是三回事。查詢欄位時,先確認實際載入設定的是哪個核心;若要排查安裝、更新或介面問題,再查閱對應用戶端的說明。

從 Clash 到 mihomo

Clash 生態系長期使用 YAML 描述連入、連出與規則。mihomo 延續了原名為 Clash.Meta 的核心專案。舊資料沿用早期名稱很常見;遇到舊文件中的介面截圖或參數時,先確認它對應的是哪個專案。名稱相似只能作為搜尋線索,不能據此判斷欄位目前仍可使用,也不能認定兩個安裝檔由同一個維護團隊提供。

開源授權與專案分工

mihomo 原始碼儲存庫採用 GPL-3.0 開源授權,可在上游儲存庫查看程式碼、變更記錄與問題討論。此授權適用於核心專案,不代表每個圖形介面用戶端也採用相同授權。提供 GUI 的專案各自維護介面操作、系統整合與發行套件;訂閱則由設定提供者維護,更新訂閱不會取代用戶端,也不會為系統安裝新的核心。

圖形介面與實際生效的設定

核心負責處理連入、依規則選擇出口並執行連線。圖形介面用戶端除了顯示這些資訊,也可能合併訂閱、覆寫設定與全域設定,再將結果交給核心。若設定檔中有規則,但介面中沒有生效,先確認目前啟用的設定,再檢查覆寫設定的套用順序,最後比對連線記錄。只查看編輯器中的原始檔案,可能會漏掉用戶端後續加入的設定。

升級前要看哪份變更說明?

更換安裝檔時,先查閱用戶端的發行說明;若涉及規則語法、DNS 行為或虛擬網卡支援,再查看所用核心的變更內容。更新前記錄目前的設定與流量接管方式,並備份本機規則及覆寫設定;更新後使用相同目標進行測試。若只是新增一條規則,單獨儲存並測試該規則,比同時更新程式、規則集與訂閱更容易找出變化原因。

NOTES / LATEST

技術筆記

找不到連線記錄時,先確認代理是否已接管要求;有記錄但路徑不對,再檢查模式。準備更換用戶端時,先確認必須保留的功能,以及設定的遷移方式。

查看所有文章 →