Windows
適合桌面瀏覽器、開發工具與日常應用程式。安裝前請在系統設定中確認裝置類型,並依架構選擇安裝檔;開啟用戶端後,先啟用設定,再開啟系統代理。
Clash Plus、Clash Verge Rev 與 FlClash 的選單位置各不相同,但訂閱、代理群組和記錄檔都是常見的排查入口。遷移舊版用戶端時,請備份設定來源,不要只複製程式資料夾。
前往下載 →先確認平台與處理器架構,再選擇用戶端。圖形介面負責管理訂閱和開關,實際支援的協定、規則與網路模式則取決於所使用的核心。
適合桌面瀏覽器、開發工具與日常應用程式。安裝前請在系統設定中確認裝置類型,並依架構選擇安裝檔;開啟用戶端後,先啟用設定,再開啟系統代理。
Clash Plus、Clash Verge Rev 與 FlClash 的選單位置各不相同,但訂閱、代理群組和記錄檔都是常見的排查入口。遷移舊版用戶端時,請備份設定來源,不要只複製程式資料夾。
前往下載 →先在「關於這台 Mac」中確認使用的是 Apple 晶片還是 Intel 處理器。安裝並啟動用戶端後,依系統提示授予必要權限,再檢查選單列中的執行狀態與目前設定。
系統代理與 TUN 是兩種不同的流量接入方式。首次設定建議先測試瀏覽器,確認規則生效後再處理其他應用程式,避免同時變更多個開關而失去排查線索。
前往下載 →行動裝置通常透過系統 VPN 介面接入流量。匯入訂閱並選擇設定後,啟動連線時請依提示確認授權;若另有 VPN 應用程式正在執行,應先確認兩者是否爭用同一介面。
背景連線中斷不一定是訂閱問題。請分別檢查電池管理、背景執行權限,以及網路切換後的記錄檔。不同品牌系統的設定入口各異,請以裝置上的實際選單為準。
前往下載 →下載頁提供 Clash Plus 的 App Store 安裝入口,並列出官方網站 clashplus.io。安裝後請先確認用戶端是否支援訂閱格式,再儲存設定,並依系統提示加入 VPN 設定。
桌面版可用的完整 YAML 不一定能直接移轉至行動版。若匯入失敗,請核對格式與支援欄位;不要把帳戶頁面網址當成訂閱網址,也不要在公開截圖中露出連結參數。
前往下載 →桌面使用者可從 Clash Verge Rev 或 FlClash 開始,依 Linux 發行版選擇相應套件格式;伺服器與路由器使用者則應區分圖形用戶端和獨立 mihomo 核心。安裝軟體只是第一步,設定檔路徑、執行權限與服務啟動方式仍需另外設定。
命令列工具不一定會讀取桌面環境的系統代理。瀏覽器可連線但終端機失敗時,請先確認應用程式使用的代理協定與本機連接埠,再檢查環境變數。不要為了解決單一程式的連線問題,就把監聽位址開放給整個區域網路。
前往下載 →訂閱提供設定來源,代理群組提供選擇入口,規則則決定連線去向。先釐清這幾個層次,再修改個別欄位,比逐一嘗試開關更容易找出問題。
以下為 mihomo 設定欄位或選項示意,並非可直接連線的完整訂閱。點選或聚焦標籤後,動畫會自動暫停。
訂閱連結是取得設定的網址,並非用戶端內建的連線服務。請在「設定檔」或「訂閱」頁面貼上現有連結,下載成功後還需選取並啟用。完整的遠端設定通常包含代理群組與規則;代理提供者則只載入代理項目,需由主設定中的代理群組引用。更新時會重新讀取遠端內容,直接修改遠端檔案可能會被覆寫。需要長期保留的設定,應使用用戶端提供的覆寫功能。連結中的存取參數應視為帳戶憑證妥善保管。
查看訂閱匯入步驟 →# 將本機訂閱檔案作為代理提供者
proxy-providers:
my-sub:
type: file
path: ./providers/my-sub.yaml
proxy-groups:
- name: PROXY
type: select
use: [my-sub]
規則模式會依清單順序比對連線,通常由第一條符合的規則決定去向,最後的 MATCH 則接收其餘連線。在用戶端切換至「規則」模式後,可在連線頁面查看命中的規則,不必只靠網頁能否開啟來猜測。網域規則適合依服務區分,位址規則則適合指定明確的網路範圍。與全域模式相比,規則模式可同時使用直連與代理,但規則名稱必須對應有效的代理群組。調整前先儲存原設定,每次只變更一項並重新測試。
閱讀規則與核心參考 →mode: rule
rules:
- DOMAIN-SUFFIX,example.com,PROXY
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,PROXY
# PROXY 必須在主設定中定義
代理群組會將多個代理項目組成一個可供規則引用的出口。在「代理」頁面展開對應群組後,手動選擇通常對應 select 類型;自動偵測與故障轉移則由其他群組類型實現。切換群組中的選項不必重寫每條規則,也不代表所有應用程式會立即改用同一出口,既有連線可能仍會持續。排查時先確認規則指向哪個群組,再檢查群組內目前選取的項目。不要把清單中的群組名稱當成協定名稱,協定能力仍取決於個別代理項目和核心。
了解模式與代理選擇 →proxy-groups:
- name: PROXY
type: select
proxies:
- DIRECT
use:
- my-sub
# my-sub 必須在代理提供者中定義
TUN 透過虛擬網路介面接入流量,可用來處理不讀取系統代理的應用程式。開啟用戶端設定前,請確認核心支援、服務權限與系統授權;行動裝置上的選項名稱可能不同。TUN 與瀏覽器讀取代理位址的方式不同,還會涉及路由與 DNS,不能簡單視為更強的全域模式。若開啟後本機網路異常,請先關閉 TUN 以恢復原狀,再檢查自動路由、網段衝突和其他 VPN 軟體。實際欄位請以目前用戶端與核心文件為準。
查看網路模式排查方法 →# 接入方式示意,DNS 需另外設定
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
# 開啟前檢查執行權限與路由衝突
覆寫可將本機偏好套用至遠端設定,減少訂閱更新後反覆修改的操作。常見入口名稱包括「覆寫」、「合併」或「擴充設定」,各用戶端的合併順序與陣列處理方式並不相同。請先確認覆寫的作用範圍,再從連接埠或記錄檔層級等單一項目開始測試。覆寫與直接編輯訂閱原文的差別,在於修改可獨立儲存,但不代表任何欄位都能安全疊加。規則插入位置、代理群組名稱重複與 DNS 設定尤其需要檢查最終產生的設定。
閱讀 Profile 與多重設定說明 →# 常見合併欄位;入口與優先順序依用戶端而異
mixed-port: 7890
allow-lan: false
log-level: info
# 儲存後檢查最終設定,再重新載入
依照「設定來源 → 規則出口 → 應用程式接入」的順序完成操作。先建立可重複驗證的基準,再考慮 TUN、自訂 DNS 或複雜覆寫。
安裝完成後,開啟用戶端的設定管理頁面,選擇從連結匯入,並貼上服務提供者給的訂閱網址。顯示下載成功不代表設定已生效,還需要在清單中選取該設定,並確認核心已完成載入。若出現解析錯誤,先確認網址回傳的內容是否受用戶端支援,而非登入頁面或錯誤訊息。
本機 YAML 可透過檔案匯入。遠端訂閱會依來源更新,本機檔案則由使用者自行維護,兩者後續修改方式不同。移轉裝置時,請一併記錄設定名稱、來源與本機覆寫;分享記錄檔前,請遮蔽訂閱參數。教學會提供具體操作順序,避免混淆匯入成功與連線成功。
首次使用可先採用設定預設的規則模式,在代理頁面找到規則引用的代理群組,並選擇其中可用的項目。規則模式決定如何分配請求,代理群組則決定分配至該群組的請求使用哪個出口,兩者並非同一個開關。若只切換未被任何規則引用的群組,實際連線可能不會改變。
全域模式適合暫時比對,不適合作為所有故障的通用解法。測試前記下原本的模式與群組選擇,測試後再還原;既有連線可能仍沿用原來的去向,需重新發出請求才能觀察變化。先了解設定作者安排群組的用意,再調整自動選擇與手動選擇,避免刪除其他群組引用的名稱。
桌面端先開啟系統代理,再用瀏覽器造訪日常使用的網站,並在用戶端的連線頁面查看網域、命中規則與出口。行動裝置則依提示啟動 VPN 連線。若看得到請求記錄,表示流量至少已抵達用戶端;若完全沒有記錄,應優先檢查應用程式的接入方式,而不是不斷更新訂閱或切換代理項目。
瀏覽器正常但終端機失敗時,請檢查終端機的環境變數;所有應用程式都失敗時,再依序檢查設定是否已啟用、代理群組選擇與錯誤記錄。測試期間每次只變更一個條件,並記下結果。如此可釐清訂閱取得、網域解析與實際連線這三個階段,減少反覆安裝用戶端帶來的額外變數。
Clash訂閱教學整理安裝入口與設定方法,不提供訂閱服務。用戶端是否適合目前的裝置,需依維護狀態、協定支援與實際系統環境判斷。
Clash 是代理工具生態系中的常見名稱,早期核心、後續分支與圖形用戶端並非同一個專案。原版 Clash 與部分早期用戶端已停止維護;社群專案沿用相近名稱,不代表其發布者、設定能力與更新方式完全相同。選擇軟體時應確認完整專案名稱,不要只憑圖示或「Clash」字樣判斷。
舊用戶端仍能啟動,不代表適合長期使用。系統升級、協定變更與設定新增欄位都可能影響相容性。移轉時先備份訂閱來源與本機設定,在新用戶端重新匯入並測試,再處理舊軟體的自動啟動、系統代理與背景服務。具體差異可參閱協定與核心參考,不必同時執行多個代理程式來比較。
圖形用戶端提供系統匣選單、訂閱管理、設定編輯與系統整合;核心則負責解析設定、比對規則與建立連線。不同介面可能使用相同核心,也可能採用不同實作,因此「介面中有某個開關」和「目前核心完整支援此功能」必須分開確認。開源儲存庫中的文件、發布說明與問題討論,有助於了解功能範圍和已知限制。
本站依實際操作情境整理說明,不以儲存庫的熱門程度取代相容性判斷。評估用戶端時,優先確認目標平台是否受支援、設定能否載入、記錄檔是否易讀,以及更新管道是否明確。遇到問題時,記錄作業系統、用戶端名稱、錯誤發生階段與已遮蔽敏感資訊的記錄檔,比只說「無法上網」更容易取得有效回應。
Clash Meta 是 Clash 生態系的後續分支,專案後來以 mihomo 之名持續發展。舊文章、用戶端選單或設定說明仍可能使用 Meta 這個名稱。新舊名稱不代表不同時期的所有版本都具備相同功能;協定類型、DNS 行為、規則欄位與 TUN 實作仍應以實際執行核心的文件為準。
將現有設定移轉至 mihomo 時,先查看解析記錄,再驗證代理提供者、代理群組與規則之間的引用關係。YAML 能被讀取,只能表示目前階段的語法或結構通過檢查,無法證明所有請求都會依預期處理。選擇協定時,也應考量伺服器端支援、網路品質與裝置耗電,不能只憑協定名稱推測連線速度。
用戶端更新會改變介面或系統整合,核心更新會改變連線與設定能力,訂閱更新則會重新取得遠端內容。這三種操作可能分別在不同頁面完成,也可能由用戶端統一管理。訂閱更新失敗時,反覆重裝應用程式通常無法修復失效的連結;核心不支援新增欄位時,只更新訂閱也無法補上功能。
更新前先儲存可用的設定、查看變更說明,並確認本機覆寫的合併方式。更新後先測試一條熟悉的連線路徑,再檢查分流與本機網路。若問題在更新後才出現,請比對具體變更以縮小範圍;若更新來源回傳錯誤內容,則檢查來源狀態與有效期限。更多案例請見說明中心,內容依基礎知識、安裝設定、使用技巧與故障排除分類。
完成入門步驟後,可依具體問題繼續閱讀。先確認問題發生在哪個層面,再選擇相應的調整方法,避免將系統代理、訂閱來源與協定支援混在一起處理。
分別從瀏覽器與終端機排查系統代理失效:檢查代理擴充功能衝突、PAC 與例外清單,並提供各系統設定終端機環境變數的方法。
閱讀說明 →集中解答新手最常遇到的十個問題,涵蓋訂閱匯入、模式選擇、節點切換、連接埠與開機自動啟動,並為每個問題提供延伸閱讀。
閱讀說明 →依時間脈絡整理三代核心的關係,比較協定支援、規則類型與 TUN 能力,並說明舊設定移轉至 mihomo 時需要調整的欄位。
閱讀說明 →