Clash 全平台
安裝與設定指南

事前準備

通用準備：用戶端、架構與設定來源

先區分用戶端、核心與訂閱

Clash 生態系包含圖形化用戶端、負責網路處理的核心，以及用來描述代理和規則的設定檔。用戶端提供匯入、切換、記錄檔和權限管理功能；核心則負責連線、網域名稱解析與規則比對。安裝成功只代表程式可以啟動，不代表已具備可用的代理出口。訂閱通常由服務提供者產生，用戶端的下載頁面不會同時提供訂閱。開始前請確認設定來源、有效期限、支援格式，以及是否允許在多部裝置上使用。

需要圖形介面時，Windows、macOS、Android 和 iOS 可優先考慮 Clash Plus；Linux 則可選 Clash Verge Rev 或 FlClash。各平台的安裝套件請至下載中心查看。產品名稱相近，不代表支援的設定功能完全相同，尤其是較新的通訊協定、規則欄位和指令碼功能。更換用戶端前，請先保留原設定，再確認目標核心支援哪些欄位，不要只憑副檔名判斷相容性。

確認系統版本與處理器架構

桌面系統請先確認作業系統版本和處理器類型。Windows 可在「設定 → 系統 → 系統資訊」查看系統類型；macOS 可在蘋果選單的「關於這台 Mac」查看晶片；Linux 可執行下方指令查看架構。Android 安裝套件也可能區分 ARM64、ARM 和通用版本，安裝失敗不一定代表檔案損毀。架構相符後仍須確認用戶端列出的最低系統需求；舊版系統若缺少執行元件，改用相同架構的安裝套件也無法解決問題。

uname -m
# x86_64：通常對應 AMD64 / x64
# aarch64：通常對應 ARM64

也請記下目前的網路環境：是否連上校園或企業網路、是否須先透過網頁完成驗證，以及是否已有其他代理或 VPN。尚未完成網路驗證時，請先關閉流量接管並完成驗證。同時啟用多個用戶端的系統代理或虛擬網卡，可能會互相覆蓋入口與路由。初次設定時只保留一個用戶端執行，之後每次只調整一個變數，才容易找出是哪個步驟造成結果變化。

建立可還原的設定備份

匯入連結前，請確認連結來自可信任的來源，並將它視為敏感資訊。連結可能包含帳號識別資訊或存取憑證，不應出現在公開截圖、分享的記錄檔或線上轉換網站中。若要匯入檔案，請保留原始 YAML 備份；若用戶端支援匯出設定，也請另存一份用戶端設定備份。訂閱內容和用戶端本機設定通常分開儲存，移轉時只複製 YAML 不一定能保留開機啟動、服務模式或介面偏好。

建議使用容易辨識的本機名稱為設定命名，並記下匯入方式、最近一次成功更新時間及使用的核心。接著確認混合連接埠、出站模式和流量接管方式。先讓一個遵循系統代理設定的瀏覽器成功連線，再考慮啟用 TUN、區域網路分享或複雜的 DNS 設定。基礎連線尚未確認正常前，同時啟用所有選項會混淆設定、權限與網路問題，增加排查難度。

安裝前也請確認系統時間正確、磁碟空間足夠，並知道如何開啟記錄檔。憑證相關錯誤可能是時間不正確造成的；連接埠啟動失敗則通常須檢查是否有監聽衝突。首次安裝的權限設定與常見錯誤，可參考跨平台初始設定檢查清單；若要重新安裝，請先記下完整錯誤訊息及發生階段。

Windows

Windows：安裝、系統代理與服務權限

選擇安裝套件並完成首次啟動

前往Windows 下載區，建議優先選用 Clash Plus。若要比較介面和設定管理方式，也可查看 Clash Verge Rev、FlClash 或 Clash Nyanpasu。Clash for Windows 已停止維護，僅供封存參考，不建議作為新裝置的首選。下載前請先確認系統類型和安裝套件需求，並非所有 Windows 裝置都使用相同處理器。

