Clash 生態系 · 設定文件

Clash 代理用戶端

依作業系統選擇用戶端,閱讀 mihomo 核心與 YAML 設定說明,從匯入訂閱到確認規則分流,一步步完成設定。

核心程式碼開源中文設定參考

用戶端設定功能

整份訂閱由用戶端匯入;節點來源則由核心依設定讀取。

訂閱與節點來源

在設定清單中貼上相容的訂閱網址,等候下載與解析完成,再將該設定設為目前使用項目。與手動輸入不同,遠端訂閱可以更新,節點重新命名也可能影響既有選擇。若手上只有節點來源,可用 proxy-providers 個別載入,再由策略組引用。兩種連結即使都回傳 YAML,也不一定能互換。更新成功卻沒有節點時,先確認回傳內容的類型,再檢查策略組是否引用正確的來源。

providers.yaml
proxy-providers:  office:    type: file    path: ./providers/office.yamlproxy-groups:  - name: PROXY    type: select    use: [office]

查看 YAML 設定參考 →

依平台選擇安裝檔

先依作業系統篩選,再確認處理器架構、安裝方式與維護狀態。若要從舊用戶端轉移,建議先匯入訂閱或設定檔,避免直接覆蓋新用戶端的應用程式資料目錄。

Windows

在系統資訊中確認裝置架構。初次使用可先啟用系統代理,檢查瀏覽器是否產生連線紀錄;若需讓不讀取系統代理的應用程式連線,再查看用戶端的 TUN 支援與權限提示。遷移舊設定前,請先關閉原有程式,避免兩款用戶端同時修改代理設定或搶用監聽連接埠。

前往下載

macOS

透過「關於這台 Mac」確認裝置使用 Apple Silicon 或 Intel,再選擇對應的安裝檔。首次啟用代理後,可在系統網路設定中確認目前的網路服務是否套用相應設定。若關閉用戶端後,應用程式仍嘗試連線至本機代理連接埠,請檢查系統代理是否已還原,不必反覆重新匯入訂閱。

前往下載

Android

依系統支援的 ABI 選擇安裝檔;處理器支援某種指令集,不代表目前的系統就能安裝對應套件。首次連線時,請依系統提示授予 VPN 權限。若鎖定螢幕後連線中斷,請記下通知列狀態,並檢查應用程式的背景執行限制,以及是否有其他 VPN 服務接管連線。

前往下載

iOS

請在 App Store 查看用戶端與系統的相容性要求。匯入設定並授權新增 VPN 設定後,返回用戶端確認目前選用的設定與策略組。若狀態列顯示 VPN 已連線,但目標應用程式仍無法使用,先用瀏覽器測試同一目標,再查看該應用程式的連線紀錄,以區分通道啟動與請求轉送問題。

前往下載

Linux

桌面環境可依 Linux 發行版選擇套件格式,例如 Debian 系使用的 DEB,或適用於特定發行版的 RPM。部署在無桌面環境的裝置時,核心可獨立執行,但需自行管理設定目錄、服務權限與記錄。啟動成功後,也要確認應用程式已透過系統設定、環境變數或其他方式將請求送往核心。

前往下載

查看所有用戶端 →

初次連線三步驟

  1. 匯入並啟用設定

    在訂閱或設定頁面新增服務提供者給的相容連結,也可選擇本機 YAML 檔。看到檔案出現在清單後,還要將它設為目前使用的設定。若匯入失敗,先確認回應內容是設定檔,而非登入頁面或服務提示頁。請勿在截圖、記錄或問題回報中公開訂閱網址。

  2. 選擇規則模式並接入流量

    選擇規則模式,並在策略組中確認要使用的出口。桌面版先使用系統代理;行動裝置則依提示授權 VPN。先確認一種接入方式可正常運作,再考慮是否需要 TUN。核心正在執行只代表已啟動,不代表應用程式的流量已進入核心;請分別確認這兩種狀態。

  3. 透過連線紀錄確認分流

    選一個預期直連的目標和一個預期經代理的目標,依序連線並查看連線紀錄。核對目標網域、命中規則與最終出口。若沒有紀錄,先檢查代理接入;若有紀錄但出口錯誤,再檢查規則順序。只有命中規則與出口都符合預期後,才繼續排查遠端連線問題。

查看完整教學 →

開源核心與維護來源

原版 Clash 與後續專案

原版 Clash 的設定主要由代理節點、策略組與規則構成。後續不同專案延續或擴充了這套寫法,但名稱相近不代表共用發布管道或維護週期。舊教學中的操作介面可能已經改變;閱讀時請先確認內容討論的是核心欄位、用戶端操作,還是特定訂閱服務提供者的轉換規則。

介面、核心與訂閱的分工

用戶端負責管理設定、接入系統與顯示連線資訊;核心負責解析設定、比對規則並建立連線;訂閱服務提供者則負責維護下發內容。同一份訂閱在兩款用戶端上的結果可能不同,例如其中一款可能額外加入 DNS 或監聽設定。排查時請分別保留訂閱原文與最終生效設定,比較兩者差異,會比只看介面開關更可靠。

mihomo 與欄位相容性

mihomo 延續 Clash Meta 核心的發展,在代理協定、規則集與網路堆疊設定方面增加了更多選項。原版設定中常見的基本欄位仍可作為遷移起點,但同名欄位的可用值與相依條件,應以目標核心為準。若解析失敗,先依錯誤訊息找出第一個出問題的欄位,再查閱設定參考;若不熟悉術語,可對照名詞解釋。

發布紀錄與升級回復

用戶端發布紀錄與核心變更紀錄應分開查看。升級前請保留可用設定與必要的本機覆寫;升級後先確認設定可載入,再檢查系統代理、解析路徑與規則命中情況。回報可重現的問題時,請說明使用的平台、接入方式與最小重現設定,並移除個人網域、訂閱參數及節點憑證。先描述實際結果,再補充預期結果,方便維護者判斷問題所在的層級。

取得 mihomo 原始碼

核心以 GPL-3.0 授權發布。以下指令用於取得原始碼,不是安裝桌面用戶端的指令。若要安裝圖形介面用戶端,請返回安裝檔頁面,依作業系統選擇。

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

用戶端資訊

查看所有文章 →