V2Ray 全平台安裝與設定

準備工作：平台、訂閱與設定層級

先分清用戶端、核心與伺服器參數

v2rayN、v2rayNG 和 v2flyNG 是設定與執行的入口。用戶端負責儲存伺服器資料、產生核心設定、顯示記錄，並依平台提供系統代理或 VPN 連線。Xray、V2Fly 則是負責執行連線與路由的核心系列。安裝用戶端不代表已有可用的伺服器；伺服器位址、連接埠、驗證資訊、傳輸方式與 TLS 參數，仍須由實際服務提供者提供。不能只憑協定名稱推測這些欄位，也不要把網路上其他設定的驗證資訊拼接到現有位址。

一次連線至少會經過應用程式、本機入口、核心路由與遠端伺服器等環節。應用程式若未將要求送至本機入口，修改遠端協定也無濟於事；核心根本沒有啟動時，反覆更換瀏覽器同樣無法解決問題。準備階段先建立這些層級的概念，之後每次測試只變更一個環節。建議記下原有系統代理設定、是否有其他 VPN、目前的網路類型及用戶端儲存目錄，避免測試後無法還原原本的網路設定。

確認處理器與安裝檔類型

開啟用戶端下載頁面後，先選擇作業系統，再選處理器與套件格式。Windows 的 Desktop 與 WPF 是介面版本，不是兩種代理協定；macOS 須區分 Apple Silicon 與 Intel；Linux 涉及處理器架構與發行版套件格式；Android 通常優先選 arm64，不確定是否相容時再查看通用版。副檔名相同不代表架構相同，裝置能下載檔案也不代表能執行檔案。

準備可辨識的訂閱資料與還原備份

訂閱通常是用來取得一組伺服器設定的網址，不是管理後台網址，也不是方案購買頁面。只有服務提供者明確指出可供用戶端匯入的連結，才應填入訂閱群組。本文統一以 https://example.com/sub?token=xxxx 示範網址格式；這個網址不提供實際服務。真實訂閱網址可能包含存取憑證，擷取畫面、分享記錄或請人協助時，應遮蔽完整查詢參數、使用者識別資訊與伺服器驗證欄位。

準備一份只有自己能存取的設定備份，並確認裝置的日期、時間與時區正確。TLS 憑證驗證仰賴系統時間；時間明顯錯誤時，多筆原本可用的設定可能同時失敗。初次測試不要同時啟用系統代理、TUN 和其他 VPN；先選擇單一連線方式，確認可用後再按應用程式需求擴充。公司或校園裝置也應先確認管理政策是否允許變更網路設定，不要以重複授權取代對權限來源的確認。

最後準備兩種測試目標：一個原本就能連線的頁面，用來確認直連是否受影響；另一個明確需要透過目前代理設定連線的目標，用來確認代理鏈路。記錄測試結果時，請寫明目標、時間與連線方式，不要只記下「網路不通」。若只想完成第一次連線，可先閱讀快速入門步驟；本手冊保留安裝、權限與還原等內容，方便按問題查閱。

Windows：v2rayN 安裝與代理連線

選擇 Desktop 或 WPF 並完成安裝

前往Windows 下載頁面，v2rayN 提供 Desktop 桌面版與經典 WPF 版。Desktop 採用跨平台介面，WPF 保留經典 Windows 操作配置；伺服器參數不會因介面不同而自動變成另一種協定。初次安裝選一種版本即可，不要同時執行兩種版本，以免爭用本機連接埠。若需要比較介面，請先結束正在執行的程式，再開啟另一個版本，並分別保留設定備份。

依安裝程式的提示完成安裝後，從正常的應用程式入口啟動。若使用可直接執行的資料夾版本，請先完整解壓縮至自己有寫入權限的位置，不要在壓縮檔預覽視窗中執行，也不要只複製主程式而漏掉隨附檔案。程式目錄、使用者設定目錄與記錄目錄的位置可能因安裝方式而異，請優先透過用戶端的開啟目錄功能確認。若啟動時提示缺少執行環境，請依提示核對所需的 .NET 桌面執行階段、架構與介面版本，不要用名稱相似的其他執行環境代替。

匯入訂閱並選擇目前使用的伺服器