安裝時依照精靈指示選擇路徑。首次啟動後，先確認程式能否進入主畫面，以及核心是否正常執行。若遭安全軟體封鎖，請查看遭封鎖的檔案、來源和原因，並依組織或裝置的安全政策處理，不要直接關閉所有防護。免安裝版和安裝版的資料位置可能不同；移轉前請透過用戶端的「開啟設定資料夾」或類似功能確認路徑，不要依照其他產品的路徑刪除檔案。

匯入訂閱並確認目前使用的設定

在「設定」、「訂閱」或相應頁面新增遠端設定，輸入本機名稱和訂閱網址，儲存後執行更新。更新完成後，還須選取並套用該設定；清單中出現項目，不代表核心已載入設定。請查看代理或策略群組頁面，確認其中有預期內容。若只有直連選項，應檢查訂閱回應和解析記錄，而非反覆切換系統代理。

本機檔案可透過匯入功能選取 YAML。載入失敗時，先檢查錯誤行附近的縮排、欄位和策略名稱，再確認核心支援的功能。若遠端設定需要本機覆寫，請使用用戶端提供的覆寫或合併機制；直接編輯快取檔案可能會在下次更新時被覆蓋。測試前請記下目前的混合連接埠，常見範例為 7890，但實際連線應以用戶端目前的監聽連接埠為準。

先測試系統代理，再啟用 TUN

開啟用戶端的「系統代理」，再到 Windows「設定 → 網路和網際網路 → Proxy」確認位址和連接埠。通常本機位址為 127.0.0.1，連接埠須與用戶端設定相同。若瀏覽器安裝了代理擴充功能，請確認由哪一層控制請求，避免擴充功能設定覆蓋系統設定。在規則模式下造訪目標網站後，請到連線記錄查看命中的規則和出站策略，不要只看開關是否開啟。

命令列工具不一定會讀取系統代理。可在單一 PowerShell 工作階段中暫時設定下方變數，再測試目標工具。只有支援這些環境變數的程式才會使用它們，工具本身的代理參數也可能優先採用。關閉視窗後，本次工作階段設定就會結束；若另有設定使用者或系統層級的變數，必須到相應位置清除，不能依據暫時工作階段的結果，推斷整台電腦的設定已還原。

$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

# 測試完成後清除此工作階段的設定
Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue
Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue

TUN 適用於不遵循系統代理的程式，因此用戶端須具備相應權限。若產品提供「服務模式」或「安裝服務」，請先依提示完成設定，再啟用 TUN 並查看記錄。安裝服務、啟動核心和建立虛擬網卡是不同階段；即使服務狀態正常，TUN 仍可能因驅動程式、權限或路由問題而失敗，此時應繼續檢查這些項目，而非重複匯入訂閱。企業裝置可能禁止使用虛擬網卡，請遵循裝置管理政策。

從睡眠恢復、連接埠衝突與退出後清理

電腦從睡眠模式恢復或切換無線網路後若連線異常，請先暫停流量接管，確認基本網路可用，再重新啟用。可使用 Get-NetTCPConnection -LocalPort 7890 查看連接埠衝突和監聽記錄，再搭配處理程序資訊判斷所屬程式。不要直接結束不熟悉的處理程序；可先關閉舊用戶端，或修改新用戶端的連接埠並同步更新所有引用位置。

開機啟動和自動連線是兩項不同設定，啟用前請先完成手動測試。若瀏覽器可用但終端機無法連線，請參考分別排查瀏覽器與終端機問題；若只有特定應用程式失敗，請檢查它是否使用獨立代理、特殊傳輸協定或自身的網路限制。

macOS

macOS：晶片架構、輔助服務與網路設定

依晶片架構選擇用戶端

在「關於這台 Mac」確認使用 Apple 晶片或 Intel 處理器，再前往macOS 下載區選擇相應安裝套件。建議優先選用 Clash Plus，也可使用 Clash Verge Rev 或 FlClash。ClashX Meta 已停止維護，僅供封存參考；移轉舊設定時，請特別留意設定欄位與新核心的差異。相容性轉譯無法取代系統需求檢查，使用原生架構套件通常較容易維護。

若提供磁碟映像檔，請開啟後將應用程式移至「應用程式」資料夾，再從該處啟動，不要長期直接在映像檔中執行。系統若提示無法開啟，請先確認下載來源和提示內容，再依照「隱私權與安全性」中的系統流程處理。不要將移除所有安全限制當成通用安裝步驟。受組織管理的 Mac 也可能限制背景項目、網路延伸功能或管理員授權，請先確認裝置政策。

