Windows
v2rayN · 桌面版 / 经典 WPF 版
桌面版采用跨平台界面，经典 WPF 版保留熟悉的操作布局。首次安装先确认系统与处理器要求，再选界面分支；不要同时启动两套客户端监听相同的本地端口。
使用系统代理时，浏览器通常会读取系统设置，终端和部分开发工具则可能需要单独指定代理。若退出客户端后网页仍无法访问，检查系统代理是否已清除，而不是反复重装。
前往下载CONFIGURATION / 配置入口
v2rayN 设置与路由分流
先区分订阅、流量入口与出站规则，再调整具体参数。右侧选择配置主题，左侧示意窗同步标出对应位置；示意仅说明设置关系，实际菜单以所用客户端界面为准。
订阅分组维护地址与分组名称
更新当前订阅系统代理应用遵循系统代理设置
自动配置系统代理路由按规则选择出站
绕过大陆TUN 模式虚拟网络接口接管
内核与协议按节点参数选择兼容内核
Xray / V2Fly界面示意，不代表当前连接状态。先完成订阅导入，再验证代理与路由。
订阅地址用于集中获取节点配置，分组则把不同来源分开维护。在 v2rayN 中新增订阅分组，填写名称与地址，保存后更新该分组，再从列表选择活动节点。v2rayNG 也应先建立订阅，再执行更新。更新已有分组与重复新增不是同一步；节点出现重复时，先检查分组来源。订阅链接可能包含访问凭据，不宜发到公开截图或陌生转换网站。图形客户端负责解析配置，链接本身并不代表连接已经成功。
了解更多系统代理决定应用是否把连接交给本地客户端，路由模式决定收到连接后如何选择出站，两者不应混为一谈。桌面端可先选择「自动配置系统代理」，再用浏览器验证；退出客户端前可清除系统代理，避免应用继续指向已经关闭的本地端口。部分终端工具和自带代理设置的应用不读取系统设置，需要单独配置。遇到浏览器能用、命令行失败时，先检查流量入口，而不是立即更换节点或开启全部接管。
了解更多路由分流按域名、目标地址等条件匹配连接，再交给代理、直连或阻断出站。初次配置可从客户端已有规则开始，例如「绕过大陆」，然后根据日志增加少量自定义规则。规则通常自上而下匹配，具体域名例外应放在宽泛规则之前。域名策略与 DNS 解析会影响地址匹配结果，不能只看规则名称判断流量去向。与只切换单一代理开关相比，分流需要同时理解流量入口、匹配条件和出站标签，修改后应逐项验证。
了解更多TUN 模式通过虚拟网络接口处理流量，适合不遵循系统代理的应用，但接管范围仍受路由、权限和应用排除设置影响。建议先确认普通代理连接正常，再开启 TUN，按界面提示授予必要权限。若与其他网络工具同时运行，应检查默认路由、DNS 接管和虚拟网卡是否冲突。开启后不等于所有连接都走代理，分流规则仍可选择直连。排查时先关闭 TUN 对比结果，保留局域网访问，并记录原有网络设置以便恢复。
了解更多客户端提供图形界面，内核执行连接与路由；界面能导入某类链接，不代表当前内核一定支持全部参数。v2rayNG 使用 Xray 内核，v2flyNG 是 V2Fly 内核方向的 Android 备选；v2rayN 的可用能力需要结合所选内核判断。VMess、VLESS、Trojan 是协议名称，REALITY 属于安全层相关配置，不能作为同一层级随意替换。遇到字段不支持或启动失败，先核对节点所需协议、传输与安全层组合，再查看内核输出。
了解更多CLIENTS / 平台选择
四平台客户端下载入口
桌面设备优先查看 v2rayN，Android 优先查看 v2rayNG。安装包应同时匹配操作系统、处理器架构和打包格式；不要把手机节点配置、桌面安装包与内核文件当成同一种文件。
macOS
v2rayN · Apple Silicon / Intel
在系统「关于本机」中确认芯片类型。Apple Silicon 对应 arm64，Intel 对应 x64；下载页将两种入口分开列出。安装后先启动客户端，再按系统提示处理应用运行权限。
系统代理与 TUN 所需权限不同。初次使用先验证系统代理路径，确有应用无法接入时再考虑 TUN。切换有线、无线或其他网络工具后，重新检查代理状态与路由，比重复导入订阅更有针对性。
前往下载Android
v2rayNG 首推 · v2flyNG 备选
v2rayNG 使用 Xray 内核，适合按订阅管理节点；v2flyNG 提供 V2Fly 内核方向的另一种选择。多数较新的设备可先查看 arm64 安装包，架构不明确时再核对通用版说明。
导入后选择节点，启动连接并确认系统 VPN 权限提示。连接图标出现只表示服务已经建立，不代表每个目标都能访问；还需验证节点、DNS 与分流。后台中断时检查电池限制，不要用重复添加订阅代替权限排查。
前往下载Linux
v2rayN · deb / rpm
按发行版的软件包体系选择 deb 或 rpm，再确认 x64 与 arm64 架构。这里介绍图形客户端的日常配置，不把桌面启动方式与系统级后台服务混用，避免重复进程和端口冲突。
桌面环境的代理设置未必会传递给所有应用。终端、包管理工具和浏览器应分别验证；TUN 还涉及网络权限与路由。出现问题时先保留原网络设置，使用系统代理完成基本连接，再逐步扩大流量接管范围。
前往下载查看全部客户端 →系统要求、安装包类型与下载相关问题集中在下载页。
QUICK START / 配置顺序
订阅导入到连接验证
一次只改变一个环节。先让客户端获得可用配置，再决定哪些应用接入，最后检查规则是否符合预期。以下三步适合首次配置，也适合更换设备后重新建立基础环境。
建立订阅分组，更新节点
安装并打开客户端后，先准备已有的订阅地址。v2rayN 从订阅分组设置中新增分组，填写便于识别的名称与地址，保存后执行更新；v2rayNG 从订阅相关菜单添加地址，再更新对应订阅。名称用于本地管理，不能代替完整地址。教学示例 https://example.com/sub?token=xxxx 不是可用订阅，也不需要照着填写。
更新完成后检查节点列表是否出现协议、地址与端口等信息。若列表为空，先看更新结果，核对地址是否完整、是否失效，以及当前网络能否访问订阅地址。不要连续新增同一地址，这只会制造重复分组。若订阅包含个人访问凭据，分享截图前隐藏完整链接；客户端安装与订阅服务是两个独立环节，安装软件不会自动生成可用节点。
选择活动节点，设置流量入口
从已导入列表中选中一个节点，再设置应用如何把流量交给客户端。桌面端可从「自动配置系统代理」开始，Android 端启动连接时按系统提示允许 VPN 服务。随后选择已有路由方案，先理解直连、代理与阻断的区别，不必一开始就同时修改 DNS、自定义规则和 TUN。菜单名称可能随界面分支变化，但「选节点、接入流量、决定出站」的顺序保持一致。
系统代理不是对所有程序的统一接管。浏览器扩展、开发工具的独立代理设置、终端环境变量，都可能覆盖或绕过系统设置。若只有某个应用失败，先检查该应用的入口。确实需要处理不遵循系统代理的程序时，再阅读 TUN 章节并检查权限。全局路由与 TUN 也不是同义词：前者影响出站选择，后者主要解决流量如何进入客户端。
验证访问结果，按日志定位
启动后打开需要访问的目标，结合客户端连接记录确认是否出现相应请求。再访问一个预期直连的目标，检查路由结果；涉及局域网设备时，也应验证本地地址仍可访问。连接成功、订阅更新成功、目标网页可用是三个不同结果，不能互相代替。一次测试尽量保持节点和规则不变，避免多个变量同时改变而失去判断依据。
若失败，按顺序检查内核是否启动、本地监听端口是否可用、请求是否进入客户端、最后命中了哪个出站。超时可能出现在远端连接，域名解析失败则应优先看 DNS，内核立即退出应先读启动输出。记录必要的错误信息时隐藏订阅、认证字段和个人地址。完成验证后再逐项添加分流例外，并保存一份可恢复的配置，后续更新也能沿用相同排查顺序。
PROJECT V / 开源生态
Project V、V2Fly 与 Xray
图形客户端、连接内核、节点协议分属不同层。理解三者关系，才能判断需要更新的是界面、内核还是远端配置。
生态关系 · 非运行状态
Project V
V2FlyXray
开源网络工具生态
v2rayNv2rayNGv2flyNG
客户端管理配置，内核执行连接。支持范围以实际选用的内核和参数组合为准。
查看项目介绍 →生态背景与内核分支
Project V 是围绕网络代理工具与相关组件形成的开源生态，V2Ray 是其中广为使用的核心项目。V2Fly 延续 V2Ray 方向的社区维护，Xray 则是在相关代码基础上发展出的另一条内核路线。它们共享部分概念和配置习惯，但各自支持的功能与参数并不完全相同。阅读旧教程时，需要先判断文章讨论的是哪一种内核，不能仅凭「V2Ray」这个统称套用所有配置。
节点能否使用，取决于客户端是否能正确生成配置、内核是否理解这些字段，以及远端服务是否按同样的协议组合运行。导入链接成功只验证了解析环节的一部分。遇到 REALITY、安全层或传输配置相关错误时，先核对内核支持与远端参数；盲目切换界面主题、重复刷新订阅，通常无法修复协议层的不匹配。
三款图形客户端的分工
v2rayN 面向桌面使用场景，负责节点列表、订阅分组、系统代理与路由等管理工作，桌面设备可优先从它开始。v2rayNG 面向 Android，采用 Xray 内核，提供节点导入与连接管理；v2flyNG 同样面向 Android，是 V2Fly 内核方向的备选。选择时以设备和节点需求为依据，而不是把三款应用当作必须同时安装的组件。
客户端名称相近，不代表菜单、权限和备份格式完全相同。迁移设备时，先确认订阅来源仍可用，再重新建立客户端设置；路由例外、应用排除和 DNS 选项需要单独复核。桌面端与 Android 的流量入口也不同，不能把系统代理的操作路径直接照搬到手机。这里将下载选择与配置教程分开，便于在同一条操作链上找到对应说明。
开源协议与服务边界
v2rayN、v2rayNG 和 v2flyNG 都属于开源客户端，公开代码便于社区审阅、讨论与持续改进。开源协议规定代码使用、修改及分发的条件；不同项目与所包含组件可能采用不同许可证，二次分发时应分别阅读相关声明。开源属性是软件协作方式，不代表任何节点服务的质量或数据处理方式，也不能替代对订阅来源的判断。
客户端负责本地配置与连接，订阅来源负责提供节点参数，远端服务负责实际转发。三者的维护主体和更新节奏可能不同。分享问题时，应区分「软件无法启动」「订阅无法更新」与「某个节点无法连接」，这样才能定位责任环节。本站提供选择与配置文档，不提供订阅地址；阅读教程时请使用已有且有权使用的配置，并遵守所在地适用规定。
更新机制与日常维护
订阅更新改变的是分组中的节点配置，客户端更新改变的是界面与集成功能，内核更新则可能涉及协议能力和配置字段。三种更新不应混为一次操作。日常先保存可恢复的设置，再查看更新说明，确认所用内核、路由资源和现有节点是否兼容。重要配置变更后，重新完成「请求进入客户端、命中预期规则、目标实际可达」这三个检查。
长期使用时，定期清理失效分组与重复节点，并保留自定义规则的用途说明。定位故障可临时提高日志详细程度，但不应把包含访问目标或凭据的日志直接公开。若更新后出现异常，先对照启动输出和配置差异，避免同时调整多个网络选项。基础概念、安装、订阅、分流、TUN 与维护的连续步骤，可在完整手册中按章节阅读。
阅读从零到精通完整手册 →READING / 配置与排查
路由规则与运行日志
完成基础连接后，再按实际问题深入阅读。下面三篇依次覆盖自定义规则、系统代理入口与日志定位，适合把「能连接」推进到「能解释每一次连接的去向」。
V2Ray 自定义路由规则写法：domain、ip、geosite 匹配语法与生效优先级
讲清 domain 的 full/domain/keyword/regexp 前缀、ip 与 geoip 写法、geosite 分类引用，以及规则自上而下匹配的顺序和 domainStrategy 的影响。
阅读规则语法 →v2rayN 系统代理不生效：浏览器绕过代理与终端命令行变量分别排查
系统代理已开启但网页或命令行仍直连？分浏览器扩展与系统设置、终端 http_proxy 环境变量两条线排查，附各平台查看当前代理状态的方法。
检查代理入口 →V2Ray 运行日志怎么看：access 与 error 日志常见报错含义对照
解释 loglevel 各级别的用途，逐条拆解连接超时、握手失败、DNS 解析失败等常见日志行的含义，并给出从日志反推问题环节的定位方法。
查看日志说明 →