入門指南 閱讀時間約 10 分鐘

Clash 初次安裝設定清單：Windows、macOS、Android 注意事項與常見問題

整理 Windows、macOS、Android 初次安裝 Clash 的重點：從安裝檔選擇、權限設定到匯入訂閱，並說明連接埠衝突與憑證提示等常見問題。

一、安裝前：確認用戶端、核心與裝置架構

Clash 用戶端通常由圖形介面與代理核心組成。圖形介面負責管理訂閱、切換模式及設定系統選項；核心則負責解析設定、比對規則並建立連線。Clash Meta 後續以 mihomo 名稱持續發展，但不同用戶端所附的核心及支援的設定欄位不盡相同。看到「支援 Clash」時，也要確認訂閱服務提供者要求的是傳統 Clash 格式，還是依賴 mihomo 功能的設定。

  • Windows：在 Windows 11 開啟「設定」→「系統」→「系統資訊」，查看「系統類型」。一般 Intel、AMD 電腦選擇 x64；ARM 裝置則優先選用用戶端提供的 ARM64 版本。
  • macOS：開啟蘋果選單 →「關於這台 Mac」。Apple 晶片裝置優先選擇 arm64，Intel 裝置選擇 x64；Universal 安裝檔則請參閱專案說明。
  • Android：近年的手機通常採用 arm64-v8a，但較舊機型與模擬器可能不同。不確定時，請選擇專案提供的通用 APK，並確認最低 Android 版本需求。

下載前也要查看專案的維護狀態與發行說明。用戶端能安裝，不代表仍有因應系統權限或新設定欄位的更新。初次使用可前往下載中心依平台選擇，並記下用戶端與核心版本，方便日後排查問題。

二、初次啟動：檢查三大平台的權限

初次啟動時不必馬上開啟所有選項。建議先匯入設定，再透過系統代理或 Android VPN 建立基本連線。桌面版 TUN 會用到虛擬網卡、路由與 DNS，適合在確認基本連線正常後再單獨測試。

平台 先確認的權限 常見混淆
Windows 確認可寫入系統代理；依用戶端需求安裝服務，或授予 TUN 所需權限。 防火牆中的「允許存取」不代表已啟用系統代理，也不表示需要開放公網連入。
macOS 首次開啟時確認來源；視需要授權網路輔助元件。 允許開啟應用程式、授權輔助服務與信任憑證，是三件不同的事。
Android 允許用戶端建立 VPN 連線。 VPN 圖示只代表本機流量已由 VPN 接管，不保證遠端節點可用。

Windows：分清系統代理與服務模式

系統代理通常會將本機 HTTP 代理位址寫入使用者設定，供遵循該設定的應用程式使用；但不保證能接管所有遊戲、終端機或 UDP 流量。TUN 則透過虛擬網卡接管符合路由設定的流量，是否需要以系統管理員身分啟動或安裝服務，視用戶端的實作方式而定。不要只因網頁無法開啟，就長期以系統管理員身分執行所有程式。

macOS：先確認來源，再處理系統提示

建議先將應用程式移至「應用程式」資料夾，再開啟。在 macOS 15 中，可前往「系統設定」→「隱私權與安全性」查看來源相關提示。只有確認安裝檔來自專案發佈管道，且提示屬於首次開啟限制時，才依系統流程處理；若提示應用程式已損毀、含有惡意內容或簽章異常，請停止執行並重新確認來源，不要全面關閉系統安全機制。

Android：分別檢查 VPN 授權與背景執行

初次連線時會出現系統 VPN 授權視窗；允許後，用戶端才能透過 VpnService 接管流量。同一使用者或工作資料範圍內，通常只能有一個一般 VPN 服務處於啟用狀態，其他 VPN 防火牆或過濾工具可能與之衝突。如果螢幕鎖定一段時間後就斷線，請再檢查該應用程式的電池限制。接近原生 Android 14 的系統可前往「設定」→「應用程式」→選取用戶端→「應用程式電池用量」查看；各廠牌系統的名稱可能不同。

