入門指南 預計閱讀 10 分鐘

Clash 初次安裝設定教學:系統代理、混合連接埠與開機啟動常見問題

整理各平台初次安裝 Clash 用戶端後的設定重點,包括系統代理、mixed-port 連接埠衝突、開機啟動與權限提示,並提供逐步排查順序。

首次啟動:先確認設定檔、核心與連線出口

Clash 用戶端視窗能開啟,不代表代理連線已經建立。完整連線至少包括:用戶端載入設定檔、核心成功監聽本機連接埠、應用程式將連線交給核心,以及規則選到可用出口。首次設定時應依序逐段檢查,不要同時開啟系統代理、TUN 和多套網路工具,再靠重新整理網頁猜原因。

本文主要介紹桌面版 Clash 類用戶端,以及使用 Clash Meta(mihomo)核心的用戶端,並補充 Android 與 iOS 的差異。不同用戶端的選單名稱可能不同;系統代理、規則模式和虛擬網卡屬於不同層級的功能,不能直接把桌面版的開關位置套用到手機。

  1. 載入設定檔:在用戶端的訂閱或設定檔頁面匯入服務提供者提供的相容設定檔,更新成功後將其設為目前使用的設定檔。清單中看得到檔案,不代表它已啟用。
  2. 查看核心記錄:確認沒有 YAML 解析錯誤、代理群組引用不存在的項目或連接埠綁定失敗。若記錄持續出現錯誤,先修正設定檔,不必急著修改系統網路。
  3. 選擇規則模式:首次使用時,建議保留設定檔原有的規則模式。全域模式只是將連線交由全域策略處理,無法修正錯誤的節點參數。
  4. 檢查策略群組:若需手動選擇群組,請選擇可用節點;若選到 DIRECT,相關流量仍會直接連線。延遲測試成功只代表測試目標可連線,不保證所有網站都能存取。

系統代理:決定哪些應用程式會使用本機連接埠

桌面用戶端中的「系統代理」通常會修改作業系統的代理設定,將遵循該設定的應用程式指向本機位址,例如 127.0.0.1:7890。這不代表所有網路流量都會被接管:部分遊戲、命令列工具、自行設定代理的瀏覽器,以及某些 UDP 流量,都不會自動使用這項設定。

Windows:檢查代理位址,別只看系統匣圖示

在 Windows 11 開啟「設定」→「網路和網際網路」→「Proxy」,查看「手動 Proxy 設定」中的位址與連接埠是否和用戶端一致。不同用戶端可能採用不同的系統代理設定方式,請以用戶端說明和目前實際設定為準。一般桌面應用程式使用的系統代理與 WinHTTP 設定也不相同,切勿為了解決瀏覽器問題而隨意修改 WinHTTP。

macOS:依目前使用的網路服務檢查

在 macOS 前往「系統設定」→「網路」→目前的網路服務→「詳細資訊」→「代理伺服器」。請特別檢查網頁代理、安全網頁代理或 SOCKS 代理是否仍指向舊連接埠。Wi-Fi 和有線網路的設定可能不同;切換網路後若出現異常,請檢查目前使用的網路服務,而非只查看原本的 Wi-Fi。

Linux:分別確認桌面環境與終端機

Linux 的桌面代理設定會受到桌面環境和應用程式實作方式影響。終端機程式通常需要明確指定代理參數或環境變數,不能因為瀏覽器已使用代理,就認定終端機也已連線。以下兩個指令會透過同一個混合連接埠,分別測試 HTTP 代理和 SOCKS5 代理:

curl -I --proxy http://127.0.0.1:7890 https://example.com
curl -I --proxy socks5h://127.0.0.1:7890 https://example.com

socks5h 表示將目標網域交由代理伺服器解析。收到目標網站的 HTTP 回應,代表這次請求至少已完成連線並收到回應;逾時、代理驗證錯誤和 TLS 錯誤則須分別判斷。這項測試不代表所有應用程式都已接入代理,也不代表本機 DNS 設定正確。

mixed-port:7890 是常見連接埠,不是固定值

mixed-port 會讓 HTTP 代理與 SOCKS 代理共用同一個監聽連接埠。這是本機入口,不是遠端節點連接埠,也不是用來控制核心的 API 連接埠。常見設定會使用 7890,但不同用戶端或設定檔可能採用其他值,請以目前生效的設定檔和執行記錄為準。

欄位用途初次設定重點
mixed-portHTTP 與 SOCKS 共用入口手動設定應用程式時填入實際值
port獨立的 HTTP 代理入口並非所有設定檔都會啟用
socks-port獨立的 SOCKS 代理入口避免與混合連接埠重複綁定
external-controller核心控制 API 的監聽位址不能當作瀏覽器代理連接埠

如何確認是哪個程式占用連接埠

如果記錄中出現 address already in use 或綁定失敗,請先檢查監聽中的程序。其他代理用戶端、仍在背景執行的舊核心,以及開發服務都可能占用相同連接埠。以下指令中的 7890 請替換成錯誤訊息中顯示的連接埠:

# Windows:在命令提示字元中執行,結果最後一欄為 PID
netstat -ano | findstr :7890

# macOS:查看 TCP 監聽程序
lsof -nP -iTCP:7890 -sTCP:LISTEN

# Linux:查看 TCP 監聽與程序資訊
ss -ltnp 'sport = :7890'

Windows 的輸出可能包含遠端連接埠相同的連線,請一併查看本機位址欄和 LISTENING 狀態。Linux 若未顯示程序名稱,可能需要提高權限。確認程序身分後,優先正常結束衝突程式,不要看到 PID 就直接強制終止。

改用 17890 後,應用程式也要同步修改

若確實需要避開衝突,可以將混合連接埠改為 17890。以下只列出需要確認的欄位,並非包含節點與規則的完整設定檔:

