Windows
v2rayN 提供桌面版與傳統 WPF 版。桌面版採用跨平台介面，WPF 版則保留熟悉的視窗與選單配置。兩者都能管理設定並啟動核心，選擇時以操作習慣與系統需求為準，不必為同一筆訂閱同時執行兩套用戶端。
安裝前，請在系統「關於」頁面確認處理器架構。首次啟動後，先檢查本機監聽連接埠與系統代理狀態；若已有其他代理程式，先結束該程式再測試，避免連接埠遭占用或系統設定互相覆蓋。需要使用 TUN 時，再另外處理權限與虛擬網卡設定。
前往下載閱讀起點 / CONFIG
用戶端管理設定，核心負責連線；系統代理決定流量入口，路由規則決定流向。
V2Ray官方下載依照這條流程整理下載入口與教學。先選擇適合裝置的用戶端，再匯入服務提供者提供的訂閱或伺服器設定，最後確認應用程式流量確實經過代理。安裝軟體不代表已經取得可用的連線參數；介面顯示已啟動，也不代表所有應用程式都使用代理。
上方編輯器展示的是 Xray 設定結構摘錄，用來說明出站協定、傳輸安全與路由規則的差異。範例網域與識別字僅供解說欄位，REALITY 所需的其他參數並未列出。日常使用圖形化用戶端時，通常由介面產生核心設定，不必將這段內容複製到設定檔。
v2rayN 設定目錄
依序閱讀六個常用設定入口：「設定來源 → 流量入口 → 比對規則 → 連線診斷」。不同介面配置的選單名稱可能略有差異；設定欄位用於對照概念，不代表所有核心都採用相同寫法。
訂閱群組 → 訂閱群組設定
依來源管理伺服器設定
訂閱網址是遠端設定清單的入口，並非單一節點網址。新增群組後填入訂閱連結、儲存並更新，再從清單中選擇目前使用的伺服器。透過群組可區分不同設定來源，也能分別設定更新週期。相較於逐一貼上分享連結，訂閱可同步伺服器清單的新增與刪除；但自行修改過的訂閱項目可能在更新時遭到覆寫。更新失敗時，先確認連結有效，再比較直連更新與透過代理更新的結果，避免依賴尚未可用的節點。
訂閱網址自動更新間隔群組備註
主介面或系統匣選單 → 系統代理
先確認應用程式是否採用系統設定
設定系統代理後，用戶端會將本機監聽位址寫入作業系統的代理設定。瀏覽器等會讀取這項設定的應用程式，才會將要求送至本機入口。這與核心路由中的全域代理是不同的設定，也不會自動涵蓋所有程式。首次連線建議先使用系統代理測試瀏覽器，再處理其他應用程式。結束用戶端前可清除系統代理；若軟體已關閉，瀏覽器仍指向本機連接埠，就可能連一般網頁也無法開啟，此時應先還原系統網路設定。
本機監聽位址HTTP / SOCKS系統代理狀態
主介面 → 啟用 TUN 模式
透過虛擬網路介面接管流量
TUN 透過虛擬網路介面處理 IP 流量，適合不讀取系統代理設定的應用程式。桌面版通常需要相應權限，實際接管範圍則取決於路由、排除項目與 DNS 設定。TUN 不是用來加速系統代理的開關，也無法保證所有連線都會經過遠端。啟用前先確認一般代理可正常使用，再查看記錄並確認本機網路存取是否正常。若與其他虛擬網卡、企業網路工具或既有 VPN 衝突，先停用其中一項進行比對，避免同時變更多個網路入口而難以找出問題。
虛擬網卡自動路由排除網段
設定 → 路由設定 → 預設規則集
依規則順序選擇出站
路由規則會將網域、IP 或連接埠條件對應至代理、直連等出站方式。多數規則依序比對，較明確的例外規則應排在範圍較廣的規則之前。GeoSite 提供網域集合，GeoIP 提供 IP 集合，兩者用途不同。選擇預設規則集後，應檢查區域網路、內部網域與目標網站的實際流向，而非只看模式名稱。相較於所有流量都交給同一個出站，分流可保留本機服務的直接連線；若規則檔案遺失或標籤拼錯，則須先修正資料庫引用。
domainStrategygeosite:cnoutboundTag
設定 → DNS 設定
區分 DNS 查詢與實際連線
DNS 負責將網域解析為 IP，DNS 查詢所走的網路路徑不一定與網頁連線相同。瀏覽器的安全 DNS、作業系統快取與核心 DNS 都可能參與同一次存取。若網域無法開啟、改用 IP 卻能連線，應先確認由哪個元件負責解析，再檢查上游是否可連線。路由中的網域解析策略也會影響 IP 規則是否參與比對。不要只更換 DNS 位址就認定問題已解決；應使用相同網域重新測試，並區分快取結果與新發出的查詢。
dns.serversqueryStrategydomainStrategy
主介面 → 記錄；設定 → 參數設定 → 記錄等級
依錯誤發生階段定位
記錄可協助區分核心啟動、網域解析、伺服器連線與協定交握等階段。先記下某次連線失敗的時間，再查看前後相鄰的錯誤，比搜尋整頁的「失敗」更容易定位。連線遭拒、連線逾時與憑證名稱不符並非同一類問題，處理方式也不同。診斷時可暫時提高記錄詳細程度，重現問題後再恢復日常等級。分享記錄前，請移除訂閱網址、識別資訊及私人伺服器資料；記錄主要提供線索，仍須搭配瀏覽器連線結果與目前使用的伺服器狀態交叉判斷。
loglevelaccesserror
設定順序比開關數量更重要
第一次使用時，先保留預設路由與 DNS，匯入訂閱並選定目前使用的伺服器。使用真實連線測試，確認用戶端能透過該伺服器完成要求，再設定系統代理，並用瀏覽器開啟已知可存取的頁面。確認這條最基本的流程正常後，再啟用 TUN、新增自訂分流或調整解析策略。否則，多項尚未驗證的設定彼此疊加，很難判斷問題出在伺服器還是本機網路。
「全域代理」的意思須依所在位置判斷。系統設定中的全域代理通常指應用程式如何將流量送進本機代理；用戶端路由中的全域模式，則指流量進入核心後如何選擇出站。若程式沒有將流量交給用戶端，即使路由設為全域，也不會因此接管該程式。反過來說，應用程式即使已進入 TUN，仍可能符合直連規則。確認代理是否生效時，應同時檢查入口與出站，而不是只看單一狀態圖示。
若只有特定網站或應用程式異常，不必立刻重新安裝用戶端。先用同一台伺服器瀏覽其他頁面，再換另一組伺服器設定進行比對；接著檢查該網域的規則比對結果與 DNS 解析結果。每次只變更一個條件，並保留故障前後的記錄，就能區分「完全無法連線」與「局部規則異常」。詳細流程請見故障排查；欄位說明可參考術語表。
用戶端與各平台下載入口
桌面端可選擇 v2rayN，Android 建議先查看 v2rayNG；若已有 V2Fly 設定需求，再比較 v2flyNG。下方連結會帶你前往對應平台的下載選項；安裝檔架構、系統需求與檔案說明集中在下載頁。
macOS
v2rayN 的 macOS 安裝選項依 Apple Silicon 與 Intel 分別提供。請在「關於這台 Mac」查看晶片資訊，再選擇對應架構。設定來源與其他桌面平台相同，但系統網路設定、啟動權限與選單位置須依目前的系統介面操作。
匯入訂閱後，先確認目前使用的伺服器，再檢查目前網路服務的代理設定。瀏覽器可正常使用、但終端機指令仍採直連，通常表示兩者使用不同的代理入口，不應直接判定為節點失效。切換無線網路後，也應重新確認目前的網路環境是否有所改變。
前往下載Android
v2rayNG 採用 Xray 核心，是 Android 的優先選擇；v2flyNG 採用 V2Fly 核心，適合已有相應設定的使用者。多數裝置可選 arm64；不確定架構時，請查看通用套件說明。協定能否使用取決於用戶端與核心的支援情況，不能只看分享連結的名稱判斷。
首次連線時須確認系統 VPN 授權。若鎖定螢幕後連線中斷，先檢查電池最佳化、背景執行與網路切換行為，再排查伺服器。應用程式分流也會改變實際接管範圍；測試時請確認瀏覽器未列入排除項目，並避免同時啟動其他 VPN 服務。
前往下載Linux
v2rayN 提供 deb 與 rpm 安裝選項，並區分 x64、arm64 架構。請先確認發行版採用的套件格式與處理器類型，再選擇檔案。圖形化用戶端適用於桌面工作階段；應用程式能否讀取系統代理設定，還取決於桌面環境與程式本身的實作方式。
桌面瀏覽器、命令列工具與背景服務可能各自使用不同的代理設定。瀏覽器測試成功，不代表所有處理程序都已接管。啟用 TUN 時應留意權限、系統路由與其他虛擬網路介面；若區域網路存取受到影響，先檢查排除網段，不要反覆切換節點。
前往下載下載用戶端後還需要準備什麼
用戶端提供本機設定管理、協定處理與流量轉送功能，不會自動建立遠端服務。連線所需的位址、連接埠、識別參數與傳輸設定，須由服務提供者提供。訂閱連結可能包含存取憑證，應視為私密設定保存，切勿貼到公開截圖或第三方線上轉換工具。更換裝置時，也應先確認匯出的是單筆伺服器設定、訂閱網址，還是整個用戶端的設定。
已有設定的使用者，建議先記錄目前使用的伺服器、路由模式與本機連接埠，再升級用戶端或更換平台。保留一份可還原的設定，有助於判斷新環境的差異。遇到無法識別的協定欄位時，應比對核心支援能力與設定格式；同屬 Project V 生態，不代表所有用戶端都能直接讀取彼此的完整設定檔。
Project V、V2Fly 與 Xray
理解開源生態時，應先區分不同層次。專案名稱、執行核心、圖形化用戶端與遠端服務各有不同職責；混用這些名稱，容易造成安裝與設定上的誤判。
設定介面 → 核心執行 → 遠端服務
同一生態，各司其職
Project V 是理解 V2Ray 相關工具的背景。V2Fly 延續 V2Ray 的社群開發路線，Xray 則在相關技術基礎上發展出獨立的核心。v2rayN、v2rayNG、v2flyNG 是提供給使用者的圖形化用戶端，負責將訂閱、伺服器參數與模式選擇轉換成核心可執行的設定。伺服器端採用的協定，仍須符合用戶端所用核心的支援能力。
Project V · 專案生態V2Fly / Xray · 執行核心用戶端 · 設定介面
核心家族與協定支援
核心負責接收入站流量、比對路由規則，並依出站設定建立連線。V2Fly 與 Xray 有部分共同的歷史背景與設定概念，但各自維護功能與設定的演進，不能將兩者的設定檔視為可任意互換。尤其涉及 VLESS、REALITY 與 Vision 等組合時，應先確認目前執行的核心，而非只確認用戶端名稱。
協定、傳輸與安全層並非同義詞。VLESS 是代理協定，REALITY 屬於傳輸安全機制，Vision 則是在特定條件下使用的流控方式。填寫參數時，應將服務端提供的整組設定對應至用戶端。若只選擇 VLESS，卻漏掉安全層或流控要求，仍可能在交握階段失敗；單純更換連接埠無法解決這類設定不符的問題。
三款用戶端的開源授權
v2rayN、v2rayNG 與 v2flyNG 都是開源用戶端，主要用戶端程式碼採用 GPL 系列授權；V2Fly 與 Xray 核心則主要採用 MPL 2.0 授權。用戶端介面、核心及隨附元件各自適用不同授權。免費使用、檢視程式碼與重新散布所享有的權利並不相同；若涉及修改、散布或整合，應以各專案的授權條款為準。
選擇時先考量裝置與設定。桌面端可透過 v2rayN 集中管理伺服器、訂閱與路由；Android 上的 v2rayNG 著重 Xray 生態，v2flyNG 則對應 V2Fly 路線。此處的「優先」與「備選」代表本站安排操作入口的順序，不代表另一款用戶端已停止維護，也不表示某個核心在所有網路環境中都比較快。
訂閱、用戶端與規則更新
用戶端升級、訂閱更新與 Geo 資料庫更新是三種不同的維護方式。用戶端升級會變更介面或隨附元件；訂閱更新會向服務提供者重新取得伺服器清單；Geo 資料庫更新則會變更網域與 IP 集合的內容。訂閱更新成功，不代表路由檔案也已更新；更新規則檔案，也無法修復已失效的訂閱網址。
更新前後應保留可供比對的條件，例如相同的使用中伺服器、路由模式與測試網域。若更新後出現異常，先查看啟動記錄與實際設定，再決定是否還原。自動更新也不宜設定得過於頻繁，更新週期應配合設定來源的要求；請求過於密集可能觸發伺服器端限制，反而影響正常更新。
下載與教學的適用範圍
設定教學與技術文章
最近三篇文章依操作問題整理：先確認訂閱要求是否成功，再檢查規則資料庫，最後確認選用的伺服器與系統代理。操作步驟與設定說明分開撰寫，方便依目前遇到的問題查閱。
訂閱更新失敗的常見原因與 v2rayN 自動更新間隔設定
從連結失效、網路無法連線、代理循環及內容格式異常四個方向，整理訂閱更新失敗的原因，並說明如何在訂閱群組中設定自動更新間隔。
適合遇到「節點仍在，但更新時出錯」的情況。先確認要求是否取得有效的設定內容，再考慮更新方式與週期，避免將遠端傳回的錯誤頁面當成訂閱匯入。
閱讀訂閱問題排查方法 →geoip.dat 與 geosite.dat 更新方式：路由規則檔案的來源與寫法
說明 GeoIP、GeoSite 資料庫在路由分流中的用途，示範如何在用戶端內更新規則檔案，以及如何在規則中引用 geosite:cn、geoip:private 等常用標籤。
適合遇到「用戶端可以連線，但部分流量流向不如預期」的情況。先確認標籤類型與資料庫是否存在，再檢查規則順序；網域集合與 IP 集合不能只因名稱相近就互換。
閱讀規則檔案說明 →v2rayN 首次連線指南：選擇節點、實際連線測速與確認代理生效
匯入訂閱後的第一步：透過實際連線測速挑選可用節點，切換系統代理模式，再分別以瀏覽器與命令列確認流量確實經過代理。
適合已看到伺服器清單，卻不確定接下來該怎麼操作的使用者。測試結果只代表測試當下的連線狀況，不能取代實際應用程式驗證；選好伺服器後，仍須確認流量入口設定正確。
閱讀首次連線流程 →