Windows
使用 v2rayN 桌面版或經典 WPF 版。桌面版採用跨平台介面，WPF 版適合偏好傳統 Windows 操作方式的使用者。安裝前先確認系統架構和執行環境。
前往下載用戶端功能
從訂閱匯入到路由分流
v2rayN 與 v2rayNG 將核心設定、伺服器管理和系統網路設定集中於圖形介面。以下功能說明依實際使用順序編排，先了解入口，再決定是否啟用更深入的流量接管。
別名
協定
群組
目前伺服器
VLESS
預設群組
備用設定
VMess
手動管理
系統代理：自動設定 · 路由：規則模式
伺服器管理
訂閱網址匯入與群組管理
訂閱匯入適合集中接收一組伺服器設定。桌面端通常從「訂閱群組」新增項目，填入完整網址後執行更新；Android 端則可透過訂閱設定新增。用戶端會將回傳內容解析為伺服器清單，但訂閱網址本身不代表連線已自動建立。
匯入後應先確認清單是否出現可選設定，再選擇一個項目作為目前伺服器。多個來源建議分別建立群組，避免更新時混在一起。若更新完成但清單為空，應優先檢查網址是否完整、群組是否啟用，以及日誌中是否出現解析錯誤。
日常維護
手動更新與自動更新的界線
訂閱更新用於重新取得伺服器設定，不等同於更新用戶端程式。首次匯入後建議手動執行一次更新，以便立即確認網址和網路條件是否正常。自動更新更適合已穩定運作的設定，可依需求設定週期，減少長期使用舊項目的情況。
更新失敗時不要連續重複點擊。先查看用戶端日誌，區分網路請求失敗、回傳內容無法解析和訂閱資訊失效三類問題。若舊設定仍可使用，可保留原群組並新增測試群組，確認新內容正常後再整理清單。
流量接管
系統代理適合瀏覽器與一般桌面應用程式
啟用系統代理後，遵循作業系統代理設定的程式會將網路請求交給用戶端監聽的連接埠。瀏覽器和多數圖形應用程式通常可直接使用，因此這是桌面端最適合優先嘗試的模式。關閉用戶端前應還原系統代理，避免系統保留已失效的本機連接埠。
部分終端機程式、獨立網路元件或自行管理連線的應用程式不會讀取系統設定。這種情況下應先確認應用程式本身是否提供代理選項，再考慮環境變數或 TUN 模式。不要只憑單一程式的表現判斷整體代理狀態。
擴充接管
TUN 模式涵蓋不讀取系統代理的流量
TUN 模式透過虛擬網路介面處理更廣泛的流量，適合系統代理無法涵蓋的程式。啟用時可能需要作業系統授予網路或管理權限，也要留意與其他虛擬網路工具、企業安全性政策及既有路由設定之間的衝突。
排查時應從簡單模式開始：先確認同一伺服器在系統代理下可連線，再啟用 TUN。若啟用後出現網路中斷，應查看虛擬介面是否建立成功、DNS 設定是否遭接管，以及路由規則是否將必要流量錯誤送往其他出口。
規則控制
依網域、IP 與規則集決定流量出口
路由分流不是伺服器篩選功能，而是針對每個連線進行規則比對。常見出口包括代理、直連和阻斷。規則通常依序處理，因此範圍較大的規則若放得太前面，可能覆蓋後面的精確規則。修改後應儲存設定並重新載入核心。
日常使用可先選擇用戶端提供的基礎規則，再逐步加入確有需要的網域或位址範圍。遇到某個網站行為異常時，先從日誌確認套用到哪條規則，而不是同時調整訂閱、DNS、連接埠和伺服器，單一變因排查更容易得到穩定結論。
生態元件
用戶端介面與代理核心分工明確
v2rayN、v2rayNG 和 v2flyNG 負責設定管理、伺服器清單與系統互動，真正解析協定並建立連線的是相應核心。不同用戶端會依平台定位選擇 Xray 或 V2Fly 生態元件，也可能允許在設定中切換適用的核心。
選擇核心時應以訂閱設定包含的協定和傳輸參數為準。遇到無法識別的欄位，先確認用戶端與核心是否支援該設定，再查看啟動日誌。只更換介面程式而不了解核心錯誤，通常無法解決設定結構不相容的問題。
故障定位
日誌是啟動失敗與連線異常的第一個入口
用戶端日誌通常會記錄設定產生、核心啟動、監聽連接埠和連線處理過程。若雙擊啟動後未正常進入工作狀態，應先確認用戶端日誌與核心日誌的入口，再尋找連接埠佔用、欄位解析失敗、權限不足或檔案路徑異常等明確提示。
排查時保留錯誤訊息前後的上下文，不要只截取最後一行。先處理最早出現的關鍵錯誤，重新啟動後再觀察後續資訊。重複錯誤往往是同一根因引發的連鎖結果，逐項修正比直接重設全部設定更可控。
裝置協作
區域網路共享需要明確的監聽位址與存取範圍
區域網路共享允許同一網路中的其他裝置連線至目前用戶端提供的代理連接埠。啟用後，需要在使用端填入執行用戶端裝置的區域網路位址和對應連接埠。主機防火牆、路由器隔離設定以及網路類型都會影響存取結果。
此功能適合臨時除錯或限定範圍內的裝置協作。設定時應記錄開放的連接埠和目前網路環境，離開該網路後及時關閉共享。若連線失敗，依序檢查兩台裝置是否位於同一網段、監聽位址是否允許外部存取，以及防火牆規則是否放行。
依系統選擇
四個平台的用戶端入口
桌面系統優先查看 v2rayN，Android 可在 v2rayNG 與 v2flyNG 之間選擇。下載頁會進一步區分處理器架構、安裝包類型和系統需求。
快速入門
安裝、匯入、驗證三個階段
首次設定不需要同時調整所有進階選項。先建立一條能被用戶端正確載入的連線，再逐步加入自動更新、路由規則和 TUN 設定。
-
01
依平台安裝用戶端
Windows、macOS 與 Linux 使用 v2rayN，Android 使用 v2rayNG 或 v2flyNG。安裝前確認處理器架構和安裝包格式；首次開啟時依系統提示完成必要的權限設定。若程式無法啟動，先檢查執行環境、解壓縮目錄和目錄寫入權限，不要急著匯入設定。
-
02
匯入訂閱並選擇伺服器
在訂閱管理中新增群組，貼上完整訂閱網址並手動更新。清單出現內容後選擇一台伺服器設為作用中項目。若使用單一分享連結，可從剪貼簿匯入，但仍應檢查協定、位址、連接埠和傳輸參數是否完整識別。訂閱更新與用戶端更新是兩項獨立操作。
-
03
啟用代理並分層驗證
桌面端先啟用系統代理，Android 端依系統提示建立網路連線。驗證時分別觀察用戶端狀態、日誌和目標應用程式的表現。系統代理正常後，再依實際需求設定路由分流或 TUN。若只有終端機程式無法連線，應單獨檢查該程式的代理變數和連接埠設定。
先縮小設定問題範圍
先確認用戶端能啟動，再確認訂閱能更新，接著測試單一伺服器，最後檢查系統接管。每次只改變一個條件，日誌中的錯誤會更容易對應到具體步驟。
開源生態系
Project V、V2Fly 與 Xray 的關係
用戶端、核心、協定和訂閱服務處於不同層級。理解這些層級，可以避免將介面問題、設定問題和核心問題混為一談。
生態歷史與專案分支
Project V 奠定了 V2Ray 設定模型和協定生態的基礎。隨著社群發展，V2Fly 延續並維護相關核心能力，Xray 則在相容既有設定思路的同時，擴充了協定、傳輸與路由能力。兩者都屬於開放協作的核心家族，但發布節奏、設定欄位和功能支援並不總是完全一致。
因此，「V2Ray 用戶端」通常指圍繞此生態建立的圖形管理工具，而非單一核心檔案。看到 VMess、VLESS、Trojan、REALITY 或 gRPC 等名詞時，應分別判斷其屬於協定、安全層還是傳輸方式，再確認目前用戶端所呼叫的核心是否支援相應組合。
三款用戶端的職責
v2rayN 面向桌面系統，負責訂閱群組、伺服器清單、系統代理、TUN、路由和日誌入口。v2rayNG 面向 Android，常見設定由 Xray 核心處理；v2flyNG 同樣面向 Android，但更貼近 V2Fly 核心生態。三者都以圖形介面降低設定管理成本，實際連線能力仍由核心與設定共同決定。
用戶端程式碼公開，使用者可以了解功能演進、設定產生方式和問題修復紀錄。開源並不代表所有分支具有相同介面或完全一致的預設值，因此跨用戶端遷移時，應核對訂閱相容性、路由規則、DNS 設定與本機監聽連接埠，而不是只比較名稱。
協定授權與社群維護
開源授權規定程式碼使用、修改和再發布的條件，具體條款以各專案隨軟體提供的授權檔案為準。用戶端與核心由不同維護者和社群參與者持續改進，發布週期也彼此獨立。更新用戶端時，介面元件與核心元件可能一同變更，也可能由用戶端分別管理。
日常維護應記錄目前可用的設定與關鍵選項，更新後先檢查核心能否正常啟動，再觀察訂閱、路由和系統接管。若新設定欄位無法識別，應查看日誌中的明確錯誤，並確認用戶端與核心的功能範圍。回到可重現的步驟，比反覆切換多個選項更有助於定位原因。
近期文件
用戶端設定與故障排查
以下三篇文章分別處理核心啟動失敗、桌面版本選擇和系統代理未生效。每篇都依可觀察到的現象拆分檢查路徑，方便從日誌或系統設定開始定位。