三、匯入訂閱：確認格式、狀態與目前設定

訂閱連結是取得設定的入口，不是節點本身，也不是軟體啟用碼。連結通常含有帳戶權杖，應妥善保管，視同密碼；在截圖、記錄檔與求助資訊中，都應遮蔽完整連結。請勿將私人訂閱貼到來源不明的線上轉換網站。

  1. 確認訂閱格式。在服務提供者的網站選擇適用於目前用戶端核心的 Clash 或 mihomo 設定。Base64 節點清單、單一分享連結與完整 YAML 設定是不同格式。
  2. 新增遠端設定。在用戶端的「設定」或「訂閱」頁面新增遠端設定，貼上連結並下載。各用戶端的選單名稱不同，請以目前介面為準。
  3. 查看下載結果。確認更新時間、解析狀態與策略群組內容。HTTP 401、403 通常應檢查權杖、帳戶權限或服務限制；若逾時，先確認目前網路能否連上訂閱網址。
  4. 啟用剛匯入的設定。清單中出現設定，不代表已經生效。請選取該設定，確認核心啟動成功，再前往策略群組選擇可用節點。

若出現 YAML 解析錯誤，先查看記錄中的欄位名稱與行號。回傳內容可能是登入頁面、服務錯誤訊息，也可能含有目前核心不支援的參數。此時反覆切換節點無法修正設定語法。請優先重新取得正確格式，不要隨意刪除錯誤行。

四、首次連線：檢查規則模式與代理入口

初次驗證建議使用規則模式，再於實際被規則引用的策略群組中選擇節點。規則模式會依設定規則決定直連或代理；全域模式無法讓無效節點恢復正常，直連模式也不等於結束用戶端。如果 TUN 仍處於啟用狀態，流量可能繼續經過本機核心，只是改為直連。

  1. 先確認目前設定已啟用，且核心沒有啟動失敗或不斷重新啟動。
  2. 桌面版開啟系統代理；Android 點選連線並完成 VPN 授權。桌面版初次測試先不要同時啟用 TUN。
  3. 對目標策略群組進行一次延遲測試，再瀏覽實際需要使用的網站。測試成功只代表測試目標可連線，不表示所有網站都能存取。
  4. 開啟連線記錄，確認出現新的連線要求，並檢查比對到的規則、策略鏈與最終節點。舊連線可能繼續使用原本的出口；切換後請重新建立連線。

桌面版可明確指定本機代理，用來分辨「核心能否轉送流量」與「瀏覽器是否使用系統代理」。以下以實際監聽連接埠為 7890 的 HTTP 或 mixed 代理為例；此數值僅供示範，請先在用戶端設定中確認。目標網站也可換成需要測試的 HTTPS 網址。

# Windows PowerShell
curl.exe -I --proxy http://127.0.0.1:7890 --connect-timeout 10 https://example.com

# macOS 終端機
curl -I --proxy http://127.0.0.1:7890 --connect-timeout 10 https://example.com

若能收到 HTTP 回應標頭，表示這次要求已透過指定代理取得回應；仍須依目標網站判斷狀態碼。若命令執行成功但瀏覽器無法連線，請優先檢查瀏覽器代理擴充功能、瀏覽器本身設定與系統代理。若顯示連線遭拒，請先檢查監聽位址、連接埠與核心狀態，不要立刻修改 DNS。

五、連接埠衝突：先查程序，再改設定

記錄中出現 address already in use 或 bind 失敗，通常表示監聽位址或連接埠已被占用。舊用戶端未完全結束，或同一程式啟動了兩個執行個體，都是常見原因。以下仍以 TCP 連接埠 7890 為例，請在執行用戶端的同一台電腦上查詢。

# Windows：查看占用連接埠的 PID
netstat -ano | findstr :7890
# 再到工作管理員的「詳細資料」頁面依 PID 尋找程序

