一、安裝前確認:用戶端、核心與訂閱

在 Windows 上使用 Clash,會涉及三個不同部分:用戶端提供操作介面、系統匣與系統設定入口;核心負責讀取設定並處理連線;訂閱或本機 YAML 則提供節點、策略群組與規則。安裝成功只代表程式能啟動,不代表已有可用節點,也不代表瀏覽器流量已經透過代理傳送。

Clash Meta 後續以 mihomo 之名持續發展。採用 mihomo 的用戶端可使用該核心支援的設定欄位,但舊版 Clash 核心不一定能讀取相同設定。遇到「不支援的代理類型」或「未知欄位」時,應先確認訂閱格式與核心的相容性,不要反覆重新安裝 Windows。

下載前先確認三項資訊

  • 系統與架構:開啟 Windows「設定」→「系統」→「系統資訊」,查看「系統類型」。常見的 Intel、AMD 64 位元電腦請選 x64;ARM 裝置則需確認用戶端是否提供 ARM64 版本及相關支援說明。
  • 用戶端與核心版本:安裝後分別在「關於」或版本資訊頁面查看。回報問題時請一併提供兩者版本,不能只寫「最新版」。
  • 設定來源:準備服務提供者提供的 Clash 或 mihomo 格式訂閱網址,或可用的 YAML 檔案。帳戶管理網頁的網址通常不能直接當作訂閱匯入。

二、下載與安裝:先啟用一般代理,再處理權限

請從本站安裝檔下載頁面選擇 Windows 用戶端,並確認系統需求、架構與維護狀態。若已安裝舊版用戶端,請先關閉系統代理並結束系統匣中的程序,避免新舊程式搶用同一個監聽連接埠。

  1. 安裝或解壓縮。使用安裝檔時依照精靈完成安裝;使用免安裝壓縮檔時,請先完整解壓縮至固定資料夾,例如 C:\Tools\ClashClient,不要直接在壓縮軟體視窗中執行主程式。
  2. 正常啟動介面。初次設定先測試系統代理,暫時不要啟用 TUN。一般本機代理通常不需要讓整個介面一直以系統管理員身分執行。
  3. 確認系統匣與核心狀態。關閉視窗後,程式可能仍在通知區域執行;請檢查記錄中是否有設定載入失敗、連接埠綁定失敗或核心反覆退出等訊息。
  4. 暫緩自動啟動。等訂閱、規則模式與網頁連線測試都完成後,再啟用「開機啟動」或「啟動時啟用系統代理」,減少排查時需要考慮的因素。

SmartScreen 與安全軟體封鎖

下載檔案後若出現「Windows 已保護您的電腦」,這是信譽或風險警示,不能只靠這項提示判斷檔案是否安全。請先確認下載來源、檔案內容中的發行者資訊,以及安全軟體顯示的具體偵測名稱。若無法確認來源,請停止執行;不要把關閉即時防護當成安裝步驟。

若程式啟動後檔案消失,可前往「Windows 安全性」→「病毒與威脅防護」→「保護歷程記錄」,查看受處理的項目與原因。公司電腦也可能受組織原則限制,無法執行程式或安裝驅動程式,請交由管理員確認。只有在確認檔案來源與風險後,才考慮針對該檔案採取處理措施;不要將整個下載資料夾設為排除項目。

三、匯入訂閱:下載完成後還要啟用設定

前往用戶端的「訂閱」、「設定」或「Profiles」頁面,透過「新增」、「匯入」或網址輸入欄新增訂閱。選單名稱依用戶端而異,重點是完成「取得設定」及「設為目前設定」兩個步驟:清單中顯示名稱,不一定代表核心正在使用該設定。

  1. 貼上完整的訂閱網址,確認網址前後沒有空格,並保留原有查詢參數。
  2. 執行下載或更新並查看結果;成功後確認節點與策略群組是否已出現。
  3. 啟用剛匯入的設定,並查看記錄確認已載入完成。
  4. 開啟「代理」或「策略群組」頁面,確認規則所使用的主要策略群組已選取可用節點,或已選取設定中定義的自動選擇群組。

