v2rayN 全平台安裝與設定

通用準備：安裝檔與連線資料

先分清用戶端、核心與節點

v2rayN 是桌面圖形介面用戶端，負責保存伺服器資料、更新訂閱、產生執行設定並控制代理入口。實際處理連線的是核心；節點則包含遠端服務的位址與驗證資料。安裝用戶端不會自動取得可連線的節點；取得訂閱也不代表其中每個項目都適用目前使用的核心。開始前，請確認資料提供者提供的是訂閱網址、單一分享連結，還是完整設定檔，並了解適用的協定與用戶端範圍。

桌面平台優先選擇 v2rayN，支援 Windows、macOS 和 Linux。Android 使用 v2rayNG，其常見設定以 Xray 核心為主；若已有 V2Fly 設定需求，再評估 v2flyNG。核心名稱相近，不代表協定欄位完全相同。尤其是 REALITY、流量控制與傳輸設定，請以目前應用程式實際提供的選項為準；不要把某個用戶端匯出的執行設定，直接當成另一款應用程式通用的訂閱。

確認系統架構與安裝條件

前往用戶端下載頁，依作業系統選擇安裝檔，再核對處理器架構。本站提供的 Windows 下載項目適用於 x64；Mac 請在「關於這台 Mac」查看晶片，Apple Silicon 與 Intel 應分別選擇；Linux 則需同時考量架構與套件格式。Android 優先依裝置架構選擇 arm64；若無法確認，或安裝時提示架構不符，再查看通用版。不要只憑副檔名判斷是否相容，也不要反覆安裝名稱相似但架構不同的套件。

安裝前請預留應用程式與設定檔的儲存空間，並確認目前帳戶具備安裝軟體的權限。一般系統代理通常不需要一直以管理員身分執行；TUN、虛擬網卡與路由修改則可能需要額外授權。公司管理的裝置也可能限制網路延伸功能、VPN 或代理設定；若受到管理政策阻擋，請先確認裝置使用規範。系統日期與時間也應保持正確，明顯偏差可能導致加密連線在交握階段失敗。

準備最精簡的驗證環境

首次設定時，先暫停其他正在接管網路的代理或 VPN，只保留目前要測試的用戶端。記下系統原有的代理與 DNS 設定，以便還原。先透過系統代理測試瀏覽器，再考慮使用 TUN；不要同時修改節點、路由、DNS 和網卡設定。若一次變更多個層次，即使恢復連線，也很難判斷是哪項設定生效；之後切換網路時，類似問題往往還會再度出現。

訂閱網址通常含有帳戶識別資訊或存取權杖，應妥善保管。不要將完整連結貼到公開截圖、線上格式轉換工具或疑難排解討論中；分享記錄時也要遮蔽驗證欄位。準備一個能正常開啟的一般網頁作為直連參考，再準備一個需要透過目前節點存取的目標網頁。回報測試結果時，說明使用哪款應用程式、是否啟用系統代理、是否開啟 TUN，比只描述「網路連不上」更容易釐清問題。

本指南說明操作順序與設定之間的關係，選單名稱可能隨介面更新而有所不同。找不到同名項目時，先依「訂閱管理」、「系統代理」、「路由設定」等功能尋找，不必照著其他平台的截圖尋找完全相同的位置。已能連線的使用者可直接前往相關章節；若還不熟悉匯入與啟用順序，請先完成快速入門教學，再回來設定分流與 TUN。

Windows：v2rayN 安裝與系統代理設定

選擇桌面版或傳統 WPF 版

開啟Windows 下載區，依需求選擇 v2rayN 桌面版或傳統 WPF 版。桌面版採用跨平台介面，適合希望在多種桌面系統間使用相近操作方式的使用者；WPF 則是 Windows 傳統介面。兩者的選單配置可能不同，排解問題時請註明使用哪個版本。不要同時開啟兩份用戶端並讓它們爭用本機監聽連接埠，否則後啟動的核心可能無法繫結入口。

依照安裝程式提示完成安裝。首次啟動時，先確認主視窗能正常顯示，再匯入節點。若程式直接關閉，先查看系統提示與應用程式記錄，不要立刻修改網路設定。若缺少執行環境，請安裝應用程式所需的相應執行階段；傳統 WPF 介面涉及桌面元件，不能以其他用途的執行環境取代。實際相依項目請以安裝提示為準，程式已正常執行時，不必額外安裝無關元件。

