安裝前:分清 Windows 用戶端、核心與訂閱

在 Windows 上使用 Clash,會涉及三個部分:用戶端負責介面、設定管理與系統整合;核心負責代理協定、規則比對及連線處理;訂閱則提供節點,以及可能附帶的策略組與規則。安裝成功只代表用戶端能啟動,不表示已有可用節點,也不表示系統流量已經經過代理。

Clash Meta 後續以 mihomo 之名持續發展。使用 mihomo 的用戶端,對設定欄位的支援可能與舊版 Clash 用戶端不同。遇到不支援協定或欄位解析失敗時,應先確認實際執行的核心及版本,而不是反覆切換系統代理。舊版 Clash for Windows 已停止維護;新安裝時,建議先確認用戶端專案的維護狀態及目前支援的 Windows 版本。

  • 用戶端:記下應用程式名稱、版本與安裝路徑,方便尋找設定入口及確認升級方式。
  • 核心:在用戶端的核心資訊或記錄開頭確認名稱與版本;應用程式版本不等於核心版本。
  • 設定:確認訂閱提供 Clash 或 mihomo 相容格式。只有節點 URI 的清單,不一定能直接當成完整 YAML 設定檔載入。

挑選安裝包:確認系統架構與安裝方式

先確認 x64 或 ARM64,再下載

在 Windows 11 開啟「設定」→「系統」→「系統資訊」,查看「系統類型」;Windows 10 通常可在「設定」→「系統」→「關於」中查看。Intel、AMD 常見桌上型處理器通常選 x64;ARM 裝置則優先選擇專案提供的 ARM64 安裝包。不要只因為 Windows 是「64 位元」,就把這兩種架構當成同一種安裝包。

檢查項目選擇依據常見誤區
處理器架構x64 或 ARM64,須與發行包標示相符混用 ARM64 與 x64
安裝程式依照專案提供的 EXE 或 MSI 安裝說明操作誤以為不同封裝代表不同代理協定
免安裝版確認資料目錄、升級方式與服務安裝說明移動解壓縮目錄後,仍使用舊的開機自動啟動路徑
系統支援確認目前版本要求的 Windows 版本與執行元件以為舊版系統能執行所有新版用戶端

安裝與首次啟動

  1. 前往下載中心選擇 Windows 用戶端,再確認對應專案的發行說明、發行者資訊與系統需求。
  2. 先關閉其他正在執行的代理用戶端。首次排解問題時,只保留一個核心執行,減少連接埠與路由衝突。
  3. 將程式安裝在固定位置。免安裝版不要長期放在暫存解壓縮目錄;設定完成後也不要任意重新命名或移動整個資料夾。
  4. 啟動後開啟記錄,確認核心沒有持續退出、重新啟動或出現設定解析錯誤。若缺少執行元件,請依該版本的專案文件安裝所需元件。

遇到 Windows 安全性提示時,先確認下載來源、發行者與檔案內容,再決定是否繼續。不要為了解決安裝問題而長期關閉系統防護。企業裝置的安裝與網路權限也可能受組織原則限制,應請管理員確認。

匯入訂閱:下載成功後,還要啟用設定

不同用戶端的設定入口名稱不盡相同,常見名稱包括「訂閱」、「設定」或「Profiles」。以下步驟依功能說明,不會把某一版本介面的按鈕名稱套用到所有用戶端。匯入前先確認連結來自訂閱服務提供者,且回傳的是用戶端可辨識的格式。

  1. 開啟設定管理頁面,選擇從 URL 匯入,將訂閱連結貼到網址輸入欄。
  2. 執行下載或匯入並查看結果。HTTP 401、403 通常需要檢查授權、有效期限或存取限制;若回傳的是網頁內容,就不能當成 YAML 設定檔繼續使用。
  3. 選取剛匯入的設定並設為目前使用的設定。清單中出現訂閱記錄,不代表核心已切換至該設定。
  4. 確認策略組存在、節點名稱完整,再將運作模式設為規則模式,並為可手動選擇的策略組指定節點。
  5. 執行一次延遲測試。若測試失敗,請檢查記錄中的具體錯誤,不要只憑單次逾時就認定 Windows 安裝失敗。

分開管理本機編輯與訂閱更新

直接修改下載產生的設定檔,可能會在下次更新訂閱時被覆寫。若要長期保留規則或 DNS 調整,請使用用戶端明確支援的覆寫、合併或本機設定機制,並在更新後確認生效設定。不要假設所有用戶端都支援相同的覆寫語法。

