V2Ray 全平台
安裝設定指南

通用準備：裝置、訂閱與設定注意事項

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

用戶端負責顯示伺服器清單、儲存訂閱及設定系統代理；核心則負責執行協定連線、路由與本機監聽。v2rayN 是桌面圖形介面用戶端，v2rayNG 與 v2flyNG 則適用於 Android。安裝用戶端不代表已有可連線的伺服器，還需要有效的訂閱網址或完整的單一連線設定。Project V 是相關技術生態的源頭，V2Fly 與 Xray 屬於核心系列，不能將這些名稱當作訂閱服務名稱。

設定前請確認伺服器資料來自可信來源，並了解使用範圍。訂閱網址通常包含存取憑證，應妥善保管，不要貼到公開討論區、截圖或線上轉換頁面。若需要求助，僅提供協定類型、傳輸方式與錯誤類別；請遮蔽伺服器位址、使用者識別碼及訂閱查詢參數。用戶端記錄也可能含有連線目標網域，分享前請逐行檢查。

確認處理器架構與安裝套件類型

即使作業系統名稱相同，處理器架構也可能不同。Windows 可在「設定 → 系統 → 系統資訊」查看系統類型；macOS 可在「關於這台 Mac」查看晶片或處理器；Android 可查看系統裝置資訊，不確定時選擇通用套件。Linux 可使用下方指令查詢架構。不要只憑裝置外觀或購買年份推測，也別把發行版名稱和處理器類型混為一談。

uname -m

系統最低需求與所需執行環境，請以下載頁及實際安裝提示為準。桌面用戶端包含介面、核心等多個部分，只移動主程式可能導致資源缺漏。選擇安裝位置時，建議使用目前帳戶可寫入的資料夾；若要以可攜方式搬移，請一併處理用戶端支援的設定備份，不要從舊資料夾任意挑幾個檔案覆蓋新安裝。

建立可重現的測試起點

先關閉其他代理用戶端、網路加速工具與重複執行的程式，只保留一個負責接管網路的程式。記下原有的系統代理、DNS 與 VPN 狀態，尤其是受組織管理的工作裝置。初次測試不要同時啟用系統代理、TUN、自訂 DNS 和大量路由規則；先用預設設定確認單一連線可用，再逐項新增功能。發生異常時，才能明確知道要回復哪個設定。

準備兩個測試目標：一個平常可直接連線的網站，以及一個用來確認代理路徑的 HTTPS 網站。瀏覽器能開啟網頁，只能證明該瀏覽器目前的連線路徑可用，不能據此認定所有應用程式都已接管。也請查看用戶端記錄是否出現相應請求，並比較關閉代理接管後的情況。測試時盡量使用同一個瀏覽器視窗，減少擴充功能、快取與應用程式差異造成的干擾。

最後確認系統時間、網路是否需要登入入口網站，以及裝置是否連上受管理的網路。憑證驗證需要正確的時間；入口網站尚未完成驗證，也可能讓訂閱更新逾時。先在關閉代理的狀態下，用一般瀏覽器確認基本網路正常，再前往對應的平台章節。若只想盡快完成首次連線，可返回使用教學，不必一次調整所有進階參數。

Windows：安裝 v2rayN 並接管網路

選擇桌面版或經典 WPF 版

前往Windows 下載區選擇 v2rayN。桌面版採用跨平台介面，經典 WPF 版則沿用 Windows 介面架構；兩者差異在於介面實作，不代表某個伺服器只能在其中一個版本使用。先確認下載區提供的 x64 套件適用於你的裝置，再依安裝程式提示完成安裝。若系統明確指出缺少執行環境，請安裝提示所需的元件，不要從不明網站單獨下載動態連結程式庫。

首次啟動時若沒有顯示視窗，先查看工作列通知區是否已有執行中的程式，再確認系統是否封鎖了應用程式。一般系統代理測試不需要長期以系統管理員身分執行。若安裝在受保護的資料夾，設定檔的寫入權限可能與一般資料夾不同；若每次重新啟動後設定都消失，請先檢查資料夾權限和安全軟體的封鎖記錄，不要反覆重新匯入訂閱。

