Clash 全平台
安裝與設定指南

通用準備：先釐清用戶端與設定檔

用戶端負責執行，訂閱提供連線資訊

Clash 生態系並非一個安裝檔就能適用所有裝置。用戶端是可操作的應用程式介面，核心則負責讀取設定、比對規則及轉送連線。mihomo 是這個生態系常見的核心；Clash.Meta 與其有演進關係，但舊版用戶端不一定支援新欄位。下載前先確認作業系統、處理器架構及用戶端維護狀態，再確認訂閱服務提供的設定格式。不能只因檔名含有 Clash，就認定各平台都能通用。

初次選用時建議先看看 Clash Plus；其他用戶端可依平台和使用習慣挑選。安裝應用程式本身不會自動提供可用節點。訂閱通常是含個人存取憑證的連結，會傳回節點、策略群組、規則等設定內容。取得連結後，先確認它是用戶端訂閱網址，而非帳戶登入頁或網頁分享連結。瀏覽器能開啟某個頁面，不代表用戶端能解析該網址。

記下系統環境與連線前提

先檢查裝置時間、可用儲存空間及基本網路。時間明顯不準可能影響加密連線驗證；若網路需要網頁認證，請先完成認證。由公司或學校管理的裝置可能限制安裝、VPN 或網路延伸功能，請勿透過停用管理政策來排除問題。處理器架構應以系統資訊為準，不能根據電腦外觀或手機品牌猜測。行動裝置也應確認目前是否有其他 VPN、封包擷取工具，或使用本機 VPN 通道的過濾應用程式正在執行。

建議先記下四項基準：目前能否正常直接連線、使用 Wi-Fi 或行動數據、是否已有手動代理，以及是否需要存取印表機或區域網路伺服器。啟用用戶端後若出現異常，就能判斷是原有網路問題，還是新設定造成的變化。不要一開始就同時啟用系統代理、TUN、自訂 DNS 和全域模式；先建立最簡單可用的連線，再逐項增加功能。

了解規則模式與設定檔的界線

規則模式會依設定檔中的規則逐項選擇出口，並非所有請求都會經過代理。全域模式會把通常受模式控制的連線交由全域策略處理，但仍不能取代系統層級的流量接管。直連模式則用於暫時略過代理出口。大多數初次安裝情境，建議先選規則模式，再到實際被規則引用的策略群組中選擇節點；只修改未被使用的群組，不會改變目前請求的出口。

YAML 是以縮排組織資料的文字格式。以下僅示範幾個常見欄位，並非含有節點的完整設定檔。合併時應放在現有設定的對應位置，同一層不可重複寫入相同鍵名，也不可用定位字元代替空格。若用戶端提供圖形介面開關，建議優先透過介面調整，避免介面產生的設定與手動編輯的檔案互相覆蓋。

mode: rule
log-level: info
allow-lan: false
ipv6: false

所有安裝入口都集中在下載頁。若要從舊用戶端移轉，請先閱讀停止維護後的設定備份與移轉流程，保留原有設定，並確認新用戶端可正常使用後，再移除舊應用程式。移轉期間一次只執行一個負責接管流量的用戶端，避免兩個程式爭用路由或代理連接埠。

Windows：從安裝到系統代理與 TUN

選擇安裝檔並完成首次啟動

前往Windows 下載區，先查看 Clash Plus，再依需求比較 Clash Verge Rev、FlClash 和 Clash Nyanpasu。Clash for Windows 已停止維護，僅供封存參考，不建議以舊用戶端建立新環境。進入「設定 → 系統 → 系統資訊」確認系統類型，再核對下載頁的適用說明。若未標示支援的架構，請勿將其他架構的安裝檔視為原生支援。

下載後先關閉舊代理用戶端，再執行安裝。一般安裝與需要系統管理員權限的服務安裝應分開看待：介面能啟動，不代表 TUN 所需的背景服務已就緒。出現安全性提示時，請檢查檔案來源及應用程式資訊；不要為了略過提示而全面關閉系統防護。若安裝遭組織政策阻擋，請聯絡裝置管理人員。安裝完成後先開啟介面，暫時不要設定開機啟動，方便判斷問題出在哪個步驟。

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