開啟「訂閱群組」，新增群組並填入容易辨識的名稱，將訂閱網址填入網址欄位，儲存後更新該群組的訂閱。更新完成只代表已成功取得設定，還需要在主畫面選擇要使用的伺服器並設為目前使用項目。若已有多個訂閱群組，請先確認目前清單屬於哪個群組，避免在錯誤的群組中反覆更新。匯入分享連結時，請使用對應的剪貼簿匯入功能，不要把完整的協定分享連結填入伺服器位址欄。

初次執行時先保留預設的本機監聽位址，並查看用戶端顯示的實際入口連接埠。本文以 10808 作為本機連接埠範例；實際使用時請以設定與記錄為準，並確認入口採用的協定。HTTP、SOCKS 或混合入口不能只靠連接埠號碼判斷。除非確實需要讓區域網路中的其他裝置使用，否則不要將監聽位址改成所有網路介面；擴大監聽範圍會增加本機防火牆與存取權限方面的問題。

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

在「系統代理」中選擇「自動設定系統代理」，接著使用會讀取 Windows 系統代理的瀏覽器前往測試目標。「清除系統代理」會撤銷用戶端設定的系統代理；「不變更系統代理」代表啟動或切換時不主動修改現有設定，不等於清除過去的代理設定。若瀏覽器安裝了獨立代理擴充功能，請先暫停其規則接管，避免系統設定與擴充功能設定互相覆蓋。由企業政策管理的瀏覽器，也要查看是否有組織鎖定的代理項目。

只有在確實需要接管不讀取系統代理的應用程式時，才考慮使用 TUN。啟用前先關閉其他虛擬網路介面接管工具，記錄目前網路狀態，並依用戶端提示授予必要權限。TUN 涉及虛擬介面、路由與 DNS；連線失敗時，應先退回已驗證可用的系統代理模式，不要不斷更換伺服器。是否需要提升權限取決於目前的實作與執行方式，不應為了更新一般訂閱而長期以系統管理員身分執行整個用戶端。

常見的平台問題包括目錄無法寫入、連接埠已被使用、啟動後只剩系統匣圖示，以及執行環境不相容。先確認工作列通知區域是否已有程式執行，再查看記錄中的監聽失敗或權限錯誤。若安全軟體記錄了攔截事件，請核對具體檔案與來源，不要直接關閉整套防護。更完整的啟動問題排查請參閱v2rayN 無法開啟或啟動時閃退的排查方式；還原網路設定與處理閃退是兩件事，應分別確認。

macOS：晶片選擇、安裝授權與網路設定

依晶片類型選擇 v2rayN 安裝檔

在系統選單中開啟「關於這台 Mac」，查看晶片或處理器資訊。顯示 Apple 晶片的裝置請選 Apple Silicon 對應版本；顯示 Intel 處理器的裝置請選 Intel 對應版本，再前往macOS 下載頁面取得 v2rayN。不要依電腦外觀或購買年份推測架構，也不要將另一種架構能否透過相容層執行，當作預設安裝方案。正確選擇符合裝置架構的版本，可減少執行環境與權限判斷上的額外變因。

開啟磁碟映像檔後，依照其中的安裝說明將應用程式移至「應用程式」，然後從已安裝的位置啟動。不要長期直接從掛載的映像檔執行；更新或卸載映像檔時，路徑可能會改變。系統若提示應用程式來源或啟動受到限制，請先確認下載來源與檔案類型，再前往「系統設定 → 隱私權與安全性」查看是否有該應用程式的處理選項。只處理這次明確辨識的應用程式，不要為了啟動用戶端而全面關閉系統安全檢查。

匯入設定並確認目前連線

進入 v2rayN 的「訂閱群組」，新增名稱與訂閱網址，儲存後更新該群組。若訂閱讀取成功但連線仍失敗，先確認主畫面已選擇一筆設定，並核對目前核心是否支援其協定與傳輸參數。不要把「訂閱更新成功」當成「每台伺服器都已測試成功」。若介面顯示多筆名稱相似的項目，可查看所屬群組與伺服器位址加以區分，避免將已失效的手動匯入項目誤認為剛更新的項目。