匯入訂閱並選擇伺服器

前往「訂閱群組 → 訂閱群組設定」，新增群組並填寫方便辨識的備註，將完整訂閱網址貼到網址欄位，儲存後執行「更新全部訂閱(不透過代理)」。首次設定建議使用不透過代理的更新方式，因為此時尚未建立可用的代理連線。更新完成後選擇對應群組，確認伺服器清單出現項目，再選取一個伺服器設為目前使用的伺服器。

若清單沒有變化，先清除搜尋條件並切換至「全部」檢視，再查看更新記錄。回傳內容是網站登入頁、訂閱已失效或網址貼得不完整，都可能導致無法解析設定。單一分享連結應使用「從剪貼簿匯入多個 URL」等對應入口，不要直接當作訂閱網址。設定頁能儲存不代表伺服器資料完整，仍須確認協定、連接埠與傳輸參數。

先使用系統代理，再評估 TUN

選好伺服器後，在「系統代理」中選擇「自動設定系統代理」，路由先選「繞過中國大陸」。系統代理只會影響遵循 Windows 代理設定的應用程式；部分命令列工具和應用程式使用自己的網路設定，不會因為瀏覽器能連線就自動跟著使用代理。查看用戶端底部的本機監聽資訊，連接埠以目前設定為準，常見設定為 SOCKS 10808 與 HTTP 10809，但不要未經確認就複製到其他應用程式。

若要讓不遵循系統代理的流量也經由用戶端傳送，再評估是否使用 TUN。TUN 需要虛擬網路介面、路由與相應權限，啟用時可能會出現權限提示。先關閉其他 VPN 或虛擬網卡接管功能，再開啟用戶端的 TUN 開關；若初始化失敗，請檢查記錄中的權限、網卡或路由錯誤。TUN 與系統代理不必同時啟用，排錯時應先分別驗證兩種接管方式。

連接埠衝突、結束程式與開機啟動

若記錄顯示連接埠已被占用，先結束重複執行的用戶端。若需進一步檢查，可在命令提示字元中執行下方指令；它只用來查看連線與處理程序編號，不會修改網路。請將結果中的處理程序編號與工作管理員的「詳細資料」核對，不要看到占用就直接結束不熟悉的系統處理程序。若必須更換連接埠，也要同步修改手動設定該連接埠的瀏覽器、終端機及其他應用程式。

netstat -ano | findstr ":10808"
netstat -ano | findstr ":10809"

關閉視窗可能只是縮到通知區，不代表程式已結束。測試結束程式時，先在系統代理選單中選擇「清除系統代理」，再從系統匣選單結束程式，並檢查「設定 → 網路和網際網路 → Proxy」是否仍保留手動代理位址。確認手動啟動與正常結束都穩定後，再啟用開機啟動；否則系統啟動後用戶端未執行，其他應用程式卻仍使用本機代理位址，瀏覽器就可能突然無法連線。

macOS：處理器架構、系統權限與代理服務

依晶片選擇 DMG

開啟蘋果選單中的「關於這台 Mac」；若顯示 Apple 系列晶片，請選 Apple Silicon 套件，若顯示 Intel 處理器，則選 Intel 套件。接著前往macOS 下載區取得對應的 v2rayN DMG，開啟磁碟映像後將應用程式複製到「應用程式」資料夾，再從該資料夾啟動。不要長期直接從磁碟映像執行，否則更新、權限記錄與應用程式位置可能不一致；卸載磁碟映像後，原本的啟動入口也會失效。

首次開啟時若出現安全性提示，請先確認下載來源與應用程式名稱，再前往「系統設定 → 隱私權與安全性」查看系統提供的處理選項。不要為了啟動單一應用程式而全面關閉系統安全防護。若提示應用程式架構不相容，請回到下載頁重新選擇套件；若系統版本不符合需求，請更新至受支援的執行環境或作業系統，不要修改套件內的檔案來繞過啟動檢查。