在設定或訂閱頁面選擇從 URL 匯入，輸入容易辨識的名稱，貼上完整訂閱網址後儲存。請移除複製時帶入的前後空格，但不要手動刪改查詢參數。等待下載及解析完成後，再明確選取這份設定。有些用戶端將「儲存訂閱」與「啟用設定」分成兩個步驟；即使清單新增了項目，也不代表核心已開始使用它。

前往策略群組頁面，選擇規則模式，並確認群組中確實有可選節點。若只剩 DIRECT 或群組清單為空，請先檢查訂閱格式與解析記錄，不要反覆啟用系統代理。節點測試成功後，再用瀏覽器造訪一個實際需要該出口的網站。測試結果只代表當下與測試網址的連線狀況，不能保證所有網站、通訊協定及登入流程都正常。

先啟用系統代理，有需要再開啟 TUN

系統代理適合用來先測試瀏覽器等常見應用程式。啟用用戶端開關後，系統代理位址通常會指向本機迴送位址，連接埠則以用戶端實際顯示為準。以下命令僅適用於用戶端混合連接埠確實為 7890 的情況，可用來明確指定代理並送出一次請求；不要為了照抄命令，將原本正常的連接埠強行改成此數值。

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

命令能連通但某個應用程式不通，表示應繼續檢查該應用程式是否遵循系統代理，或是否另有代理設定。TUN 透過虛擬網路介面接管流量，適合不讀取系統代理的程式。啟用時依用戶端提示安裝服務或授予權限，再檢查記錄中是否有介面或路由錯誤。不要把「以系統管理員身分執行整個介面」當成長期解決所有權限問題的方法。

排查連接埠、睡眠喚醒與退出後殘留

啟動時若提示連接埠遭占用，先檢查舊用戶端是否仍在系統匣或背景執行，也可檢查開發代理、容器工具等程式。不要任意結束不熟悉的系統處理程序。若必須更換連接埠，請一併核對用戶端、手動代理設定及終端機環境變數。系統代理與 WinHTTP 代理並非同一套設定，有些背景程式也可能完全使用自己的連線機制。

電腦從睡眠狀態恢復、切換 Wi-Fi 或連上公司 VPN，都可能改變路由與 DNS。先關閉再重新啟用用戶端的流量接管開關，觀察是否恢復；若每次都發生，請儲存相關時段的記錄。退出用戶端前先關閉系統代理；若程式異常結束，請到系統代理設定檢查是否殘留迴送位址。用戶端已關閉但瀏覽器仍指向本機連接埠時，所有頁面可能會突然無法開啟。

最後再設定開機啟動，並重新啟動一次，確認背景服務、設定選擇及策略群組都能恢復。若要使用「允許區域網路連線」，應同時了解監聽位址、防火牆輸入規則及驗證設定；只供本機使用時，保持關閉即可。其他個別問題可繼續查看常見問題，不必因單一應用程式異常就重裝整套環境。

macOS：釐清晶片架構與網路權限

下載對應架構並安裝應用程式

開啟「關於這台 Mac」，先確認是 Apple 晶片還是 Intel 處理器，再前往macOS 下載區選擇對應安裝檔。建議先查看 Clash Plus，也可比較 Clash Verge Rev、FlClash。ClashX Meta 已停止維護，可供了解舊環境參考，不建議作為新裝置的預設選擇。不同架構的程式即使能透過相容機制執行，也不代表其輔助服務和網路功能完全相同。

安裝磁碟映像檔中的應用程式時，依提示將它複製到「應用程式」資料夾，再從該位置啟動；不要長期直接從掛載的安裝映像檔執行。如此一來，應用程式更新、輔助程式路徑及登入項目會更容易保持一致。遇到系統安全性提示時，先確認下載來源及簽章資訊，再依系統允許的流程處理；不要直接執行網路上流傳的整機停用安全檢查命令。

匯入訂閱後，先進行最基本的連線測試

開啟用戶端的設定頁面，新增 URL 訂閱，儲存並等待解析完成。啟用設定後檢查策略群組是否完整，選擇規則模式及實際出口。若訂閱服務提供通用設定、mihomo 設定或其他用戶端格式，請選擇符合目前核心的入口。檔案能匯入，不代表所有擴充欄位都已生效，也要留意記錄中不支援欄位的提示。