訂閱失敗時,先辨別回應內容

狀況優先檢查項目
HTTP 401 或 403確認權杖是否有效、帳戶權限與服務提供者的存取政策;查看回應說明,不要靠重新安裝解決。
HTTP 404確認網址是否完整,以及服務提供者是否已更換訂閱網址。
連線逾時或網域名稱解析失敗檢查本機網路與訂閱網域是否可連線,並確認目前的下載要求是否受到舊代理設定影響。
YAML 解析失敗確認回應內容是否為登入頁面、錯誤頁面,或縮排格式已損壞的設定檔。
不支援的代理類型確認訂閱格式是否適用於目前的核心,以及用戶端內建的核心是否支援使用的通訊協定。

四、規則模式與系統代理:分開設定、分別測試

初次使用建議選擇「規則 / Rule」模式。規則會決定送入核心的要求要直連、經由代理群組,或遭到拒絕;「全域 / Global」通常會將要求交由全域策略處理;「直連 / Direct」則不會經過遠端代理節點。切換模式只會改變核心的處理方式,不會自動讓所有應用程式都把要求送交核心。

開啟用戶端的「系統代理 / System Proxy」開關,再前往 Windows「設定」→「網路和網際網路」→「Proxy」查看手動 Proxy 狀態。用戶端常將伺服器設為 127.0.0.1,連接埠則填入目前的 HTTP 或 mixed 監聽連接埠。部分用戶端會透過其他 Proxy 設定方式接入,請依照用戶端說明判斷,不要再加上一組互相衝突的手動設定。

全程使用相同連接埠,逐段確認

例如目前設定使用 mixed-port: 7890,明確指定的 HTTP 測試網址就是 http://127.0.0.1:7890。mixed 連接埠可接受 HTTP 與 SOCKS 代理連線;僅供 SOCKS 使用的連接埠,不能直接作為 Windows 手動 HTTP 代理連接埠。管理介面 external-controller 也不是瀏覽器代理入口。

  • 先確認監聽:核心確實在目標連接埠執行,系統代理位址也與其一致。
  • 再確認流量:使用 Edge 或 Chrome 開啟新網頁,查看用戶端的「連線」清單是否出現相應要求。
  • 最後確認出口:查看該連線套用的規則、策略群組與最終節點。若規則允許直連,網站使用本機網路出口屬正常情況。

瀏覽器擴充功能、企業原則與應用程式內部的代理設定都可能覆蓋系統設定。Firefox 也需檢查「設定」→「一般」→「網路設定」是否選擇「使用系統 Proxy 設定」。因此,「系統代理已啟用」不代表「所有軟體都會使用代理」。

五、初次驗收:區分連接埠、節點與應用程式問題

先在 PowerShell 中檢查本機連接埠,再測試明確指定代理的要求。以下指令以 mixed 連接埠 7890 為例,網址用來說明測試方式,結果仍取決於目標網站與網路連線狀況;範例不代表實測結果,也不要求特定毫秒數。

PowerShell · 本機監聽與明確代理測試
Test-NetConnection 127.0.0.1 -Port 7890
curl.exe -I --connect-timeout 10 --max-time 20 --proxy http://127.0.0.1:7890 https://example.com/

TcpTestSucceeded: True 只代表 TCP 連接埠可以連線,不代表遠端節點可用。第二個指令明確指定代理,可排除「應用程式是否使用 Windows 系統代理」這項變數;此處使用 curl.exe,避免 Windows PowerShell 中的 curl 別名造成參數差異。

  • 本機連接埠無法連線:檢查核心是否正在執行、連接埠是否填錯,優先處理設定載入或監聽錯誤。
  • 連接埠可連線,但代理要求失敗:檢查選取的節點、命中的規則、驗證資訊、DNS 與目標位址,並查看同一時間的記錄。
  • 明確指定代理後測試成功,但瀏覽器失敗:優先檢查 Windows 代理設定、瀏覽器擴充功能與瀏覽器本身的網路設定。
  • 網頁能開啟,但連線清單沒有記錄:可能是直連、瀏覽器快取或使用了另一組代理,請再送出一個新的要求確認。