設定訂閱與目前使用的伺服器

在 v2rayN 的「訂閱群組」相關設定中新增群組，儲存完整訂閱網址，再使用不透過代理的訂閱更新入口。跨平台桌面介面的按鈕位置可能與 Windows 經典版不同，但操作流程仍是先儲存群組、再取得訂閱，最後選擇目前使用的伺服器。更新後清單若為空，請先確認目前群組與篩選條件，再查看更新結果，不要把選單位置不同誤判為訂閱不相容。

首次連線時請保留訂閱提供的 TLS、伺服器名稱與傳輸參數。伺服器位址用來建立網路連線，TLS 伺服器名稱則用於憑證與交握識別，兩者不一定相同，不要只為了讓欄位一致就手動改成相同值。匯入完成後選擇一個伺服器、啟用系統代理，再連線測試目標；若失敗，先查看核心記錄，不要同時切換多個傳輸選項。

系統代理與網路服務的對應關係

macOS 的代理設定與網路服務相關。可在「系統設定 → 網路」中，進入目前使用的 Wi-Fi 或乙太網路服務，開啟「詳細資訊 → 代理」查看實際狀態。用戶端設定系統代理時可能需要授權；若拒絕授權，介面顯示的設定與系統實際狀態可能不同，請重新確認。手動修改前先記下原有設定；受組織管理的代理或自動設定網址不要直接刪除，應先了解裝置的管理要求。

從 Wi-Fi 切換到有線網路，或透過擴充基座新增網路服務後，請先確認目前生效的是哪個服務。瀏覽器可能改用新服務的代理狀態，但用戶端仍在執行，因而出現「程式正常，但請求沒有進入記錄」的情況。結束用戶端後若網頁無法連線，請檢查該網路服務是否仍指向本機連接埠。復原時只處理這次修改的設定，不要清除所有網路設定。

TUN 授權、睡眠與網路切換

TUN 需要建立虛擬網路介面並調整路由，實際授權方式取決於用戶端實作與系統環境。啟用前請關閉其他 VPN 接管功能，並依用戶端提示授予所需權限。若取消授權、背景輔助程序未執行或建立路由失敗，應先處理初始化錯誤。不要把所有權限提示都當成一般通知權限，也不要假設授權一次就能涵蓋之後變更的安裝位置。

從睡眠狀態恢復或切換網路後，舊連線可能失效，DNS 與預設路由也可能改變。先關閉再重新開啟目前的接管模式，觀察是否建立新的請求；只有介面或核心確實異常時，才重新啟動應用程式。若更換安裝位置、系統帳戶或還原備份後出現權限問題，請重新確認應用程式所在資料夾與系統授權狀態。每次只修改一個因素，通常比連續重裝更容易找出原因。

搬移至另一台 Mac 時，建議先搬移訂閱來源與必要的路由記錄，再重新確認新電腦的晶片、監聽連接埠與權限。舊裝置匯出的完整設定可能包含本機路徑與特定網路服務資訊，不宜未經檢查就直接覆蓋。搬移完成後先測試系統代理，再單獨測試 TUN，並確認正常結束程式後網路狀態能復原，才能將問題範圍限縮到特定接管方式。

Linux：軟體套件、桌面代理與權限

同時確認處理器架構與套件格式

Linux 需要確認兩個項目：處理器架構與發行版使用的套件格式。常見的 Debian、Ubuntu 系統使用 deb，Fedora 等系統使用 rpm；x86_64 通常對應 x64，aarch64 通常對應 arm64。先查看系統資訊或使用下方指令確認，再前往Linux 下載區選擇 v2rayN。不要只看副檔名，也不要將容器環境中的架構輸出視為主機桌面系統的完整資訊。

uname -m
cat /etc/os-release