初次測試建議關閉 TUN，只使用系統代理。用戶端設定系統代理後，可在「系統設定 → 網路」中選取目前使用的連線，進入詳細資訊查看代理項目；有線網路、無線網路與其他服務可能各自有獨立設定。切換網路後若行為不同，請確認目前生效的是哪個網路服務，不要只看用戶端按鈕是否仍顯示為啟用。自動代理設定、手動 HTTP 代理與 SOCKS 代理也不應在來源不明的情況下疊加保留。

區分圖形應用程式、終端機與 TUN 的權限

有些圖形應用程式會讀取系統代理，有些則使用自己的網路堆疊或代理設定。終端機程式也不一定會繼承圖形介面的系統代理，因此瀏覽器可以連線、終端機卻不行的情況並不少見。若要讓特定指令使用本機代理，請依該指令支援的入口協定另行設定，並先確認監聽連接埠確實存在。不要一開始就將終端機變數永久寫入啟動檔，否則結束用戶端後，新開的終端機仍可能嘗試連線至已關閉的本機入口。

TUN 是否需要額外授權、輔助元件或提升權限，取決於目前用戶端的實作方式。依介面提示完成必要授權後，請查看記錄，確認虛擬介面與路由是否已建立；應用程式有啟動權限，不代表它已獲准變更網路路徑。啟用 TUN 後若原本可直連的頁面無法開啟，請先停用 TUN，再檢查 DNS 與網路服務順序。不要同時執行另一套 VPN 來補救，兩套接管機制可能使路由繞回本機，掩蓋最初的問題。

更新前先結束應用程式並備份設定，避免新舊版本分別存在於不同目錄。更新後若設定看似消失，先確認啟動的是「應用程式」中的版本，還是下載目錄裡的舊版本，再確認目前使用者設定的位置。解除安裝或停止使用前，請先在用戶端清除系統代理、停用 TUN，然後檢查目前網路服務的代理項目。只將應用程式移至垃圾桶，無法可靠地撤銷所有既有網路設定；請在刪除程式前完成還原步驟。

Linux：套件格式、桌面代理與 TUN 權限

確認發行版、架構與圖形工作階段

Linux 安裝時，先確認套件管理系統與處理器架構。Debian、Ubuntu 等發行版通常使用 deb 套件，Fedora 等通常使用 rpm 套件；實際情況仍應以發行版的套件管理文件為準。開啟Linux 下載頁面後，分別選擇 x64 或 arm64。不要只因系統能辨識某個壓縮檔，就認定該安裝套件可用。v2rayN 是圖形介面用戶端，純終端機伺服器或沒有桌面工作階段的環境，不適用於本頁的圖形介面安裝流程。

安裝前可用以下唯讀指令查看架構與系統識別資訊。x86_64 通常對應下載頁面的 x64，aarch64 通常對應 arm64；若顯示其他架構，不要勉強套用這兩種套件。系統識別資訊可用來判斷發行版系列，但不能保證所有桌面相依套件都已安裝。請透過發行版的軟體安裝程式或套件管理器開啟實際下載的套件，並仔細處理相依性提示，不要將強制忽略相依性當作通用安裝方式。

uname -m
cat /etc/os-release

以一般使用者啟動並匯入訂閱

安裝完成後，從桌面應用程式清單啟動 v2rayN。先以一般使用者身分執行，確認介面、設定儲存與記錄輸出正常，再處理需要權限的網路功能。不要只為了解決單一目錄權限錯誤，就以 root 身分執行整個圖形應用程式；這可能產生擁有者錯誤的設定檔，導致下次以一般使用者啟動時無法寫入。若曾誤以提升權限的方式啟動，請先找出實際設定目錄並檢查擁有者，不要對整個家目錄遞迴放寬權限。

在「訂閱群組」填入網址並更新，選擇目前使用的伺服器後查看核心記錄，確認本機入口已成功監聽。Linux 桌面環境與網路管理器的組合很多，用戶端的「自動設定系統代理」不一定會影響所有應用程式。請在桌面環境的網路代理設定中確認位址與連接埠，再使用確定會讀取該設定的應用程式測試。若瀏覽器有獨立代理設定，請先統一入口，避免桌面設定已變更、瀏覽器卻仍固定使用另一條路徑。