訂閱連結通常含有存取憑證。排解問題時,請在截圖中遮蔽完整連結、權杖與管理金鑰。使用第三方訂閱轉換服務,代表該服務可能接觸訂閱內容;請先評估信任風險,並優先使用服務提供者直接提供的相容設定。

系統代理:先確認 127.0.0.1 與實際監聽連接埠

系統代理主要影響遵循 Windows 代理設定的應用程式,並非攔截所有處理程序流量的全域開關。部分命令列工具、遊戲及自行處理網路連線的程式不會自動採用這項設定,因此「瀏覽器能連線、終端機不能」不一定代表發生故障。

本文以 7890 示範混合代理連接埠;部分用戶端可能使用 7897 或其他數值,請以目前核心的有效設定與監聽記錄為準。HTTP 與 SOCKS 連接埠也可能分開設定,請勿將控制介面連接埠填入系統代理。

# 本機連線參數範例,並非可直接取代訂閱的完整設定
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
  1. 啟用用戶端的系統代理功能。
  2. 開啟 Windows「設定」→「網路和網際網路」→「Proxy」,確認手動代理的位址與連接埠指向目前使用的用戶端。部分環境會使用設定指令碼,也請確認是否有其他軟體寫入指令碼位址。
  3. 在 PowerShell 中確認本機連接埠是否能建立 TCP 連線。
Test-NetConnection -ComputerName 127.0.0.1 -Port 7890
curl.exe --proxy http://127.0.0.1:7890 --head --connect-timeout 10 https://example.com/

TcpTestSucceeded : True 只代表本機連接埠可連線,不能證明遠端節點可用。第二個命令會明確使用本機 HTTP 代理,有助於判斷是「程式未使用系統代理」,還是「代理連線本身失敗」。使用 curl.exe 可避免部分 PowerShell 環境中的 curl 別名造成參數差異;測試網域僅供示範,可替換成實際要排查的目標。

服務模式、TUN 與防火牆:分別處理權限與流量接管範圍

服務模式用來處理權限,不能取代設定驗證

部分 Windows 用戶端會透過服務模式啟動核心,或執行需要較高權限的操作。安裝服務時出現 UAC 授權提示,是權限提升流程的一部分;請先確認要求來自已安裝的用戶端。各用戶端的實作方式不同:安裝服務不代表已啟用 TUN,也不保證路由與 DNS 設定正確。

安裝服務後,先查看用戶端中的服務狀態;若要進一步確認,請按 Win + R,輸入 services.msc 開啟服務管理員,並依專案文件確認實際服務名稱與執行狀態。不要照抄網路上其他用戶端的服務名稱,也不要刪除不明系統服務。

先確認基本連線正常,再啟用 TUN

TUN 透過虛擬網路介面與路由,接管符合條件的 IP 流量,可涵蓋部分不遵循系統代理的應用程式。這通常涉及管理員權限、路由與 DNS 處理。請先確認一般本機代理正常,再啟用 TUN,並查看記錄是否出現虛擬介面建立失敗、路由新增失敗或權限不足。

  • 與其他 VPN 同時使用時,請檢查路由優先順序、DNS 設定與虛擬網卡。初次排解問題時,可暫時只保留一種流量接管方式。
  • 區域網路裝置、公司內網或遠端桌面異常時,請確認內網網段是否被錯誤送進代理;不要長期使用全域模式來掩蓋規則問題。
  • TUN 下的 DNS 劫持只會作用於實際經過對應路徑的請求;瀏覽器內建的加密 DNS,以及其他 VPN 的 DNS 設定,都需要另外檢查。

依程式與用途設定防火牆權限

出現 Windows Defender 防火牆提示時,請確認核心程式路徑,並依實際使用情境選擇網路設定檔。若只在本機使用迴送代理,通常不必對區域網路開放代理連接埠的輸入連線;只有在要與其他裝置共用時,才需要進一步檢查監聽位址、allow-lan 與對應的輸入規則。

不要為了測試而關閉整個防火牆。第三方安全軟體或組織原則也可能限制輸出連線,請檢查封鎖記錄。核心升級後,可執行檔路徑可能改變,舊的程式規則也可能不再適用;此時應更新授權路徑,而不是新增不限制程式的寬鬆規則。

常見故障:連接埠占用、代理設定殘留與設定錯誤

連接埠占用:先找出處理程序,再決定關閉或更換連接埠

記錄出現 address already in use 或繫結失敗時,請檢查目標連接埠的監聽處理程序。以下兩個命令用於找出監聽位址與處理程序 ID,不會自動結束處理程序。