下載完成後，建議使用發行版的軟體安裝程式開啟套件檔，讓套件管理員處理相依項目與應用程式入口。若相依性解析失敗，先查看缺少的元件及系統支援範圍，不要把其他發行版的程式庫檔案複製到系統資料夾。圖形介面用戶端需要可用的桌面工作階段；僅有遠端終端機的環境，即使安裝成功，也不代表圖形介面、系統匣或系統代理整合可以正常使用。

以一般使用者建立可用設定

從應用程式選單啟動 v2rayN，先以目前的一般使用者帳戶儲存訂閱。前往「訂閱群組」新增網址，使用不透過代理的更新方式，確認伺服器清單出現項目後，再選擇目前使用的伺服器。不要為了避免權限提示就以超級使用者身分執行整個圖形程式，否則設定資料夾中的檔案可能變更擁有者，之後一般使用者啟動時反而無法儲存設定。若儲存失敗，先檢查使用者資料夾是否可寫入。

更新前請先確認基本網路能連上訂閱網址所在網站。桌面環境中的瀏覽器可能已使用代理，但用戶端的訂閱請求未必走相同路徑，因此「瀏覽器能開啟訂閱頁面」不能直接證明直連更新可行。初次匯入建議使用可直接連線的訂閱來源；已有可用伺服器後，才依來源要求測試透過代理更新，並分別記錄兩種方式的錯誤。

桌面系統代理不是統一套用至所有處理程序的開關

Linux 不同桌面環境對代理的支援方式各異。GNOME、KDE 的系統網路設定與終端機處理程序的環境變數是不同管道；有些應用程式會讀取桌面設定，有些則使用自己的設定或環境變數。用戶端顯示已設定系統代理後，請到桌面網路設定確認，再以實際應用程式測試。若終端機仍直接連線，不要立刻判定用戶端故障，應先確認工具支援哪種代理設定方式。

確認本機 HTTP 監聽連接埠為 10809 後，可使用下方指令單獨驗證該連接埠是否能處理 HTTPS 請求。這個指令只會替這次 curl 請求指定代理，不會設定整個終端機或系統。範例使用保留作文件示範的網域；測試實際服務時，請改成獲准存取的目標。若用戶端目前使用不同連接埠，請先修改指令；若未安裝 curl，可用瀏覽器的獨立代理設定進行類似測試。

curl --proxy http://127.0.0.1:10809 -I https://example.com

一般 HTTP 代理可透過 CONNECT 承載 HTTPS 請求，因此代理位址使用 HTTP，不代表目標網站不再使用 TLS。若程式要求 SOCKS，請填入用戶端實際提供的 SOCKS 連接埠，不要只更換協定前綴、卻沿用 HTTP 連接埠。不同工具處理遠端網域解析的方式也不同，比較測試時應一併記錄代理類型與解析位置。

TUN、路由與桌面工作階段

TUN 涉及裝置存取、網路管理權限與系統路由，一般使用者啟動的用戶端可能需要額外授權。請依用戶端與發行版提供的方式完成授權，不要照抄來源不明的提權指令或長期授予過寬權限。若啟動失敗，先確認是否遭拒絕授權、虛擬介面建立失敗或與現有 VPN 路由衝突，再決定下一步，不要將所有失敗都歸咎於伺服器。

系統匣圖示未顯示，可能只是桌面環境未啟用相應支援，不代表核心沒有執行。開機啟動也要區分桌面工作階段自動啟動與系統服務，兩者使用者、環境變數及權限都不同。先確認手動啟動、切換網路、停止接管與結束程式後的網路復原都正常，再設定自動啟動；更新應用程式後請重新檢查授權與啟動項目，避免舊入口仍指向已移除的路徑。

Android：v2rayNG 與 v2flyNG

安裝套件與用戶端選擇

前往Android 下載區時，建議優先選擇 v2rayNG，它使用 Xray 核心；若需要 V2Fly 核心環境，再考慮 v2flyNG。請勿同時讓兩款用戶端建立 VPN 連線。多數較新的裝置使用 arm64；若不確定架構，可選擇通用套件。通用套件是為了支援更多架構，不代表連線品質更好，也不應只憑手機品牌決定安裝哪一款。

