開源社群 · 全平台用戶端

Clash 用戶端下載與設定檔參考

從用戶端挑選到規則分流,一次查閱 config.yaml 常用欄位與實際操作。

程式碼開源YAML 設定中文文件
config.yaml YAML

config.yaml

Clash開源社群 · 設定工作區

連接埠與模式

mixed-port: 7890allow-lan: falsemode: rulelog-level: info

DNS

enable: trueenhanced-mode: fake-ipnameserver:- 223.5.5.5- 119.29.29.29

代理節點

name: 範例節點type: ssserver: example.comport: 443udp: true

策略組

select url-test fallback load-balance

規則

DOMAIN-SUFFIXDOMAIN-KEYWORDGEOIP,CN,DIRECTMATCH,PROXY

覆寫與合併

prepend-rulesappend-proxies合併順序

延伸閱讀

欄位摘錄,並非完整設定;覆寫鍵由用戶端解讀。

欄位速查 / CONFIG

config.yaml 中
最常修改的六個區段

先分清輸入端、出口與比對順序,再調整參數。連接埠負責接收連線,節點負責提供出口,策略組負責整理出口,規則則決定流量要交由哪個出口處理。

這些片段用來理解欄位,不應直接拼在一起啟用。節點名稱、策略組名稱與規則目標必須互相對應;不同核心及用戶端支援的擴充功能,也要分別確認。

瀏覽器或其他應用程式需要本機代理入口,mixed-port 可在同一個連接埠接受 HTTP 與 SOCKS 代理連線。先查看用戶端顯示的實際監聽連接埠,再填入應用程式設定;這不是節點伺服器的連接埠。若啟動日誌顯示位址已被占用,先關閉其他代理程序,再決定是否更換連接埠。僅在本機使用時,請關閉區域網路存取。這裡的 rule 表示依規則分流,不代表系統已將流量送入核心;系統代理或 TUN 仍須另外設定。

mixed-port: 7890
allow-lan: false
bind-address: "127.0.0.1"
mode: rule
log-level: info
ipv6: false
用戶端下載 / PLATFORMS

依作業系統挑選 Clash 用戶端

先選擇作業系統,再確認處理器架構。圖形用戶端負責匯入訂閱、管理設定及控制核心;若只有命令列核心,還需要自行安排設定檔路徑、啟動參數與系統服務。日常使用桌上型電腦或手機時,通常從圖形用戶端開始,更容易找出問題。

Windows

適合需要系統匣管理、系統代理與可視化規則面板的桌面使用者。下載頁依序列出 Clash Plus、Clash Verge Rev、FlClash 等用戶端,也保留 Clash for Windows 的封存說明。

從舊用戶端遷移時,請先備份訂閱網址與自訂規則,不要直接複製整個程式資料夾。若安裝後可啟動,但應用程式沒有經過代理,先檢查系統代理開關、實際連接埠與應用程式本身的代理設定,再考慮啟用 TUN。

前往下載 Windows 用戶端

macOS

先在「關於這台 Mac」確認使用的是 Apple Silicon 還是 Intel,再選擇相符的安裝檔。Clash Plus、Clash Verge Rev 與 FlClash 的介面及設定管理方式各有不同,系統需求請以下載頁說明為準。

系統代理與終端機環境變數是兩條不同的路徑。瀏覽器連線正常,不代表命令列工具也已使用代理;終端機連線異常時,應確認該工具支援的代理參數。安裝輔助服務需要權限,依照用戶端提示逐步處理即可。

前往下載 macOS 用戶端

Android

手機使用者可從 Clash Plus、Clash Meta for Android、FlClash 與 Surfboard 中挑選。請注意,各用戶端支援的訂閱格式不盡相同;檔案成功下載只代表取得檔案,不代表所有欄位都能正確辨識。

首次啟動連線時,需確認系統的 VPN 授權。若鎖定螢幕後連線中斷,先檢查系統的電池管理與背景執行限制;同時執行另一個使用 VPN 通道的應用程式,也可能造成衝突。依應用程式分流時,請確認所選應用程式是加入允許清單還是排除清單。

前往下載 Android 用戶端

iOS

下載頁提供 Clash Plus 的 App Store 下載入口,並列出官方網站 clashplus.io。安裝後依照介面提示匯入支援的設定,確認策略組中有可選節點,再允許系統新增 VPN 設定。