匯入設定並保留用戶端偏好

開啟設定管理頁面，透過連結新增遠端訂閱；更新後將其設為目前使用的設定。查看記錄確認載入成功，再前往策略群組選擇出站方式。匯入檔案只會提供檔案內的設定，不一定包含選單列行為、系統代理控制和輔助服務狀態。移轉舊用戶端時，請先匯出原始檔案和本機覆寫設定，再逐項設定新用戶端，避免同時還原多個產品的背景服務。

遠端訂閱更新後若自訂規則消失，請確認規則是寫在訂閱快取中，還是透過獨立覆寫儲存；兩者的更新方式不同。編輯前可透過用戶端開啟目前設定資料夾，確認實際生效的檔案；不要以為「下載」資料夾中的原始檔案會持續與用戶端同步。若設定可成功解析，卻沒有預期的策略群組，請繼續檢查訂閱類型和選取的設定，而不是重新安裝應用程式。

確認目前網路服務的代理設定

啟用系統代理後，前往「系統設定 → 網路」，選取目前使用的 Wi-Fi 或乙太網路服務，再到「詳細資料 → 代理伺服器」檢查代理位址。不同網路服務各自有獨立設定，從 Wi-Fi 切換到有線網路後，請重新確認。用戶端可能會同時設定網頁代理、安全網頁代理和 SOCKS 代理；實際項目依產品實作而異，重點是確認位址和連接埠都指向目前執行中的用戶端。

可在終端機執行下方指令查看系統代理狀態，但這只會讀取設定，不代表每個命令列程式都會自動使用。若要診斷單次 HTTP 請求，可明確指定本機代理。範例使用保留作示範的網域名稱，只用來驗證請求路徑；請求成功不代表所有網站和通訊協定都正常。請查看連線記錄，確認請求確實進入核心。

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

「網頁可以開啟，命令列卻失敗」時，通常須檢查工具本身的代理設定、環境變數和網域名稱解析方式。若工具支援 SOCKS 且需要透過代理解析網域，請依照工具文件選擇相應模式，不要將 HTTP 代理位址填入所有通訊協定選項。憑證錯誤也應單獨判斷，先確認系統時間、憑證鏈和網路攔截狀況，不要將略過憑證驗證當成長期設定。

TUN 權限與還原網路

啟用 TUN 前，請依照用戶端提示安裝或授權輔助服務。輔助服務負責執行需要額外權限的系統操作，不代表 GUI 已自動取得所有網路權限。若提示安裝成功，但開關隨即自動關閉，請查看服務記錄、核心記錄和系統授權狀態。切換用戶端前，請先停止舊用戶端的 TUN，避免殘留路由與新的流量接管機制互相影響。

從睡眠模式喚醒、切換網路服務，以及啟動或停止其他 VPN，都可能改變路由。排查時先關閉 TUN 和系統代理，確認直接連線正常，再只恢復一種流量接管方式。若直接連線正常，但啟用後所有網域都無法使用，請先檢查 DNS 和路由；若只有特定目標失敗，則查看規則和出站設定。不要一開始就重設整個系統網路，以免遺失工作網路所需的靜態位址和驗證設定。

最後再設定登入時啟動，並確認允許背景項目執行。系統更新後若權限有所變更，請重新檢查權限設定位置，不要反覆匯入同一份訂閱。若平台設定正常但仍出現解析錯誤，可前往設定與排錯章節，從檔案、核心和規則三個層面繼續排查。

Android

Android：安裝套件、VPN 權限與背景執行

選擇適用架構並處理安裝限制

前往Android 下載區選擇用戶端，首推 Clash Plus；其他選項包括 Clash Meta for Android、FlClash 和 Surfboard。不同產品支援的訂閱格式和規則功能不盡相同，尤其不要未經檢查，就將某個用戶端的完整 YAML 匯入另一個產品。請先確認格式支援情況，再選擇符合裝置架構的套件；若不確定，可查看產品是否提供通用套件。