依入口協定測試，不要猜測連接埠

終端機程式通常適合明確指定代理。以下指令僅用於測試已確認為 SOCKS 入口的本機連接埠；範例中的 10808 必須替換為介面顯示的實際連接埠。socks5h 表示由代理端解析目標網域；使用一般的 socks5 時，解析位置可能不同。指令有回應只能證明這次要求經過該入口，不能證明整個桌面環境或所有協定流量都已被接管。

curl --proxy socks5h://127.0.0.1:10808 --head https://example.com

TUN 也涉及虛擬裝置、系統路由與權限。啟用後先查看記錄，確認能否建立介面，再確認預設路由與 DNS 是否依預期調整；若錯誤發生在建立裝置之前，更換訂閱並無幫助。不同發行版可能透過系統服務、授權機制或用戶端提供的方式取得權限，請依照目前軟體的說明操作。不要隨意替來源不明的檔案新增系統功能權限，也不要將所有網路問題都歸咎於防火牆後直接關閉規則。

若休眠、切換網路或異常結束後無法連線，請先停用 TUN，還原桌面代理設定，再檢查網路管理器管理的連線與 DNS。安裝更新時保留設定備份並結束舊程序，避免兩個核心爭用連接埠。手動執行穩定後再啟用自動啟動，並區分「啟動圖形用戶端」與「建立系統層級網路接管」。若要進一步判斷終端機與瀏覽器的差異，可參閱系統代理未生效的分流排查方式。

Android：用戶端安裝與 VPN 接管

優先選用 v2rayNG，視需求改用 v2flyNG

前往Android 下載頁面，優先查看使用 Xray 核心的 v2rayNG；需要 V2Fly 核心生態時，再考慮 v2flyNG。兩款應用都應依裝置選擇 arm64 或通用版。較新的主流裝置通常採用 arm64，但最後仍應以裝置架構與應用程式相容性為準。通用版只是架構選擇上的替代方案，不代表同一筆伺服器設定會因此支援另一種協定，也不表示安裝失敗都能靠改用通用版解決。

開啟下載的安裝檔後，系統可能要求允許目前的檔案管理員或瀏覽器安裝應用程式。只對這次安裝確實會用到的來源授予權限，安裝完成後可依裝置設定撤銷。若系統提示無法剖析、簽章不一致或無法覆蓋安裝，請先確認檔案已下載完成、應用程式架構與現有應用程式的來源。不要立即解除安裝舊應用程式；請先匯出可還原的設定，再判斷是安裝檔不相容，還是不同來源造成簽章衝突。

新增訂閱、更新群組並選擇伺服器

開啟應用程式，在「訂閱群組設定」或相應的訂閱管理入口新增群組，填入名稱與網址，儲存後返回主畫面並更新訂閱。若介面提供多種更新方式，先使用一般更新流程；若必須透過現有連線取得訂閱，請先確認目前連線可存取訂閱網址。不要在清單尚未更新完成時連續重複點選，否則難以判斷最新一次操作的結果。伺服器項目出現後，仍須手動選擇目前要使用的項目。

掃描條碼與從剪貼簿匯入適合單筆分享連結；訂閱網址則適合持續更新一組設定。兩種方式可以並存，但必須清楚每筆設定的來源，避免把一次性匯入項目當成會由訂閱自動維護的項目。若傳輸方式、TLS 或伺服器名稱欄位缺漏，請先查看原始資料，不要依照另一筆看似相似的設定自行補填。Android 應用程式之間的剪貼簿與檔案存取權限也可能受到系統限制，匯入失敗時請確認實際讀取到的內容。

了解系統 VPN 提示與個別應用程式範圍

點選啟動後，Android 會顯示 VPN 連線授權提示。此授權允許應用程式透過系統 VPN 介面接管選定範圍的流量，不代表遠端伺服器已連線。v2rayNG 常見的 VPN 模式會透過虛擬網路介面處理流量，不能直接套用桌面系統代理開關的判斷方式。若應用程式也提供僅代理模式，請確認目前模式是否已建立 VPN；只啟用本機監聽，不會自動讓其他應用程式改用該入口。

