Windows
使用 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面，WPF 版适合偏好传统 Windows 操作方式的用户。安装前先确认系统架构和运行环境。
前往下载客户端能力
从订阅导入到路由分流
v2rayN 与 v2rayNG 把内核配置、服务器管理和系统网络设置集中到图形界面。下面的功能说明按实际使用顺序组织，先理解入口，再决定是否启用更深层的流量接管。
别名
协议
分组
当前服务器
VLESS
默认分组
备用配置
VMess
手动管理
系统代理：自动配置 · 路由：规则模式
服务器管理
订阅地址导入与分组管理
订阅导入适合统一接收一组服务器配置。桌面端通常从“订阅分组”新建条目，填入完整地址后执行更新；Android 端则可通过订阅设置添加。客户端会把返回内容解析为服务器列表，但订阅地址本身不会自动代表连接已经建立。
导入后应先查看列表是否出现可选配置，再选择一个条目作为当前服务器。多个来源建议分别建立分组，避免更新时混在一起。若更新完成但列表为空，应优先检查地址是否完整、分组是否启用，以及日志中是否出现解析错误。
日常维护
手动更新与自动更新边界
订阅更新用于重新获取服务器配置，不等于更新客户端程序。首次导入后建议手动执行一次更新，以便立即确认地址和网络条件是否正常。自动更新更适合已经稳定运行的配置，可按需要设定周期，减少长期使用旧条目的情况。
更新失败时不要连续重复点击。先查看客户端日志，区分网络请求失败、返回内容无法解析和订阅信息失效三类问题。若旧配置仍可使用，可保留原分组并新建测试分组，确认新内容正常后再整理列表。
流量接管
系统代理适合浏览器和常规桌面应用
系统代理开启后，遵循操作系统代理设置的程序会把网络请求交给客户端监听端口。浏览器和多数图形应用通常可以直接使用，因此它是桌面端最适合先尝试的模式。关闭客户端前应恢复系统代理，避免系统保留已失效的本地端口。
部分终端程序、独立网络组件或自行管理连接的应用不会读取系统设置。这种情况下应先确认应用自身是否提供代理选项，再考虑环境变量或 TUN 模式。不要仅凭一个程序的表现判断整个代理状态。
扩展接管
TUN 模式覆盖不读取系统代理的流量
TUN 模式通过虚拟网络接口处理更广范围的流量，适合系统代理无法覆盖的程序。启用时可能需要操作系统授予网络或管理权限，并且要注意与其他虚拟网络工具、企业安全策略和已有路由设置之间的冲突。
排查时应从简单模式开始：先确认同一服务器在系统代理下可连接，再启用 TUN。若开启后出现网络中断，应查看虚拟接口是否创建成功、DNS 设置是否被接管，以及路由规则是否把必要流量错误送入其他出口。
规则控制
按域名、IP 与规则集决定流量出口
路由分流不是服务器筛选功能，而是对每个连接做规则匹配。常见出口包括代理、直连和阻断。规则通常按顺序处理，因此范围较大的规则放得过早，可能覆盖后面的精确规则。修改后应保存配置并重新加载内核。
日常使用可以先选择客户端提供的基础规则，再逐步增加确有需要的域名或地址段。遇到某个站点行为异常时，先从日志确认命中了哪条规则，而不是同时调整订阅、DNS、端口和服务器，单变量排查更容易得到稳定结论。
生态组件
客户端界面与代理内核分工明确
v2rayN、v2rayNG 和 v2flyNG 负责配置管理、服务器列表与系统交互，真正解析协议并建立连接的是对应内核。不同客户端会根据平台定位选择 Xray 或 V2Fly 生态组件，也可能允许在设置中切换适用的内核。
选择内核时应以订阅配置包含的协议和传输参数为准。遇到无法识别的字段，先确认客户端与内核是否支持该配置，再查看启动日志。只更换界面程序而不理解内核报错，通常无法解决配置结构不兼容的问题。
故障定位
日志是启动失败与连接异常的第一入口
客户端日志通常会记录配置生成、内核启动、监听端口和连接处理过程。若双击启动后没有正常进入工作状态，应先确认客户端日志与内核日志的入口，再寻找端口占用、字段解析失败、权限不足或文件路径异常等明确提示。
排查时保留报错前后的上下文，不要只截取最后一行。先处理最早出现的关键错误，重新启动后再观察后续信息。重复报错往往是同一根因引发的连锁结果，逐项修正比直接重置全部配置更可控。
设备协作
局域网共享需要明确监听地址与访问范围
局域网共享允许同一网络中的其他设备连接当前客户端提供的代理端口。启用后，需要在使用端填写运行客户端设备的局域网地址和对应端口。主机防火墙、路由器隔离设置以及网络类型都会影响访问结果。
该功能适合临时调试或明确范围内的设备协作。配置时应记录开放的端口和当前网络环境，离开该网络后及时关闭共享。若连接失败，依次检查两台设备是否处于同一网段、监听地址是否允许外部访问，以及防火墙规则是否放行。
按系统选择
四个平台的客户端入口
桌面系统优先查看 v2rayN，Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会进一步区分处理器架构、安装包类型和系统要求。
快速上手
安装、导入、验证三个阶段
首次配置不需要同时调整所有高级选项。先建立一条能被客户端正确加载的连接，再逐步增加自动更新、路由规则和 TUN 设置。
-
01
按平台安装客户端
Windows、macOS 与 Linux 使用 v2rayN，Android 使用 v2rayNG 或 v2flyNG。安装前确认处理器架构和安装包格式；首次打开时按系统提示完成必要权限设置。若程序无法启动，先检查运行环境、解压目录和目录写入权限，不要急于导入配置。
-
02
导入订阅并选择服务器
在订阅管理中新增分组，粘贴完整订阅地址并手动更新。列表出现内容后选择一个服务器设为活动项。若使用单条分享链接，可从剪贴板导入，但仍应检查协议、地址、端口和传输参数是否被完整识别。订阅更新与客户端更新是两项独立操作。
-
03
开启代理并分层验证
桌面端先启用系统代理，Android 端按系统提示建立网络连接。验证时分别观察客户端状态、日志和目标应用表现。系统代理正常后，再按实际需求配置路由分流或 TUN。若只有终端程序无法连接，应单独检查该程序的代理变量和端口设置。
配置问题先缩小范围
先确认客户端能启动，再确认订阅能更新，然后测试单个服务器，最后检查系统接管。每次只改变一个条件，日志中的错误会更容易对应到具体步骤。
开源生态
Project V、V2Fly 与 Xray 的关系
客户端、内核、协议和订阅服务处于不同层级。理解这些层级，可以避免把界面问题、配置问题和内核问题混为一谈。
生态历史与项目分支
Project V 奠定了 V2Ray 配置模型和协议生态的基础。随着社区发展，V2Fly 延续并维护相关核心能力，Xray 则在兼容既有配置思路的同时扩展了协议、传输与路由能力。二者都属于开放协作的内核家族，但发布节奏、配置字段和特性支持并不总是完全一致。
因此，“V2Ray 客户端”通常指围绕这一生态构建的图形管理工具，而不是单一内核文件。看到 VMess、VLESS、Trojan、REALITY 或 gRPC 等名词时，应分别判断它属于协议、安全层还是传输方式，再确认当前客户端所调用的内核是否支持对应组合。
三款客户端的职责
v2rayN 面向桌面系统，负责订阅分组、服务器列表、系统代理、TUN、路由和日志入口。v2rayNG 面向 Android，常见配置由 Xray 内核处理；v2flyNG 同样面向 Android，但更贴近 V2Fly 内核生态。三者都以图形界面降低配置管理成本，实际连接能力仍由内核与配置共同决定。
客户端代码公开，用户可以了解功能演进、配置生成方式和问题修复记录。开源属性并不意味着所有分支具有相同界面或完全一致的默认值，因此跨客户端迁移时，应核对订阅兼容性、路由规则、DNS 设置与本地监听端口，而不是只比较名称。
协议许可与社区维护
开源许可规定了代码使用、修改和再分发的条件，具体条款以各项目随软件提供的许可文件为准。客户端与内核由不同维护者和社区参与者持续改进，发布周期也彼此独立。更新客户端时，界面组件与内核组件可能一同变化，也可能由客户端分别管理。
日常维护应记录当前可用配置与关键设置，更新后先检查内核能否正常启动，再观察订阅、路由和系统接管。若新配置字段无法识别，应查看日志中的明确报错，并确认客户端与内核的功能范围。回到可复现步骤，比反复切换多个选项更利于定位原因。
近期文档
客户端配置与故障排查
下面三篇文章分别处理内核启动失败、桌面版本选择和系统代理不生效。每篇都按可观察现象拆分检查路径，便于从日志或系统设置开始定位。