安裝外部應用程式時，系統可能要求允許目前使用的瀏覽器或檔案管理器安裝應用程式。請只授權這次使用的來源，安裝完成後可依需要從系統設定撤銷權限。若出現解析失敗提示，請依序檢查系統需求、架構、檔案是否完整下載及儲存空間。若發生簽章衝突，通常與既有應用程式的簽章或發行來源不同有關；解除安裝前請先匯出設定和本機偏好。

匯入訂閱並切換目前使用的設定

前往「設定」或「訂閱」頁面新增連結，也可透過檔案選擇器匯入本機 YAML。Android 檔案選擇器可能只授予用戶端讀取所選檔案的權限，因此匯入後的設定不一定會隨來源檔案更新。儲存後請手動更新一次，檢查內容和策略群組，再將其設為目前使用的設定。用戶端顯示「匯入成功」只代表匯入作業完成，仍須確認核心能否載入。

遠端連結若回傳網頁、登入頁面或不支援的格式，可能會造成設定空白或解析錯誤。此時請先確認訂閱是否過期、是否選擇適用於該用戶端的入口，以及系統時間是否正確。不要在聊天群組公開完整連結尋求協助。若用戶端支援分享記錄檔，請先移除訂閱網址、帳號識別資訊和節點憑證，只保留錯誤類型、相關欄位及必要的上下文。

了解 VPN 介面與依應用程式分流

啟動連線時，Android 會顯示 VPN 連線要求。確認用戶端身分後授予權限，再查看系統狀態列和應用程式內的連線狀態。VPN 介面是系統提供的流量接管入口，不代表所有連線都必須經過遠端代理；實際流量仍由規則、策略群組和依應用程式設定決定。一般情況下不必修改 Wi-Fi 的手動代理，以免混淆行動網路和無線網路的設定入口。

同一個使用者環境中，通常無法同時讓多個一般 VPN 應用程式占用這個介面。若已安裝企業 VPN、防火牆或本機流量過濾工具，請先決定保留哪一個負責接管流量。啟用「永遠開啟的 VPN」或「封鎖未使用 VPN 的連線」前，請先測試用戶端的啟動和重新連線情況；後者可能在用戶端停止時封鎖網路，容易被誤認為無線網路故障。

依應用程式分流常見兩種模式：只接管選取的應用程式，或接管除選取項目以外的應用程式。儲存前請先確認清單的用途，不要只根據勾選狀態推斷。測試時，請使用明確納入接管範圍的應用程式發送請求，再查看記錄和命中規則。工作資料夾、分身應用程式和不同使用者空間可能有各自的限制，主空間的選擇不一定會影響其他空間。

背景限制、網路切換與耗電排查

若鎖定螢幕後連線中斷，請先檢查系統的電池最佳化、背景活動和自動啟動設定。不同廠牌的選單名稱各異，請以應用程式詳細資訊頁面實際顯示的選項為準。前景服務通知通常用於維持執行並顯示連線狀態，不應只因通知常駐就判定用戶端異常。完成設定後，請分別測試螢幕亮起、鎖定螢幕，以及從無線網路切換至行動網路的情況，並記下首次發生問題的步驟。

若只有行動網路無法使用，請檢查系統是否限制該應用程式使用行動數據、是否啟用流量節省模式，以及訂閱的出口能否透過目前網路建立連線。若已連線，但部分應用程式無法使用，請再檢查依應用程式分流和 DNS。區域網路裝置無法存取時，則檢查私有位址是否依預期直接連線。不要強行將所有流量送往單一出站來掩蓋分流錯誤，這會改變本機服務的連線路徑。

需要分享網路時也請留意，手機上的 VPN 流量接管不一定會涵蓋熱點下游裝置，實際情況取決於系統和實作方式。若只是透過手機讓電腦連上網路，不要假設電腦已自動使用代理，請先在電腦端獨立驗證請求路徑。應用程式內規則模式、全域模式和直連模式的差異，可參閱Clash 新手十問。

iOS

iOS：從 App Store 下載、匯入設定與網路延伸功能

從 App Store 下載 Clash Plus