netstat -ano | findstr LISTENING | findstr :7890
Get-NetTCPConnection -LocalPort 7890 -State Listen |
  Select-Object LocalAddress, LocalPort, OwningProcess

根據輸出的 PID,在工作管理員的「詳細資料」頁面找出對應處理程序。若是舊版用戶端或重複啟動的核心,請先從介面正常結束。若該連接埠必須留給其他程式,可將目前用戶端的混合連接埠改為例如 7891,再同步更新系統代理、終端機代理環境變數與明確指定代理的測試命令。

系統代理無效:分清應用程式設定與 Windows 設定

狀況優先檢查下一步
明確指定代理的測試成功,但某個應用程式失敗應用程式是否遵循系統代理,以及是否有自己的代理設定設定應用程式代理,或評估改用 TUN
無法連線至本機連接埠核心狀態、實際連接埠與設定解析記錄先恢復監聽,再測試遠端連線
瀏覽器連線正常,命令列失敗工具是否需要單獨設定代理參數或環境變數依工具文件設定代理,並重新啟動處理程序
連線記錄顯示直接連線規則比對結果、策略組選擇與目前運作模式修正規則目標或策略組選擇
啟用 TUN 後內網連線異常路由、DNS、其他 VPN 與內網規則先關閉 TUN 進行對照測試,再逐項調整

WinHTTP 與使用者層級的系統代理並非同一種設定來源。netsh winhttp show proxy 可查看 WinHTTP 設定,但結果不代表所有瀏覽器與桌面應用程式的代理狀態。不要只為修復單一程式,就貿然修改電腦層級的代理設定。

關閉用戶端後無法上網:確認代理是否仍指向已關閉的連接埠

若用戶端異常結束,而 Windows 仍指向 127.0.0.1:7890,遵循系統代理的應用程式就可能無法連線。可先重新啟動用戶端以恢復監聽,或在 Windows 代理設定中關閉先前啟用的手動代理。不要任意刪除企業設定的代理指令碼;請先記錄原值,再依管理規範處理。

設定解析失敗時,應回到記錄確認出錯的欄位:YAML 縮排必須使用空格,策略組引用必須對應實際存在的名稱,協定類型也必須受到目前核心支援。保留完整錯誤訊息、行號與核心版本,比只記下「連不上」更有助於找出問題。

開機自動啟動:分開驗證登入啟動、服務啟動與代理恢復

用戶端的「開機自動啟動」通常是指使用者登入 Windows 後啟動介面;背景服務則可能在使用者登入前就已啟動,兩者並不相同。啟用自動啟動後,還要確認目前設定是否自動載入、系統代理是否依預期恢復,以及 TUN 是否具備所需權限。

  1. 在用戶端設定中啟用提供的開機啟動選項。不要另外手動新增多個啟動捷徑。
  2. 在 Windows 11「設定」→「應用程式」→「啟動」,或工作管理員的「啟動應用程式」中,確認對應項目沒有停用。若透過服務或工作排程器啟動,請另外依用戶端文件檢查。
  3. 正常結束並重新啟動用戶端,確認已選取的設定、策略組與連接埠仍然保留。
  4. 實際重新啟動 Windows 並登入一次,不要只測試從睡眠狀態喚醒。等待網路連線建立後,再測試本機連接埠與目標連線。
  5. 確認只有一個核心執行個體,並確保系統匣介面、背景服務與目前設定狀態一致。

重新啟動後訂閱更新失敗,但手動更新成功,可能與啟動時 Wi-Fi 尚未連線、系統時間尚未同步或訂閱存取路徑有關。先查看時間順序與錯誤記錄,再考慮使用用戶端提供的延遲啟動或更新重試選項,不必立刻重新安裝。

完成設定後的檢查清單

  • 本機監聽連接埠可連線,沒有繫結失敗或核心反覆重新啟動。
  • 目前設定與訂閱記錄相符,策略組已選取可用節點。
  • 連線記錄能說明目標請求符合哪條規則,以及最後使用的出口。
  • 正常結束用戶端後,網路恢復狀況符合預期;系統代理沒有指向無人監聽的連接埠。
  • 重新啟動並登入後,設定能正常恢復;若需要 TUN,請另外確認虛擬介面、路由與 DNS 狀態。

依照以上順序完成安裝,後續故障通常可歸納為應用程式代理、核心監聽、訂閱設定、節點連線或系統流量接管其中一個環節。若想進一步了解規則與訂閱維護,請參閱使用文件;權限與網路異常的補充處理方式,請見常見問題。