首次測試先使用系統代理。macOS 代理設定會依網路服務而異，Wi-Fi 和有線網路可能各自有一筆設定。切換網路後，若用戶端顯示已啟用但瀏覽器沒有連線記錄，請到目前網路服務的代理設定確認。瀏覽器擴充功能、開發工具和終端機也可能有各自的代理來源，不能以單一應用程式的結果代表整台電腦。

網路延伸功能、輔助服務與 TUN 授權

需要使用 TUN 時，請依用戶端實際提示授權。不同實作可能使用特權輔助程式、系統網路延伸功能或其他機制，不要假設每個用戶端都會顯示完全相同的視窗。通常需在系統設定的隱私權、安全性或網路相關頁面確認授權。首次授權後應返回用戶端重新啟用功能，並檢查核心記錄；不能只因系統提示視窗已關閉，就認定流量接管成功。

若開關自動跳回關閉，請優先檢查輔助服務是否安裝成功、系統是否仍有待確認的授權，以及舊用戶端是否占用相同資源。反覆重裝卻保留舊服務和舊設定，通常無法解決問題。應先正常結束舊應用程式，再依其提供的方式停用服務；不要手動刪除不熟悉的系統目錄或網路裝置。

scutil --proxy
scutil --dns
route -n get default

這三個唯讀命令分別用來查看代理、DNS 和預設路由，可在啟用功能前後比較。輸出中出現某個解析器，不代表每次查詢都會使用它；系統也可能依網路介面、網域範圍及優先順序選擇解析路徑。提交輸出前請隱藏個人網路資訊。分析 DNS 時，應搭配用戶端記錄及實際存取的網域，不要只截取一行位址就下結論。

排查區域網路、睡眠與網路切換

啟用 TUN 後若印表機、檔案共享或本機開發服務異常，先判斷目標是迴送位址、私有位址，還是依賴區域網路探索的名稱。私有位址直連規則只能解決部分問題；多點傳播探索、鏈路本機網域名稱及虛擬機網路可能需要用戶端專用的排除設定。不要任意將整個區域網路網段導向外部代理，也不要為了連印表機而永久切換到全域模式。

闔上筆電進入睡眠後重新連上網路，連線工作階段可能已失效。先等網路恢復，再重新建立用戶端通道；若 DNS 一直使用舊網路的結果，可停止再啟動流量接管功能，觀察是否改善。切換手機熱點、公司網路與家用網路時，尤其要留意認證頁及其他 VPN。請先確認基本網路可用，再檢查代理，避免將上游網路中斷誤判為設定損毀。

移轉到另一台 Mac 時，建議重新匯入訂閱，再還原必要的覆寫和規則。不要一併照搬輔助服務、絕對路徑及舊電腦的網路介面名稱。完成瀏覽器、終端機及常用應用程式的實際測試後，再開啟登入時啟動，並確認結束應用程式時系統代理能正常還原。

Android：VpnService 授權與背景常駐

安裝前確認架構與舊應用程式

前往Android 下載區優先查看 Clash Plus，也可依需求選擇 Clash Meta for Android、FlClash 或 Surfboard。各用戶端支援的設定格式並不完全相同，尤其 Surfboard 不能預設可原樣匯入任意 mihomo YAML。請先查看訂閱服務的格式說明，再選擇用戶端。架構應以系統實際支援為準；裝置採用 64 位元處理器，也不代表系統只能執行 64 位元應用程式。

安裝從外部下載的應用程式時，系統可能要求允許目前使用的瀏覽器或檔案管理員安裝應用程式。只對本次使用的來源授予必要權限，完成後即可關閉該來源的安裝授權。更新時若提示簽章不一致，不要立刻解除安裝舊版；先匯出訂閱與覆寫，確認新舊安裝檔是否來自相同維護管道。直接解除安裝通常也會清除用戶端儲存在應用程式私人目錄中的資料。

完成訂閱匯入與系統 VPN 授權