iPhone 和 iPad 建議優先使用 Clash Plus。可前往iOS 下載區查看下載方式，或直接開啟Clash Plus 的 App Store 頁面；產品官網為 clashplus.io。下載前請查看商店列出的系統相容性和裝置支援資訊。安裝完成後先開啟應用程式確認介面正常，再匯入設定；下載應用程式和取得訂閱是兩個不同步驟。

判斷 iOS 設定相容性時，須分別檢查各個層面：支援某種規則語法，不代表也支援其他用戶端的所有介面設定、指令碼和擴充欄位。若服務提供者提供多種訂閱入口，請選擇明確適用於目前用戶端的格式。從舊裝置移轉時，先記下策略群組選擇和自訂規則；新裝置是否透過系統備份還原應用程式資料，也須實際確認，不能只看應用程式圖示已出現。

連結、檔案與掃描匯入的適用範圍

通常可在設定管理頁面新增遠端設定，貼上網址、命名並儲存，接著更新並選取套用。部分入口允許讀取剪貼簿；若系統詢問是否允許貼上，請依目前操作決定是否授權。貼上後請檢查連結是否混入空格、換行或聊天軟體附加的字元。更新成功後，請確認代理或策略群組內容，不要只停留在訂閱清單頁面。

若要匯入檔案，可在系統的「檔案」App 選取已儲存的設定。雲端硬碟中的檔案若尚未下載到本機，請先確認可正常開啟，再交由用戶端讀取。匯入檔案通常只會複製一次，之後修改原始檔案不一定會自動更新應用程式內的設定。若需要持續更新，建議保留遠端連結的管理方式；若選擇自行維護本機檔案，請確認每次修改後如何重新匯入並套用。

掃描功能適用於用戶端支援的 QR Code 內容。QR Code 可能包含訂閱連結、單一代理或產品專用的匯入網址，掃描成功不代表取得完整的規則設定。掃描後請先確認辨識結果和匯入類型，避免匯入來源不明的內容。相機權限只會影響掃描功能；不使用掃描時，可直接透過連結或檔案完成設定，不必調整其他系統權限。

授予 VPN 權限並確認實際流量接管

初次連線時，系統會要求允許新增 VPN 設定，也可能要求透過裝置解鎖方式確認。完成後返回用戶端啟動連線，再到系統設定確認 VPN 狀態。這項功能透過網路延伸功能接管流量，與桌面系統的 HTTP 代理開關不同。設定載入、系統通道啟動和遠端出站可用是三個獨立環節；任何一個環節失敗都可能導致網頁無法開啟。

先在規則模式下選擇可用的策略，再造訪目標網站並查看用戶端記錄。若直連目標可用，但需要代理的目標失敗，請重點檢查策略群組選擇和遠端連線；若所有網域都無法使用，則檢查 DNS、網路延伸功能狀態和基本網路。顯示正在連線不代表每條規則都正確，也不能以狀態列圖示取代實際請求測試。若平台限制較少，可同時記下應用程式內的記錄、錯誤發生時間和網路類型。

依需求連線、背景行為與網路衝突

若用戶端提供按需連線，請在手動連線穩定後再啟用。逐項確認按需連線的觸發條件和無線網路例外，避免在需要網頁驗證的網路中提前接管請求。連上飯店、校園或公共無線網路時，請先確認驗證頁面能正常開啟。必要時暫時中斷用戶端連線以完成驗證，再重新連線；不要將驗證閘道問題誤判為訂閱失效。

iOS 前景應用程式和網路延伸功能的執行週期不同。離開前景畫面不一定會停止網路延伸功能；反過來說，應用程式仍顯示在最近使用項目中，也不代表通道運作正常。排查背景問題時，應查看系統 VPN 狀態並實際發送請求，不要反覆切回前景畫面。啟用其他 VPN 或網路過濾產品前，請先確認它們是否會取代現有設定；排錯期間只保留一個流量接管入口。

若無線網路正常、行動網路卻無法使用，請檢查應用程式的行動數據權限和目前網路限制；若只有特定應用程式異常，再查看其獨立網路功能和命中規則。詳細匯入步驟請參閱iPhone 下載用戶端與匯入設定。更換裝置或停用用戶端前，請先關閉自動連線相關選項，並在系統設定中確認不再需要的 VPN 設定。

Linux

Linux：發行版安裝、桌面代理與核心執行

