Windows
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版保留经典桌面交互；已有使用习惯时，可先阅读两种界面的说明，再决定安装哪一种。
首次运行后，先确认内核能够启动，再导入配置。若本地监听端口已被其他应用占用，应修改端口并同步应用代理设置，而不是反复重装。两个界面入口不意味着需要同时运行两份客户端。
前往下载v2rayN · 配置导入示意
分享链接
vmess:// · vless://其他协议
trojan:// · ss://导入方式从剪贴板导入批量 URL
导入后检查传输类型 / TLS / SNI
分享链接包含参数；订阅地址用于获取配置集合。
v2rayN 可从剪贴板批量导入分享链接，v2rayNG 也提供剪贴板与二维码入口。导入后先核对协议、地址、端口和传输类型，再检查 TLS、SNI 等字段。VMess、VLESS、Trojan 与 Shadowsocks 的字段并不通用，不能只改协议名称复用配置。不同客户端对新传输选项的支持取决于所带内核；出现无法识别的参数时，应查看兼容说明，而不是删除字段强行保存。订阅地址则应放入订阅分组，再执行更新。
v2rayN · 路由设置示意
域名策略
IPIfNonMatch广告域名
geosite:category-ads-all → block本地网络
geoip:private → direct匹配方式按规则顺序选择出站
规则顺序与规则库内容共同决定匹配结果。
路由分流让不同目标使用直连、代理或阻断出站。v2rayN 的路由设置可按域名、IP 与端口组织规则；使用 geosite、geoip 条目时，需要对应规则数据。通常先放明确的例外项，再放范围更大的规则，避免前面的宽泛匹配遮住后续设置。域名策略决定何时解析域名，并不等同于 DNS 服务器地址。v2rayNG 的预设路由与自定义规则入口有所不同，迁移配置时应检查实际生成的规则，不能仅凭模式名称判断两端行为一致。
v2rayN · 流量接入示意
系统代理自动配置系统代理
本地 SOCKS
127.0.0.1:10808本地 HTTP
127.0.0.1:10809TUN 模式检查权限与虚拟网卡组件
系统代理适用于遵循系统设置的应用，TUN 接入范围不同。
系统代理会修改操作系统的代理设置，但应用是否使用该入口，仍取决于应用自身。v2rayN 的 TUN 模式通过虚拟网络接口接入流量，具体能力由平台、权限及配套组件决定，并非简单的全局代理开关。建议先用系统代理验证基础连接，再按需要启用 TUN，避免同时修改路由与 DNS 后难以定位问题。Android 上 v2rayNG 通常通过系统 VPN 授权接入；这与桌面 TUN 的菜单、权限和分应用设置不同，不应逐项照搬。
v2rayN · 订阅分组示意
分组备注按配置来源命名
订阅地址填写已有订阅 URL
更新操作更新当前订阅
本地配置与订阅分组分开保存
更新前区分订阅配置与手动保存的配置。
订阅分组用于区分配置来源，也便于单独更新与筛选。v2rayN 可在订阅分组设置中填写地址和备注；更新后，需要重新确认当前活动配置是否仍然有效。订阅内容由地址提供方决定，更新可能替换组内条目，因此长期修改的配置宜另存为本地条目。v2rayNG、v2flyNG 的分组界面与支持的订阅格式可能不同，导入前应确认内容是逐行分享链接还是原生 JSON。订阅地址可能包含访问凭据，不宜出现在截图、公开日志或在线转换工具中。
v2rayN · 内核选择示意
Core 类型
Xray / v2fly选择依据协议与传输功能支持
移动端 Xray
v2rayNG移动端 V2Fly
v2flyNG界面负责管理，内核负责执行配置与建立连接。
图形客户端与代理内核是两层组件。v2rayN 的可选 Core 类型取决于当前发行包和协议支持，切换前应确认目标内核能够理解完整配置。Xray 与 V2Fly 有共同的技术来源，但后续功能与配置字段各自发展，不能视为完全互换。Android 上，v2rayNG 侧重 Xray 生态，v2flyNG 可作为 V2Fly 内核的备选入口。涉及 REALITY 等特性时，应以客户端实际集成的内核能力为准；已有配置能够稳定工作时，也不必仅因内核名称不同而迁移。
DOWNLOAD BY PLATFORM
V2Ray 下载
按系统选择客户端
桌面使用 v2rayN；Android 优先查看 v2rayNG，也可按内核需求选择 v2flyNG。安装格式与处理器架构在下载页集中列出。
macOS
v2rayN 按 Apple Silicon 与 Intel 提供不同安装入口。在系统的“关于本机”中查看芯片或处理器信息，再选择对应架构，避免依赖文件名中的陌生缩写判断。
安装后先确认应用可以正常打开，再授权所需的网络设置。系统代理与 TUN 的接入机制不同，是否需要额外权限也不同；遇到浏览器可用、其他应用不可用时，应先检查该应用是否遵循系统代理。
前往下载Android
v2rayNG 使用 Xray 内核，v2flyNG 是 V2Fly 内核备选。多数较新的手机适合 arm64；不确定设备架构时，可查看设备信息或选择通用包，并以安装页的系统要求为准。
连接时需要确认系统 VPN 授权。若切到后台后连接中断，应检查电池优化、后台活动与厂商省电策略；分应用代理则用于控制哪些应用进入代理通道，设置后需重新连接并验证实际效果。
前往下载Linux
v2rayN 提供 deb 与 rpm 格式，并区分 x64、arm64 架构。安装格式由发行版的软件包体系决定，处理器架构则应通过系统信息确认；两者需要同时匹配。
图形桌面的系统代理不一定覆盖终端程序。需要为特定应用配置代理时，应核对本地监听地址与端口；使用 TUN 前，先阅读当前发行包对权限及组件的要求。出现问题时，从内核日志与端口占用开始排查。
前往下载
查看全部客户端 →
下载页提供当前安装入口与系统要求；首页不固定展示发行版本，避免将旧信息带入安装决策。
QUICK START
v2rayN 配置教程
先完成一条连接
客户端负责读取与执行配置。安装完成并不代表已经具备可用连接，还需要有效的分享链接、订阅地址或完整配置。先验证最小流程，再添加分流与自动化设置。
-
导入分享链接或订阅
复制完整的分享链接，在 v2rayN 中选择从剪贴板导入；如果持有的是订阅地址，则进入订阅分组设置，填写地址与备注，再执行更新。两种入口不能混用：订阅地址返回的是配置集合，分享链接描述的是单条配置。导入成功后，检查协议、服务器地址、端口、传输类型与 TLS 相关选项，不要仅凭列表中出现一条记录就判断配置完整。
v2rayNG 的对应入口通常位于添加配置或订阅设置中。先确认复制内容未夹带说明文字和换行截断，二维码导入后也应打开编辑页复核字段。分享链接与订阅地址可能含有连接凭据，排查时只展示必要字段，并隐藏敏感内容。
-
选择配置与流量接入方式
将准备使用的配置设为活动配置，再启动连接。桌面端可先选择自动配置系统代理，并使用遵循系统代理的浏览器测试；Android 端按提示允许建立 VPN 连接。路由规则决定流量去往哪个出站，系统代理或 TUN 决定流量如何进入客户端，二者不是同一层设置。
初次测试时尽量保留默认的基础设置，不要同时启用多个代理程序。确实需要 TUN、分应用代理或自定义 DNS 时，每次只改一类选项并记录结果。这样可以区分配置本身的问题与流量接入问题，也便于在失败后恢复到已知可用的状态。
-
验证访问并查看日志
打开需要使用代理的目标应用，确认页面或服务可以实际访问，同时观察客户端日志。列表中的测试结果只反映特定测试方式，不等于所有应用均能连接；浏览器成功也不能证明终端或其他程序已使用相同代理。应分别验证日常需要使用的应用。
遇到 TLS 握手错误，优先检查设备时间、SNI 与证书相关设置；出现解析失败，先核对 DNS 和路由策略；完全没有连接日志，则检查系统代理、本地端口以及应用自己的代理选项。保持证书验证开启，不要把跳过验证作为长期解决方法。详细步骤与对应判断路径见完整教程。
PROJECT V ECOSYSTEM
Project V 生态
客户端与内核的关系
先区分界面、内核与协议，再比较功能。客户端名称相近，不代表配置可以原样互换；选型应落到实际使用的协议、传输方式和系统环境。
TECHNICAL ORIGIN
Project V · V2Ray
协议、传输、路由与出站的模块化思路
V2Fly
延续 V2Ray 核心的社区维护。v2flyNG 提供 Android 图形入口；v2rayN 的可选内核以实际发行包与功能支持为准。
Xray
从共同技术基础发展出独立功能与配置能力。v2rayNG 使用 Xray 内核；涉及 REALITY 等特性时需核对内核支持。
从 Project V 到图形客户端
Project V 的技术体系将入站、路由与出站分开组织。V2Ray 核心负责接受本地流量、执行规则并与远端建立连接；图形客户端则把配置编辑、订阅管理、日志查看和系统集成放到可操作的界面中。因此，用户下载的 v2rayN 或 v2rayNG，不只是一个协议名称，也是一套围绕内核的管理工具。
排查时也应按这两层划分：界面能正常打开，不代表内核已启动；内核启动成功，也不代表目标应用已经把流量交给它。先查看日志是否存在启动错误，再检查代理接入与活动配置，比反复切换协议更容易找到原因。本站的术语手册将这些概念分别解释，适合在遇到陌生字段时查阅。
V2Fly 与 Xray 的兼容边界
V2Fly 与 Xray 有共同的历史来源，也共享部分协议和配置思路，但两者沿各自方向维护。协议支持、传输选项、DNS 行为及新增字段可能存在差异。不能仅因同样使用 JSON，便认定一份原生配置可以跨内核直接使用；图形客户端对导入参数的转换，也受自身实现限制。
VMess、VLESS、Trojan 与 Shadowsocks 是协议层面的选择；TLS、REALITY 及具体传输方式又涉及其他层次。REALITY 不是可以随意替换 VMess 的独立代理协议，通常需要与相应协议和支持它的内核组合。服务端提供了什么配置，客户端就需要匹配什么能力，选型时不宜只按名称新旧判断。
三款客户端的开源属性
v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端，源代码与许可证构成其协作和使用的基础。v2rayN 面向桌面使用，强调配置管理与系统集成；v2rayNG 在 Android 上衔接 Xray 内核与系统 VPN 接口；v2flyNG 为希望使用 V2Fly 内核的 Android 用户提供另一种入口。
开源不意味着三款客户端功能完全相同，也不意味着某一款可以读取另一款的全部本地数据。迁移时优先使用双方都支持的分享链接或订阅格式，随后重新检查路由、DNS、分应用代理和后台权限。涉及再分发或修改时，应分别阅读客户端及所含组件的许可证，不能把整个生态视为同一种授权。
更新时分开检查三类变化
客户端界面、内核与规则数据可以分别变化。界面更新可能调整菜单位置和导入逻辑；内核更新可能新增协议能力或改变配置要求；geosite、geoip 等规则数据变化，则可能影响同一条规则的匹配范围。出现更新前后行为不同时，先确认变化发生在哪一层，再决定是否修改配置。
更新前保留必要的本地配置和自定义规则，阅读发行说明中的系统要求与兼容提示。订阅更新只更新配置来源提供的内容，不等于客户端或内核已经更新。对能够稳定工作的配置，应有目的地维护，而不是同时替换客户端、内核、订阅和路由后再追查原因。更完整的协议比较见协议与内核技术参考。
CONFIGURATION NOTES
V2Ray 配置文章
订阅、DNS 与 TLS
从具体报错和设置问题进入。文章区分协议字段、客户端选项与系统行为，避免用一个开关解释所有连接故障。
V2Ray 订阅链接格式详解：Base64 订阅、原生 JSON 与分享链接互相转换
科普常见订阅格式的结构与适用客户端，说明 Base64 订阅如何解码成逐行分享链接、分享链接与原生 JSON 配置怎样对应，以及导入失败的格式原因。
阅读文章 →V2Ray DNS 泄漏检测方法与 v2rayN 防泄漏配置步骤
介绍 DNS 泄漏的成因与检测思路，逐步配置 v2rayN 的远程 DNS、域名策略与 TUN 模式，并给出 v2rayNG 端对应设置的检查清单。
阅读文章 →V2Ray TLS 握手失败排查：系统时间偏差、SNI 填写与 allowInsecure 误区
梳理 TLS 与证书类报错的常见来源：设备时间不同步、SNI 与伪装域名不一致、指纹设置不匹配，并说明为什么不建议长期开启跳过证书验证。
阅读文章 →