匯入訂閱並確認目前伺服器

在訂閱群組設定中新增群組，填入容易辨識的備註，將完整訂閱網址貼到網址欄位並儲存，接著更新目前訂閱。儲存群組只會記錄來源，不代表已經取得節點。更新完成後，切換至對應群組，確認是否出現伺服器項目，再選擇其中一個作為目前伺服器。若網址是從瀏覽器複製，請確認複製的是資料提供者給的訂閱連結，而非帳戶中心或訂單頁面的網址。

使用單一分享連結時，從剪貼簿匯入與更新訂閱是不同操作。匯入後請核對伺服器位址、連接埠、協定與傳輸方式，尤其不要把連結末尾的備註誤認為伺服器位址。首次驗證可只保留一個明確可用的候選項目，減少自動切換與批次測試造成的干擾。清單中的延遲測試結果只反映特定測試方式，不能取代實際存取目標網頁的結果，也不能據此判定協定設定完全正確。

啟用系統代理，再檢查路由

核心正常啟動後，在系統代理選單中選擇自動設定系統代理，讓遵循 Windows 系統代理設定的應用程式使用用戶端本機入口。系統代理負責將請求交給用戶端；路由則決定收到的請求要直連還是透過代理，兩者不能混為一談。選擇繞過中國大陸預設，不代表已啟用系統代理；啟用系統代理，也不保證所有應用程式都會遵循。終端機、開發工具與部分下載工具可能需要各自設定代理。

驗證時重新開啟測試頁面，必要時重新啟動仍保留舊連線的應用程式。如果瀏覽器正常，但命令列仍是直連，先查看命令列工具使用的代理來源，不要重複匯入訂閱。瀏覽器的代理擴充功能也可能覆蓋系統設定。想了解模式差異，可參考系統代理與路由模式說明中的概念；不同平台的介面雖然不同，入口設定與出口選擇仍是兩個層次。

TUN 授權與退出後還原

只有在需要接管不遵循系統代理的應用程式，或需要更完整地接管網路時，才啟用 TUN。先關閉其他虛擬網卡接管工具，依用戶端提示授予必要權限，並查看核心記錄是否成功建立網路入口。若安全軟體阻擋網路元件，請確認遭封鎖的具體項目與用途，不要直接關閉所有防護。若裝置受組織政策管理，即使具有管理員權限，也不一定能解除限制。

退出前先關閉 TUN，再清除用戶端設定的系統代理。若異常關機後瀏覽器完全無法連線，而用戶端尚未啟動，可到 Windows 代理設定中查看是否殘留指向本機的手動代理。還原網路時，只撤銷本次新增的設定；不要刪除不明網卡或重設所有網路。啟動問題詳情可參閱執行階段與啟動權限疑難排解，將程式啟動失敗與節點連線失敗分開處理。

macOS：晶片選擇、安裝權限與代理

依晶片選擇安裝檔

在 Mac 的「關於這台 Mac」查看晶片資訊，再前往macOS 下載區。Apple Silicon 請選擇對應的 arm64 安裝檔，Intel 則選擇 x64 安裝檔。優先使用與電腦架構相符的版本，不要把透過相容層成功啟動視為最佳安裝方式。下載完成後開啟磁碟映像檔，依畫面提示將 v2rayN 移至「應用程式」，再從應用程式資料夾啟動，避免長期從暫時掛載的位置執行。

首次開啟時，可能會出現系統來源確認或權限提示。請先確認檔案確實來自預期的下載來源，再透過系統設定中的「隱私權與安全性」處理允許開啟。如果出現程式已損毀、無法驗證或沒有存取權限等提示，應分別排查下載是否完整、安裝位置是否可寫入，以及系統政策是否阻擋。不要把所有提示都歸為同一種原因，更不要為了啟動一個應用程式而關閉整個系統的應用程式檢查機制。

匯入後先測試，再設定系統代理

開啟 v2rayN 的訂閱群組設定，填入備註與完整訂閱網址，儲存後更新目前群組。節點清單出現後，選定目前伺服器並確認核心能正常啟動。如果訂閱可以儲存但更新失敗，先檢查網址是否含有多餘空格、是否已失效，以及目前網路能否連上訂閱服務。更新訂閱與連線至節點使用不同的請求路徑；前者成功不代表後者可用，前者失敗也不一定表示既有節點已失效。