圖形化用戶端與安裝套件格式

Linux 桌面環境可優先考慮Clash Verge Rev 與 FlClash，並依發行版選擇適用的套件格式。Debian、Ubuntu 系統通常使用 deb；Fedora 等系統通常使用 rpm，但能否安裝仍取決於架構、系統函式庫和桌面環境。不能只憑副檔名判斷相容性。安裝前請查看發行版資訊及 uname -m 的輸出，確認套件需求與目前系統相符。

使用系統套件管理員安裝，通常比自行解壓縮更容易處理相依套件。下方指令會切換到套件所在目錄，並使用 APT 安裝使用者指定的本機 deb 檔案；執行前請確認所選檔案確實來自可信任的來源。遇到相依性錯誤時，先閱讀套件管理員的輸出，分辨是軟體來源問題、函式庫版本不足，還是架構不符。不要強制忽略相依性，讓程式進入難以維護的狀態。

cd ~/Downloads
read -r -p "輸入目前目錄中的 deb 檔案名稱：" package_file
if [ -f "$package_file" ]; then
  sudo apt install "./$package_file"
else
  printf '找不到指定檔案\n'
fi

匯入訂閱與設定桌面代理

安裝完成後，從桌面啟動用戶端，先匯入遠端訂閱或本機設定，選取並套用後再查看核心記錄。桌面圖形環境可能透過工作階段匯流排管理系統代理，GNOME、KDE 和精簡視窗管理員的行為各不相同。若用戶端的系統代理開關無法生效，請到桌面網路設定確認實際值；開關顯示已啟用，不代表所有程式都會讀取該設定。

瀏覽器可能會遵循桌面代理設定，終端機、容器和服務程序則常常不會。診斷單次請求時，可明確使用 curl --proxy http://127.0.0.1:7890 --head https://example.com。若指定代理後請求成功，但直接執行失敗，請優先檢查目標程式的代理設定。另請注意，容器內的 127.0.0.1 指向容器本身，而非主機，不能直接沿用桌面位址。

TUN 權限與多種網路管理機制

TUN 通常需要存取 /dev/net/tun 並修改路由；圖形化用戶端可能透過輔助服務取得授權。請優先使用產品提供的權限管理方式，不要預設整個圖形程式都必須以管理員身分執行。可使用下方指令檢查裝置和路由是否存在，但輸出僅供檢視；不了解用途時，不要刪除路由、清空防火牆規則或停用系統解析服務。

ls -l /dev/net/tun
ip route
resolvectl status
ss -lntp 'sport = :7890'

resolvectl 僅適用於使用相應解析服務的系統；找不到指令不代表 DNS 已損壞。NetworkManager、systemd-resolved、其他 VPN 和用戶端本身的 DNS 模組都可能影響解析。啟用 TUN 後若網域無法連線，請先觀察請求是否抵達核心，以及由哪個服務處理解析，再決定要調整哪一層。若同時關閉所有解析服務，會失去排查依據。

伺服器與路由器上的 Mihomo

沒有桌面環境的伺服器或路由器，可在下載中心取得 Mihomo 核心，但這與安裝 GUI 用戶端是不同的做法。使用者須自行管理程序、設定目錄、記錄檔和權限。除了確認架構，也要核對執行環境需求；尤其是路由器，不能只根據產品標示的處理器系列選擇檔案，還須確認架構名稱和浮點運算能力。一般桌面使用者不必為了使用規則分流而先學習部署服務。

可使用 mihomo -t -f config.yaml 驗證設定，前提是可執行檔已加入命令搜尋路徑，而且目前檔案名稱確實為該設定檔。驗證通過後，先以前景模式執行並查看記錄，確認監聽連接埠和出站運作正常，再交由服務管理員管理。若設定引用外部規則集，也須檢查工作目錄、檔案權限和下載路徑；服務環境可能與互動式終端機不同。

自動啟動故障應分別檢查桌面登入時啟動和系統服務啟動。前者依賴使用者工作階段，後者可能在網路尚未就緒時執行。若手動執行正常、服務卻失敗，請查看實際執行使用者、工作目錄和記錄檔，而不是修改已確認可用的訂閱。停止使用時，也要一併移除環境變數、桌面代理和服務啟動項目，避免背景程序與新用戶端爭用連接埠。