對於 HTTPS 要求,輸出中的 200 Connection established 只代表 HTTP CONNECT 通道已建立,還需檢查後續 TLS 交握與目標回應。目標回傳 403 也不代表代理連接埠失效,請根據完整輸出判斷是遠端網站拒絕連線,還是代理鏈路失敗。

六、常見安裝問題:連接埠衝突、權限與設定遭覆蓋

7890 已被占用:確認占用程序,不要直接結束不明服務

記錄中出現 address already in use 或綁定失敗時,可在 PowerShell 中查詢監聽程序。以下指令只會讀取資訊,不會停止任何程式;若需查看更多程序資訊,可能必須使用系統管理員權限。

PowerShell · 查詢連接埠占用狀況
Get-NetTCPConnection -State Listen -LocalPort 7890 |
  Select-Object LocalAddress, LocalPort, OwningProcess

Get-Process -Id (Get-NetTCPConnection -State Listen -LocalPort 7890).OwningProcess

確認占用者是舊代理程式後,請正常結束該程式;若必須保留該連接埠,可在目前用戶端的連接埠設定或持續性覆寫中改用未占用的連接埠,例如 7891。也要一併更新 Windows 系統代理與明確代理測試指令。訂閱管理用戶端可能在更新時覆寫原本的 YAML,直接修改快取檔案通常無法長期生效。

權限不足:區分檔案寫入與 TUN 服務

「無法儲存設定」可能是目錄權限不足、檔案設為唯讀,或安全軟體阻止寫入;請先查看錯誤訊息中提到的實際路徑。安裝 TUN 服務、建立虛擬網卡及調整路由則可能需要系統管理員授權。若系統代理已能正常運作,不必為了瀏覽一般網頁而強行安裝 TUN;確實需要接管不遵循系統代理的應用程式時,再依照用戶端文件安裝服務並確認權限。

控制介面發生錯誤:不要把 9090 當成流量連接埠

external-controller 用於透過介面管理核心,常見範例為 127.0.0.1:9090。該連接埠發生衝突時,介面可能無法取得節點或連線清單,但修改它不能取代修改 mixed-port。請維持本機監聽並設定存取金鑰,不要為了排除問題而直接開放給所有網路介面。

七、代理未生效與結束後無法上網:依影響範圍排查

若瀏覽器正常,但終端機、遊戲或其他應用程式無法連線,請先確認這些應用程式是否支援系統代理。有些應用程式使用自己的網路堆疊,部分流量則使用 UDP,無法只靠修改 Windows HTTP 代理接管。終端機工具也可能只讀取自身參數或代理環境變數;netsh winhttp show proxy 顯示的 WinHTTP 設定,與 Windows 設定頁面中的使用者代理並不相同。

TUN 是進一步接管流量的選項,並非初次設定的必要步驟。它透過虛擬網卡與路由,接管符合設定範圍的流量;實際效果仍取決於路由、DNS、排除項目與核心支援。啟用前請先完成本文的明確代理測試;如果基礎節點無法使用,改用 TUN 也不會自動修復節點。

結束程式後無法上網

  1. 重新開啟用戶端,關閉「系統代理」後正常結束程式,並確認 Windows 代理設定是否已還原。
  2. 若用戶端無法啟動,請前往 Windows「設定」→「網路和網際網路」→「Proxy」,檢查設定是否仍指向已停止的本機連接埠。
  3. 個人裝置可移除確認屬於該用戶端的殘留手動代理設定;公司或機構網路若使用統一代理或設定指令碼,請先記下原始設定並聯絡管理員。
  4. 重新開啟瀏覽器測試。若仍無法連線,再檢查其他 VPN、網路過濾軟體與 DNS;不要一開始就重設所有網路設定。

後續尋求協助時,請提供 Windows 版本、用戶端版本、核心版本、目前模式、監聽連接埠,以及發生錯誤時段的去識別化記錄。每次只修改一個變數,再重複相同的測試,才能判斷問題來自訂閱、節點、系統設定或特定應用程式。