進入設定頁面，從 URL 新增訂閱，儲存後等待下載完成，再選取它作為目前設定。切換到策略群組，確認有節點可用並選擇規則模式。首次啟動連線時，Android 會顯示 VPN 連線要求。VpnService 是系統提供的介面，用戶端透過它建立本機虛擬通道來接收流量；出現 VPN 圖示，不代表流量一定經過某台遠端伺服器。

授權前先核對彈出視窗中的應用程式名稱。拒絕授權後，用戶端可能仍會顯示設定和節點清單，但無法接管其他應用程式的流量；再次啟動連線即可重新觸發授權。若系統始終沒有顯示提示，請檢查是否已有其他 VPN、工作資料夾中的 VPN，或裝置管理限制。Android 通常不允許兩個一般應用程式同時占用同一使用者空間的 VPN 通道。

規則、依應用程式分流與一律開啟 VPN

先維持規則模式並用瀏覽器測試，再調整依應用程式分流。這項功能可能採用「僅包含所選應用程式」或「排除所選應用程式」兩種相反邏輯，勾選前請先看清楚說明。被排除的應用程式可能不會進入核心記錄，不能只靠更換節點讓它恢復代理。若支付、區域網路裝置控制或工作應用程式異常，請逐一測試，不要一次排除大量應用程式。

系統 VPN 設定中的「一律開啟 VPN」用來維持指定 VPN 應用程式的系統連線；「封鎖未使用 VPN 的連線」則可能在通道尚未建立時阻止網路連線。兩者並非同一功能。請先確認用戶端在重新啟動及切換網路後都能恢復，再考慮啟用封鎖選項。否則訂閱過期、應用程式遭限制或啟動失敗時，整支手機可能暫時無法連網。

鎖定螢幕後斷線，先檢查電池限制

若鎖定螢幕後連線中斷、亮起螢幕又恢復，請優先檢查應用程式的電池設定。將用戶端設為允許背景活動，或不受電池最佳化限制；部分廠牌還需要允許自動啟動，並在背景工作管理中保留應用程式。不同系統的選項名稱可能不同，重點是讓 VPN 服務在螢幕鎖定後持續執行。通知權限及持續執行通知也應依用戶端說明設定，但只開啟通知不能取代電池白名單。

不要只在螢幕亮起時測速一次，就認定問題已修復。先連線並鎖定螢幕一段時間，再解鎖查看用戶端服務狀態及中斷時間；接著分別測試 Wi-Fi 與行動數據。數據節省模式、背景數據限制及廠牌省電模式都可能影響結果。具體設定路徑可參考VpnService 授權與省電白名單設定要點逐項確認。

DNS、熱點分享與跨用戶端移轉

Android 的私人 DNS、瀏覽器安全 DNS，以及用戶端內的 DNS 設定可能同時生效。遇到網域解析失敗時，先記下各層設定，再一次只修改一處進行測試。不要看到 DNS 字樣就全部關閉；應先判斷請求由哪個應用程式發出、是否進入 VPN，最後使用哪個解析器。節點位址本身也需要解析；若節點伺服器網域無法解析，後續規則再正確也無法建立連線。

手機開啟熱點，不代表連上熱點的裝置會自動共用手機應用程式的 VPN 路徑。各系統的轉送機制及權限限制不同，不應把「允許區域網路連線」理解為一鍵代理熱點。移轉用戶端時，也要重新檢查依應用程式分流清單、省電設定及 VPN 授權；這些通常無法隨 YAML 檔案一起移轉。最後完成鎖定螢幕、重新啟動及切換網路三種測試，再停用或移除舊用戶端。

iOS：從 App Store 安裝、設定相容性與 VPN 連線

從 App Store 安裝 Clash Plus

iOS 建議優先使用 Clash Plus，可從iOS 下載區前往，也可直接開啟Clash Plus 的 App Store 頁面。產品官方網站為 clashplus.io。安裝前請查看 App Store 列出的系統相容需求，並以裝置實際系統版本及商店資訊為準，不要直接將桌面用戶端的功能清單套用到手機。

首次開啟應用程式後，先找到設定匯入及連線頁面，暫時不要修改大量進階選項。iOS 應用程式通常透過系統提供的網路延伸功能建立 VPN 通道；系統授權與訂閱內容是兩回事：允許建立通道不代表已取得節點，成功匯入訂閱也不代表系統已允許應用程式接管網路。這兩個步驟都必須分別完成並確認。

