第一次安裝 Clash 客戶端要注意什麼？Windows、macOS、Android、iOS 初始設定與常見問題

初次設定順序：先匯入訂閱，再接管流量

第一次使用時，依序完成「安裝客戶端 → 匯入並啟用設定檔 → 選擇策略組 → 開啟流量接管 → 檢查連線」。先確認連線正常，再調整 TUN、DNS 或開機啟動。這樣遇到問題時，才能判斷錯在哪個步驟。

Clash 是代理核心及相關客戶端生態的常見稱呼，並非所有平台都使用同一套安裝程式。Clash Meta 後來改稱 mihomo，採用 mihomo 的圖形介面客戶端也各有不同設定介面。訂閱是否相容，取決於實際使用的核心與設定檔格式，不能只看應用程式名稱。

1. 確認作業系統與處理器架構：Windows 分為 x64 與 ARM64，macOS 分為 Intel 與 Apple Silicon；Android 安裝套件也可能依 arm64-v8a 等架構區分。
2. 準備相容的訂閱：請向服務提供者索取 Clash 或 mihomo 設定檔連結。只有節點清單、網頁網址或其他客戶端專用連結，不一定能直接匯入。
3. 暫時關閉其他代理或 VPN：避免多個客戶端同時變更系統代理、虛擬網卡或路由設定。
4. 記下目前的網路狀態：先確認一般網站可以正常開啟，再開始設定。曾手動設定代理的電腦，請先記下原本的設定。

匯入訂閱與策略組：看得到設定檔，不代表已經啟用

在客戶端的「訂閱」、「設定檔」或 Profiles 頁面選擇透過 URL 匯入，貼上完整網址並下載。各客戶端的中文選單名稱不盡相同，以下依功能說明，不以特定軟體的按鈕名稱作為通用操作路徑。

第一次匯入時，確認以下四項

• 確認下載成功：設定檔清單中應顯示名稱、更新時間或可用項目，而不是停留在錯誤訊息。
• 確認已設為目前使用的設定檔：有些客戶端匯入後還要點選「啟用」。只新增一張設定檔卡片，不代表核心已切換。
• 確認策略組有可用選項：在「代理」或 Proxies 頁面展開主要策略組，先手動選擇一個節點，避免誤選 DIRECT 或 REJECT。
• 確認模式設為規則模式：初次使用建議選擇 Rule／規則模式，依設定檔中的規則決定直連或代理。Global／全域模式可用於短時間比對測試；Direct／直連模式則不會透過代理節點轉送流量。

匯入時若出現 YAML 解析錯誤，先確認訂閱網址是否真的回傳設定檔。過期連結可能會導向登入頁面，複製時漏掉參數也可能讓伺服器回傳錯誤內容。不要一看到錯誤就隨意刪除設定檔中的縮排：YAML 的階層取決於縮排，修改後可能產生更多錯誤。

若出現不支援某種代理類型或設定欄位的訊息，請先確認客戶端使用的核心，再向服務提供者索取相符格式。不要為了成功匯入就任意移除連線協定、加密或 TLS 參數；設定檔能載入，不代表節點一定能連線。

Windows 與 macOS：先檢查系統代理，再考慮 TUN

桌面版初次使用時，先開啟客戶端的「系統代理」功能，再用瀏覽器測試。這項功能通常會將系統的 HTTP／HTTPS 代理指向本機監聽連接埠，但不保證所有應用程式都會使用代理。未讀取系統代理設定的應用程式，仍可能直接連線。

本機位址與連接埠要一併確認

常見的混合連接埠是 7890，但不同客戶端可能使用其他數值，請以目前介面或實際生效的設定為準。例如，客戶端監聽 127.0.0.1:7890，但系統代理仍指向舊軟體的 127.0.0.1:7897，瀏覽器就可能出現代理連線失敗。混合連接埠可接受 HTTP 與 SOCKS5 連線，但不代表系統設定會自動同步。

macOS 首次變更網路設定或安裝輔助服務時，可能會要求管理員驗證。Windows 安裝服務、設定 TUN 虛擬網卡也可能需要提升權限。請先確認提出要求的應用程式名稱與來源，再決定是否授權；一般桌面系統代理測試通常不必長期以系統管理員身分執行整個客戶端。

TUN 不是安裝完成後必須開啟的功能

TUN 會透過虛擬網路介面接管流量，適合處理不遵循系統代理設定的應用程式，但也會增加路由、DNS 與權限等變因。建議先確認一般瀏覽器測試正常，再開啟 TUN，而且每次只變更一項設定。開啟後若無法連線到區域網路裝置、公司內網或其他 VPN，先關閉 TUN 進行比對，不要立刻再疊加更多 DNS 設定。

Android 與 iOS：分別處理 VPN 授權與背景執行限制

Android：先允許 VPN 連線，再確認背景執行是否穩定

Android 客戶端通常會使用系統 VPN 介面接管流量。首次點選啟動時，系統會顯示 VPN 連線要求，確認後狀態列通常會出現 VPN 圖示。這只代表 VPN 介面已建立，不表示訂閱有效或代理節點已連線。

1. 匯入並啟用設定檔，在策略組中選好節點後，再啟動連線。
2. 若系統提示已有 VPN 連線，請先中斷原有連線。一般個人使用情境下，同一位使用者通常一次只能啟用一項使用系統 VPN 介面的服務。
3. 鎖定螢幕約 5 分鐘後再開啟網頁，確認是否仍能連線；這只是簡單的再次測試，不代表實際續航測試結果。
4. 只有在確實發生背景斷線時，才檢查「設定 → 應用程式 → 對應客戶端 → 電池」中的背景執行限制。部分廠商也另有「自動啟動」或背景鎖定設定。

