桌面平台
Windows
Windows 用户使用 v2rayN，可在新一代跨平台桌面界面与经典 WPF 操作结构之间选择。下载页分别说明两种版本的适用条件、首次启动位置、系统代理入口和常见运行依赖。已有使用习惯的用户可沿用经典界面，新安装用户可先查看桌面版说明后再决定。
PLATFORMS Windows · macOS · Android · Linux
CLIENTS v2rayN · v2rayNG · v2flyNG
CORES Xray · V2Fly
LICENSE 开源软件生态
按操作系统选择
四个平台的客户端入口
首页只负责平台分流。安装包类型、系统架构与客户端差异统一放在客户端页说明，避免在未确认设备条件前选择错误的软件包。
桌面平台
macOS
macOS 对应 v2rayN 桌面客户端，安装前需要确认处理器架构。Apple Silicon 与 Intel 使用不同安装包，不能只按系统名称判断。客户端页给出芯片查看路径、安装包选择规则、首次运行授权说明，以及系统代理启用后的基本检查方法。
移动平台
Android
Android 可按内核家族选择 v2rayNG 或 v2flyNG。v2rayNG 使用 Xray 内核，适合需要 Xray 相关协议与传输能力的配置；v2flyNG 使用 V2Fly 内核，可用于已有 V2Fly 配置体系。多数近年设备优先查看 arm64 包，无法确认架构时再参考通用版说明。
桌面平台
Linux
Linux 桌面端使用 v2rayN，根据发行版选择 deb 或 rpm 软件包，并进一步确认 x64 与 arm64 架构。安装完成后需要分别检查客户端进程、桌面环境代理设置与应用程序是否读取系统代理。平台页把软件包选择和运行检查拆成连续步骤。
客户端配置路径
从订阅导入到路由生效
四组设置对应实际使用中的不同阶段。选择标签可查看设置目标、操作顺序和界面片段。
规则优先级
路由预设与自定义分流
路由设置决定不同连接交给哪个出口处理。新用户可先从客户端预设规则开始，例如选择“绕过大陆”后保存，再回到主界面确认当前路由模式。需要精细控制时，可继续按 domain、ip、geosite 与 geoip 条件添加规则，并注意规则通常按照界面中的排列顺序匹配。
这一层与系统代理不是同一个开关：系统代理负责让应用把连接交给客户端，路由规则负责客户端收到连接后的处理方向。分开理解两者，可以避免只切换路由却发现浏览器没有进入代理流程，或者系统代理已启用但特定域名仍按旧规则处理的问题。
查看协议与路由参考 →路由设置预设规则
绕过大陆当前选择
全局代理可选
全局直连可选
自定义规则编辑
配置管理
订阅分组与更新范围
订阅地址应放入独立分组，而不是直接当作单个服务器地址添加。分组负责保存备注、更新地址和自动更新间隔，执行更新后，客户端才会解析其中可识别的配置并写入对应列表。多个来源分别建组，后续停用、更新或排查时更容易确认配置来自哪里。
更新后列表为空时，先检查当前显示的分组，再确认地址是否完整、更新操作是否成功，以及订阅内容是否属于客户端能够识别的格式。不要在同一步骤中反复修改协议、路由与系统代理；先让分组正确出现配置，再继续选择服务器与连接模式，定位会更直接。
查看订阅导入步骤 →订阅分组编辑基础设置
更新订阅（不通过代理）
连接接管
系统代理与应用生效范围
选择服务器并不等于桌面应用已经使用该连接。桌面端通常还要将系统代理切换为“自动配置系统代理”，使读取系统代理设置的浏览器和应用把请求交给客户端。切换后应重新打开需要检查的应用，并确认应用自身没有固定使用另一套代理参数。
部分程序不读取系统代理，处理这类程序时应先查看其网络设置，而不是不断更换服务器。连接检查也应按层次进行：先确认客户端已启动并选中有效配置，再确认系统代理状态，然后检查目标应用是否继承系统设置。这样的顺序比同时改动多个开关更容易找到问题所在。
查看连接故障排查 →系统代理设置项
清除系统代理
自动配置系统代理
不改变系统代理
当前选择会影响读取系统代理的桌面应用。
兼容关系
Xray 与 V2Fly 内核选择
客户端是图形操作层，内核负责协议解析、传输建立和路由执行。v2rayNG 采用 Xray 内核，v2flyNG 对应 V2Fly 内核；桌面端 v2rayN 的设置界面会明确显示当前 Core 类型。导入配置前先确认协议与内核能力，能够减少配置字段存在但运行时无法按预期处理的情况。
VMess、VLESS、Trojan、Shadowsocks 与 REALITY 涉及不同的协议或传输组合，不能只比较名称。实际选择还要同时看服务端配置、客户端版本、内核家族和订阅格式。协议参考页按认证方式、资源开销、移动端表现与配置兼容性拆解这些差异，适合在添加服务器类型前查阅。
查看内核与协议对比 →Core 类型内核设置
Xray已选择
V2Fly按配置选择
内核、协议类型与服务端参数需要保持兼容。
快速上手
订阅、模式、连接三步检查
首次配置按照固定顺序推进。每完成一步再进入下一步，可以把订阅内容、客户端状态和应用接管范围分别确认。
-
01
添加订阅分组并执行更新
打开客户端的订阅分组管理，新增分组后填写便于识别的备注与完整订阅地址。保存后执行更新订阅，等待客户端完成解析，再回到服务器列表查看该分组下是否出现可用配置。若列表为空，先检查当前分组筛选、地址复制范围和更新提示，不要立刻改动路由或系统代理。
订阅是一组配置的分发形式，不等同于客户端，也不等同于某个协议。客户端只会读取自身支持的字段与协议组合。多个订阅来源建议分别建立分组，并采用清晰备注；这样更新后出现差异时，可以直接限定到单个来源排查，而不必在混合列表中逐项辨认。
-
02
选择服务器与路由模式
服务器列表出现配置后，先选中需要使用的一项，再打开路由设置确认处理模式。一般场景可以从预设规则开始，理解连接路径后再添加自定义 domain、ip、geosite 或 geoip 条件。规则排列会影响匹配结果，新增规则时应记录用途，并避免同时建立相互覆盖的宽泛条件。
协议类型必须与配置内容一致。手动添加服务器时，应按实际配置选择 VMess、VLESS、Trojan 或 Shadowsocks 等入口，并逐项填写地址、端口、认证信息和传输参数。订阅导入通常会携带这些字段，除非已经明确字段含义，否则不建议为了尝试而随意改写传输层选项。
-
03
启用系统代理并验证应用
桌面客户端选中配置后，将系统代理设为自动配置系统代理，再重新打开用于验证的浏览器或应用。Android 客户端则需要在系统连接确认界面完成授权，并保持客户端处于连接状态。验证重点不是界面按钮的颜色，而是目标应用是否确实读取了当前连接路径。
遇到无法连接时，按“订阅是否更新—配置是否选中—内核是否兼容—系统代理是否生效—应用是否读取系统设置”的顺序逐层检查。日志适合用于确认协议握手、域名解析和路由匹配阶段的问题，但应先完成前面的基础检查。一次只改变一个变量，才能判断调整是否真正产生作用。
开源生态
Project V、V2Fly 与 Xray
客户端、内核、协议和订阅分别承担不同职责。明确这些层次，比只记住软件名称更有助于选型和排查。
从 Project V 到两个内核家族
Project V 形成了以代理协议、传输方式、路由规则和配置结构为核心的开源技术生态。早期用户常把 V2Ray 同时用于指代项目、内核和整套工具，但在实际使用中，这几个概念需要分开：图形客户端负责配置管理与系统集成，内核负责处理连接，协议定义通信方式，订阅则用于分发一组配置。
V2Fly 延续 V2Ray 的社区维护路线，保留了广泛使用的配置模型和协议能力。Xray 在相近配置体系上发展出独立内核家族，并扩展了 VLESS、REALITY 等相关能力。两者有较多共同概念，但并不意味着每个字段、传输组合或新功能都可以直接互换。客户端显示的 Core 类型，是判断配置兼容关系的重要信息。
配置选型应从服务端提供的实际参数开始，而不是先决定某个名称。若订阅给出 VLESS 与 REALITY 组合，需要使用能够识别对应字段的内核和客户端；若现有配置体系以 V2Fly 为基础，则应确认订阅格式和协议字段是否属于该内核支持范围。协议参考页进一步比较认证设计、连接建立、资源占用和移动端使用条件。
桌面客户端
v2rayN
v2rayN 提供服务器列表、订阅分组、路由设置、系统代理和日志等图形化入口，覆盖 Windows、macOS 与 Linux 桌面平台。桌面端安装包会按操作系统、处理器架构和界面类型区分，下载前需要先确认设备条件。
Android · Xray
v2rayNG
v2rayNG 是采用 Xray 内核的 Android 图形客户端，适合导入包含 Xray 生态协议与传输字段的配置。订阅、路由和连接开关均在移动端界面内管理，安装包选择还需考虑设备架构。
Android · V2Fly
v2flyNG
v2flyNG 面向 V2Fly 内核配置体系，作为 Android 端的另一种内核家族选择。与 v2rayNG 的主要差异不在界面颜色，而在底层内核、协议能力和配置兼容范围。
开源协议与代码审阅
三款客户端及其相关内核属于开源软件生态，软件行为、配置结构和功能变更可以通过公开的项目资料与社区文档持续审阅。开源属性提供的是可检查、可讨论和可复现的工程基础，不等同于替用户完成配置判断。使用者仍需确认下载平台、内核类型、订阅来源与服务端参数是否匹配。
更新机制与配置迁移
客户端更新通常包含界面调整、内核适配、协议能力变化和问题修复。跨较大更新范围迁移时，应先记录订阅分组、路由规则与系统代理模式，再阅读下载页和相关技术笔记。订阅地址可以重新导入，但本地自定义规则、手动服务器和应用级网络设置需要分别确认。
文档与软件职责边界
Xray内核站围绕客户端选择和图形界面操作整理资料：下载页处理平台与软件包选择，使用指南处理订阅到连接的操作顺序，协议参考处理内核与协议兼容关系，帮助中心集中回答安装、配置和故障问题。文档不替代客户端项目自身的功能说明，遇到差异时应以实际界面和当前配置字段为准。
技术笔记
平台部署、路由规则与客户端选型
文章围绕具体设置项展开，补充使用指南中不适合展开的发行版差异、规则组合和客户端横向比较。
v2rayN 国内外分流实战：预设规则、白名单与黑名单模式怎么配
从 v2rayN 路由设置面板出发，解释“绕过大陆”等预设规则的实际处理范围，对比白名单与黑名单两种分流思路，并给出规则组合、优先级检查和应用验证路径。
阅读文章 →v2rayN Linux 桌面安装：deb/rpm 包安装与开机自启动配置
面向 Ubuntu、Debian 与 Fedora 桌面用户，梳理 deb、rpm 软件包选择，说明系统依赖、用户级自启动和桌面环境系统代理的检查顺序。
阅读文章 →v2rayN、v2rayNG、v2flyNG 怎么选：三款客户端功能与内核差异对比
按平台覆盖、内核家族、协议支持、订阅管理和路由能力比较三款客户端，说明桌面端选择 v2rayN，以及 Android 端按 Xray 或 V2Fly 配置体系取舍的方法。
阅读文章 →