Clash 全平台安裝與設定指南

01 / BEFORE INSTALLATION

一般準備：客戶端、訂閱與流量接管方式

先了解客戶端與核心各自負責的工作

Clash 生態系包含圖形介面的客戶端，以及負責實際轉送流量的核心。客戶端用來管理訂閱、系統匣、權限與設定介面；核心則讀取設定並處理連線。介面相似不代表支援的欄位完全相同，尤其是舊版 Clash 設定與 mihomo 擴充設定之間。選擇時先確認支援的平台，再核對訂閱使用的協定及核心支援範圍。本指南會優先介紹各平台支援的 Clash Plus；若需要其他介面或桌面管理功能，可前往安裝檔頁面選擇 Clash Verge Rev、FlClash 等客戶端。

開始前請記下作業系統、處理器架構及安裝權限。桌面裝置通常分為 x64 與 ARM64；Apple Silicon 與 Intel 的安裝檔不能只看檔名中的 macOS 判斷；Android 裝置也可能使用 arm64 或較舊的 ARM 架構。安裝完成只是第一步，背景服務或虛擬網卡可能還需要額外授權。公司裝置若限制驅動程式、網路延伸功能或管理員權限，請先遵守裝置管理規範，不要關閉系統防護來規避組織政策。

準備訂閱，並保留可還原的設定

客戶端本身不會提供可直接使用的遠端代理資源。請準備有權使用的訂閱網址、單一連線資訊或本機設定檔，並確認內容符合所選客戶端的格式。訂閱連結可能包含存取憑證，請勿貼在公開截圖、記錄檔或線上轉換網站。匯入前可記下原客戶端使用的模式、策略組選項及自訂規則；移轉時不要直接覆蓋新客戶端的整個資料目錄，以免帶入不相容的資料庫與路徑。

遠端訂閱與最後生效的設定並非同一層。更新訂閱會重新取得內容，直接修改訂閱本文中的連接埠或規則可能遭到覆蓋。需要長期保留的變更，應放在客戶端提供的覆寫、合併或擴充設定入口。不同客戶端合併清單的方式不盡相同，特別要確認規則順序與策略組是否被整組取代。第一次匯入時先保留原始設定，確認運作正常後另存一份本機副本，之後每次只調整一類設定。

分清規則模式與流量入口

規則、全域、直連是連線進入核心後的處理模式；系統代理、TUN 則決定連線如何進入核心。啟用規則模式不會自動讓所有應用程式走代理，啟用 TUN 也不代表所有連線都會傳送到遠端。系統代理適合會遵循系統代理設定的瀏覽器與桌面應用程式；TUN 透過虛擬網路介面接收更多流量，涉及路由、DNS 與權限。初次排查建議先使用較簡單的入口，避免同時啟用多個客戶端或多種流量接管機制。

以下是 mihomo 的基本欄位範例，不含遠端代理，因此不能取代完整訂閱。混合連接埠可同時接收 HTTP 與 SOCKS 要求；綁定回送位址則僅供本機存取。若客戶端會管理監聽連接埠或 DNS，請以它最後產生的設定為準，不要在多個覆寫入口分散設定同名欄位。YAML 請使用空格縮排，同一層的鍵不可重複；編輯後先用客戶端檢查設定，再重新載入核心。

mixed-port: 7890
allow-lan: false
bind-address: 127.0.0.1
mode: rule
log-level: info

dns:
  enable: true
  enhanced-mode: fake-ip
  fake-ip-range: 198.18.0.1/16
  nameserver:
    - https://dns.alidns.com/dns-query

請分階段驗證：確認核心正在執行、設定已載入、策略組有可選項目，再開啟目標並查看連線記錄中的命中規則。連線測試只反映特定探測目標的結果，不能代表所有網站、UDP 或登入服務都可使用。記下測試時的網路環境與錯誤時間，之後才能分辨設定變更、遠端故障與本機網路變化。若只想完成首次連線，可回到使用指南，依照步驟操作。

03 / MACOS

macOS：架構選擇與網路權限

依晶片選擇客戶端並安裝至「應用程式」

開啟「關於這台 Mac」，確認裝置使用 Apple 晶片或 Intel 處理器，再到macOS 安裝檔區選擇相符的檔案。Clash Plus 可列為優先選項，也可依介面偏好選擇 Clash Verge Rev 或 FlClash。ClashX Meta 已停止維護，保留它主要是為了相容既有使用環境。不要將舊客戶端的設定目錄直接複製到新客戶端目錄；訂閱、規則與設定應分開移轉，並特別留意舊設定中的絕對路徑及已失效的指令碼。