匯入時確認格式，別只看連結名稱

在用戶端支援的匯入入口貼上訂閱網址，確認儲存後選取對應設定。若應用程式支援匯入檔案，也應確認檔案類型與欄位範圍。Clash 生態系的設定並非各種實作都完全一致，核心擴充功能、規則提供者、本機檔案路徑及指令碼功能都可能有所差異。桌面上能載入的 YAML，在手機上可能需要調整，或改用訂閱服務提供的相容入口。

匯入失敗時，先確認錯誤是下載失敗還是解析失敗。下載失敗應檢查連結是否有效、網路是否需要認證，以及網址是否在複製時被截斷；解析失敗則檢查回傳內容是否為設定檔，是否混入登入頁面或錯誤訊息。不要將完整訂閱網址貼到公開問答區。需要求助時，保留錯誤類型與欄位名稱，隱藏連結參數、節點密碼及個人帳戶識別資訊。

允許新增 VPN 設定並選擇出口

首次啟動連線時，系統可能要求允許新增 VPN 設定，並透過裝置密碼或生物辨識確認。完成後返回應用程式查看連線狀態，再確認系統 VPN 記錄是否對應目前的應用程式。應用程式建立的 VPN 設定與裝置管理描述檔並非同一概念；日常匯入訂閱不應因此變成安裝來源不明的管理描述檔，也不需要為了一般代理連線授予整部裝置的管理權限。

在應用程式支援的範圍內，先選擇規則模式，再到實際使用的策略群組中選擇節點。若頁面能開啟但指定應用程式無法連線，先檢查是否有分流差異，不要立即切換所有網路選項。iOS 上某些應用程式會維持既有連線；變更策略後，可能需要重新開啟應用程式或重新建立連線，才能使用新的出口。測試時也要分辨快取頁面與實際送出的新請求。

需另外測試鎖定螢幕與網路切換

iOS 的 VPN 網路延伸功能與應用程式前景介面的生命週期不同，不能照搬 Android 的背景鎖定方式。不要反覆從多工畫面滑掉應用程式來測試背景執行；應正常返回主畫面，鎖定螢幕後觀察重新連網的情況。低耗電模式、網路切換及系統資源狀態都可能影響連線恢復；判斷時應看是否需要重新連線，而不只是確認應用程式是否仍顯示在多工畫面。

Wi-Fi 切換到行動數據時，原有連線可能失效並重新建立。若只有特定 Wi-Fi 無法連線，先檢查該網路的認證頁面及存取限制。若同時啟用了其他 VPN、裝置管理政策或系統隱私相關網路功能，請先記錄目前狀態，再逐項停用以確認是否衝突。不要將每個異常都歸咎於節點，也不要同時重置所有系統網路設定，以免失去比對依據。

更新訂閱與移轉時，保留可還原的做法

更新訂閱前，先保留現有本機規則或用戶端支援的設定備份；更新後確認策略群組名稱及選擇沒有變動。節點遭刪除或群組名稱變更時，原有選擇可能失效。手機與電腦共用同一訂閱，也必須遵守訂閱服務的裝置數量及同時連線規範；能匯入同一個連結，不代表可以讓不限數量的裝置同時連線。

更換手機後，建議重新安裝應用程式、重新匯入訂閱並完成授權，不要假設系統備份會完整還原 VPN 狀態。完成瀏覽器、常用應用程式、鎖定螢幕及行動數據測試後，再清除舊裝置上的設定。若要確認各用戶端的差異，可參考手機版 Clash 用戶端比較，確認支援範圍，避免將其他應用程式的操作步驟當成目前介面的固定路徑。

Linux：桌面代理與獨立核心部署

先分清桌面用戶端與伺服器核心

Linux 下載區提供 Clash Verge Rev、FlClash 等圖形介面用戶端，適合桌面環境；獨立 mihomo 核心則適合伺服器、路由器，或需要自行管理服務的情境。請先確認發行版、套件格式及處理器架構，再選擇安裝檔。Debian 系與使用 RPM 套件管理的發行版，不能只因副檔名相似就混用；桌面元件的相依套件也可能不同。