Android 13 及更新版本可能會另外要求通知權限。通知權限與 VPN 授權不同：常駐通知有助於查看連線狀態，但授予通知權限本身不會建立代理連線。一開始也不建議開啟所有背景保活選項，先觀察預設設定是否穩定即可。

iOS：確認應用程式支援的格式與網路延伸功能

不要把 iOS 上的代理應用程式都當成同一款 Clash 客戶端。不同應用程式支援的訂閱格式、規則語法與策略組功能各不相同。匯入前請查看應用程式說明，確認是否直接支援 Clash 設定檔，或需要服務提供者提供專用格式。

首次啟動時，通常需要允許新增 VPN 設定。可前往「設定 → 一般 → VPN 與裝置管理」檢查相關設定，但仍須同時確認應用程式內的啟用狀態與系統 VPN 狀態。學校或企業管理的裝置可能禁止新增 VPN；若看到管理政策提示，請聯絡裝置管理員，不要安裝來源不明的描述檔來繞過限制。

連接埠占用與憑證警告：依錯誤類型處理

連接埠占用：找出相關程序，不要直接結束不明服務

記錄中出現 address already in use 或連接埠繫結失敗，通常表示已有程式正在監聽同一連接埠。先關閉舊客戶端和重複啟動的程序，再檢查連接埠。以下指令以 7890 為例，實際檢查時請替換成目前的監聽連接埠。

在 Windows 命令提示字元中執行：

netstat -ano | findstr :7890

查看對應本機位址的 LISTENING 列，最右欄是 PID；接著在工作管理員的「詳細資料」頁面依 PID 查詢程式。macOS 可在終端機執行：

lsof -nP -iTCP:7890 -sTCP:LISTEN

若占用連接埠的程式必須繼續執行，可將代理客戶端的混合連接埠改成未被占用的數值，例如 7891，接著重新套用系統代理。手動設定過代理的瀏覽器、終端機及其他軟體也要同步更新連接埠。不要只修改設定檔，卻忘了更新系統代理位址。

分辨應用程式簽章、網站憑證與節點 TLS 錯誤

• 應用程式無法驗證開發者：這通常是安裝來源或系統簽章檢查問題。請回到專案發布管道確認系統需求與安裝套件來源，不要關閉整套系統安全機制。
• 瀏覽器提示網站憑證無效：先檢查系統日期、時區、網站網域，以及目前是否連上需要登入驗證的公共 Wi-Fi。不要直接選擇繼續瀏覽敏感頁面。
• 記錄顯示 TLS 憑證驗證失敗：檢查節點設定中的伺服器名稱、憑證有效期限與系統時間，再聯絡服務提供者。不要把略過憑證驗證當成一般修復方式。

連線驗證：分別檢查節點、規則與流量接管範圍

「延遲測試有數字」不等於實際網站能正常瀏覽。測試位址有回應，只代表該次探測成功；目標網站仍可能因規則、DNS、帳號狀態或出口限制而無法開啟。請依照以下順序檢查，避免一次變更太多條件。

1. 檢查核心記錄：先確認沒有設定檔載入失敗、連接埠監聽失敗或反覆重新啟動的情況。
2. 檢查連線記錄：用瀏覽器開啟明確需要代理的網站，觀察是否出現該網域的連線記錄。若完全沒有記錄，先確認系統代理、VPN 或 TUN 是否已接管該應用程式的流量。
3. 檢查命中的策略：確認連線使用預期的策略組，而不是意外命中 DIRECT。若記錄顯示連線遭拒，請檢查是否符合封鎖規則。
4. 更換單一節點重新測試：保持設定檔與規則不變，只更換節點。若恢復正常，就進一步檢查原節點，不必重裝客戶端。
5. 必要時短暫切換至全域模式：若全域模式可用、規則模式不可用，請優先檢查規則與策略組選擇；測試後切回規則模式。全域模式本身不會擴大系統代理的流量接管範圍。

瀏覽器能用、終端機卻無法連線，是常見的流量接管範圍差異。許多命令列工具不會自動讀取桌面系統代理設定。確認 7890 是目前的 HTTP 或混合連接埠後，可用明確指定代理的請求進行比對：

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

Windows 可使用 curl.exe，避免部分 PowerShell 環境中的同名別名造成影響。這項指令只能驗證指定請求能否經由本機代理傳送，無法證明所有應用程式都已接管；還需參照連線記錄，判斷目標網站回傳的 HTTP 狀態。

設定完成後：保留必要設定並確認退出狀態

首次確認可正常使用後，再考慮訂閱自動更新、開機啟動與 TUN。訂閱更新可能覆蓋手動編輯的內容；需要長期保留的修改，建議使用客戶端支援的覆寫或合併功能，並依照該客戶端的說明設定。

• 記下必要資訊：記錄客戶端名稱、版本、核心版本、監聽連接埠與流量接管方式，方便日後檢查。
• 檢查區域網路連線選項：若只在本機使用，請保持「允許區域網路連線」關閉，避免將代理連接埠公開給同一網段的裝置。
• 正常退出一次：先關閉系統代理，再退出應用程式，確認一般網路已恢復。若直接強制結束程序，系統可能仍指向已停止監聽的本機連接埠。
• 重新啟動後再次測試：檢查設定檔是否仍已啟用、VPN 是否需要重新連線、連接埠是否變更；不要只看系統匣圖示。

遇到問題時，請分別檢查五個環節：「設定檔能否載入、核心能否啟動、流量是否進入、策略是否正確、節點能否連線」。尋求協助時，提供作業系統版本、客戶端版本與已去識別化的錯誤片段，並刪除訂閱權杖、節點密碼等敏感資訊。更多設定步驟請參閱入門指南，個別參數則可參考進階設定。