若安裝檔是磁碟映像，請先將應用程式拖曳至「應用程式」資料夾，再從該目錄啟動，避免長期直接從掛載的映像執行。首次開啟時若出現系統安全性提示，請先確認來源，再透過系統提供的正常授權方式處理。不要照抄來源不明的批次解除隔離指令，也不要為了執行客戶端而關閉整套系統安全機制。若應用程式啟動後沒有主視窗，可查看選單列圖示；選單列應用程式的執行狀態與視窗是否顯示並不相同。

匯入訂閱並確認設定與策略組

在設定管理中匯入訂閱網址或本機 YAML，更新完成後明確選為目前使用的設定。接著前往代理頁面，確認選擇組與自動策略組已建立。若匯入內容只有連線資訊，並非完整 Clash 設定，請使用客戶端對應的匯入入口，不要只把其他格式的副檔名改成 YAML。策略組名稱必須與規則引用一致，特別是複製自訂規則時，不可保留新訂閱中不存在的目標組名稱。

初次驗證時維持規則模式，先選擇已知可用的成員，再查看存取時的連線記錄。如果介面測速成功但網站無法開啟，請確認問題發生在 DNS 解析、建立連線還是 TLS 階段。不同階段代表不同問題，不宜一概歸因於「線路太慢」。自動策略組的探測間隔與容許值會影響切換頻率，但無法修復失效的訂閱或錯誤的本機代理入口；參數選擇可參考策略組類型與適用情境。

系統代理依網路服務分別生效

啟用系統代理後，請檢查目前網路服務使用的代理設定。macOS 的 Wi-Fi、乙太網路及其他網路服務可以各自儲存代理項目，因此切換介面後結果可能不同。以下先列出服務名稱，再查詢 Wi-Fi 的 HTTP 與 SOCKS 代理。若系統中的服務名稱不同，請使用清單回傳的實際名稱；這些查詢指令只會讀取狀態，不會修改網路設定。

networksetup -listallnetworkservices
networksetup -getwebproxy "Wi-Fi"
networksetup -getsecurewebproxy "Wi-Fi"
networksetup -getsocksfirewallproxy "Wi-Fi"

HTTP、HTTPS 與 SOCKS 代理選項應符合客戶端支援的入口。若客戶端提供混合連接埠，多種代理協定可以共用同一個連接埠，但仍須確認實際設定。終端工具可能不會讀取系統網路代理，請使用工具自己的代理參數，或在目前終端工作階段設定代理環境變數。不要把一次性的測試直接寫入所有 shell 啟動檔，否則客戶端結束後，新開的終端仍會嘗試連線到已停止的本機連接埠。

TUN、背景輔助服務與其他網路工具

桌面客戶端啟用 TUN 時，可能需要安裝具特殊權限的輔助服務、授權網路延伸功能或啟動背景元件，實際需求取決於客戶端的實作方式。授權要求應與當下進行的操作相符。完成授權後，先重新載入核心，再查看記錄中的虛擬介面與路由狀態。只看到介面上的 TUN 開關已開啟，並不足以證明流量接管成功；還需測試一個原本不遵循系統代理的應用程式，並確認其連線已出現在記錄中。

若裝置同時執行企業 VPN、內容過濾軟體或其他虛擬網路工具，預設路由與 DNS 的管理可能互相影響。排查時一次停用一個可停用的元件，並記下結果；組織要求保留的軟體不可擅自解除安裝。啟用 TUN 後若無法存取區域網路印表機、共享資料夾或開發服務，請先檢查位址範圍與路由，再考慮加入精確的直連規則。不要將所有內網網域都改走代理，也不要用關閉所有 DNS 功能來掩蓋問題。

從睡眠狀態恢復或更換無線基地台後，舊 TCP 連線與 DNS 快取可能仍保留原網路資訊。可先關閉相關應用程式的連線，再重新載入客戶端設定。如果系統代理仍存在但核心未啟動，請先正常啟動客戶端或關閉對應代理，再重新測試。解除安裝前，請先關閉系統代理與 TUN，並透過客戶端提供的入口處理輔助服務；只將應用程式移到垃圾桶，不一定會清除背景元件或目前的網路設定。

05 / IOS

iOS：匯入 Clash Plus 並確認連線

從商店安裝並確認匯入入口

iOS 可使用 Clash Plus，前往App Store 的 Clash Plus 頁面安裝，產品資訊可參閱官方網站 clashplus.io。本站的iOS 下載區也提供相同入口。安裝後先確認應用程式可以正常開啟，再準備訂閱資訊。介面名稱可能隨客戶端更新而調整，請依設定、訂閱與連線等功能辨認入口，不必刻意尋找與桌面版完全相同的選單名稱。