安裝下載的套件時，Android 可能會要求允許目前使用的瀏覽器或檔案管理員「安裝未知的應用程式」。請只對實際用於安裝的來源授予權限，完成後可關閉此權限。若安裝失敗，先檢查是否有相同名稱的舊應用程式、裝置剩餘空間與系統相容需求。若已有設定，請先使用用戶端的匯出功能備份，避免為了解決升級問題直接解除安裝，連訂閱與自訂規則也一起遺失。

匯入訂閱與單一設定

在 v2rayNG 選單中開啟「訂閱群組設定」，新增群組備註與訂閱 URL，儲存後更新訂閱。不同版本的更新入口可能位於主畫面選單或群組選單，請依功能名稱尋找。更新成功後返回清單，點選要使用的伺服器，確認它是目前選取的項目，再啟動連線。只儲存群組而未更新，不會自動顯示伺服器。

單一分享連結可透過主畫面的新增入口從剪貼簿匯入；掃描 QR Code 則需要相機權限。剪貼簿內容可能被其他應用程式取代，匯入後請確認類型、位址與連接埠符合預期。若系統限制背景讀取剪貼簿，請在用戶端開啟時重新匯入，不要反覆授予不相關的權限。v2flyNG 的操作方式相近，但仍須確認其核心支援的具體協定選項。

系統 VPN 授權與應用程式範圍

首次點選連線按鈕時，系統會顯示 VPN 連線要求。確認要求來自剛安裝的用戶端後再授權；此授權是用於在本機接管 VPN 流量，不代表系統會自動提供遠端伺服器。連線後請檢查系統 VPN 狀態與用戶端執行記錄。Android 通常一次只允許一個 VPN 服務啟用；工作設定檔、其他 VPN 工具或本機流量篩選程式都可能與它互相取代。

Android 用戶端通常透過 VPN 服務接管應用程式流量，不要照搬桌面上的「自動設定系統代理」操作。若要指定應用程式範圍，請查看用戶端的分應用程式代理或依應用程式代理設定，先弄清楚目前是「僅代理選取的應用程式」還是「略過選取的應用程式」。兩種設定方向相反，設定後請重新連線並分別測試清單內外的應用程式，不要只看勾選狀態就認定範圍正確。

背景執行、私人 DNS 與網路切換

若鎖定螢幕後連線中斷，解鎖後又恢復，請先檢查系統對用戶端的電池最佳化、背景執行與自動啟動限制。不同廠牌的設定名稱不盡相同，請針對該用戶端逐項確認，不必關閉整台裝置的省電功能。背景限制通常會讓處理程序遭到結束或 VPN 狀態消失；若處理程序仍在執行，但記錄顯示連線逾時，應改查網路切換、伺服器連線狀態與 DNS，而非繼續調整電池設定。

從 Wi-Fi 切換至行動網路會變更本機位址與預設路由，舊連線可能因此中斷。先停止再重新啟動連線，觀察新的交握是否成功；若只有特定網路連線失敗，請記下網路類型與時間，並比較同一伺服器的狀況。系統「私人 DNS」和用戶端 DNS 是不同的設定；同時修改兩者會增加排錯難度。發生解析異常時，請先記下目前的私人 DNS 狀態，再逐一測試。

用戶端的延遲測試不等同於應用程式的完整連線流程，有些測試方式只會驗證部分連線階段。伺服器顯示可測量，但應用程式仍無法使用時，請檢查分應用程式代理範圍、路由與網域解析；測試失敗但網頁能開啟時，也要考慮測試目標或測試方式本身。跨裝置搬移時，建議優先搬移訂閱來源；Android VPN 權限與電池策略必須在新裝置重新設定，不能直接從設定備份繼承。

訂閱管理：更新、參數與設定搬移

訂閱網址與伺服器連結的差異