桌面使用者建議透過套件管理員安裝對應用戶端，方便管理相依套件及解除安裝。啟動後從設定介面匯入 URL 訂閱，啟用後檢查策略群組與規則模式。不要為了繞過權限問題，長期以管理員帳戶執行整個圖形介面應用程式。TUN 所需的特權服務應依用戶端文件安裝，介面權限與網路介面權限須分開處理。

系統代理與終端機環境需分別設定

GNOME、KDE 等桌面環境都有各自的網路代理設定入口，但不是所有應用程式都會讀取這些設定。命令列程式常使用環境變數或獨立設定檔，容器內的程式則有自己的網路空間。用戶端已啟用系統代理，但終端機仍直接連線，是常見情況，不一定代表核心異常。請先透過明確指定代理的請求驗證監聽連接埠，再檢查特定程式的代理設定。

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

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890
export no_proxy=localhost,127.0.0.1,::1

unset http_proxy https_proxy no_proxy

以上範例假設混合連接埠為 7890，實際使用時請以目前設定為準。環境變數只影響繼承它的處理程序，已執行的程式不會自動變更；不同工具對變數大小寫的支援也可能不同。此處僅在目前 shell 暫時設定，確認有效後再決定是否寫入登入設定。不要將代理變數直接寫入全系統設定，以免用戶端未啟動時所有維護命令都無法連網。

獨立核心先以前景模式測試，再交由服務管理

獨立部署前，先準備可執行檔及完整設定，並放在權限明確的目錄。以下假設程式安裝於 /usr/local/bin/mihomo，設定檔位於 /etc/mihomo/config.yaml。先執行語法檢查，再以前景模式啟動，觀察訂閱引用、本機規則檔及監聽連接埠是否正常。語法檢查通過只代表設定可解析，不保證節點可連線或路由正確。

/usr/local/bin/mihomo -t -d /etc/mihomo -f /etc/mihomo/config.yaml
/usr/local/bin/mihomo -d /etc/mihomo -f /etc/mihomo/config.yaml

以前景模式確認運作正常後，再依發行版選用服務管理器。systemd 服務需明確設定程式路徑、設定目錄、執行身分、重新啟動策略及記錄檢視方式。一般本機代理可採用最低必要權限執行；TUN 涉及建立網路介面及修改路由，需另外規劃權限。不要直接複製來源不明的服務檔，也不要將訂閱憑證寫入其他使用者可讀取的啟動參數。

TUN、DNS 與容器網路的界線

啟用 TUN 前，先確認系統提供 TUN 裝置，且服務帳戶具備必要權限。自動路由可能與其他 VPN、策略路由、容器橋接網路或遠端管理路徑衝突。操作遠端伺服器時尤其要保留復原方式；先確認新的路由不會中斷目前的 SSH 管理連線，再考慮持久化設定。不要在唯一的遠端工作階段中直接測試全流量接管，並立即重新啟動服務。

DNS 通常由 NetworkManager、systemd-resolved 或其他元件管理。不要假設 /etc/resolv.conf 一定是可永久手動編輯的一般檔案；它可能是連結，也可能由服務產生。請先確認現有的管理流程，再決定用戶端如何接收查詢、上游解析會經過哪裡，以及節點伺服器網域如何解析。容器中的迴送位址指向容器本身，不會自動指向主機代理。

更新核心前先備份目前的程式及設定；更新後先執行測試命令，再重新啟動服務並查看啟動記錄。遇到欄位相容性問題時，請參考Clash、Meta 與 mihomo 核心差異，不要直接刪除所有報錯欄位。確認本機請求、DNS、遠端管理及重新啟動後的恢復狀況都正常，才算完成部署。

設定常見問題：依連線流程排查，別反覆重裝

如何區分訂閱下載失敗與設定解析失敗

先確認錯誤發生在哪一層。連線逾時、網域無法解析或伺服器拒絕請求，屬於取得訂閱時的問題；出現縮排、欄位型別或引用不存在項目的錯誤，才是設定解析問題。訂閱網址若回傳網頁，用戶端可能會把網頁內容當成 YAML 解析，錯誤位置往往沒有參考價值。請先確認連結有效且回傳預期格式，不要只看第一行錯誤就修改縮排。