接著在系統代理選單中啟用自動設定系統代理。Mac 的系統代理與網路服務相關；切換 Wi-Fi、有線網卡或其他網路服務後，請重新確認目前服務的代理狀態。系統代理選單中的「不變更系統代理」只是停止主動修改系統設定，不代表系統中沒有殘留代理。要恢復直連，應選擇清除系統代理，並在系統網路設定中核對結果，而不是只切換到不變更狀態。

區分瀏覽器連線與應用程式連線

先使用遵循系統代理的瀏覽器開啟目標網頁，觀察請求是否出現在用戶端記錄中。如果瀏覽器能正常使用，某個開發工具卻無法連線，先查看該工具自己的代理選項與程序環境。部分應用程式只會在啟動時讀取代理設定，變更系統設定後需要重新開啟。瀏覽器也可能設定了獨立代理擴充功能或自訂解析方式，讓同一台 Mac 上的應用程式呈現不同結果；不應只靠反覆更換節點來排解。

繞過中國大陸、全域等路由預設應依目標選擇，不要把「自動設定系統代理」理解為所有連線都會經過遠端。啟用系統代理後，核心仍可依規則讓指定網域或位址直連。開發環境中的本機服務應特別留意回送位址與區域網路目標的處理，避免將原本要連到本機的請求送往遠端。需要存取印表機、區域網路服務或內部網域時，應保留適當的直連範圍。

TUN 與休眠後的還原順序

需要接管不讀取系統代理的應用程式時，再測試 TUN。依用戶端提示完成權限提升或輔助元件授權，並留意系統是否要求核准相關網路功能。啟用 TUN 後，先測試一般網頁，再測試區域網路與目標應用程式；若只測試一個頁面，可能會漏掉區域網路路由或解析異常。不要同時執行多個試圖管理預設路由的工具，關閉視窗也不代表相關背景網路功能已停止。

Mac 從休眠中喚醒或切換網路後，舊連線可能失效。先確認基本網路可用，再重新連線目前節點；若仍有問題，先關閉 TUN、還原系統代理基準狀態，再依原順序啟用。退出應用程式前，請主動清除代理；若異常退出，則到目前網路服務的代理頁面檢查是否有殘留。操作時可參考macOS 系統代理模式詳解；啟動階段的問題另請參閱權限與隔離屬性疑難排解。

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

同時確認發行版與處理器架構

前往Linux 下載區，先確認發行版使用 deb 或 rpm 套件，再確認電腦架構是 x64 還是 arm64。不要藉由更改副檔名把一種套件變成另一種，也不要混淆處理器架構與發行版名稱。可在系統的「關於」頁面查看資訊；若使用終端機，以下命令只會讀取系統資訊，不會安裝軟體或變更網路。確認輸出的架構名稱與下載頁說明相符後再繼續。

uname -m
cat /etc/os-release

使用發行版提供的軟體安裝工具開啟下載的套件，檢查相依項目提示並完成安裝。若安裝程式指出缺少元件，請使用目前發行版的正式軟體來源解決相依問題，不要混用其他發行版的套件。應用程式安裝成功卻無法顯示視窗時，可從終端機啟動已安裝的程式以查看錯誤輸出，並優先確認圖形工作階段、桌面元件與檔案權限；這時尚未進入節點連線階段，修改訂閱並無幫助。

使用一般帳戶執行並確認監聽入口

日常啟動圖形介面時，建議使用一般帳戶，避免以高權限執行一次後，設定目錄變成一般帳戶無法寫入。首次啟動時，確認訂閱與應用程式設定能正常儲存；結束後重新開啟，確認設定仍然存在。若每次修改都會遺失，先檢查設定目錄權限、磁碟狀態，以及是否誤從暫存位置執行。備份或遷移時也應保留適當的檔案擁有者，不要以放寬所有目錄權限來掩蓋問題。

新增訂閱群組、填入網址、儲存並更新；選定節點後查看核心記錄。若出現位址已被使用，通常表示另一個核心或代理工具正在使用相同的本機連接埠。先查明占用項目，再停止重複執行的執行個體或調整用戶端入口。變更連接埠後，也要同步更新使用該入口的應用程式設定；若只修改用戶端而未修改瀏覽器、終端機或桌面代理，就會出現「核心正常執行，但請求進不來」的情況。