設定與排錯

常見設定問題：欄位、規則、DNS 與連線測試

先釐清設定來源與實際生效內容

用戶端顯示的訂閱原始內容，不一定就是核心最後讀取的檔案。遠端設定、本機覆寫、介面設定和自動產生的欄位，可能會合併後才生效。遇到「檔案已修改但行為沒變」時，請先查看用戶端提供的執行設定或核心記錄，確認目前的設定名稱、載入結果和最終欄位。不要同時修改原始訂閱、快取檔案和介面開關，否則難以判斷是哪個值覆蓋其他設定。

YAML 對縮排和資料類型很敏感。請使用空格而非定位字元，同一層級的欄位維持相同縮排；清單項目隸屬哪個欄位，須從父層結構判斷。錯誤行有時只是解析器停止的位置，真正問題可能在上一行的引號、冒號或縮排。可先還原到上一次可用的檔案，再逐段重做修改。更多回應和格式問題，請參閱訂閱更新失敗與設定解析錯誤。

規則順序與出站模式

規則通常由上而下比對，命中後使用相應策略。特定網域規則一般應排在範圍較廣的規則之前，最後的兜底規則則放在末尾。規則引用的策略群組必須存在，名稱也須一致。以下僅以直連診斷設定說明結構：此設定不包含遠端代理，載入後所有符合規則的請求仍會直接連線。正式使用時請保留服務提供者的代理和策略群組，並依核心文件合併規則。

mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,DIRECT

全域模式適合短時間比較，不能取代正確的規則設定。若規則模式失敗、全域模式卻成功，請檢查命中記錄、策略群組和規則集，不要立刻認定用戶端不穩定。直連模式也不代表系統代理已關閉：應用程式仍可能先連上本機入口，再由核心直接連線。測試原始網路時，請明確關閉流量接管，不要只將出站模式切換為直連。

DNS 與 TUN 的檢查範圍

DNS 負責將網域名稱轉換為位址，代理則負責後續連線；兩者可能在不同位置執行。啟用 TUN 後，路由和解析路徑可能改變，須一併確認設定中的 DNS 開關、系統解析服務和用戶端覆寫。不要隨意複製其他裝置的 fake-ip 位址範圍、排除清單和上游伺服器，這些設定須符合現有網路、核心功能和實際需求。設定組合錯誤可能導致部分網域異常。

請依序確認基本網路、核心監聽狀態、請求是否進入核心、網域解析、規則命中和遠端出站。若網域無法連線，但已知位址可連線，代表應檢查解析鏈路；但也不能因此忽略憑證和伺服器依據網域名稱進行的路由。瀏覽器的加密 DNS 也可能繞過預期路徑，排查時請記錄其狀態，並一次只更改一項設定以比較結果。

如何判斷延遲、測速與無法上網

節點延遲測試只反映特定測試目標、通訊協定和時間點的結果。測試逾時不一定代表所有服務都無法連線，數值較低也不保證大型檔案的傳輸速度較快。請先確認測試位址和測試方式，再以實際目標驗證。若策略群組包含自動選擇功能，也要確認目前真正使用的出口，不要將清單中某個節點的測試結果當成實際連線路徑。

測速結果會受到本地頻寬、無線訊號、遠端限速、同時執行的工作和測速網站影響。比較時盡量使用相同網路、時段和目標，暫停其他大量傳輸工作，並記下使用的出口。不要在同一次測試中同時切換用戶端、DNS 和規則模式。若只有特定應用程式速度變慢，請優先查看該應用程式的連線記錄和通訊協定，而不是反覆重新整理所有節點。

Clash 無法上網時，先關閉流量接管並確認直接連線正常，再檢查目前設定是否已載入、代理入口連接埠是否正在監聽，以及策略群組是否有可用選項。接著確認錯誤屬於解析失敗、連線逾時、驗證失敗或拒絕連線。尋求協助時，請提供平台、用戶端名稱、接管方式、完整錯誤訊息和已做過的檢查，並移除敏感資訊。可依問題現象查閱常見問題 FAQ，或返回快速入門教學重新執行基本測試流程。