DESKTOP / WINDOWS
Windows
选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，WPF 版适合延续传统操作路径；两者都可管理订阅、系统代理、路由规则和内核配置。
前往下载// PLATFORM DOWNLOADS
按设备选择图形客户端
桌面设备以 v2rayN 为主，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。平台入口会直接定位到对应下载标签。
DESKTOP / MACOS
macOS
使用 v2rayN 的桌面端构建。下载前先在系统信息中确认 Apple Silicon 或 Intel 处理器类型，安装后再根据网络使用范围决定是否启用系统代理。
前往下载MOBILE / ANDROID
Android
优先选择使用 Xray 内核的 v2rayNG；需要 V2Fly 内核时可选 v2flyNG。多数近年设备适合 arm64 构建，无法确认架构时再考虑通用构建。
前往下载DESKTOP / LINUX
Linux
v2rayN 提供适配常见软件包体系的桌面构建。先确认发行版采用 deb 或 rpm，再区分 x64 与 arm64 架构；安装后可在图形界面管理订阅和路由。
前往下载// CLIENT WORKFLOW
从订阅导入到规则生效，按配置链路处理
图形客户端只是操作入口。连接能否按预期工作，取决于订阅内容、活动配置、系统代理、路由规则和 DNS 设置是否形成完整链路。
STEP 01 / IMPORT
导入并更新订阅
在订阅分组中添加地址，主动更新一次并确认配置列表已出现。导入失败时先检查链接格式、复制完整性和网络可达性。
STEP 02 / ACTIVATE
选中活动配置
导入成功不等于已经启用。桌面端需把目标配置设为活动项，Android 端需选中配置并启动连接，再检查状态提示。
STEP 03 / ROUTE
确定代理与分流范围
先选择适合日常使用的路由模式，再根据域名、IP 和 geosite 条目补充规则，避免一开始堆叠大量难以验证的自定义条件。
// SUBSCRIPTION GROUP
订阅地址、分组与更新是三件事
订阅地址负责提供配置集合，分组负责整理不同来源，更新操作才会把远端内容写入客户端。常见问题是只保存了地址却没有执行更新，或者更新后仍停留在旧的活动配置。较稳妥的做法是为不同来源建立独立分组，更新后检查新增、删除和重命名的配置，再手动选定当前使用项。与直接编辑长配置相比，图形客户端把来源、更新时间和活动项分开显示，后续定位问题更清楚。
订阅分组
日常配置更新方式
手动更新活动配置
已选择// SYSTEM PROXY
客户端连接与系统流量入口分别确认
客户端显示运行中，只代表本地内核已经启动；浏览器和其他软件是否使用该连接，还取决于系统代理或应用自身代理设置。桌面端建议先记录本地 HTTP、SOCKS 监听端口，再启用系统代理并用浏览器验证。若只有部分程序无法访问，应检查这些程序是否忽略系统设置、是否固定使用其他端口。图形界面的价值在于把内核状态、端口和系统代理开关放在同一条检查路径中。
系统代理
已启用本地监听
HTTP / SOCKS应用范围
跟随系统// ROUTING POLICY
先用预设模式，再补充最小规则集
路由规则决定一条请求进入直连、代理还是拦截出口。规则可以匹配域名、IP、geosite 与 geoip 数据，但条件越多，优先级越难判断。首次配置应先选用客户端提供的常用模式，确认基础连接正常，再添加少量可解释的自定义规则。每次修改后都应验证目标域名和本地网络访问，不要同时改动 DNS、内核与路由。相比只提供单一开关的工具，V2Ray 生态客户端能把匹配对象和出口动作明确拆开。
ip:private
directgeosite:cn
directcategory-ads-all
block// TROUBLESHOOTING
按层排查，避免反复重装客户端
连接问题通常可以分为订阅未更新、活动配置未选中、本地端口冲突、系统代理未接管、路由误匹配和 DNS 解析异常。排查时先看客户端日志中的启动结果，再确认本地监听端口，随后检查系统代理和目标请求的路由动作。移动端还应确认连接权限与后台运行状态。重装只会恢复程序文件，无法自动修正错误订阅或规则，因此应先保留现场信息并逐层缩小范围。
内核启动
先检查端口监听
再确认路由与 DNS
最后定位// ROUTING RULES
V2Ray 路由规则：匹配对象与出口动作分开看
路由配置不是一张简单的域名清单。客户端会按照规则顺序检查域名、IP、端口或协议条件，命中后再交给指定出口。直连适合本地网络和明确不需要代理的目标，代理出口处理需要转发的流量，拦截出口则用于明确拒绝的类别。理解这三个动作后，再阅读规则文本会更直观。
自定义时建议一条规则只解决一个问题，并记录它位于预设规则之前还是之后。若同一目标同时命中多条条件，顺序往往比规则数量更重要。可继续阅读domain、ip、geosite 写法与匹配优先级，再决定是否覆盖客户端预设。
局域网地址
ip:private → direct大陆常用域名
geosite:cn → direct广告类别
category-ads-all → block其余请求
final → proxy// PROTOCOL CHOICE
协议类型、传输方式与安全层不要混为一项
VMess、VLESS、Trojan 和 Shadowsocks 描述的是不同协议方案；TCP、WebSocket、gRPC 等属于传输层选择；TLS、REALITY 等配置又承担不同的握手与安全职责。订阅通常已经给出完整组合，初次使用时不应随意拆改其中某一项，否则容易出现地址可达但握手失败的情况。
客户端中的“协议类型”只是配置入口之一。真正排查时还要核对服务器地址、端口、用户标识、传输参数、服务端名称和时间设置。需要理解各方案的设计取舍，可查看协议与内核技术参考，按兼容性、资源占用和使用场景选择，而不是只比较名称。
协议
VLESS传输
TCP安全层
REALITY内核支持
Xray// DNS SETTINGS
DNS 配置要与路由目标保持一致
域名请求先经过解析，再由路由规则判断出口。若解析结果与预期出口不一致，可能出现域名规则生效但实际连接走向异常、某些网站只能偶尔打开，或系统与客户端得到不同结果。排查时应区分系统 DNS、客户端内置 DNS 和远端解析，不要在尚未确认基础连接前同时启用多套复杂策略。
较清晰的检查方法是先使用客户端默认 DNS 完成连接验证，再观察目标域名由哪一层解析、结果是否进入预期规则。若怀疑存在解析路径问题，可参考DNS 泄漏检测与配置实操，修改后重新测试，而不是仅凭页面能否打开判断。
系统解析
基础网络客户端 DNS
按规则处理域名策略
匹配路由修改后
重新验证// OPEN SOURCE ECOSYSTEM
Project V、V2Fly 与 Xray 的家族关系
图形客户端、代理内核和协议配置属于不同层级。把这些名称放回各自位置，选型和排查都会更准确。
Project V：协议工具与配置体系的起点
Project V 形成了以配置驱动为核心的代理工具体系。其重要影响不只是某一个可执行程序，而是建立了入站、出站、路由、传输和 DNS 等模块化概念。用户在图形客户端里看到的协议类型、路由出口、规则对象与日志选项，大多是在操作这些底层能力。图形界面降低了编辑结构化配置的门槛，但配置含义仍由内核决定。
因此，遇到功能差异时要先判断问题属于客户端界面还是内核支持。按钮位置变化属于客户端层，某种协议或传输是否可用则主要取决于内核及配置格式。将两层混在一起，容易把“界面里没有入口”误判成“内核不支持”，也可能把订阅字段缺失误判为程序故障。
V2Fly：延续 V2Ray 配置与社区维护路线
V2Fly 延续 V2Ray 核心的社区维护方向，保留模块化配置结构，并持续处理协议实现、传输组件、路由数据和兼容性问题。它适合需要 V2Ray 传统配置语义、关注通用兼容和现有配置迁移的场景。Android 端的 v2flyNG 以 V2Fly 内核为主要选择，让移动端用户可以在熟悉的图形入口中使用这一内核家族。
内核升级可能带来字段校验、默认行为或资源文件变化。图形客户端通常会跟进适配，但订阅提供方和客户端更新节奏未必完全一致。遇到升级后无法使用时，应先查看错误指向哪个配置字段，再判断是旧配置兼容、客户端生成逻辑还是内核行为变化，不宜直接替换全部设置。
Xray：扩展协议能力与独立演进
Xray 从相近的配置基础发展出独立内核路线，常见于 VLESS、XTLS 与 REALITY 等配置场景。v2rayN 和 v2rayNG 都能围绕 Xray 提供图形化管理，使订阅、内核启动、系统代理与路由设置在同一界面完成。Xray 与 V2Fly 的部分配置结构相似，但不能据此假设所有字段、协议组合和默认值都能直接互换。
选择内核时，优先依据订阅配置明确要求和客户端支持范围。若配置包含某个内核特有能力，应保持客户端、内核和规则资源之间的对应关系；若只是常规协议使用，则更应关注稳定运行、平台适配和配置可读性。详细差异可在协议详解中按协议、资源占用和兼容性继续比较。
开源许可与更新机制：看清组件边界
V2Fly、Xray 以及三款图形客户端均以公开代码和许可条款进行维护，不同项目采用的许可类型并不完全相同。公开许可说明了复制、修改和再发布时需要遵循的条件，也使协议实现与配置处理逻辑能够被社区审阅。对普通用户而言，更实际的价值是问题可以被定位到明确组件，而不是依赖一个不可见的整体程序。
更新通常分为客户端界面、代理内核、路由资源和订阅内容四条线。客户端更新不一定同时改变内核，订阅更新也不会自动替换本地程序。下载页负责区分平台构建，教程负责解释操作顺序；实际维护时则应一次只更新一个层级，并保留原有配置，以便出现兼容问题时快速判断变化来源。
// V2RAYN
桌面端统一入口
v2rayN 将订阅管理、内核切换、系统代理、路由规则和日志查看集中在图形界面中。跨平台桌面构建与经典 Windows 界面并行，用户可按系统环境和操作习惯选择。
// V2RAYNG
Android 与 Xray 内核
v2rayNG 是 Android 上常见的 V2Ray 图形客户端，以 Xray 内核支持多种订阅配置。移动端操作重点包括导入配置、授予连接权限、选择活动项以及管理分应用规则。
// V2FLYNG
Android 的 V2Fly 选择
v2flyNG 面向需要 V2Fly 内核的 Android 使用场景，基本操作路径与常见移动图形客户端相近。选择前应确认订阅字段与目标内核兼容，避免只按名称替换客户端。
// QUICK ANSWERS
常见问题精选：先确认配置链路
多数故障不需要从头重装。按订阅、活动配置、内核、端口、系统代理、路由与 DNS 的顺序检查，通常能更快定位。
订阅导入后为什么没有配置？
添加地址后还需要执行订阅更新，并确认内容被写入正确分组。若更新结果为空，先检查链接是否完整、是否已过期，以及客户端是否能访问订阅地址。查看订阅导入步骤。
客户端运行中，浏览器仍无法连接？
先确认目标配置已设为活动项，再检查系统代理是否启用、本地端口是否被占用。部分程序使用独立代理设置，还需核对其地址和端口。查看连接问题分类。
路由模式应该选全局还是分流？
排查基础连接时可用范围明确的模式进行对照，日常使用则通常从预设分流规则开始。确认正常后再逐条增加自定义规则，并观察每条规则对应的出口动作。
REALITY 配置需要哪种内核？
REALITY 常见于 Xray 相关配置，除了协议类型，还要保证服务器名称、公钥、短标识和指纹等字段与服务端一致。可在协议参考中查看配置层级与选型说明。
// TECHNICAL NOTES
安装、订阅与 DNS 技术笔记
围绕具体操作和高频故障展开，文章中的入口名称、检查顺序和配置对象均对应图形客户端实际界面。
v2rayN Windows 安装配置全流程：桌面版与 WPF 版怎么选、常见坑逐一排掉
从运行环境准备讲到首次启动，说明两种界面的选择、解压位置、权限问题和系统代理不生效时的处理顺序。
阅读全文 →订阅链接导入教程：v2rayN 与 v2rayNG 的入口位置与常见订阅格式说明
分别说明桌面端与 Android 端的订阅添加入口、更新操作，以及 Base64、vmess://、vless:// 等常见内容形态。
阅读全文 →DNS 泄漏是什么：检测方法与 V2Ray 客户端防泄漏配置实操
解释 DNS 请求为何可能偏离预期路径，给出桌面端与 Android 端的设置检查方法，并说明修改后如何复测。
阅读全文 →