Windows
建議先查看 Clash Plus,也可比較 Clash Verge Rev、FlClash 等圖形介面用戶端。先到「設定 → 系統 → 系統資訊」確認系統類型;安裝後若無法啟動,再檢查執行環境與安全性提示,避免反覆覆寫設定資料夾。
前往下載六項常用設定,先看欄位,再看解答。示意內容不會修改本機設定。
訂閱網址 · 範例
匯入成功卻沒有代理?
先確認目前的設定已啟用。
全域模式會比較快嗎?
模式會改變流量的走向,不會提升線路品質。
mixed-port: 7890
allow-lan: false
7890 被占用怎麼辦?
變更連接埠後,記得同步系統代理設定。
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
取得虛擬位址是錯誤嗎?
fake-ip 回傳映射位址是預期行為。
DOMAIN-SUFFIX,google.com,PROXY
GEOIP,CN,DIRECT
MATCH,PROXY
為什麼後面的規則沒有生效?
規則會依由上而下、首次符合即套用的順序執行。
infoStart initial configuration in progress
infoMixed(http+socks) proxy listening at: 127.0.0.1:7890
監聽成功不代表遠端連線成功。
繼續查詢
依作業系統挑選
挑選安裝檔時,先確認作業系統,再確認處理器架構。桌面圖形介面用戶端適合日常操作,獨立核心則適用於伺服器與路由器,兩者的安裝方式不同。下載中心列出用戶端、系統需求與封存狀態;首頁則保留各平台入口。
建議先查看 Clash Plus,也可比較 Clash Verge Rev、FlClash 等圖形介面用戶端。先到「設定 → 系統 → 系統資訊」確認系統類型;安裝後若無法啟動,再檢查執行環境與安全性提示,避免反覆覆寫設定資料夾。
前往下載在「關於這台 Mac」確認是 Apple 晶片還是 Intel 處理器,再選擇相符的安裝檔。首次啟動與授權系統代理是兩回事;應用程式能開啟,不代表系統流量已交由代理處理。若要接管更多應用程式,再依文件設定網路延伸功能或 TUN。
前往下載可從 Clash Plus、Clash Meta for Android 等用戶端中挑選。匯入設定後,還要確認已授權系統 VPN;若鎖定螢幕後斷線,優先檢查電池最佳化與背景執行限制。同時啟用其他 VPN 類應用程式,可能會讓系統切換目前的連線。
前往下載前往下載中心開啟 Clash Plus 的 App Store 頁面;官方網站為 clashplus.io。匯入前先確認訂閱格式相容;新增 VPN 設定時,依照系統提示完成授權。如果設定內容缺少代理或策略組,只開啟連線開關也無法補上。
前往下載桌面環境可參考 Clash Verge Rev 與 FlClash,並依發行版選擇套件。純命令列環境則查看 mihomo 核心區,另外設定設定檔路徑、服務權限與記錄輸出。不要直接將桌面應用程式的安裝步驟套用到路由器系統。
前往下載常用欄位問答
先分清用戶端介面、實際執行的核心,以及目前使用的設定檔。不同用戶端的選單名稱可能不同,但連接埠、模式、DNS 與規則仍可逐項對照欄位確認。以下片段僅用於說明個別設定,並非可直接連線的完整訂閱。
先確認訂閱確實已更新成功,再確認目前已選取該設定。在用戶端的「設定」或「訂閱」頁面新增服務提供者給的網址,更新後查看是否出現代理與策略組。網址能在瀏覽器開啟,不代表回傳內容就是相容的 Clash 設定;登入頁面、到期提示與純文字錯誤訊息都不能直接當成 YAML。若更新失敗,先查看狀態碼與記錄,不要急著修改 DNS。訂閱連結通常包含個人存取憑證,截圖或回報問題前應遮住完整連結;公開範例只保留網域與參數名稱。
也要分清「設定匯入成功」與「線路可用」:前者表示用戶端接受了內容,後者則必須實際發起連線才能判斷。切換設定後,確認策略組仍選取預期線路;本機修改的內容也可能在下次更新訂閱時被覆蓋。
查看訂閱匯入步驟 →日常使用通常先選規則模式,讓不同要求依設定分流;暫時要確認是否為規則問題時,再切換全域模式進行比對。全域模式不會讓線路本身變快,而且仍須選取 GLOBAL 對應的代理。直連模式會讓進入核心的要求走直連路徑,適合用來確認本機網路是否正常。三種模式改變的是已進入核心的流量走向,不會自動接管所有應用程式;未遵循系統代理設定的程式,還需另外設定代理,或視需要使用 TUN,不能只靠切換模式解決。
mode: rule
mode: global
mode: direct
可以修改連接埠,但要先確認占用連接埠的是不是舊的執行個體。同一台裝置同時啟動多個代理用戶端,最容易發生監聽衝突;結束不需要的執行個體,通常比隨意修改設定更容易釐清問題。確實需要更改連接埠時,可將 mixed-port 改成未被占用的值,再重新載入設定,確認記錄中出現新的監聽位址。接著同步系統代理與應用程式的代理連接埠,否則瀏覽器仍會連到舊位址。allow-lan 用來控制是否允許區域網路存取,不是解決本機衝突的開關;僅供本機使用時維持 false,較容易控管存取範圍。
查看連接埠占用排查方式 →config.yaml · 本機混合連接埠範例
mixed-port: 7891
allow-lan: false
mode: rule
先判斷是網域名稱解析失敗,還是解析後連線失敗。檢查 dns.enable、目前核心支援的欄位,以及應用程式是否真的使用這條解析路徑。fake-ip 回傳映射位址是正常機制,不能只因位址看起來不像公網 IP 就判定設定錯誤。nameserver 是上游解析伺服器;fallback 也不是「所有要求都再備用一次」的簡單開關,實際作用方式須配合篩選條件與核心行為理解。瀏覽器內建的加密 DNS 也可能繞過預期路徑。排查時一次只修改一個變數,並記錄修改前後的記錄,比同時更換所有解析伺服器更容易找出原因。
以下僅為欄位結構範例:本機 DNS 監聽於迴圈位址,不能因此認定系統已自動使用它。是否需要 DNS 劫持,以及如何搭配 TUN,應繼續確認用戶端的流量接管方式;更新設定後也要留意應用程式與系統快取。
查看 DNS 欄位與解析路徑 →config.yaml · DNS 局部結構
dns:
enable: true
listen: 127.0.0.1:1053
enhanced-mode: fake-ip
nameserver:
- 223.5.5.5
先確認目前確實使用規則模式,再從規則清單頂端開始檢查。比對邏輯是首次符合便停止,前面的寬鬆規則可能已經接走要求;MATCH 通常用於兜底,放得太前面會讓後續規則沒有機會生效。規則結尾的策略名稱必須與設定中的代理或策略組完全一致;PROXY 在此只是範例名稱,並非每份設定都內建的保留策略。排查時開啟連線詳細資訊,核對實際要求的網域、符合的規則與最後的出口,不要只憑網頁顯示結果猜測。也要留意既有連線可能沿用舊路徑,修改後應重新發出要求。
查看規則語法與順序 →config.yaml · 須先定義名為 PROXY 的策略組
rules:
- DOMAIN-SUFFIX,google.com,PROXY
- GEOIP,CN,DIRECT
- MATCH,PROXY
「已連線」通常只表示本機服務或網路接管已啟動,不代表遠端線路可用。先關閉代理,確認本機網路能否瀏覽一般網站,再查看啟動記錄是否有設定解析、連接埠監聽或權限錯誤。接著開啟目標網頁,檢查連線清單是否出現要求:若沒有記錄,優先檢查系統代理或 TUN;若有記錄但逾時,再檢查策略組選擇、DNS 與遠端連線。Clash 節點測速只能反映指定測試位址的回應,延遲低不代表所有網站都能連線。若遇到閃退,先保留錯誤記錄,再檢查設定、核心檔案與系統執行環境,不要直接清空整個資料目錄。
回報問題時,建議附上系統類型、用戶端名稱、核心資訊、操作步驟,以及錯誤發生前後幾行記錄。隱藏訂閱憑證與伺服器驗證資訊,但保留欄位名稱及原始錯誤內容;只有一張「無法連線」的截圖,通常不足以判斷故障層級。
依故障狀況繼續排查 →專案與文件參考
下載前先查看維護狀態,修改前先閱讀核心文件。本網站整理用戶端下載入口與使用問答,不混淆不同專案的功能、授權方式與發布週期,也不會把所有社群用戶端都稱為同一款官方應用程式。
Clash 生態系常見的桌面與行動應用程式,通常會在圖形介面之外整合代理核心。訂閱管理、系統匣選單與系統代理開關屬於用戶端功能;通訊協定解析、規則比對與 DNS 處理則主要由核心負責。因此,換個介面不一定會改變線路品質,同一份 YAML 在不同核心上也不一定支援完全相同的擴充欄位。遇到設定錯誤時,應先確認正在執行的核心,再查閱對應文件。
原始 Clash 專案停止公開維護後,社群仍推出了不同方向的後續專案。mihomo 是其中持續發展的核心專案,部分用戶端介面與舊教學仍會使用 Clash Meta 等舊名稱。名稱相近不代表發布者相同;挑選用戶端時,應依據作業系統支援、實際維護狀況與所需通訊協定判斷。封存應用程式可供舊環境參考,但不應將舊截圖中的選單與新核心參數逐一對應。
圖形介面用戶端與內建核心可能各自更新;修正介面問題與調整規則行為也不是同一回事。更新前請備份本機覆寫設定、規則檔案與必要選項,並閱讀專案發布說明中的相容性變更。若更新後出現異常,先以原設定進行最精簡的比對,確認問題來自設定、核心還是網路接管方式。訂閱服務提供者發布的內容與用戶端升級也互相獨立;更新應用程式無法修復已失效的訂閱網址。
近期設定筆記
需要完整操作流程時,可從下方專題繼續閱讀。模式問題先確認流量走向,背景斷線先檢查系統授權與省電限制,連接埠衝突先找出占用程序;不要把不同層級的故障一概歸因於節點無法使用。
比較規則、全域、直連三種代理模式的流量走向與適用情境,說明日常使用為何建議採用規則模式,以及暫時切換全域模式時的注意事項。
閱讀代理模式選擇說明 →說明 Android 端 VpnService 授權視窗、常駐通知、電池最佳化白名單與各品牌的背景管理設定,解決鎖定螢幕後連線自動中斷的問題。
閱讀背景斷線排查方式 →使用系統指令找出占用 7890 等連接埠的程序,判斷應結束程序或更改連接埠,並說明修改 mixed-port 後同步系統代理與瀏覽器設定的方法。
閱讀連接埠處理步驟 →