一般裝置同一時間只能有一個作用中的 VPN 接管者。其他 VPN、工作資料夾中的網路元件，或某些本機過濾工具，可能與目前連線衝突。先關閉其他流量接管來源，再重新授權。使用個別應用程式代理時，請分清「所選應用程式透過代理連線」與「所選應用程式略過代理」這兩種相反設定，儲存後依介面要求重新建立連線。測試時請指定一個應用程式，不要只根據狀態列圖示就認定所有應用程式都已納入接管範圍。

若應用程式在前景正常、鎖定螢幕後卻反覆中斷，可在系統電池設定中檢查該應用程式的背景執行限制，並依裝置廠商提供的設定允許必要的背景活動。設定「一律開啟 VPN」或「封鎖未使用 VPN 的連線」前，請先確認斷線時的行為符合預期；後者可能在用戶端停止時直接封鎖網路。停止使用前先關閉應用程式內的連線，再檢查系統 VPN 設定是否仍要求持續接管。行動數據與 Wi-Fi 的 DNS、IPv6 和驗證條件可能不同，應分別測試，不要以單次測試概括所有網路。

訂閱管理、核心選擇與設定搬移

分開管理訂閱更新與手動修改

訂閱是設定集合的來源，不代表網路連線已建立。更新時，用戶端會取得內容並解析成伺服器項目；建立連線時，核心才會依目前選取項目的參數連線至遠端。因此，訂閱網址無法存取、訂閱內容無法解析，以及個別伺服器連線逾時，應分成三類問題處理。先查看更新記錄中的網路與解析結果，再確認項目是否出現，最後測試目前使用的連線。訂閱解析失敗時不要修改路由規則，也不要以更新成功取代連線測試。

建議依來源或用途建立群組，不要把所有網址都放進名稱含糊的同一組。自動更新可能會取代訂閱產生的伺服器項目；手動調整前，請先確認用戶端是否會保留修改。需要長期固定使用的設定可另建手動項目，並記下它不會再隨原訂閱自動更新。服務提供者更換網址或驗證資訊後，應更新來源網址，不要只是不斷用舊項目重新連線。刪除群組前，也請確認其中是否包含尚未備份的手動項目。

安全使用範例與敏感欄位

以下網址僅用來示範常見的訂閱格式。真實網址的路徑與查詢參數由服務提供者決定，不能照著範例自行猜測。訂閱可能回傳經編碼的多筆分享連結，也可能回傳用戶端可辨識的其他格式；檔案能在瀏覽器中顯示文字，不代表適用於目前的匯入入口。收到完整的核心 JSON 設定時，應尋找用戶端的自訂設定匯入功能，不要將 JSON 貼到訂閱網址欄位。

https://example.com/sub?token=xxxx

分享問題截圖時，至少遮蔽訂閱查詢參數、驗證識別資訊、密碼與私人伺服器資料。匯出完整用戶端設定可能同時包含訂閱、手動項目、本機監聽設定與路由，不應當作一般診斷資料公開傳送。通常只需提供錯誤片段、協定與傳輸類型、平台、連線模式及重現步驟，就足以請人協助。若懷疑訂閱網址已外洩，請至服務提供者的管理入口更換存取憑證；只刪除本機記錄，無法使已被複製的網址失效。

依功能相容性選擇核心

v2rayN 的核心設定用來選擇執行設定的核心，不是單純的效能高低開關。Xray 與 V2Fly 有共同的生態背景，但擴充功能、傳輸實作與參數支援可能不同。請先確認目前伺服器的需求，再檢查用戶端能否為目標核心產生相應設定。若某個核心不認得特定欄位，切換路由模式無法補足相容性；同樣地，換成另一個核心後能啟動，也不代表所有原有自訂規則都完整保留。

切換前記下目前使用的伺服器、路由與 DNS 設定；切換後先檢查設定產生與核心啟動記錄，再測試單筆要求。在 Android 上從 v2rayNG 改用 v2flyNG，應視為更換應用程式，而不是在原應用程式內無縫切換：必須重新新增訂閱、確認 VPN 授權與背景執行策略，應用程式的私人資料也不會因伺服器名稱相同而自動同步。一次只執行一個流量接管應用程式，避免將權限衝突誤判為核心差異。