匯入前先確認手上的內容類型：網頁管理網址、訂閱網址、單一連線與完整設定並不相同。複製連結時請保留完整參數，避免遭通訊軟體截斷或附加結尾標點。若透過系統分享選單，或從其他應用程式跳轉匯入，儲存前仍要確認目標內容與名稱。剪貼簿中的訂閱可能包含存取憑證，完成後不要將其放進公開備忘錄，也不要為了排錯直接傳送完整網址。

啟用設定並建立 VPN 連線

在客戶端新增訂閱或設定，取得內容後選為目前使用項目，再檢查可用策略。匯入成功通常只代表內容已儲存，還需要啟用並啟動連線。首次建立網路接管時，iOS 會詢問是否允許新增 VPN 設定，請依系統提示完成裝置驗證。接著回到客戶端檢查連線狀態，開啟目標應用程式並查看記錄。系統顯示 VPN 狀態只代表通道工作階段已建立，不能單獨證明特定遠端線路、網域或服務可正常使用。

若啟動後立即停止，請先查看客戶端提供的錯誤訊息與系統 VPN 狀態，不要連續點擊連線。原因可能包括設定解析錯誤、遠端參數不相容、目前網路無法建立連線，或其他 VPN 設定已接管。先保留目前設定的副本，再以最少變更進行測試。刪除系統中的 VPN 設定可能讓客戶端下次重新申請授權，但無法修復訂閱中的無效欄位，因此不應把反覆刪除設定當成通用解決方式。

了解行動作業系統的流量接管與規則範圍

iOS 的流量接管仰賴平台提供的網路延伸功能，不能直接等同於桌面設定中的 HTTP 系統代理開關。若客戶端提供路由、規則或模式選項，請依其實際支援方式設定。規則模式用來區分不同目標的出口；全域模式則會將接管範圍內的連線交由選定策略處理。即使使用全域模式，仍可能有系統或客戶端定義的排除範圍，不能因此推斷每項系統服務都會走相同路徑。

首次驗證時，請選擇明確的策略成員，使用實際目標頁面測試要求，再查看網域、規則與最後出口。網頁可以開啟但應用程式登入失敗時，請分別考慮登入 API、驗證碼、資源網域及 UDP 等連線需求。有些服務也受帳號狀態與伺服器地區政策影響，網路連通不代表這些條件會自動改變。不要只憑瀏覽器結果反覆調整所有規則；先確認失敗的要求是否進入客戶端，以及是否命中預期策略。

訂閱更新、DNS 與網路切換

訂閱更新會改變可用成員與策略引用；更新前請先確認本機修改是否會被覆蓋。如果客戶端提供獨立規則或覆寫入口，長期變更應放在該層管理；若只支援編輯匯入內容，請先儲存副本，並在下次更新後重新比對差異。策略組引用已刪除的成員時，介面可能仍保留名稱，卻無法連線。更新完成後至少檢查目前選項與實際存取結果，不要只看更新時間。

Wi-Fi、行動網路與公共熱點的 DNS 和連線條件各不相同。切換網路後，既有連線可能失效，需要重新建立。遇到飯店、機場等需要網頁驗證的網路，請先完成正常的網路登入，再連線客戶端；否則訂閱取得與遠端連線都可能遭入口網站攔截。若某個網路持續無法使用，請比較關閉連線時是否能正常開啟基本頁面，並記錄失敗階段，避免把網路登入問題誤認為客戶端設定損壞。

DNS 設定應以 Clash Plus 實際支援的選項為準。本文其他章節的 mihomo 範例用於說明欄位意義，不保證整段貼入每個行動客戶端都能使用。自訂解析器、系統網路設定與瀏覽器功能可能共同影響結果，排查時每次只調整一項。若想了解 Fake-IP 的映射方式與偵測範圍，可閱讀DNS 檢測與防洩漏設定，再依客戶端支援情況實際設定。

長期使用時，請定期確認訂閱仍有效且目前策略正常，不必頻繁清除所有設定。換到另一台裝置後，需要重新授予系統網路權限；還原訂閱不代表舊裝置的連線狀態也會一併還原。準備刪除客戶端前，請先中斷連線並確認系統網路已恢復正常。排錯資料只保留必要的時間、錯誤類型與去識別化設定，避免截圖洩露訂閱入口或連線驗證資訊。

07 / DIAGNOSTICS

常見設定問題：依連線階段排查

訂閱更新失敗與設定解析失敗