訂閱網址指向一組可更新的設定，單一分享連結則描述一台伺服器，兩者應使用不同的匯入入口。判斷時不要只看字串長短，請確認資料來源說明的用途。將網頁分享網址當成訂閱，常會取得無法解析的 HTML 頁面；把單一連結填入訂閱網址欄位，也可能導致更新失敗。請先確認資料類型，再選擇群組設定或剪貼簿匯入。

建議依來源或用途建立群組，並使用容易辨識的備註。群組不是越多越好；重複訂閱會產生相似項目，讓目前使用的伺服器與測試結果難以對照。更新後若發現項目減少，不要立刻認為用戶端刪除了設定，請先比較訂閱來源是否調整內容、帳戶是否到期，以及用戶端是否隱藏了某些群組。請分開檢查清單篩選條件與訂閱實際內容。

透過代理更新與直接連線更新

「更新全部訂閱(不透過代理)」表示訂閱請求不依賴目前使用的代理連線，適合作為首次設定的入口，但不保證一定能直接連上訂閱來源。「透過代理」則需要先選定可正常運作的伺服器。如果目前使用的伺服器來自已失效的訂閱，再透過它更新同一份訂閱可能形成循環。因此請保留原始訂閱來源資訊，並在基本網路允許時使用直接連線更新。

更新失敗時分三步檢查：是否成功建立連線、回傳內容是否符合預期格式，以及解析出的項目是否可用。連線逾時與收到登入頁面不是同一類問題；成功解析也只代表欄位可讀取，不代表伺服器能完成交握。訂閱網址中的特殊字元、結尾參數與大小寫都可能有意義，不要為了縮短網址而自行刪改。複製時也要留意換行、全形標點及通訊軟體附加的文字。

不要任意修改協定欄位

常見欄位可分為連線目標、身分驗證、傳輸層與 TLS 四類。位址與連接埠決定連線目的地；使用者識別碼或密碼用於驗證；傳輸類型與路徑決定資料如何傳送；TLS 伺服器名稱、ALPN 或相關安全參數則參與交握。欄位是否可省略取決於具體協定與伺服器設定，不能直接套用另一台可用伺服器的參數，也不應根據欄位名稱猜測預設值。

伺服器位址、Host 與 TLS 伺服器名稱可能不同，因為它們負責不同的連線層級。若出現憑證名稱不相符，應核對來源參數與系統時間，不要直接略過憑證驗證來掩蓋錯誤。協定可被識別，也不代表核心支援所有擴充功能；切換 v2rayNG 與 v2flyNG 後，尤其要確認特定協定與傳輸選項，不要只比較介面上的伺服器備註。

備份與跨平台搬移

搬移建議分兩階段進行：先保留訂閱來源、群組備註與必要的自訂規則，再視需要使用用戶端提供的完整備份。不同系統的本機路徑、監聽連接埠、TUN 權限與介面設定可能無法直接沿用。新裝置先安裝符合架構的用戶端，匯入訂閱並確認基本連線，再逐項還原路由與 DNS；這樣才能分辨搬移問題與原有設定問題。

更新訂閱可能會重建由訂閱管理的伺服器項目，直接修改這些項目不一定能長期保留。若要測試參數，可在用戶端支援的情況下複製為獨立測試設定，並清楚標示用途，避免日後誤用。搬移完成後，請確認舊裝置是否仍需保留授權；若訂閱資訊曾經外洩，應從來源端更換存取憑證，單純刪除用戶端中的群組無法撤銷已外洩的網址。

代理、路由與 DNS：分層驗證

接管入口不代表最終出口

系統代理、應用程式獨立代理與 TUN 負責將請求交給用戶端；路由規則再決定要直接連線、透過代理或封鎖。啟用 TUN 不代表所有目標都會經由遠端伺服器；選擇「全域」路由也不代表所有應用程式都已接管。這兩個面向需要分別驗證：先確認請求進入核心記錄，再確認它命中了哪個出站。不要只憑開關顏色判斷實際網路路徑。