桌面環境不代表有統一的系統代理

Linux 的桌面代理行為取決於桌面環境與應用程式本身的實作。即使用戶端提供系統代理選項，也應到桌面的網路代理設定確認寫入結果。部分圖形應用程式會讀取桌面設定；命令列程式則可能讀取環境變數或自己的設定檔，而已啟動的程序也未必會自動更新。先讓一個明確支援代理的應用程式使用本機入口，確認節點連線可用後再擴展到其他程式，能更有效縮小排查範圍。

為終端機設定代理前，請確認工具支援的代理協定，以及用戶端實際啟用的監聽類型。HTTP 入口與 SOCKS 入口不能只因為都在本機就互相替用。暫時設定的環境變數通常只影響目前終端機及其子程序，不會自動修改整個桌面。要取消設定時，也應一併移除相應的環境變數；否則用戶端結束後，新執行的命令仍可能嘗試連線至已不存在的本機連接埠，看起來就像系統網路故障。

TUN、路由與網路管理服務

TUN 需要存取虛擬網路裝置並修改相關路由；權限不足時，請依用戶端提示設定必要授權。不要為了啟動 TUN 而長期以高權限帳戶開啟整個桌面應用程式。啟用後，確認是否確實建立網路入口、是否有其他 VPN 接管預設路由，以及區域網路目標是否仍可存取。桌面網路管理服務可能在切換網路後重新套用設定，因此啟動時成功不代表切換網路後的狀態也一定相同。

DNS 也可能分別由桌面環境、網路管理服務或本機解析服務管理。先確認目前由哪一層負責，再調整用戶端 DNS，避免直接覆寫系統管理的解析檔。無法解析時，先關閉 TUN 回到基準狀態，確認系統解析能否恢復；基本網路恢復後，再逐步檢查虛擬入口與規則。退出前撤銷本次新增的代理設定，保留原有網路設定；尤其是遠端維護的機器，若沒有回復方式，請勿直接修改預設路由。

Android：匯入訂閱與 VPN 授權

選擇 v2rayNG 或 v2flyNG

前往Android 下載區選擇用戶端。一般 Xray 設定優先使用 v2rayNG；若現有資料明確以 V2Fly 為主，再評估 v2flyNG。兩款應用程式都能管理節點，但功能選項與協定支援不能只憑名稱推斷完全相同。若服務資料要求 REALITY 或特定流量控制，請先確認目前用戶端是否提供相應欄位，避免匯入成功後才發現執行時無法識別。

安裝檔提供 arm64 與通用版，較新的主流裝置通常可選 arm64，但仍應以實際處理器架構為準。若安裝時提示不相容，先核對架構與系統需求，不要持續覆蓋安裝不同來源的套件。透過瀏覽器安裝時，Android 可能要求允許目前來源安裝應用程式；只需依需求授權這次使用的來源。安裝完成後，從應用程式清單開啟用戶端，先確認能進入主畫面並儲存設定。

貼上網址後更新訂閱

複製完整訂閱網址，在應用程式的訂閱設定或訂閱群組管理中新增來源，填入備註並儲存，再更新訂閱。不同介面可能會將更新入口放在主清單選單中；訂閱設定頁看得到網址，不代表更新已完成。更新後回到節點清單，選擇要使用的項目。若取得的是分享連結，請使用對應的剪貼簿匯入功能，不要把單一節點連結填入只接受訂閱網址的欄位。

手機複製資料時，容易一併帶入換行、空格或聊天軟體附加的說明，匯入前請檢查開頭的協定與完整內容。掃描 QR Code 匯入也只會讀取編碼資料，無法確認設定仍然有效。若節點名稱出現卻無法啟動，請核對傳輸類型、加密連線參數與核心支援情形，再查看記錄。格式差異詳情請參閱訂閱、原生 JSON 與分享連結說明，不要把所有文字都用同一種方式匯入。

了解 Android 的 VPN 接管方式

點選連線後，系統通常會跳出 VPN 連線要求；確認後，應用程式才能透過本機虛擬網路入口接收流量。這是 Android 提供給這類用戶端的網路接管機制，不代表系統會自動補齊節點資料。看到 VPN 狀態圖示，只能確認本機接管通道已建立；遠端連線是否成功，還需透過記錄與目標請求判斷。若拒絕系統授權，反覆更換節點也無法解決授權問題。