跨平台搬移分三個層級處理

搬移時先處理訂閱或伺服器參數，再處理路由與 DNS，最後重建本機設定。Windows 系統代理、Linux 桌面工作階段與 Android 個別應用程式範圍無法直接互換。本機連接埠、設定路徑、自動啟動項目與 TUN 權限都屬於裝置環境，不應未經確認就隨備份覆寫。使用伺服器清單中的「匯出」或「分享」功能前，請確認匯出的是單筆設定還是整個群組；目標裝置應使用與匯出類型相符的匯入入口。

完整備份適合在相容的用戶端環境中還原；跨平台搬移則優先使用用戶端明確支援的交換格式。先在目標裝置測試一筆連線，再批次匯入；確認訂閱更新、路由設定與停止連線後的網路還原都正常，才停用舊裝置。搬移成功的標準不是清單數量相近，而是重要參數正確、目前連線可用、流量範圍符合預期，並保留可撤銷變更的還原方式。

系統代理、TUN 與路由分流

入口接管與核心出站是兩個不同問題

系統代理要確認的是「應用程式是否將要求送至本機代理」；路由規則要確認的是「核心收到要求後選擇哪個出站」。啟用全域路由，不會讓完全忽略系統代理的應用程式突然經過用戶端；啟用 TUN 也不代表所有被接管的流量都必須傳送至代理伺服器。請先確認要求已進入核心，再判斷它符合直連、代理或攔截規則。理解這項差異，可避免入口設定錯誤時一再修改網域規則，讓問題範圍不斷擴大。

v2rayN 常見的「繞過大陸」、「全域」、「直連」都是預設路由策略，實際行為取決於目前的規則內容、出站標籤與資料庫。全域策略適合短時間確認代理鏈路；日常分流則應依需求恢復合適的策略。「直連」也不代表已退出用戶端，流量仍可能先經過本機入口，再由核心直接連線至目標。測試時請同時記錄系統代理或 TUN 狀態，以及路由模式；只有一張「已啟用」的截圖，不足以說明要求實際經過的路徑。

看懂規則欄位與順序

以下是可嵌入相容核心設定的 routing 片段，並非完整的啟動設定。第一條依網域集合比對，第二條依私有 IP 集合比對，兩者都指向名為 direct 的出站。主設定中必須存在這個標籤，並備妥規則所引用的資料檔案。缺少出站定義或資料庫時，單獨複製此片段無法建立可用連線。用戶端的路由編輯器可能採用不同的儲存結構，應使用它提供的欄位，不要直接覆寫整份設定檔。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "domain": ["geosite:cn"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      }
    ]
  }
}

路由通常依規則順序比對，前面的寬泛條件可能蓋過後面的細部例外。特定網域、區域網路服務等例外，通常應放在會攔截它們的萬用規則之前；但實際順序仍取決於設定目的。同一條規則中同時設定網域與 IP 條件，也不能簡單解讀成符合其中任一項就算命中，請確認核心對不同條件組合的定義。未命中任何規則時的預設出站行為，必須依完整設定確認，不要從片段最後一條規則推斷。

DNS 與規則資料庫要一併檢查

geosite:cn 代表資料庫中的網域分類，geoip:private 代表私有位址集合。它們不是會自動從網際網路即時查詢的標籤，也不表示所有網域分類都永遠不變。更新路由資料後，請確認核心實際載入的是新檔案，而不是其他目錄中的舊版本。資料更新入口與引用方式請參閱GeoIP 與 GeoSite 規則檔更新方式；若要了解欄位順序，可接著閱讀分流規則實作指南。

DNS 會決定網域名稱的解析方式，也會影響哪些 IP 條件能參與比對。範例中的 AsIs 不會為了路由比對而主動將所有網域解析成 IP；若應用程式只提供網域名稱，而規則依賴 IP，請明確選擇合適的策略，並了解額外的解析成本。瀏覽器的加密 DNS、自訂解析器與 TUN 的 DNS 接管也可能改變解析位置。先用網域規則測試目標，再逐步加入 IP 判斷，不要一次更動所有解析路徑。

