Windows
v2rayN 提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面，WPF 版保留经典桌面操作方式；两者的界面布局可能不同，跟教程操作时先确认下载的类型，不必为寻找同一个按钮来回更换版本。
安装前在系统“设置”中确认处理器与系统类型。首次运行后先完成订阅导入，再从托盘设置系统代理。关闭主窗口不一定退出进程，停止使用前应确认代理设置已恢复，避免浏览器继续连接已关闭的本地端口。
前往下载 Windows 客户端→v2rayN 常用设置
先分清接管方式，再调整规则
导入订阅只是准备好连接参数。应用是否使用代理，还取决于系统代理、虚拟网络接口和路由规则。把这几层分开看，遇到“节点能测试、网页却打不开”时，才知道该检查哪一个菜单，而不是反复重装客户端。
系统代理：先让浏览器接入
系统代理把客户端的本地代理地址交给操作系统，适合会读取系统设置的浏览器与桌面应用。首次使用可在托盘菜单选择“自动配置系统代理”，再打开网页验证。“清除系统代理”用于撤销设置；“不改变系统代理”只表示客户端不主动修改现状，并不等于清除。与 TUN 相比，这种方式不需要接管整个网络接口，但无法保证所有程序都会跟随，命令行工具通常还要单独设置。
TUN 模式：接管更多应用
TUN 模式通过虚拟网络接口接收流量，适合不读取系统代理的应用。启用前先确认当前平台的权限要求，避免与其他虚拟网络工具同时抢占默认路由。开关打开后，流量仍会受到路由与 DNS 设置影响，不代表所有请求都走代理。与系统代理相比，TUN 的接管范围更广，排查也多了接口、权限和解析三层。建议先用系统代理验证节点可用，再单独开启 TUN，出现问题时逐项恢复。
路由规则：决定流量的去向
路由在流量进入内核后决定使用代理、直连还是阻断。“绕过大陆”“黑名单”“全局”是常见预设，具体行为以当前规则内容为准，不要只凭名称推断。首次配置可先选一个预设验证，再逐条补充域名或 IP 规则。与切换节点不同，修改路由改变的是匹配方式，不会提升节点本身的线路质量。遇到部分网站异常，先检查规则顺序、域名解析结果与规则数据库，再考虑更换连接参数。
订阅分组：分开管理来源
订阅分组用于保存不同来源的订阅地址，并把更新后的节点归到对应分组。先打开“订阅分组”添加名称和地址，再选择更新方式。“更新订阅(不通过代理)”使用当前直连环境；直连无法访问订阅地址、且已有可用代理时，再尝试“更新订阅(通过代理)”。与手动逐条导入相比，分组便于后续统一更新，但不会自动修复失效的服务。订阅地址可能包含账户标识，截图与日志分享前应隐藏完整链接。
内核切换：以配置兼容为准
图形客户端负责管理配置，内核负责实际处理连接，两者不是同一个组件。选择 Xray 或 V2Fly 时，应先看节点使用的协议、传输方式与安全参数，再确认客户端当前支持的内核组合。不同内核的功能覆盖和配置字段会有差别，不能把更换内核当作通用提速开关。与切换路由相比，内核切换更可能影响参数兼容性；调整前记录原设置，重新启动连接后查看日志，确认配置已被正确加载。
菜单名称可能随客户端界面调整。需要按平台逐项操作时，查看完整安装配置文档 →
V2Ray 客户端平台入口
桌面平台使用 v2rayN；安卓优先选择 v2rayNG，需要 V2Fly 内核时再考虑 v2flyNG。先确认操作系统与处理器架构，再进入下载页选择安装包。
macOS
v2rayN 按 Apple Silicon 与 Intel 提供对应入口。打开“关于本机”，看到“芯片”时按芯片型号选择，看到“处理器”时确认是否为 Intel。不要仅凭电脑购买年份判断架构，也不用为了导入同一份订阅而混用安装包。
首次打开若遇到系统安全提示，应先确认文件来源，再依据系统设置中的实际提示处理。系统代理和 TUN 的授权路径不同，浏览器可用后再测试其他应用；如果只有个别程序异常，先查看程序自身的代理选项。
前往下载 macOS 客户端→Android
优先使用基于 Xray 内核的 v2rayNG；需要 V2Fly 内核兼容配置时，可以选择 v2flyNG。主流较新设备通常选择 arm64，不确定架构时查看设备信息，或按下载页说明选择通用安装包。两款客户端的配置选项不必完全一致。
导入订阅、更新列表并选中节点后，启动连接时按系统提示允许创建 VPN 连接。若系统已有其他 VPN 应用运行，应先处理接管冲突。后台断连还可能与省电限制有关，排查时把应用电池策略和实际日志一起看，不要只反复点击连接按钮。
前往下载 Android 客户端→Linux
v2rayN 的 Linux 入口按 deb、rpm 和处理器架构区分。Ubuntu、Debian 等发行版通常选择 deb，Fedora 等发行版通常选择 rpm；处理器是 x64 还是 arm64 需要另外确认，包格式与处理器架构是两个独立条件。
安装后先检查桌面环境是否显示托盘图标，再验证系统代理能否被浏览器读取。不同桌面环境对代理设置的处理可能不同，终端程序也未必跟随。需要 TUN 时再查对应权限与虚拟接口状态，不建议一开始就同时修改系统路由、DNS 和多个代理工具。
前往下载 Linux 客户端→下载页集中说明安装包类型与系统要求。本站提供客户端入口与配置文档，连接所需的有效订阅或节点参数需要另行准备。
查看全部客户端 →订阅导入到连接验证
先跑通一条最简单的连接，再增加分流或 TUN。每次只改一个设置，出现异常时更容易回到上一步。
-
添加订阅，确认更新结果
在 v2rayN 打开“订阅分组”，添加便于识别的分组名称并粘贴完整订阅地址。保存后执行“更新订阅(不通过代理)”，确认列表确实出现可选节点，再继续下一步。复制时注意链接首尾的空格，以及聊天软件是否把地址截断。
更新失败不等于客户端安装失败。先判断返回的是网络错误、认证错误，还是内容格式不被识别。若已有一条可用连接，才考虑通过代理更新。单条分享链接与订阅地址也不是同一种输入：前者导入一组连接参数，后者用于获取和更新节点集合。
-
选择节点，再确定接管方式
选中需要使用的节点并设为活动配置。桌面端先从“自动配置系统代理”开始，让会跟随系统设置的浏览器接入；安卓端则按客户端操作启动连接，并允许系统创建 VPN。首次验证阶段保持其他网络工具关闭，减少互相覆盖设置的可能。
需要让更多应用进入内核时，再单独测试 TUN。接管方式只解决流量怎样进入客户端，路由规则才决定进入之后往哪里走。因此，“开启 TUN”和“全局代理”不能画等号。保留一份可用设置的记录，后续调整 DNS 或路由时就有明确的对照。
-
验证网页、应用与退出状态
先用浏览器访问已知可用的网站，再测试实际需要使用的应用。客户端显示运行，只能说明进程或接口已经启动，不能替代端到端访问验证。若浏览器可用而某个应用失败，优先检查该应用是否读取系统代理，以及是否使用了独立的网络设置。
节点测试结果也不能直接代表文件下载或视频播放表现。速度异常时，按节点、线路、本地设置的顺序分层判断，并观察是否只有特定目标受影响。最后测试一次停止连接：清除不再使用的系统代理，确认普通网络仍可访问，这样下次启动更容易定位状态变化。
Project V、V2Fly 与 Xray
客户端、内核、协议各管一层。理解它们的关系，比把所有网络问题都归到“节点失效”更有用。
Project V：从工具集合看生态
Project V 是理解 V2Ray 生态的一个起点。日常语境里的“V2Ray”有时指内核，有时又泛指一类客户端，教程因此很容易把不同层面的设置混在一起。实际使用时，可以把图形界面看作配置管理层，把内核看作连接执行层：前者负责保存订阅、选择活动节点和整理设置，后者负责解析配置、建立连接并执行路由。浏览器或其他应用则处在更外侧，需要通过系统代理、应用内代理或虚拟接口把流量交过来。
这也解释了为什么同一份订阅能在不同客户端中使用，却不保证每个选项都能原样迁移。界面可能只暴露部分内核能力，订阅转换也可能影响字段。排查问题时先记下客户端名称、使用的内核和接管方式，比只说“V2Ray 连不上”更容易找到对应说明。
V2Fly 与 Xray：相关，但不能互换参数
V2Fly 社区延续了 V2Ray 相关开发，Xray 则是在相关代码基础上发展出的另一条内核分支。两者有共同的技术背景，也各自演进协议支持、传输能力与配置实现。不能简单理解为一个是另一个的界面皮肤，更不能只按名称判断哪一个在所有场景下更快。真正影响能否连接的，往往是服务端参数、协议支持和本地配置是否相互匹配。
VMess、VLESS 属于连接配置中需要辨认的协议名称；REALITY 则涉及连接的安全机制，不应当作可以随意替换的普通节点标签。订阅中出现陌生选项时，先查对应内核的支持情况，再决定是否调整客户端。有关协议的补充说明放在完整文档的通用准备章节，不需要为了理解一个字段重新安装整套软件。
三款客户端：按平台与内核选择
v2rayN 是面向桌面平台的开源图形客户端，适合集中管理订阅、系统代理与路由设置；v2rayNG 面向安卓，使用 Xray 内核；v2flyNG 也是安卓图形客户端，提供 V2Fly 内核方向的备选。三者均属于开源客户端项目，发布与再分发应尊重各自的 GPL-3.0 等适用许可及所附依赖许可。开源属性说明了代码与许可层面的事实，不等于任何订阅服务的可用性保证。
桌面用户可以先选 v2rayN，再按系统和处理器决定安装包；安卓用户先看节点参数是否适合 v2rayNG，确有兼容需求再考虑 v2flyNG。客户端并不附带通用可用的连接资源，也不能代替服务端账户、有效期和流量状态的检查。需要对照差异时，查看三款客户端对比，以实际平台和参数为依据，不按名称相似程度选择。
更新机制：客户端、内核与订阅分开看
客户端更新主要影响界面与配置管理能力，内核更新可能改变协议支持或运行行为，订阅更新则从服务来源重新获取节点集合。它们是三条不同的维护路径：更新订阅不会自动升级客户端，更换客户端也不会让过期账户恢复有效。规则数据库又是另一类数据，涉及域名、IP 分类与分流匹配；只有部分站点异常时，应结合规则与解析判断，而不是把所有组件一次性全部替换。
升级前记录原来的代理方式、活动节点和自定义规则，升级后先复测基础连接，再逐项恢复复杂设置。分享日志时只保留定位问题所需的信息，隐藏订阅地址、账户标识和连接密钥。本站整理下载入口与中文操作路径，具体菜单和可用功能仍以安装的客户端为准；系统提示、客户端日志和实际访问结果，需要放在一起判断。
V2Ray 配置与排查文章
基础连接跑通后，再读配置结构、DNS 与规则数据库。按问题找文章，不必一次改完全部设置。
geoip.dat 与 geosite.dat 怎么更新：路由规则数据库使用说明
区分按 IP 分类的 GeoIP 与按域名分类的 GeoSite，了解客户端内的更新方式，以及 geosite:cn、geoip:private 等规则写法。适合处理规则已启用、部分目标却没有按预期分流的问题。
阅读文章 →FakeDNS 工作原理：虚拟 IP 映射与 TUN 模式下的适用场景
从域名与虚拟 IP 的映射关系理解 FakeDNS，说明它如何减少一次真实解析、为什么常与 TUN 一起讨论，以及遇到应用兼容问题时应先确认哪些条件。
阅读文章 →V2Ray config.json 结构详解：inbounds、outbounds 与 routing 逐段拆读
按 log、inbounds、outbounds、routing、dns 的顺序阅读配置，分清入口、出口和规则分别负责什么。先理解字段之间的关系，再处理客户端生成配置与自定义设置的衔接。
阅读文章 →