同一個系統使用者通常無法同時由兩款一般 VPN 應用程式接管流量。若已啟用其他 VPN、流量過濾工具，或透過 VPN 介面運作的網路應用程式，請先停用再測試。應用程式內的分應用程式代理可選擇哪些應用程式納入接管範圍；不同選項可能代表「僅代理所選項目」或「略過所選項目」，操作前請先閱讀目前模式的說明。清單中勾選某個應用程式，不一定表示它會走代理，實際方向取決於模式定義。

背景限制、網路切換與恢復

若前景使用正常，鎖定螢幕後連線卻經常中斷，先檢查系統是否限制用戶端的電池使用、背景執行或自動啟動。依裝置提供的設定允許必要的背景活動即可，不必一次放寬所有無關應用程式的限制。也要確認是系統回收了程序，還是 Wi-Fi 切換至行動網路後舊連線失效。兩者處理方式不同：前者與背景限制有關，後者則應先嘗試重新連線目前設定並查看記錄。

首次驗證不建議立刻啟用「一律使用 VPN」或「封鎖未使用 VPN 的連線」等系統選項。若用戶端尚未成功連線，這些設定可能連其他請求也一併阻擋，掩蓋基本網路狀況。需要這些功能時，請先測試正常連線、中斷與重新啟動後的狀況。排查完成後，在應用程式內主動中斷連線，並確認系統 VPN 狀態已解除；更換用戶端前也先停用原有的網路接管，避免把前一款應用程式的殘留狀態誤認為新用戶端故障。

訂閱管理：格式、更新與設定遷移

辨識資料類型，選擇相應的匯入方式

訂閱網址是可重複請求的資源入口，用戶端更新時會從該網址取得節點資料。分享連結通常描述單一節點；原生 JSON 則可能描述整套入站、出站、路由與 DNS 設定。這些資料無法只靠更改副檔名就互相通用。遇到匯入失敗時，先確認輸入資料類型，再確認用戶端是否支援該類型；把網頁內容另存成文字，或再次編碼已編碼的內容，都不會自動產生有效設定。

Base64 訂閱常用於編碼一組分享連結，解碼後仍須符合用戶端可辨識的連結格式。部分訂閱服務會依請求方式回傳不同結構，因此瀏覽器看到的內容與用戶端實際收到的內容可能不完全相同。排查時請查看更新記錄中的回應與解析錯誤，不要只憑網址能否在瀏覽器開啟就下結論。若回傳登入頁面、錯誤訊息或空內容，都可能導致沒有可匯入的節點。

分開處理群組更新與節點選擇

訂閱群組建議使用容易辨識的備註，以區分不同來源與用途。更新目前群組只會重新整理該來源；更新所有訂閱則可能同時替換多個群組的項目。更新前若曾手動修改訂閱中的節點，請先備份，因為用戶端可能會依來源重新產生項目，手動調整不一定保留。需要長期維護的自訂節點，適合另外保存，而非每次更新後都修改同一筆訂閱記錄。

更新完成後，確認目前選取的節點仍然存在；節點名稱、伺服器位址或設定內容都可能變更。不要只看到群組更新成功就直接離開。自動更新間隔也應依來源限制設定；若更新失敗，避免短時間內頻繁重試。訂閱服務暫時無法連線，但現有節點仍可使用時，可以先繼續使用已儲存的設定，再處理訂閱請求路徑，不必刪除所有項目重建環境。

遷移時優先使用應用程式內建備份

在相同用戶端之間遷移時，優先使用應用程式提供的備份與還原功能，或依說明備份設定目錄。遷移前先關閉應用程式，避免複製仍在寫入的資料庫；還原前也要另行保存目標裝置原有資料。備份可能包含完整訂閱網址、驗證資訊與本機使用記錄，請存放在受控位置。新裝置還原成功後，再核對本機監聽連接埠、系統代理與 TUN 設定，不要假設依賴裝置的選項可以直接照搬。

跨平台遷移尤其要留意檔案路徑、權限方式與網路服務差異。Windows 路徑不能直接用於 Mac，Linux 的授權方式也不能照搬到 Android。跨用戶端遷移則應以雙方都支援的分享格式為主，並逐項核對重要參數。完整執行設定可能含有特定核心專用欄位，不能因為都是 JSON 就認定彼此相容；即使匯入時沒有報錯，也應進一步驗證實際連線與路由結果。