更新後突然失敗時，請保留上一份可用設定，並比較變更範圍。訂閱中的群組名稱、規則提供者或通訊協定欄位可能已經調整，舊版核心未必支援。透過用戶端的設定測試及記錄確認後，再決定更新用戶端或改用相容訂閱。第三方線上轉換服務可能會取得訂閱內容，使用前請了解資料外洩風險；不要為了解決一次匯入錯誤，就把私人連結交給不明服務。

節點測試成功，網頁卻無法開啟

依「應用程式 → 流量接管 → 規則 → 策略群組 → 節點 → 目標網站」的順序檢查。用戶端沒有對應連線記錄，優先檢查系統代理、VPN 授權及應用程式排除設定；有記錄但使用 DIRECT，檢查規則比對結果；命中預期群組卻選錯節點，檢查群組內的選擇；出口正確仍失敗，再檢查 DNS、交握或目標服務限制。每次只變更一項條件，才能判斷哪個步驟改善了結果。

全域模式可短暫用來判斷是否為規則問題，但不適合作為所有故障的最終解法。測試後請恢復原模式。節點延遲是特定測試請求的結果，會受測試網址、逾時設定及網路狀況影響，不能直接視為下載速度排名。連續測速也可能增加手機耗電。若要使用自動選擇策略，請先了解 url-test、fallback 與 load-balance 的差異，再參考策略群組設定詳解進行設定。

為什麼自訂規則沒有生效？

規則通常會由上往下比對，具體規則應放在範圍較廣的兜底規則之前。策略名稱必須與現有策略群組完全一致，也要留意名稱中的空格及大小寫。以下是用來說明順序的局部範例：私有位址直連、指定網域直連，最後才交由「手動選擇」；該策略群組必須已存在，不能只複製規則而未定義引用對象。

rules:
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - DOMAIN-SUFFIX,example.com,DIRECT
  - MATCH,手動選擇

若用戶端使用訂閱覆寫、規則前置或合併設定，應編輯可持續保留的覆寫入口，而非只修改下載快取，否則更新訂閱時修改會被覆蓋。規則看似正確卻沒有命中時，也要確認請求實際使用的是網域還是 IP、連線是否早在修改前就已建立，以及用戶端顯示的是來源檔案還是最終執行設定。比對最終設定，比反覆重新整理訂閱更有效。

DNS 失敗、IPv6 與區域網路問題

DNS 是將網域名稱轉換為位址的過程，解析成功後仍可能無法連線。先區分節點伺服器網域與目標網站網域；前者解析失敗會導致整個代理出口無法建立。使用 Fake-IP 時，用戶端可能會提供供內部映射使用的位址，這不一定是錯誤，但相關連線必須繼續進入同一套處理流程。若遇到相容性異常，應先了解設定，再排除特定網域，而非任意更換整段位址範圍。

IPv6 也需要檢查整條連線路徑：系統是否取得位址、DNS 是否回傳對應記錄、用戶端是否接管，以及節點是否支援該出口。關閉某個選項只適合用來縮小問題範圍，不能據此認定所有網路都應停用 IPv6。區域網路異常時，先核對路由及直連規則，再檢查探索協定和名稱解析。不要把代理錯誤、憑證錯誤及區域網路探索失敗混為同一種「連不上」。

備份、還原與求助時應提供的資訊

可靠的備份應包含訂閱來源、本機覆寫、必要的規則檔及用戶端設定說明，並另外保護敏感資料。還原時先恢復最近一次可用狀態，再重現單一變更，不要同時更換用戶端、訂閱和 DNS。尋求協助時，請提供作業系統、用戶端名稱、流量接管方式、錯誤發生步驟及去識別化記錄；只需暫時提高記錄詳細程度，找出問題後即恢復一般等級，避免長期記錄不必要的瀏覽資訊。

若已將問題定位到單一設定，請繼續查看常見問題；忘記術語意思時，請查閱術語手冊；想重新依序建立可用連線，則返回快速入門教學。本手冊的使用原則是先保留可用狀態，再逐層驗證。只要能確認請求停在哪一層，就不必靠反覆解除安裝再安裝來代替排查。