訂閱更新失敗時，先檢查取得內容的階段。確認網址完整、系統時間正確、服務仍有效，以及目前網路能否連線至訂閱端點。如果網址回傳登入頁面、流量限制提示或錯誤文字，客戶端接著出現的解析錯誤只是結果，不應靠修改 YAML 縮排來處理。更新是否經過代理取決於客戶端實作；有些情況必須先連線才能取得內容，也可能因舊代理失效而無法更新。請查看客戶端的更新網路設定，並進行對照測試。

內容已下載但核心拒絕載入時，再檢查語法、欄位與引用。YAML 縮排請使用空格，各清單項目的位置要一致，同一個對應表不可依賴重複鍵覆蓋。規則引用的策略組，以及策略組引用的代理或代理集合都必須存在。不同核心支援的協定與欄位各有差異，將副檔名改成 YAML 並不會轉換格式。先還原最近一次覆寫，再逐段恢復，比一次刪除所有設定更容易找出問題。

連接埠、監聽位址與流量是否進入核心

應用程式提示連線遭拒時，先確認核心是否正在執行、本機連接埠是否正在監聽，以及應用程式的代理位址是否相符。監聽在 127.0.0.1 的服務只能供本機使用，其他裝置不能把自己的回送位址當成這台電腦。跨裝置使用時，必須確認伺服器的區域網路位址、允許存取的監聽範圍及防火牆規則。不要為了排錯直接開放所有介面；先在本機明確指定代理並確認成功，再逐步擴大至受控的區域網路範圍。

存取目標時，連線記錄完全沒有變化，通常應先檢查流量入口，而非修改出口策略。應用程式可能忽略系統代理、使用獨立設定，或不在行動裝置的接管範圍內。若記錄有新增但走直連，請檢查命中規則與順序；若記錄顯示走預期代理卻仍失敗，再檢查遠端連線、驗證資訊與目標服務。依層次排查可避免把所有錯誤都歸咎於節點無法使用，也能減少不必要的重新匯入訂閱。

DNS、Fake-IP 與規則順序

Fake-IP 會為網域指派保留位址映射，讓後續連線仍可依網域進行規則判斷。看到這類位址不代表 DNS 損壞，但依賴真實解析結果的程式可能需要精確的例外規則。例外應盡量指定特定網域，避免排除範圍過大，導致網域規則無法如預期運作。內網網域還需要能解析它們的本機 DNS；公共解析器通常不知道企業或家用網路中的私人名稱。

規則會依序比對，精確的服務規則通常要放在較廣泛的規則之前，MATCH 作為兜底規則放在最後。以下範例需加入完整設定，並使用內建直連策略，不依賴自訂組名。這只示範順序與語法，不代表完整的業務分流方案；仍須保留實際訂閱中的遠端代理與選擇組。修改後重新載入，並從連線記錄確認命中項目，不要只檢查檔案是否已儲存。

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
  - MATCH,DIRECT

DNS 檢測結果中的解析器位置，不能單獨證明服務流量是否依預期送出。應一併查看解析要求路徑、目標連線與規則記錄；瀏覽器安全 DNS、應用程式內建解析及快取都會影響比較結果。想深入了解設定，可閱讀DNS 洩漏檢測與防洩漏實作。啟用更多 DNS 選項不會自動提高可靠性，請先了解各欄位的作用，再逐項測試。

策略選擇、連線重用與更新還原

自動策略組會依探測目標與自身邏輯選擇路徑；不同類型分別著重延遲、可用性或負載分配。探測成功不代表特定服務一定可用，探測失敗也可能只是探測網址無法連線。先手動選擇成員並測試實際目標，再決定是否調整探測參數。切換策略後，舊的長連線可能仍使用原本出口；請關閉相關連線或重新啟動應用程式後再比較，否則可能誤以為策略切換沒有生效。

升級客戶端或核心後若出現問題，先保留記錄檔與目前設定，再用備份設定比對。自訂擴充欄位、舊路徑、規則集合快取及權限變更都可能影響啟動。尚未備份時，不要同時升級、清除資料並重寫設定，否則難以判斷哪個步驟造成影響。舊客戶端移轉可參考Clash for Windows 停止維護後的替代方案與移轉方式，優先轉移訂閱與規則，不要直接複製所有執行資料。

記錄必要的排錯資訊，保留復原方式

需要進一步排查時，請記錄系統與架構、客戶端名稱、流量接管方式、失敗目標類型及錯誤時間，再附上去識別化後的相關記錄檔。暫時提高記錄層級只用於重現問題，完成後請恢復一般層級，避免持續累積大量存取記錄。連線憑證、訂閱參數與控制介面驗證資訊不應放入公開資料。還原順序應與啟用順序相反：先關閉新增的路由或 TUN，再還原代理與 DNS，最後確認客戶端已正常結束。各平台入口請參閱本頁對應章節；基本操作則可回到快速入門指南。