核對 REALITY 與傳輸參數

VLESS 節點需要分別檢查伺服器位址、連接埠、使用者識別碼、傳輸方式、連線安全設定與流量控制。REALITY 的伺服器名稱、公鑰與短識別碼應符合服務端要求，不可從其他節點任意拼湊；伺服器名稱也不一定等同實際連線位址。若缺少相關參數，請向資料提供者確認，不要試著關閉驗證碰運氣。原理說明請參閱REALITY 與 XTLS Vision 說明。

遷移完成後分兩輪驗證：先在新裝置建立最精簡的連線，再逐步恢復原有分流、自動更新與背景選項。確認穩定後再清理舊資料；若新裝置尚未驗證成功，保留舊裝置設定有助於區分資料問題與平台環境問題。格式轉換的適用範圍詳情，請參閱訂閱格式詳解。

系統代理、TUN、路由與 DNS

先判斷請求如何進入用戶端

系統代理是一種應用程式協作機制：系統記錄代理入口，願意讀取這項設定的應用程式會將請求送到該入口。TUN 則是在網路層建立虛擬入口，透過路由將符合條件的資料交給用戶端。兩者首先解決的是如何接收流量，並不會直接決定所有請求最終從哪裡出去。若某個應用程式沒有遵循系統代理，修改節點分流規則通常不會生效，因為請求根本沒有進入核心。

要確認入口是否正常運作，可在送出明確請求時查看記錄，留意目標網域、連線時間與應用程式行為是否相符。沒有記錄時，先檢查代理入口與應用程式設定；有記錄但連線失敗時，再檢查節點、路由與解析。不要長時間使用過於詳細的記錄層級；排查完成後請恢復常用層級，並清除含有敏感資訊的記錄。連線重複使用可能導致重新整理頁面時沒有建立新連線，必要時重新開啟應用程式再觀察。

路由規則依序選擇出口

繞過中國大陸通常會透過網域與位址規則，將相關請求送往直連出口；其他請求則繼續依預設規則處理。規則順序很重要，範圍較廣的規則若排在前面，可能讓後面的特定規則永遠無法符合。區域網路位址、特定開發網域與遠端目標應分別考量，不要只新增一條涵蓋所有位址的規則。尤其在公司網路中，內部網域可能只能透過內部解析服務解析，不宜一律交由遠端處理。

以下是 Xray 路由結構範例，用來說明資料庫規則與出口標籤之間的關係。此範例必須合併至既有設定，不能直接當作完整用戶端設定啟動；並假設已有名為 direct 與 proxy 的出站，以及可用的規則資料庫。圖形介面用戶端可能會重新產生執行設定，日常修改建議優先使用內建路由介面，而不要直接編輯暫時產生的檔案。

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

DNS 不只是填入解析位址

網域解析可能發生在應用程式、系統、用戶端或遠端；不同代理方式的解析位置也可能不同。瀏覽器自行啟用加密 DNS 後，修改系統 DNS 未必會影響它。排查時先確認目標應用程式使用哪一層解析，再查看用戶端規則是否能取得網域資訊；如果請求進入時只剩位址，依賴網域的規則可能無法如預期比對。不要只因網頁無法開啟，就立刻同時更換多個層級的解析服務。

用戶端 DNS、直連出口與代理出口之間也可能互相依賴。例如，若解析節點伺服器位址的請求必須先透過尚未建立的同一個節點，就會形成啟動迴圈。應先確保連線至伺服器所需的基本解析可用，再處理目標網域的分流解析。使用 TUN 時也要確認 DNS 請求是否依設計交由用戶端接管，避免系統與用戶端分別取得不同結果，導致同一網域的行為不一致。

分開驗證資料庫規則與 UDP

GeoSite 管理網域分類，GeoIP 管理位址範圍，兩者不是可以互換的規則資料。規則寫法正確但分類失效時，請檢查資料庫是否存在、是否成功載入，以及目前用戶端核心支援哪種資料格式。更新資料庫後，還要確認核心是否重新載入；下載完成不代表規則已生效。詳細比對順序請參閱GeoIP 與 GeoSite 更新指南。