mixed-port: 17890
allow-lan: false
mode: rule

修改後重新載入設定檔,確認新連接埠已開始監聽,再關閉並重新開啟用戶端的系統代理。曾手動設定代理的瀏覽器、終端機和下載工具也需要同步修改。部分圖形介面用戶端會以自己的連接埠設定覆蓋訂閱欄位,請在用戶端設定或其支援的覆寫設定檔中修改,否則訂閱更新後可能會恢復成舊值。

TUN 與權限提示:先確認一般代理可用,再擴大接管範圍

TUN 模式透過虛擬網路介面和路由接管流量,適合不遵循系統代理設定的應用程式,但並非「功能更進階就一定要開啟」。首次設定桌面版時,可以先用明確指定代理的請求確認節點和本機連接埠正常,再視需要啟用 TUN,避免將節點故障和路由問題混為一談。

  • Windows:建立虛擬網卡、加入路由等操作通常需要提高權限,用戶端也可能透過服務模式完成。若安裝服務失敗,請先查看記錄,不要長期以系統管理員身分執行所有程式。
  • macOS:修改系統代理、輔助服務或網路延伸功能時,可能會觸發不同的授權提示。只允許來源明確且符合目前操作的要求;若無法啟動,請檢查用戶端提供的輔助服務狀態。
  • Linux:建立 TUN 裝置和調整路由涉及網路管理權限,具體可透過服務或能力設定來實現。請依照所用用戶端的說明操作,不能因為桌面代理測試成功,就推斷 TUN 所需權限也已齊備。
  • Android:常見用戶端會透過系統 VPN 介面接管流量,需確認已授予 VPN 連線權限。這與桌面版的系統 HTTP 代理開關不同;其他 VPN App 也可能占用相同的系統通道。
  • iOS:請使用支援相應設定的用戶端,並確認已授予 VPN 設定權限。桌面版 Clash 安裝檔不能用於 iOS;設定檔格式和功能支援情況也須依個別用戶端確認。

啟用 TUN 後,若區域網路裝置、公司內網或其他 VPN 出現異常,請先關閉 TUN 比較是否恢復,再檢查路由排除項目與 DNS 設定。不要直接複製不熟悉的 DNS 設定:內網網域、路由器網域和一般公網網域的解析路徑可能不同。想進一步了解流量接管方式,請參閱技術參考。

開機啟動:用戶端自動啟動、核心執行與代理恢復是三回事

「開機啟動」通常是指使用者登入後啟動用戶端,不一定代表登入前就有代理服務,也不保證啟動後會自動載入正確的設定檔、恢復系統代理或開啟 TUN。首次驗證時,應完整測試結束用戶端後重新登入或重新啟動電腦,而不是只看設定開關是否已開啟。

  1. 啟用用戶端自動啟動:在用戶端的啟動設定中開啟相關選項,並確認程式已移至預計長期使用的位置。請勿從暫存解壓縮資料夾、磁碟映像檔或即將刪除的安裝目錄執行。
  2. 檢查系統啟動項目:Windows 11 可前往「設定」→「應用程式」→「啟動」確認;macOS 可前往「系統設定」→「一般」→「登入項目與延伸功能」確認。Linux 則檢查目前桌面環境的自動啟動應用程式或相關服務。
  3. 確認啟動後的實際狀態:查看目前設定檔是否仍為選取狀態、策略群組是否恢復預期選項、監聽連接埠是否正確,以及系統代理或 TUN 是否依用戶端設定啟用。
  4. 等網路連線就緒,再判斷訂閱更新:登入後,Wi-Fi、入口網站驗證或公司網路可能尚未就緒。此時自動更新失敗,不代表本機現有設定檔無法使用;請先確認網路正常,再手動重試更新。

行動裝置還要檢查背景執行與電池管理設定

Android 的背景執行限制可能會在螢幕鎖定後終止代理服務。若出現「剛開啟時正常,過一會兒就斷線」的情況,請查看用戶端是否仍在執行、系統 VPN 狀態是否維持,以及電池管理是否限制背景活動。只調整確有需要的應用程式,不必關閉整台裝置的所有省電功能。iOS 的自動連線行為則取決於用戶端和系統支援,不能保證與桌面版自動啟動完全相同。

首次安裝排查順序:從本機監聽到應用程式接入

排查時應逐層縮小範圍,每次只修改一個變數。當「節點看起來正常,但應用程式無法連線」時,可逐項核對下表:

檢查步驟具體操作下一步判斷
1. 基本網路連線暫時關閉系統代理與 TUN,嘗試連線至可正常存取的網站仍無法連線,先處理本機網路或驗證問題
2. 載入設定檔查看目前設定檔名稱和核心錯誤記錄解析失敗時,修正設定檔或重新匯入
3. 連接埠監聽確認實際使用的混合連接埠及占用程序綁定失敗時,先排除連接埠衝突
4. 明確指定代理請求使用 curl 指定本機代理發出請求若請求失敗,檢查出口、規則與請求記錄
5. 應用程式接入確認系統代理或應用程式本身的代理設定明確指定代理的請求成功但應用程式失敗,請優先檢查代理接入方式
6. 重新啟動驗證重新啟動後,再測試一次請求和應用程式只有重新啟動後才失敗,請優先檢查自動啟動與權限

比對用戶端的連線記錄,也能進一步找出問題:完全看不到目標請求,通常應檢查接入路徑;出現請求但命中 DIRECT,應查看規則與策略群組;請求已送往代理出口卻逾時,則檢查節點是否可連線及目標網站狀態。可暫時提高記錄層級以利排查,問題解決後請恢復常用層級,避免持續產生大量記錄。

下載 Clash依平台選擇用戶端