Windows
Windows 桌面端首选 v2rayN。下载页同时说明新一代桌面界面与经典 WPF 界面的区别。首次运行后，按“添加订阅—更新列表—选择节点—配置系统代理”的顺序操作，便于确认每个环节是否完成。
前往下载
核心设置
订阅管理、路由分流与运行诊断
客户端的关键差异不只在安装界面，更在于订阅如何整理、流量如何匹配规则、异常发生后能否快速定位。下面按真实使用顺序拆开说明。
01
订阅分组与更新顺序
订阅地址用于批量下发节点参数，客户端负责解析并归入对应分组。导入前应确认链接完整，再为不同来源设置清晰名称；更新时先刷新订阅，再选择当前节点，避免仍在使用旧列表。v2rayN 适合把桌面端的多个订阅拆成独立分组，v2rayNG 与 v2flyNG 则更适合保留简洁的移动端列表。自动更新间隔应结合订阅提供方的更新频率设置，日常无需反复手动导入同一地址。
如果更新后原有选择失效，先重新选中节点并观察状态，再检查订阅内容是否调整了分组或节点名称。这个顺序比直接删除全部配置更容易保留有效设置，也便于判断问题来自订阅响应还是本地选择状态。
订阅分组
已同步
默认分组当前使用
订阅 A自动更新
手动节点本地维护
02
系统代理与路由规则分工
系统代理决定应用是否把请求交给客户端，路由规则决定请求进入客户端后走代理、直连还是阻断。两者处在不同层级，排查时不能混为一谈。常规浏览器和遵循系统设置的桌面程序，可先使用自动配置系统代理；需要更细的目标匹配时，再选择绕过局域网与大陆或手动规则。修改规则后应建立新连接复测，旧连接可能继续沿用变更前的路径。
手动规则适合处理域名、地址段和进程维度的特殊需求，但规则顺序会影响最终结果。范围更具体的规则通常放在前面，通用兜底放在后面。先保持规则数量可控，再逐条增加，比一次导入大量陌生规则更容易维护。
路由模式
规则按序匹配
绕过局域网与大陆
全局
手动规则
domain:geosite-cn → direct
ip:geoip-private → direct
final → proxy
03
从日志区分订阅、节点与本地设置
连接异常时，日志比反复切换开关更有判断价值。订阅更新阶段应关注网络请求、响应格式和解析结果；节点连接阶段则关注域名解析、握手、传输参数与远端响应；只有部分应用无法访问时，还要回到系统代理或 TUN 接管范围检查。把故障按阶段拆开，可以避免把订阅地址问题误判成节点问题。
日志中的时间顺序同样重要。先清理旧输出，再执行一次明确动作，例如更新订阅或打开目标页面，然后只观察这段操作产生的记录。遇到连续重试时，应先处理最早出现的错误，而不是只看最后一行概括信息。
运行日志
按阶段查看
INFO load routing rules
INFO apply system proxy
INFO subscription parsed
INFO outbound configuration ready
平台入口
按设备选择 V2Ray 客户端
桌面平台统一查看 v2rayN，安卓设备可在 v2rayNG 与 v2flyNG 之间选择。平台入口只负责带到对应下载分区，具体安装包类型、处理器架构和安装说明在下载页内逐项列出。
macOS
macOS 使用 v2rayN 桌面端。选择安装包前先查看设备使用 Apple Silicon 还是 Intel 处理器，两种架构需要对应文件。安装完成后再导入订阅，并根据日常应用是否遵循系统代理决定是否启用 TUN 模式。
前往下载Android
安卓端首选 v2rayNG，也可按内核偏好选择 v2flyNG。多数较新的设备可优先查看 arm64 安装包，无法确认架构时再参考通用版说明。两款客户端都支持订阅导入和路由配置，但内核家族与界面组织方式不同。
前往下载Linux
Linux 桌面端使用 v2rayN，可按发行版的软件包体系选择 deb 或 rpm，并根据处理器架构选择对应文件。安装后建议先在客户端内完成订阅和代理设置，再考虑开机启动、桌面环境代理同步等日常维护项目。
前往下载
快速上手
从订阅地址到正常连接的三步顺序
首次配置最容易出现的问题通常不是某个高级选项，而是操作顺序被打乱。先完成订阅导入，再确认节点与代理模式，最后用新的网络请求验证结果，可以快速缩小排查范围。
-
导入订阅并更新列表
复制完整订阅地址，在客户端的订阅管理中新增记录，并为它设置容易识别的名称。保存后执行更新，确认列表出现可选节点。若更新没有结果，先核对链接首尾是否被截断，再查看日志中的网络请求与解析提示。不要在导入失败时直接修改路由或 TUN 设置，因为这些选项不会修复订阅响应问题。
-
选择节点与系统代理模式
从更新后的分组中选择一个节点，再启用适合当前应用的系统代理模式。浏览器与多数桌面应用通常会读取系统代理；少数程序使用独立网络栈，可能需要单独设置或启用 TUN。第一次测试时先保持路由规则简单，确认基础连接成立后，再逐步加入分流需求。
-
建立新连接并检查日志
设置变化后关闭旧页面或旧连接，再发起一次新的访问请求。若无法连接，查看操作发生时生成的日志，判断错误位于域名解析、协议握手、传输参数还是系统代理接管阶段。一次只调整一个变量，调整后立即复测，这样才能知道哪项设置真正影响了结果。
常见操作问题
订阅更新失败先检查什么？
先确认地址是否完整、设备网络是否能请求该地址，再从客户端日志中区分网络错误与内容解析错误。订阅问题处理完成前，不必反复切换节点。
查看订阅导入步骤系统代理已经开启但部分程序没有流量？
先确认该程序是否遵循系统代理。若使用独立网络栈，可查看程序自身的代理选项，或评估 TUN 模式是否适合当前设备环境。
查看连接设置更换路由模式后为什么结果没有变化？
旧连接可能继续使用原来的路径。关闭目标程序中的现有连接，重新发起请求，并确认新日志已经命中调整后的规则。
阅读路由分流章节桌面端和安卓端应该选择同一个客户端吗？
桌面端使用 v2rayN，安卓端可选择 v2rayNG 或 v2flyNG。订阅内容可以相同，但不同客户端的界面位置和内核家族可能不同。
查看客户端列表
生态背景
Project V、V2Fly、Xray 与图形客户端的关系
理解内核、客户端和订阅之间的边界，有助于正确判断功能来源。图形界面负责配置和管理，内核负责实际网络处理，订阅则提供一组可以被客户端转换为本地配置的连接参数。
Project V 是协议与工具生态的起点
Project V 形成了一套围绕代理协议、传输方式、路由规则和配置结构展开的开源生态。VMess、VLESS 等协议名称属于连接配置的一部分，TCP、WebSocket、gRPC 等传输方式负责承载数据，routing 规则则决定不同目标应交给哪个出站。客户端把这些字段组织成可操作的界面，但底层概念仍然来自同一类配置模型。
因此，“客户端名称”和“协议名称”不能互相替代。v2rayN、v2rayNG、v2flyNG 是用户直接操作的图形客户端；VMess、VLESS、Trojan 是可能出现在节点参数中的协议类型；V2Fly 与 Xray 则属于负责执行配置的内核家族。遇到连接问题时，先确定问题位于哪一层，往往比直接重装更有效。
V2Fly 与 Xray 采用相近配置思路
V2Fly 延续 Project V 的社区维护路线，围绕协议实现、传输层、路由和出入站结构持续演进。Xray 在相近配置模型上发展了自己的功能集合。两者都能处理常见订阅节点，但具体支持的协议字段、传输选项和新增能力并非始终一致。订阅提供方标明内核要求时，应按要求选择客户端及内核，避免把字段不兼容误认为订阅失效。
路由配置中的入站、出站和规则匹配，是理解两个内核家族的共同基础。入站描述本地应用如何把流量交给内核，出站描述流量从哪种连接方式离开，routing 则在二者之间完成选择。图形客户端虽然隐藏了大量 JSON 字段，但高级设置中的系统代理、TUN、分流规则与 DNS 选项，最终仍会映射到这些结构。
三款客户端对应不同平台与内核取向
v2rayN 是 Windows、macOS、Linux 的桌面客户端，适合管理多个订阅、切换系统代理、编辑路由规则并查看详细日志。v2rayNG 面向安卓设备，通常配合 Xray 内核使用，界面围绕移动网络、VPN 接管和订阅列表组织。v2flyNG 同样面向安卓设备，但采用 V2Fly 内核路线，可作为有明确内核偏好或配置需求时的选择。
客户端之间不需要追求界面完全一致。更重要的是保持订阅来源、节点参数和路由目标一致，并理解各客户端把同一功能放在什么位置。例如桌面端常用“系统代理”描述应用接入方式，安卓端则通过系统提供的 VPN 接口接管流量；操作入口不同，但目的都是把目标请求送入本地内核。
开源协议与社区维护意味着功能会持续调整
这些客户端和内核以开放源代码方式维护，功能讨论、缺陷修复和兼容性调整由不同社区参与者推进。开放维护便于技术人员理解配置生成过程，也让协议实现和平台适配能够持续演进。实际使用时仍应关注客户端与内核之间的兼容关系，特别是新增协议字段、传输方式和操作系统网络接口发生变化时。
更新客户端前，可以先记录当前订阅名称、代理模式、路由选择和 TUN 状态。更新完成后按原顺序核对设置，并通过一次明确的连接测试观察日志。若新旧界面调整了菜单位置，应以功能名称和配置含义为线索，而不是只依赖旧截图寻找按钮。这样更适合长期维护，也能减少界面变化带来的误操作。
技术笔记
查看全部文章
客户端配置与排查文章
围绕客户端选型、首次设置和延迟测试整理可复用的操作方法。