初次測試建議從系統代理與預設路由開始。v2rayN 的「路由 → 繞過中國大陸」適合用來建立常見的直連與代理分流；「全域」可暫時用來比較同一目標經由不同出口時的狀況。預設規則的實際內容可能會隨設定而改變，請查看目前規則，不要只看名稱。若某個應用程式完全沒有請求記錄，應先排查接管範圍，不必急著修改網域規則。

規則順序與比對範圍

核心路由通常會依規則順序逐一比對，第一個符合的規則會決定結果。特定網域規則通常應放在範圍較廣的規則之前；私人位址直連規則則可避免本機服務被錯誤送往遠端。比對網域與比對 IP 是不同的路徑：若核心只取得 IP 位址，某些網域規則可能無法生效；若取得的是網域，解析後是否繼續比對 IP，則取決於網域策略與具體設定。

以下是 Xray 路由欄位的示意片段，依序表示「本機私人位址直連、文件網域直連，其餘 TCP 與 UDP 使用代理」。這不是可獨立執行的完整設定；既有設定中必須存在名為 direct 與 proxy 的出站標籤。圖形介面用戶端通常會產生核心設定，直接編輯執行目錄中的暫存檔可能會在下次啟動時被覆蓋，建議使用用戶端的路由編輯入口。

{
  "routing": {
    "domainStrategy": "AsIs",
    "rules": [
      {
        "type": "field",
        "ip": ["geoip:private"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "domain": ["full:example.com", "domain:example.org"],
        "outboundTag": "direct"
      },
      {
        "type": "field",
        "network": "tcp,udp",
        "outboundTag": "proxy"
      }
    ]
  }
}

full:example.com用於完整網域比對，domain:example.org用於該網域及其子網域。規則標籤必須與實際出站設定一致，不要直接照抄名稱。若要使用 geosite 或 geoip 資料，也要確認核心能讀取對應資源。語法正確只代表結構可解析，不保證規則順序符合需求；可搭配自訂路由語法與優先順序逐項檢查。

DNS 解析位置會影響結果

DNS 會將網域名稱轉換為位址，也會影響哪些資訊可供路由判斷。系統 DNS、瀏覽器安全 DNS、應用程式內建解析與用戶端 DNS 可能同時存在。網頁出現解析錯誤時，請先確認是哪個元件發起解析；若瀏覽器啟用了自己的加密 DNS，修改系統 DNS 未必會影響它。也不要把「更換 DNS 伺服器」當成憑證、驗證或連接埠問題的通用解法。

FakeDNS 會以虛擬位址與網域建立對應關係，協助保留網域資訊，常見於 TUN 或透明接管情境，但不是首次連線的必要設定。啟用後，若應用程式快取了虛擬位址，關閉功能後可能需要重新建立連線或清除該應用程式的快取。不熟悉位址對應的有效期間時，請先使用一般 DNS 設定；相關機制可參閱FakeDNS 運作原理，不要同時更換系統與用戶端的所有解析設定。

以對照測試取代連續調整參數

驗證自訂規則時，選擇一個明確的目標，記錄目前的接管方式、路由模式與記錄中的出站。先用預設模式確認基本連線，再新增一條規則並重新發出請求；瀏覽器沿用的舊連線可能仍走原本路徑，因此必要時請關閉該網站的連線後重試。若一條規則已解決問題，再逐步擴大到同類目標，避免一次匯入大量規則後無法判斷是哪一條改變了行為。

常見設定問題：依故障層級排查

先找出故障發生的層級

排錯順序依序為基本網路、用戶端啟動、本機監聽、流量接管、遠端連線、路由與應用程式。先關閉接管功能，確認一般網路可用；再啟動用戶端，查看核心是否正常執行，接著檢查本機連接埠。以上都正常後，才檢查伺服器交握與目標網站。這樣可避免把連接埠衝突誤認為訂閱問題，也能避免系統代理尚未生效時反覆更換伺服器。

建立一份簡短記錄，包含裝置系統、用戶端類型、使用的接管方式、發生錯誤的時間，以及從啟動到首次失敗之間的記錄。測試時只保留一個用戶端和一台目前使用的伺服器，不要連續切換後才截取一張無法對應的記錄。分享前請遮蔽訂閱網址、身分欄位與敏感目標；只需保留足以判斷故障層級的資訊，不必公開完整設定檔。

清單空白、啟動失敗與連接埠占用

伺服器清單空白時，先切換至全部群組並取消篩選，再確認訂閱更新是否確實成功。若更新記錄顯示解析失敗，請檢查回傳內容、資料格式與網址是否完整；若顯示網路錯誤，則先檢查基本連線與更新請求是否經由代理。若已有伺服器但核心無法啟動，應重點檢查設定產生錯誤、資源路徑與連接埠占用，不要繼續重複更新訂閱。

記錄出現 address already in use，通常表示要繫結的位址或連接埠已被占用。先結束其他用戶端與重複執行的程式，再重新啟動服務。更換監聽連接埠也可能解決部分衝突，但所有手動引用該連接埠的應用程式都要同步修改。若是 TUN 介面或路由衝突，更改 SOCKS 連接埠不一定有用，應回到虛擬網路與權限層面檢查；這兩類資源不可混為一談。

交握失敗、逾時與憑證錯誤

連線逾時表示某個階段未能在指定時間內完成，不代表伺服器必然失效。請確認逾時發生在取得訂閱、連線遠端伺服器，還是存取目標網站，再比較同一設定在另一個可用網路上的情況。若所有伺服器只在某個網路逾時，應優先檢查網路環境；若只有一個伺服器失敗，請檢查該伺服器資料與服務端狀態。不要為了看到測試數字就同時修改協定、連接埠與傳輸類型。

遇到 TLS 或憑證錯誤，先檢查裝置日期、時間與時區，再核對伺服器名稱、連線位址與來源資料。若驗證失敗，請檢查使用者識別碼、密碼或訂閱有效期限。WebSocket 路徑、Host、服務名稱等傳輸欄位不一致，也可能造成連線建立後立即中斷。記錄中的 warning 不一定是致命錯誤；請確認其後是否成功啟動，並對照真正失敗的請求。

網頁可連線，但應用程式失敗，或結束程式後無法上網

網頁能開啟但應用程式失敗時，先檢查該應用程式是否遵循系統代理、是否被分應用程式規則排除，以及是否需要 UDP。HTTP 代理、SOCKS 與 TUN 的涵蓋範圍不同，不能用一次瀏覽器測試證明所有協定都可用。若應用程式請求已進入記錄，接著檢查路由出站與遠端回應；若沒有進入記錄，就先處理接管入口。全域路由無法修復根本未被接管的應用程式。

結束程式後無法上網，請優先檢查系統是否仍保留指向本機的代理，或是否啟用了封鎖非 VPN 連線的系統政策。先還原這次修改的代理與接管設定，再確認用戶端確實已結束。不要立刻重設所有網路設定，以免一併移除工作網路、固定 IP 位址及其他必要設定。若需要重新啟動裝置，請先儲存錯誤記錄；重新啟動或許能清除部分暫存狀態，卻無法解釋原本的原因。

先還原可用的基本設定，再逐項加回

仍無法定位時，先匯出必要設定並保留訂閱來源，回到單一伺服器、預設路由與單一接管方式。暫時移除自訂 DNS 與新增規則，確認恢復後再逐項加回，每次都重複相同測試。若需要重新安裝，請先確認問題是否與使用者設定有關；否則重新安裝程式後再匯入同一份故障設定，通常不會改變現象。其他裝置能正常使用，只能證明資料在另一個環境可用，無法排除本機網路差異。

零星問題可繼續查閱常見問題；若要了解具體記錄欄位，可閱讀v2rayN 執行記錄排查方法。排錯完成後，記下最後使用的監聽連接埠、代理方式與路由選擇，刪除僅供測試建立的暫存規則，再確認正常結束與重新啟動都沒有問題。保留這份簡要的基本設定，比累積大量無法說明的參數更有利於後續維護。