# macOS：查看監聽此 TCP 連接埠的程序
lsof -nP -iTCP:7890 -sTCP:LISTEN
  • 找到舊代理程序：先從舊軟體介面正常結束，不要直接強制結束不熟悉的系統程序。
  • 確實需要更換連接埠：例如從 7890 改成 7895，也要一併更新系統代理、瀏覽器手動代理及終端機中的代理設定。
  • 連接埠未在監聽：查看核心記錄，確認設定已成功載入。控制面板連接埠不是流量代理連接埠，兩者不能互相替代。

只在本機使用時，建議維持監聽於迴路位址，並關閉不需要的區域網路存取功能。HTTP、SOCKS、mixed 與控制介面各有用途，不要為了「連得上」就將所有監聽位址改成對外開放。

六、憑證、DNS 與 TUN：依問題狀況處理

出現憑證提示，不代表應該安裝憑證

一般 HTTPS 代理連線通常會透過通道轉送，不需要安裝用戶端提供的根憑證。若瀏覽器顯示憑證日期無效，先確認系統日期、時區與自動校時；若顯示名稱不符或簽發者不受信任，請檢查是否前往錯誤網域、公共網路登入頁，或受到其他 HTTPS 檢查軟體影響。

若下載訂閱時發生 TLS 錯誤，也應檢查訂閱伺服器憑證與本機時間。不要將略過憑證驗證當成通用修復方式，更不要安裝聊天訊息或陌生網頁提供的根憑證。公司管理的裝置若有明確憑證政策，請向管理員確認。

網域連線失敗時，先分辨是哪一層解析出問題

系統 DNS、瀏覽器安全 DNS、代理核心 DNS 與遠端節點解析可能同時存在。網站無法開啟時，先查看記錄，確認是網域解析失敗，還是解析成功後連線逾時。Android 的「私人 DNS」與廠牌網路設定可能影響解析路徑；可先記下原設定，再暫時調整作為對照，不要一次變更所有 DNS 項目。

先完成基本驗證，再啟用 TUN

只有需要接管不遵循系統代理的程式時，才測試桌面版 TUN。啟用前記下目前的 VPN、虛擬網卡與 DNS 設定；啟用後檢查核心記錄、預設路由與連線記錄。若系統代理運作正常，一開啟 TUN 就無法上網，請優先停用 TUN，排查權限、路由衝突與 DNS 接管問題，而不是重新安裝用戶端。

七、安裝完成後的檢查與退出確認

初次設定完成後，不能只看「已連線」。請逐一確認以下項目，減少重新啟動、切換網路或更新訂閱後重複排查問題。

  • 設定檢查：目前設定名稱與更新時間清楚，記錄中沒有持續發生解析錯誤；需要的策略群組中有可用節點。
  • 流量檢查：新開啟的網頁要求能在連線記錄中找到，且能確認它為何直連或使用代理。
  • 退出檢查：結束用戶端前先關閉系統代理，或使用正常退出流程，並確認一般網路仍可使用。Windows 11 可前往「設定」→「網路和網際網路」→「Proxy」檢查是否有殘留的手動代理設定。
  • 重新啟動檢查：重新啟動用戶端後，確認仍選取原本的設定；若已設定自動啟動，請確認沒有與其他網路工具同時啟動。
  • 行動網路檢查：Android 在 Wi-Fi 與行動網路間切換後重新測試，螢幕鎖定後再確認背景連線是否維持。
  • 求助資訊：記下作業系統、用戶端與核心版本、具體錯誤訊息及重現步驟。只提供必要的記錄片段，並遮蔽訂閱權杖、密碼與私人位址。

遇到問題時，優先保留能正常運作的最精簡設定。先驗證一份設定、一個節點與一種接管方式，再逐步加入自動更新、TUN 或自訂規則。這樣更容易找出故障原因，也能在設定變更後迅速還原至已驗證的狀態。

下載Clash