Windows
適合需要系統匣控制、系統代理與切換設定檔的桌面使用者。尋找 Clash for Windows 替代方案時,可優先比較 Clash Plus 與 Clash Verge Rev,並確認作業系統架構、服務權限及 TUN 支援。遷移前先保留原設定,匯入後測試,避免直接覆蓋現有工作環境。
前往下載依作業系統選擇用戶端,按欄位查閱YAML 設定,從 DNS 到規則掌握分流路徑。
此片段僅展示欄位階層,並非完整代理設定;PROXY 目前只有 DIRECT,實際使用時須匯入有效節點並加入策略組。
先確認作業系統與處理器架構,再選擇圖形化用戶端。Clash Plus 在 Windows、macOS、Android 與 iOS 的下載清單中優先推薦;Linux 可先考慮 Clash Verge Rev。用戶端負責管理設定與整合系統,真正解析欄位、建立連線的是核心。介面看起來相似,不代表支援的設定功能完全相同。
適合需要系統匣控制、系統代理與切換設定檔的桌面使用者。尋找 Clash for Windows 替代方案時,可優先比較 Clash Plus 與 Clash Verge Rev,並確認作業系統架構、服務權限及 TUN 支援。遷移前先保留原設定,匯入後測試,避免直接覆蓋現有工作環境。
前往下載先在系統資訊中確認是 Apple Silicon 還是 Intel,再下載相應安裝檔。系統代理與網路延伸功能的授權方式可能不同,首次啟動時請依用戶端提示完成設定。既有設定可以遷移,但開機啟動、代理接管與本機路徑等選項,都需要在新用戶端重新確認。
前往下載行動裝置通常透過系統 VPN 介面接管流量。安裝前確認裝置架構,連線前完成系統授權;若鎖定螢幕後連線中斷,請檢查電池最佳化與背景執行限制。依應用程式分流屬於用戶端功能,與 YAML 中依網域或目標位址分流的規則並非同一層設定。
前往下載從下載頁前往 Clash Plus 的 App Store 頁面,官方網站為 clashplus.io。匯入訂閱後,先確認用戶端是否辨識出節點與策略組,再允許新增 VPN 設定。部分桌面版可用的底層網路參數,在行動裝置上可能由系統接管,請以用戶端實際支援的功能為準。
前往下載桌面使用者可比較 Clash Verge Rev 與 FlClash,並依 Linux 發行版選擇套件格式。伺服器與路由器使用者可參考 mihomo 核心入口,自行管理服務與設定路徑。啟用透明代理前,先了解路由、DNS 與權限之間的關係;遠端操作時,請保留可用來復原的管理連線。
前往下載安裝檔只包含用戶端,不會自動附上可用的代理服務。訂閱網址通常含有存取憑證,請妥善保存在可信任的裝置中;分享設定或記錄檔前,先移除敏感參數。查看所有用戶端 →
一條連線的流程可分為入口、模式、解析、節點、策略與規則六個部分。以下依序說明各層設定:先看重點,再對照 YAML 範例。範例都是局部片段,不能直接拼接成完整訂閱;手動選取欄位後,自動輪播會停止。
mixed-port: 7890allow-lan: false
bind-address: 127.0.0.1連接埠欄位設定的是本機監聽入口,不是遠端節點的連接埠。port 接收 HTTP 代理連線,socks-port 接收 SOCKS 代理連線,mixed-port 則可在同一個連接埠接收這兩類連線。上例只監聽本機,應用程式需將代理位址設為本機位址與對應連接埠。常見設定錯誤包括只啟動核心,卻未設定應用程式代理;或兩個用戶端占用相同連接埠。允許區域網路存取前,應一併檢查綁定位址、防火牆與驗證設定,不能只切換單一選項。
mode: rulelog-level: info
rules:
- GEOIP,CN,DIRECT
- MATCH,PROXY日常依網站分流通常選擇 rule,由核心依規則順序決定連線出口;global 使用 GLOBAL 策略;direct 則採用直連。模式只控制已進入核心的連線,不會自動讓所有應用程式使用代理。全域模式也不代表一定會走遠端節點,仍須檢查 GLOBAL 目前選取的項目。排查規則時,可暫時切換模式進行比對,但請先記下原本的設定。用戶端可能透過執行時介面變更模式,因此磁碟上的設定值未必等於目前生效的值。
dns:
enable: true
enhanced-mode: fake-ip fake-ip-range: 198.18.0.1/16
nameserver:
- https://dns.alidns.com/dns-queryfake-ip 會回傳一個映射位址給應用程式,讓核心在後續連線中對應原始網域;redir-host 則回傳實際解析出的位址。兩種模式會影響網域辨識與應用程式相容性,不是節點加速開關。範例雖啟用了核心 DNS,系統查詢是否會進入這裡,仍取決於用戶端的 DNS 接管設定。若區域網路裝置或特定應用程式發生異常,應先檢查查詢路徑與快取,再判斷是否需要排除特定網域。只修改增強模式而不檢查系統 DNS,實際解析路徑可能完全不變。
proxies:
- name: example-socks
type: socks5 server: 127.0.0.1
port: 1080proxies 用來設定單一代理出口的參數;訂閱網址則用於取得設定或一組節點。每個節點通常需要名稱、協定、伺服器與連接埠,驗證和傳輸欄位則因協定而異。範例指向本機 SOCKS 服務,只用來展示結構,不代表可用的遠端節點。常見設定錯誤包括把訂閱連結填進伺服器欄位、連接埠使用錯誤的資料結構,或採用目前核心不支援的協定。節點定義完成後,還需要由策略組或規則引用,才能成為實際的連線出口。
proxy-groups:
- name: PROXY
type: select proxies:
- example-socks
- DIRECTproxy-groups 可將節點與其他策略組組合成可供引用的出口。select 用於手動選擇,url-test 依測試結果選擇,fallback 依序尋找可用項目,load-balance 則依策略分配連線。自動策略組的測試目標應能反映實際需求,單次測得較短的時間,不代表所有服務都會變快。範例依賴前面已定義的 example-socks。名稱必須完全一致,策略組之間不可互相循環引用,也不要把組名誤當成協定類型。
rules:
- DOMAIN-SUFFIX,example.com,PROXY - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- GEOIP,CN,DIRECT
- MATCH,PROXYrules 會由上往下比對,符合後便使用該條規則指定的策略,不會繼續尋找更精確的規則。因此,特定網域與區域網路位址通常應排在範圍較廣的規則之前,並將 MATCH 放在最後作為兜底。目標策略必須是已存在的節點、策略組或內建動作。若應用程式的連線結果不如預期,請在連線詳細資訊中核對網域、目標位址與命中規則,不要一味新增重複規則。核心能否辨識網域,也與 DNS 和流量接入方式有關;語法正確不代表一定能符合比對條件。
初次使用時,先完成最短的可行流程:設定能載入、策略有出口、應用程式能接入。不要同時修改連接埠、DNS、TUN 與規則;每次只調整一個層面,發生異常時才容易找出原因。以下是完整入門流程的三步預覽。
開啟用戶端的設定或訂閱管理頁面,新增可信來源提供的訂閱連結,或匯入本機 YAML 檔案。更新完成後,確認設定已選取,且清單中有節點與策略組。若出現解析錯誤,先檢查錯誤行附近的縮排、冒號與清單結構;不要試圖靠反覆重新安裝用戶端來修正內容錯誤。遠端訂閱下載成功,也不代表每個節點都能連線。
先使用規則模式,找出規則引用的主要策略組,並選取一個有效節點。桌面版開啟系統代理後,確認連接埠與目前用戶端一致;行動裝置則依提示允許建立 VPN。若有應用程式不會讀取系統代理,TUN 可能是較合適的接管方式,但會涉及路由與權限,建議先確認一般代理連線正常再啟用,避免混淆接入失敗與節點故障。
開啟目標網站,並在用戶端的連線清單中查看應用程式、目標網域、命中規則與最終出口。網頁能開啟不代表分流方式符合預期,測速成功也不代表特定網站一定可用。若瀏覽器正常但終端機無法連線,請檢查終端機是否讀取代理環境變數;若全部逾時,先檢查本機網路與節點狀態。驗證完成後,請關閉暫時啟用的詳細記錄。
先保留一份已驗證可用的設定,再逐步加入應用程式分流或自動策略。遇到問題時,切回基準設定即可判斷原因來自新變更還是網路環境。查看完整教學 →
判斷設定能否使用,應檢查核心與欄位支援情況,而不只是看用戶端名稱。本網站整理下載入口與中文欄位說明,不代表任何用戶端的開發團隊。開源程式碼、專案文件與實際執行記錄,是確認功能行為的重要依據。
Clash 生態系經歷了原專案停止維護、社群分支持續發展的過程。原用戶端儲存的 YAML、策略選擇與本機設定,未必能原樣遷移至新用戶端。mihomo 延續並擴充了相關設定功能,但舊版核心通常無法辨識新加入的協定或欄位。查閱範例時,請先確認文件適用的核心,再判斷是否符合目前的使用環境。
下載清單中的 Clash for Windows 與 ClashX Meta 已標示為停止維護的封存項目。新裝置建議優先考慮仍在維護的方案;若舊環境確實有相依需求,請先評估系統相容性與所需協定,不要只因介面熟悉就做選擇。查看用戶端挑選建議 →
用戶端負責匯入設定、系統匣選單、更新訂閱與系統代理等操作;核心負責讀取設定、解析網域、比對規則與建立對外連線;服務提供者則維護遠端伺服器及訂閱內容。這三個部分可能分別發生問題。介面顯示已連線,只能代表某個本機狀態成立,不能證明遠端服務可用,也不代表所有應用程式都已接管。
同一個節點在不同用戶端的表現不一,應比較核心、協定參數與 DNS 接管方式。同一用戶端在不同網路下結果不同,則還要考慮網路業者、路由與伺服器端限制。將問題分層檢查,比直接更換所有設定更容易找出可重複驗證的原因。
mihomo 採用 GPL-3.0 開源授權,原始碼、提交紀錄與問題討論都可在專案儲存庫查閱。核心的授權不代表所有圖形化用戶端都採用相同授權;散布或修改前,應查閱各專案的說明。程式碼開源讓使用者能檢視實作,但不能取代對安裝來源、操作權限與網路行為的判斷。
查找欄位行為時,先閱讀對應文件,再搭配記錄檔驗證。回報問題時,請說明作業系統、用戶端名稱、核心資訊、最小設定與重現步驟;不要公開完整訂閱網址、驗證資訊或可辨識個人的連線記錄。精簡的重現資料有助於區分設定問題與程式缺陷。
更新用戶端、更新核心、更新訂閱與更新規則資源是四種不同操作。更新用戶端時可能一併更換核心;更新訂閱可能替換節點與策略組;更新規則資源則只會影響對應的比對集合。操作前請確認此次更新會修改哪個層面,並保留可供還原的設定與自訂內容。
長期維護時,請分開管理遠端訂閱與本機覆寫,並記錄規則用途。策略組名稱變更後,應檢查自訂規則是否仍引用有效目標。DNS 模式變更後,可依需要清除相關快取再測試,避免舊映射影響判斷。設定成功載入後,仍須透過實際連線確認更新效果。
已安裝 Git 的使用者可複製以下指令,在本機取得公開儲存庫以供閱讀。複製原始碼不等於安裝或啟動用戶端;一般使用者直接從下載頁挑選圖形化用戶端即可。
git clone https://github.com/MetaCubeX/mihomo.git
欄位參考適合逐項查閱,文章則會針對單一問題說明判斷流程。以下依發布日期列出最近三篇,涵蓋系統代理接入、記錄檔判讀與多份設定管理等不同使用情境。
系統代理已開啟,但網頁或命令列仍未使用代理時,可分別檢查瀏覽器擴充功能與代理設定、終端機環境變數 http_proxy,以及 TUN 模式等替代方式。
說明 log-level 各級別的輸出差異,逐一解析 dial tcp 逾時、i/o timeout、規則未命中等常見記錄,並提供透過記錄檔定位問題的思路。
說明 Profile 在用戶端中的意義,區分遠端訂閱與本機 YAML 兩類設定,並介紹多份設定的命名、更新、切換方式,以及如何保留自訂規則。