瀏覽器網頁能正常使用，也不代表 UDP 應用程式一定可用。UDP 能否轉送，取決於應用程式入口、用戶端設定、協定能力、節點服務與網路條件。語音、即時通訊或使用不同傳輸方式的應用程式發生問題時，應單獨觀察對應流量，不要以網頁測試結果取代。設定複雜度應逐步增加：系統代理可用後測試路由，再測試 TUN，最後處理 DNS 與特定應用程式需求；每一步都保留可還原的上一版設定。

常見設定問題：依失敗階段排查

程式無法開啟與核心無法啟動

先判斷主視窗能否開啟。主視窗尚未顯示時，優先檢查安裝架構、系統相依項目、應用程式權限與安全性提示；此時訂閱內容通常不是主要排查對象。若主視窗能開啟，但提示核心已退出，請查看核心記錄，留意設定解析失敗、本機連接埠占用、檔案存取失敗及不支援的欄位。記錄清楚錯誤發生階段，可避免程式啟動問題一再更換節點，或參數錯誤時反覆重裝整個用戶端。

若剛修改設定就出現啟動失敗，先撤銷最近一項變更；有備份時，還原至已知可正常啟動的設定。不要立刻刪除所有設定目錄，其中可能還有可供定位問題的記錄與有效資料。連接埠被占用時，找出是否有重複執行的用戶端；遇到權限錯誤時，檢查具體檔案位置。跨平台啟動問題可參閱v2rayN 閃退與權限疑難排解，先還原程式基準狀態再測試網路。

訂閱失敗與連線失敗

訂閱更新失敗時，先確認能否連線至訂閱服務，再檢查回傳內容是否可辨識。連線逾時、驗證失效與格式不支援是不同問題。確認網址完整且仍有存取權限後，檢查目前網路是否出現登入頁面或存取限制；若現有節點可用但訂閱無法連線，再查看用戶端是否提供合適的更新請求方式。不要任意將敏感訂閱交給線上轉換服務，以免資料問題擴大為存取憑據外洩。

節點已匯入但連線失敗時，請依序核對遠端位址、連接埠、協定、傳輸方式與安全參數。逾時通常需要檢查連線是否可達及服務狀態；驗證或交握錯誤則應優先確認設定內容、系統時間與服務端要求。錯誤訊息本身無法單獨證明原因，應搭配發生階段判斷。批次更換節點前，先驗證一筆資料明確的設定；若所有設定都在相同階段失敗，應優先檢查共通環境，而非逐筆修改參數。

已連線但網頁或應用程式無法使用

用戶端顯示執行中，只代表本機程序正在運作。先確認請求是否進入記錄，再檢查符合的出口，最後查看目標解析與遠端回應。瀏覽器可用但其他應用程式不能用，多半需要比較入口與應用程式代理設定；所有應用程式都失敗時，再回頭檢查核心與節點。若只有部分網域異常，請檢查路由分類、DNS 結果與目標服務本身，不必立刻全面接管更多流量。

網頁載入不完整、下載中斷或影片停頓，也不應直接歸因於「節點太慢」。頁面可能同時請求多個網域，若某組資源被錯誤分流，就會造成部分載入失敗。先查看失敗資源的目標與出口，確認是否走了預期路徑。延遲測試只測量特定連線，無法代表傳輸速度、長時間傳輸或所有協定的表現；比較節點時，請使用相同目標、相同網路與相同代理方式，避免混用不同條件下的結果。

關閉後仍無法連線與問題回報

結束用戶端後無法上網，先檢查系統代理是否仍指向本機入口，再確認 TUN 或系統 VPN 是否還在接管流量。還原時先撤銷用戶端修改，再測試直連參考頁面。Linux 也要檢查終端機環境變數與桌面代理是否各自殘留；Mac 請留意目前網路服務；Android 則檢查是否啟用了封鎖未使用 VPN 之連線的系統選項。不要一看到「關閉後無法上網」就重設所有網路，先處理能明確對應本次操作的設定。

需要進一步求助時，請整理作業系統與架構、用戶端名稱、資料類型、連線方式及重現步驟，並附上已遮蔽敏感欄位的錯誤片段。說明是所有目標都失敗還是只有部分目標失敗、直連是否正常，以及問題是在安裝後首次發生，還是切換網路後才出現。每次只驗證一項假設，記錄結果後再繼續。常見概念可前往常見問題；準備重新完整設定連線時，請回到使用文件，依序完成匯入、選擇、啟用與驗證，建立基準狀態。