每次修改前先匯出路由或儲存可還原的副本，再一次只新增一組規則。重新載入後，查看記錄中的目標與出站。不要直接編輯用戶端執行期間產生的暫存設定，切換伺服器時可能會被覆寫。測試完成後，移除僅供測試使用的全域覆寫規則，並保留規則用途說明。穩定分流仰賴明確的入口、解析與出站關係，而不是不斷堆疊來源不明的規則。

設定常見問題與分層還原

依故障位置安排檢查順序

排查時先記下最後一個正常的操作：應用程式能否啟動、訂閱能否更新、核心能否監聽、本機入口能否收到要求、遠端能否完成交握、目標能否傳回內容。依序檢查可將問題範圍限制在相鄰兩層之間。若記錄已顯示本機連接埠繫結失敗，先處理連接埠占用；若完全沒有要求記錄，先檢查應用程式的代理入口。不要將「連線失敗」視為單一錯誤，也不要一次更換用戶端、核心、DNS 與路由後，再猜測究竟是哪項設定生效。

訂閱清單空白、核心啟動失敗，或只有部分應用程式可用

訂閱更新後清單空白時，先分辨是網路取得失敗，還是回傳內容無法解析。查看網址是否誤複製成管理頁面、尾端是否多了空格，以及群組是否被篩選而隱藏。若回傳的是網頁提示或過期說明，請聯絡實際服務提供者處理訂閱，不要對空清單執行連線。只有透過現有代理才能取得訂閱時，請先用已有的可用設定建立連線，再選擇相應的更新方式，避免陷入「沒有設定，卻依賴設定下載」的循環。

核心啟動失敗時，應找出第一筆具體錯誤，而不是只看最後的「程序已結束」。監聽位址遭占用、設定欄位不受支援、規則資料缺漏與目錄權限不足，各有不同的處理方式。變更連接埠前先確認是否有其他用戶端執行個體；更換核心前先確認伺服器的功能需求。設定包含自訂 JSON 時，先還原成用戶端可正常產生的基本設定，再逐項加入修改。反覆點選啟動通常只會產生更多時間接近的記錄，不會自動修正設定。

瀏覽器可用、終端機不可用時，先用明確的代理參數測試終端機入口；終端機可用、瀏覽器不可用時，則檢查瀏覽器擴充功能、獨立代理與受管理的政策。若只有特定應用程式失敗，還需確認它是否納入 Android 的個別應用程式範圍，或是否使用獨立網路堆疊。TUN 模式下也要確認該要求是否進入核心，不能因為理論上能接管，就略過實際證據。詳細差異請參閱瀏覽器與終端機的分別排查步驟。

分別處理交握、解析與間歇性中斷

TLS 交握失敗時，請核對系統時間、伺服器名稱、傳輸方式與服務提供者要求的參數。不要把略過憑證驗證當成一般修復方式，這會繞過原本用來確認伺服器身分的保護機制。網域解析失敗時，先確認解析失敗的是伺服器網域，還是最終目標網域；兩者可能採用不同的解析路徑。若只有大型要求或特定網路下會失敗，請記錄網路類型與重現條件，再檢查傳輸方式、路徑 MTU 或 UDP 支援；不要因為小型頁面能開啟，就認定所有流量都正常。

遇到間歇性中斷時，請觀察事件之間的關聯：鎖定螢幕、休眠、切換網路、更新訂閱，還是切換伺服器。Android 先確認背景程序是否仍在執行；桌面環境則查看網路恢復後虛擬介面與 DNS 是否重新建立。重新啟動後恢復，不代表已找出原因；請保留中斷前後一小段已遮蔽敏感資訊的記錄。只在必要期間提高記錄層級，確認問題後恢復日常設定，避免持續產生大量檔案，也減少私人存取目標長期留在記錄中的機會。

尋求協助時，提供平台與架構、用戶端名稱、目前使用的核心、連線方式、錯誤原文及已驗證的步驟即可。訂閱網址、密碼與驗證識別資訊都不是必要資料。若問題已縮小至單一設定，可至說明中心查找相關問答；需要重新建立最小可用設定時，請回到使用指南。最後確認時應涵蓋正常連線、分流符合預期，以及停用後網路能夠還原三項結果，而不只是成功開啟一次頁面。