Windows
在「設定 → 系統 → 關於」查看系統類型,先比對下載頁提供的架構,再選擇安裝檔。更換用戶端前,先退出舊程式,並確認系統匣中的背景程序也已結束,避免兩個執行個體同時嘗試監聽同一個連接埠。
INSTALL / PLATFORM
先確認作業系統與處理器,再挑選用戶端。同一個專案可能會提供不同架構的安裝檔,檔名相近也不能混用。初次使用建議選擇圖形介面用戶端,匯入設定、查看連線及切換策略都能透過介面完成。若已在路由器或伺服器上管理網路服務,再考慮單獨部署核心。
在「設定 → 系統 → 關於」查看系統類型,先比對下載頁提供的架構,再選擇安裝檔。更換用戶端前,先退出舊程式,並確認系統匣中的背景程序也已結束,避免兩個執行個體同時嘗試監聽同一個連接埠。
在「關於這台 Mac」查看晶片或處理器資訊,選擇 Apple 晶片或 Intel 安裝檔。用戶端出現在選單列,通常只表示程式正在執行。匯入設定後,還要確認目前使用的設定已啟用,並視需要開啟系統代理。
選擇與裝置應用程式架構相符的安裝檔,不能只憑手機型號標示「64 位元」就下定論。首次連線時,留意系統的 VPN 授權提示。若裝置原本已啟用其他本機 VPN,先確認是否需要中斷連線,再啟動新的用戶端。
從下載頁前往 Clash Plus 的 App Store 頁面,查看 App 詳細資訊中的系統需求。安裝後先確認用戶端支援的匯入格式。建立連線時依照系統提示加入 VPN 設定,接著回到用戶端確認目前使用的是哪一份設定。
先確認發行版支援的套件格式,再核對處理器架構。桌面環境可考慮使用圖形介面用戶端;純命令列環境則須自行管理設定目錄、程序啟動與記錄檔。遷移至另一台電腦時,別只複製主要設定,也要確認規則集與本機檔案引用。
舊教學中同名的按鈕,在新版用戶端裡可能已移到別的位置。尤其是從已停止維護的 Clash for Windows 遷移時,先保留自行新增的規則與覆寫設定,再於新用戶端重新匯入設定。不要直接搬移整個舊工作目錄:裡面除了設定檔,也可能包含快取及僅適用於舊介面的設定。
CONFIG / INSPECTION
排查時將三個問題分開看:請求有沒有進入核心、進入後符合哪條規則,以及最後使用哪個出口。以下片段各自說明一個欄位,並非可直接取代整份設定的完整範例;若要查詢欄位值與相依關係,請參閱完整設定欄位參考。
規則模式會依清單順序由上往下判斷,符合條件後就不再檢查後續項目。若要讓某個子網域採用不同於主網域的路徑,先寫精確網域,再寫涵蓋範圍較廣的網域後綴規則,最後以預設規則收尾。有別於全域模式,規則模式可在同一份設定中指定不同出口。修改後,透過連線記錄確認實際符合的項目;若規則指向自訂策略群組,也要確認規則中的名稱與群組名稱完全一致。
mode: rule
rules:
- DOMAIN,blocked.example.com,REJECT
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,DIRECT
策略群組將規則與實際出口分開。規則指定群組名稱,由群組決定實際出口。手動選擇的群組適合固定出口或臨時比對測試;自動測速群組則會依探測網址與測得的延遲挑選候選項目。以下範例中的兩個節點名稱必須在同一份設定中定義。變更群組名稱時,也要同步更新引用該群組的規則。測速結果只反映探測網址的連線狀況;排查下載速度慢或連線中斷時,還需測試實際使用的網址。
proxy-groups:
- name: 手動出口
type: select
proxies:
- 節點甲
- 節點乙
- DIRECT
網域尚未成功解析時,切換節點通常無法直接解決問題。先查看用戶端記錄是否有解析逾時,再確認發出查詢的是瀏覽器、作業系統還是核心。啟用核心的解析功能,不代表所有應用程式都會改用這套解析設定。範例採用回傳真實 IP 位址的模式,方便比對結果;實際使用的解析服務,應依本機網路環境與設定需求選擇。每次只調整一項,再重新測試。
dns:
enable: true
enhanced-mode: redir-host
nameserver:
- 223.5.5.5
系統代理仰賴應用程式讀取並遵循代理設定;TUN 則透過虛擬網卡與路由導入流量,適合處理不讀取系統代理設定的應用程式。能否順利啟用,取決於權限、平台與既有路由。首次測試時,先記下原本的流量接管方式,只啟用一種方式,再分別檢查外部網站與區域網路裝置。若啟用後無法連線公司內網或印表機,先還原原有設定並確認路由變化,再決定如何處理例外流量。
tun:
enable: true
stack: mixed
auto-route: true
auto-detect-interface: true
混合連接埠可在同一個監聽連接埠接收 HTTP 與 SOCKS 代理要求。應用程式設定中的位址與連接埠指向本機監聽器,而非遠端節點位址。本機自用時維持迴圈位址監聽;若連接埠已被占用,先確認目前是哪個程序正在監聽。變更連接埠後,也要同步更新瀏覽器或終端機中手動填寫的代理位址。否則用戶端雖能啟動,這些應用程式仍會連到舊連接埠,甚至誤連其他代理程序。
mixed-port: 7890
allow-lan: false
SETUP / FIRST RUN
首次測試時,選一個平常能開啟的網站,先記下未啟用代理時的狀況。接下來一次只變更一項設定;若遇到問題,可以回到上一步,確認故障是在哪次變更後出現。
進入用戶端的「設定」或「訂閱」,選擇從檔案匯入,或輸入來源可信的訂閱網址。匯入後選取該設定,確認規則與策略群組是否載入。清單中出現項目,不代表核心目前正在使用它。若發生解析錯誤,先記下提示指出的欄位或行號;保留一份原始檔,再修改副本中的縮排、清單層級或欄位型別。
先使用規則模式測試,再於相關策略群組中選定一個出口。桌面版可先透過系統代理測試會讀取系統設定的應用程式;行動版則依照用戶端提示建立系統 VPN。暫時不要同時更換模式、節點與接管方式。若只想讓單一終端機工具透過代理連線,可先依照該工具的文件設定代理位址,不必立刻更改整台裝置的路由。
開啟測試頁面後,在用戶端的連線清單中找出目標網域,核對規則與出口。若完全沒有連線記錄,先確認應用程式是否已接入;若有記錄但符合預設規則,回頭檢查規則順序與網域寫法;若規則符合正確仍逾時,再檢查目標網站與所選出口是否連通。回報錯誤時,記下時間、模式與錯誤訊息;分享記錄前,請刪除訂閱網址及驗證資訊。
測速要求與網頁要求可能套用不同規則,目標位址也可能不同。先確認網頁要求是否出現在連線清單,再核對實際出口。延遲數值只能說明該次探測的結果。相關名詞請參閱術語手冊。
先保留可正常使用的設定。確認更新錯誤是要求逾時、授權失敗還是格式解析失敗,再依原因處理;遠端內容無法讀取時,反覆重新安裝用戶端通常無法解決。可先參閱術語手冊,了解訂閱與本機設定的差異。
命令列程式不一定會讀取系統代理設定。有些會讀取環境變數,有些則需另外設定;先查閱該工具的說明,再到用戶端確認是否有連入記錄。網路流量接管方式可參閱術語手冊。
SOURCE / MAINTENANCE
專案名稱、用戶端名稱與訂閱來源是三回事。查詢欄位時,先確認實際載入設定的是哪個核心;若要排查安裝、更新或介面問題,再查閱對應用戶端的說明。
Clash 生態系長期使用 YAML 描述連入、連出與規則。mihomo 延續了原名為 Clash.Meta 的核心專案。舊資料沿用早期名稱很常見;遇到舊文件中的介面截圖或參數時,先確認它對應的是哪個專案。名稱相似只能作為搜尋線索,不能據此判斷欄位目前仍可使用,也不能認定兩個安裝檔由同一個維護團隊提供。
mihomo 原始碼儲存庫採用 GPL-3.0 開源授權,可在上游儲存庫查看程式碼、變更記錄與問題討論。此授權適用於核心專案,不代表每個圖形介面用戶端也採用相同授權。提供 GUI 的專案各自維護介面操作、系統整合與發行套件;訂閱則由設定提供者維護,更新訂閱不會取代用戶端,也不會為系統安裝新的核心。
核心負責處理連入、依規則選擇出口並執行連線。圖形介面用戶端除了顯示這些資訊,也可能合併訂閱、覆寫設定與全域設定,再將結果交給核心。若設定檔中有規則,但介面中沒有生效,先確認目前啟用的設定,再檢查覆寫設定的套用順序,最後比對連線記錄。只查看編輯器中的原始檔案,可能會漏掉用戶端後續加入的設定。
更換安裝檔時,先查閱用戶端的發行說明;若涉及規則語法、DNS 行為或虛擬網卡支援,再查看所用核心的變更內容。更新前記錄目前的設定與流量接管方式,並備份本機規則及覆寫設定;更新後使用相同目標進行測試。若只是新增一條規則,單獨儲存並測試該規則,比同時更新程式、規則集與訂閱更容易找出變化原因。
NOTES / LATEST
找不到連線記錄時,先確認代理是否已接管要求;有記錄但路徑不對,再檢查模式。準備更換用戶端時,先確認必須保留的功能,以及設定的遷移方式。
分兩個方向排查:瀏覽器端檢查代理擴充功能與系統設定是否遭覆蓋;終端機端檢查 http_proxy 環境變數,以及命令列工具讀取代理設定的方式。
逐項比較熱門用戶端的平台支援、核心版本、介面操作、TUN 支援與訂閱管理,並依不同使用情境提供選型建議。
透過流量路徑圖解說 rule、global、direct 三種模式的判斷方式,並提供日常使用、臨時排查與測速時的切換建議。