Windows
v2rayN 提供桌面版與經典 WPF 版。桌面版採用跨平台介面，WPF 版則保留熟悉的桌面操作方式；兩者版面可能不同，請依實際選單尋找教學中提到的功能。初次安裝建議只使用其中一個版本，避免同時執行造成監聽連接埠衝突。
下載前，請在系統設定中確認處理器架構；安裝後先開啟主畫面，再匯入訂閱。若程式一開啟就閃退，請檢查所需的桌面執行階段、目錄寫入權限與安全軟體記錄，不要直接認定是節點失效。升級前請備份訂閱群組與自訂路由；更新安裝套件不能取代個人設定備份。
前往下載 →常用功能與設定位置
用戶端負責儲存設定，核心負責處理連線。先分清設定所屬層級，再修改對應欄位。
依訂閱群組管理連線資料
訂閱網址會儲存在用戶端的群組中，並非核心 JSON 的通用欄位。請在 v2rayN 的訂閱群組設定中輸入網址、命名群組，再更新訂閱；更新後確認伺服器清單是否有內容。自動更新間隔應依服務端說明設定。若更新失敗，先確認是網址失效、網路逾時還是格式不符。相較於逐一匯入分享連結，群組更方便管理更新後的資料，但不代表訂閱會提供路由規則。右側僅示意核心的出站結構，請勿將訂閱網址填入這段設定。
對應設定區段 →訂閱群組設定 → 自動更新間隔（分鐘）
{
"outbounds": [
{
"tag": "direct",
"protocol": "freedom",
"settings": {}
}
]
}依規則順序選擇出站
路由分流會將網域、目標位址或入站標籤對應至指定出站，但不負責建立伺服器連線。在路由設定中，先確認規則集，再核對規則引用的出站標籤是否存在。Xray 與 V2Fly 常見設定會使用 routing.rules，規則依序比對，符合後便選用 outboundTag 指定的出口。相較於所有連線都走同一出口，分流可分別處理區域網路與特定網域。使用 geosite、geoip 項目時，也需要有相應的資料檔，不能只複製規則文字。
對應設定區段 →路由設定 → 規則清單 → 出站標籤
{
"routing": {
"domainStrategy": "IPIfNonMatch",
"rules": [
{
"type": "field",
"ip": ["geoip:private"],
"outboundTag": "direct"
}
]
}
}讓應用程式流量進入虛擬網卡
TUN 模式適用於不讀取系統代理設定的應用程式，透過虛擬網卡接收流量。啟用前，先用一般代理入口確認節點可連線，再檢查執行權限、虛擬網卡與 DNS 設定。v2rayN 可透過相應核心提供此功能，實際支援範圍取決於用戶端與核心的組合。TUN 與系統代理的差異在於接管流量的位置不同，不代表速度一定會提升。右側是 sing-box 的 TUN 入站片段，並非 Xray 通用欄位；請勿將整段直接貼入 V2Fly 設定。
對應設定區段 →參數設定 → TUN 模式 · 範例格式：sing-box
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"address": ["172.19.0.1/30"],
"auto_route": true
}
]
}依協定需求選擇核心
選擇核心時，應考量伺服器協定、傳輸方式與安全層需求，而非只比較名稱。在 v2rayN 的參數設定中確認核心類型，並查看啟動記錄，確認實際使用的核心。Xray、V2Fly 與 sing-box 的功能和設定格式各有差異，即使選項名稱相同，行為也不一定一致。更換核心前請保留原有設定，先測試單一連線，再恢復複雜路由。右側示範 Xray 與 V2Fly 常見的記錄設定格式；核心類型屬於用戶端設定，並非這段 JSON 的欄位。
對應設定區段 →參數設定 → 核心類型 → 啟動記錄
{
"log": {
"loglevel": "warning"
}
}連接系統代理與本機監聽
系統代理會引導相容的應用程式將要求傳送至本機監聽連接埠；用戶端啟動成功，不代表系統代理已生效。在 v2rayN 主畫面的系統代理選單中選擇所需操作，並確認應用程式設定的代理位址與本機連接埠一致。不讀取系統代理設定的程式，須另外設定代理入口，或依需求使用 TUN。結束用戶端前，請清除不再使用的系統代理，避免應用程式繼續連線至已關閉的連接埠。右側僅示意 Xray 的本機 SOCKS 入站，並非系統代理開關。
對應設定區段 →系統代理選單 → 設定系統代理 / 清除系統代理
{
"inbounds": [
{
"tag": "socks-in",
"listen": "127.0.0.1",
"port": 10808,
"protocol": "socks",
"settings": { "udp": true }
}
]
}用戶端與安裝平台
桌面端可選 v2rayN，Android 端建議先了解 v2rayNG。先確認作業系統、處理器架構與安裝套件格式，再前往下載頁選擇檔案。
macOS
v2rayN 提供 Apple Silicon 與 Intel 對應的安裝選項。請先在「關於這台 Mac」查看晶片資訊，再選擇合適版本，勿只憑裝置外觀判斷架構。安裝後請將應用程式放在固定位置執行。首次啟動若出現系統提示，先閱讀提示內容並確認下載來源，再依系統提供的選項處理。
初次設定時，先確認訂閱匯入與本機代理運作正常，再考慮登入時啟動或使用 TUN。系統代理只會影響遵循系統設定的應用程式；瀏覽器擴充功能中的個別代理設定也可能覆蓋系統設定。若需要虛擬網卡功能，請依用戶端提示授予權限。排查期間一次只使用一種流量接管方式，才能確認問題出在哪個層級。
前往下載 →Android
v2rayNG 使用 Xray 核心，是 Android 端的主要選擇；v2flyNG 使用 V2Fly 核心，適合需要相應相容性的設定。多數新款手機可選 arm64；若不確定架構，請先查看系統資訊與安裝說明，再考慮通用套件。兩款用戶端的設定應分別核對，匯入成功不代表所有選項都相同。
匯入訂閱後選擇伺服器，首次連線時須確認系統 VPN 授權。背景連線能否維持，也會受到系統電池管理與應用程式背景權限影響。若切換應用程式後連線中斷，先檢查省電限制，再查看用戶端記錄。連線資料包含驗證資訊；向他人求助時，只提供已隱去敏感資料的錯誤內容，勿公開完整訂閱網址或分享連結。
前往下載 →Linux
v2rayN 提供 deb 與 rpm 安裝套件，並依處理器架構區分版本。先確認發行版使用的套件管理格式，再選擇 x64 或 arm64。圖形介面是否能執行、桌面系統代理是否生效，以及 TUN 權限是否足夠，是不同問題。軟體能開啟只代表介面已啟動，還需確認核心程序與本機監聽是否正常。
不同桌面環境處理系統代理的方式可能不一，有些程式仍須在應用程式內指定代理位址。先用回環位址與本機連接埠完成測試，再調整路由與 DNS。啟用 TUN 前，請檢查權限及是否與既有虛擬網卡軟體衝突。若要部署路由器或旁路由，請參閱核心部署文章；桌面安裝套件不能當作路由器韌體使用。
前往下載 →Project V 生態系與核心分工
用戶端名稱、核心名稱與連線協定各自代表不同層級。理解彼此關係，比照抄整份設定更容易維護。
Project V 是認識 V2Ray 技術生態系的起點。早期 V2Ray 將協定處理、傳輸與路由等功能整合為可設定的網路工具，後來社群依不同的維護方向發展出多個專案。V2Fly 延續 V2Ray 的社群開發，Xray 則以相關技術為基礎，發展出自己的功能與實作。兩者有共同背景，但並非可以任意混用名稱的同一套程式，也不保證每項設定都相容。
圖形介面用戶端位於核心之上。使用者在介面中儲存訂閱、選擇伺服器及修改規則，用戶端再產生或整理執行設定，交由相應核心處理。因此，介面中的「更新訂閱」不會直接成為核心 JSON 裡同名的欄位；「設定系統代理」也不是遠端伺服器的協定選項。查閱文件時，先確認討論的是介面設定、核心欄位還是伺服器端參數，可減少許多無效嘗試。
用戶端與核心屬於不同層級
v2rayN 主要用於桌面環境，集中管理伺服器資料、訂閱群組、系統代理與路由設定，並提供多核心相關選項。v2rayNG 適用於 Android 裝置，主要使用 Xray 核心；v2flyNG 則提供採用 V2Fly 的 Android 用戶端選擇。三者都是開源用戶端，但專案名稱相近，不代表選單、設定儲存位置與功能範圍完全相同。
選擇用戶端時，先確認裝置平台，再確認伺服器需求。若連線資料使用 Xray 專屬功能，請確認用戶端呼叫的核心是否支援；若使用 V2Fly 設定，遷移前先檢查欄位相容性。不要只將某個用戶端的設定檔複製到另一個目錄，就假定所有設定都會自動生效。
了解核心與用戶端的關係 →協定、傳輸與安全層
VLESS、VMess 與 Trojan 是連線協定；WebSocket、gRPC 等是傳輸方式；TLS 與 REALITY 則涉及連線的安全層設定。這些不是同一份清單中可以互相取代的選項。查看連線資料時，應逐項確認協定、伺服器位址、連接埠、驗證參數、傳輸方式與安全層；任何一項不符都可能導致交握失敗。
VLESS 本身不提供資料加密，實際部署時須搭配合適的安全層。匯入連結通常會自動填入部分參數，但仍應檢查伺服器名稱、傳輸路徑與相關選項是否完整。連線失敗時，先逐項比對伺服器端的要求；不要一次修改多個選項，否則難以判斷是哪項變更影響結果。
查看協定與設定範圍 →開源授權與使用範圍
開源表示專案原始碼依相應授權條款公開；使用、修改與散布時，都應遵守各自的授權要求。用戶端、核心及其相依套件可能採用不同授權，不能將整個生態系視為同一份授權。一般使用者可從專案說明了解功能來源；重新封裝或散布軟體時，還須留意授權文字與著作權聲明的保留要求。
用戶端與遠端服務也應分開看待。安裝軟體不會自動取得伺服器、帳號或訂閱；訂閱內容由提供該網址的服務端決定。用戶端是否開源，與特定遠端服務如何記錄資料是兩回事。處理業務資料時，應同時評估伺服器來源、存取權限與使用情境，不要只依用戶端名稱判斷。
本網站定位與內容範圍 →更新機制與設定維護
用戶端更新、核心更新、訂閱更新與規則資料更新各自解決不同問題。用戶端更新會影響介面與設定產生邏輯，核心更新會影響協定實作，訂閱更新會同步連線資料，規則資料更新則可能改變網域或位址分類。連線異常時，先確認最近變動的是哪一層；不要把四種更新當成同一項操作反覆執行。
維護設定時，請保留可還原的記錄。變更前備份自訂規則與必要參數；變更後檢查啟動記錄、本機監聽及應用程式的實際連線情況。自動更新可減少重複操作，但不能取代結果確認。尤其是長期使用的自訂 JSON，調整核心後應確認欄位仍受支援，並清除不再引用的出站標籤。
查看 JSON 設定參考 →從匯入成功到實際可用
初次設定建議依序確認：先匯入訂閱，確認伺服器清單有資料；再選擇一台伺服器啟動連線，檢查錯誤記錄；接著讓應用程式使用本機代理，確認實際要求能正常送出；最後才加入分流與 TUN。訂閱匯入成功只代表資料可供解析，不代表伺服器目前可連線。核心啟動成功也不代表瀏覽器正在使用代理，這兩項結果須分別確認。
查看記錄時，留意錯誤發生的位置。位址解析失敗，先檢查 DNS；連線逾時，先確認目標位址與連接埠；交握失敗，再比對協定與安全層；本機連接埠遭占用，則處理重複執行的程序。記錄可能包含位址與驗證資料，分享前請先隱去敏感資訊。逐層找出問題，比不斷更換伺服器、重裝用戶端或修改所有設定更容易得到可重現的結果。
常見設定概念混淆
訂閱與分享連結：訂閱網址通常用來取得一組連線資料，分享連結則通常描述單一連線。請使用相應的匯入選項，不要只憑連結中是否包含長字串來判斷類型。網址本身可能含有存取憑證，請妥善保管，如同帳號資料。更多資訊請參閱訂閱術語說明。
系統代理與分流：系統代理決定相容的應用程式將流量送往何處；路由規則則決定核心收到流量後如何選擇出口。即使選用直連規則，應用程式仍可能先將要求送至本機監聽；即使啟用了系統代理，也不代表所有應用程式都會遵循。更多資訊請參閱路由與出站標籤。
流量嗅探與 DNS：嗅探可從部分連線辨識網域資訊，協助路由比對，但無法保證每次連線都能取得網域，也不能取代完整的 DNS 設計。網域規則未命中時，應一併檢查入站設定、解析方式與規則順序，而不是反覆切換嗅探選項。更多欄位位置請參閱入站設定說明。
TUN 與連線品質：TUN 會改變應用程式流量進入用戶端的方式，不會自動修復伺服器逾時或協定參數錯誤。若一般代理也無法連線，應先解決基本連線問題，再啟用虛擬網卡接管。在複雜的網路環境中，也要留意其他 VPN 軟體與虛擬網卡對路由的影響。更多資訊請參閱TUN 模式術語說明。
安裝、訂閱與部署文章
從具體選項與錯誤情況著手。以下三篇依發布日期由新至舊排列，分別介紹平台部署、訂閱匯入與核心生態系。
路由器與旁路由部署 Xray 核心概覽：硬體需求、透明代理與分流概念
讓核心直接在路由器或旁路由上執行，家中裝置就不必逐一安裝用戶端。本文概述硬體選擇、透明代理原理、設定檔放置方式與常見問題。
閱讀文章 →V2Ray 訂閱連結匯入教學：v2rayN 與 v2rayNG 的選項位置及常見格式
本文整理桌面端與 Android 端訂閱群組的設定路徑，並說明 Base64 訂閱與 vless://、vmess:// 分享連結的差異及辨識方式。
閱讀文章 →Project V 生態系圖解：V2Fly、Xray 核心與 v2rayN、v2rayNG 的關係
本文整理 Project V 從單一專案發展出 V2Fly、Xray 兩個核心分支的歷程，並說明各圖形介面用戶端使用哪個核心，以及彼此如何分工。
閱讀文章 →