切換 Wi-Fi 與行動網路後,DNS 解析環境及可用出口可能改變。若網頁一直停留在載入畫面,先確認問題是訂閱無法更新、節點連線失敗,還是特定網域的規則不合適。不要預設桌面用戶端的擴充指令碼也能直接在手機上執行。

前往下載 iOS 用戶端

Linux

桌面環境可優先查看 Clash Verge Rev 與 FlClash;伺服器或路由器使用者則可考慮 mihomo 核心。套件格式、處理器架構與發行版執行環境都要一併確認,不能只看檔名是否包含 Linux。

命令列工具通常需要另外設定代理環境變數;系統服務也不會自動沿用目前終端機的設定。啟用透明代理前,先用本機代理連接埠確認基本連線,再檢查路由、DNS 與防火牆,避免一次修改就混入多項網路變更。

前往下載 Linux 用戶端

安裝檔提供執行環境,訂閱則提供連線參數。本網站整理用戶端與設定相關知識;安裝軟體後,仍需自行準備有效且獲授權的節點或訂閱。請勿在公開截圖、問題回報或分享的設定中洩漏訂閱網址或驗證資訊。

查看所有用戶端 →
開源生態系 / SOURCE

Clash、用戶端與 mihomo

這三個名稱經常一起出現,但指的並不是同一樣東西。挑選用戶端要看操作體驗,查詢欄位要看核心文件,排除問題則要查看實際執行設定。釐清各自的層次,才能找出許多「換個軟體就好了」問題背後的真正原因。

前往 mihomo 開源儲存庫 ↗

從 Clash 專案到持續發展的生態系

Clash 以規則驅動的代理核心及 YAML 設定,建立了廣泛使用的操作方式。原 Clash 專案與部分早期圖形用戶端停止維護後,社群沿著不同方向持續發展:有些專注於介面與訂閱管理,有些則持續擴充核心通訊協定與規則功能。因此,「Clash 設定」更像是生態系中的常見說法,並不保證所有軟體都支援相同欄位。

Clash for Windows 停止更新後,挑選替代方案應考量仍在維護的用戶端、作業系統支援度與設定遷移成本,而不只是介面是否熟悉。舊教學中的選單位置、輔助服務安裝方式與欄位預設值,可能已不適用於目前的用戶端。保留舊設定作為參考固然有用,重新匯入後仍應檢查解析結果、策略組引用及系統接管方式。

圖形介面與核心各自負責不同部分

圖形用戶端通常負責下載訂閱、切換設定、系統匣操作與顯示日誌;mihomo 等核心則負責解讀設定、比對規則、解析網域及建立連線。介面上看得到某個開關,不代表設定檔中一定有同名欄位;反過來說,核心支援的擴充參數,也不一定能在每個用戶端介面中直接編輯。查閱資料時,應同時確認用戶端名稱與核心類型。

mihomo 延續 Clash 生態系的設定方式並持續擴充,專案採用 GPL-3.0 授權;原始碼、變更內容與問題討論都可在儲存庫中查閱。此授權適用於相應的開源專案,不應直接套用到所有第三方介面、商店應用程式或配套服務。本網站定位為整理社群資料;用戶端發行、商店資訊與功能範圍仍由各專案自行決定。

更新前先看變更,更新後確認結果

用戶端更新、核心更新與訂閱重新整理是三件不同的事。更新用戶端可能改變介面與系統整合;更新核心可能影響欄位解析及連線行為;重新整理訂閱則主要變更節點與規則來源。遇到異常時,先記下最近變更的是哪個部分,避免把訂閱錯誤歸咎於安裝檔,也不要為了一個失效節點反覆重新安裝軟體。

較穩妥的做法是保留目前可用的設定,一次只修改一類選項;重新載入後查看日誌是否有錯誤,再測試目標應用程式的實際連線。測試節點時固定測試條件;連線失敗時,記錄時間、目標網域與命中規則。分享日誌前請移除伺服器驗證資訊與訂閱參數;提供可重現的步驟,通常比只拍下紅色錯誤訊息的截圖更有幫助。

檢視原始碼 · 需先在本機安裝 Git

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

複製儲存庫是為了閱讀原始碼與文件,不會自動安裝用戶端,也不會提供可用節點。若只想日常使用,直接選擇下載頁中的圖形用戶端即可。

近期文章 / NOTES

匯入訂閱與連線排錯

先判斷問題出在取得設定、解析設定,還是建立連線的階段。文章依實際情境說明,不必先讀完所有欄位文件;帶著錯誤訊息與實際設定查找,通常更容易找到下一步。

下載用戶端