v2rayN
Windows / macOS / Linux
桌面全平台客户端
客户端下载
按操作系统选择安装入口
先确认系统与处理器架构，再选择安装包。桌面端使用 v2rayN，安卓端优先了解 v2rayNG；已有 V2Fly 配置需求时，可查看 v2flyNG。
v2rayN 提供桌面版与经典 WPF 版。桌面版采用跨平台界面，经典版适合熟悉原有操作习惯的用户。初次安装先看运行环境说明，不必同时安装两种界面。
将程序与配置放在便于管理的位置，更新前备份订阅分组和路由设置。启动后先导入服务器，再设置系统代理。
v2rayN 提供 Apple Silicon 与 Intel 两类安装入口。在系统的“关于本机”中查看芯片信息，按实际硬件选择，不要只根据电脑外观或购买年份判断。
首次打开时留意系统权限提示。涉及系统代理或虚拟网络接口的设置，需要结合当前系统权限与客户端说明处理。
v2rayNG 使用 Xray 内核，v2flyNG 以 V2Fly 内核为基础。多数近年的主流手机可选择 arm64；不确定处理器架构时，先阅读下载页的通用版说明。
建立连接时系统会请求 VPN 授权。若手机已有其他 VPN 应用运行，先结束冲突连接；后台连接中断还应检查电池优化设置。
v2rayN 按发行版的软件包体系提供 deb 与 rpm 入口，并区分 x64 和 arm64。先确认发行版类型和设备架构，再通过系统的软件包安装界面完成安装。
不同桌面环境对系统代理的处理可能不同。应用没有采用系统代理时，应先检查该应用自己的网络选项，而不是重复更换服务器。
配置要点
订阅、路由与网络模式
客户端负责管理配置，内核负责处理连接。把这两层分开理解，遇到问题时更容易找到应该检查的设置。
订阅导入与分组管理
订阅是一组服务器配置的更新入口，不是客户端本身提供的连接服务。拿到有效订阅地址后，为它建立独立分组，再执行更新，后续就能按来源整理服务器，而不必反复手动录入参数。
- 按来源建立分组。给分组起一个能辨认用途的名称，避免把不同来源的服务器混在一起。更新前确认当前操作的分组，删除时也更容易判断影响范围。
- 导入后检查内容。订阅地址保存成功，不等于服务器已经加载。更新后查看列表是否出现条目，并确认当前选中的服务器属于刚刚导入的分组。
- 区分订阅与分享链接。单个分享链接通常只带一份服务器配置；订阅地址用于拉取配置集合。选择对应的导入入口，能减少格式识别失败的问题。
路由分流与出站选择
路由决定一条连接走直连还是代理。它与服务器选择不是同一件事：即使已经选中代理服务器，匹配直连规则的连接仍会走直连。先理解匹配顺序，再添加自己的域名或地址规则。
- 具体规则放在前面。将明确域名、局域网地址等规则与宽泛规则分开管理。规则发生重叠时，优先检查匹配顺序，而不是只看列表里有没有目标域名。
- 全局代理用于对照。需要判断问题是否来自分流规则时，可暂时切换代理出站进行测试。测试完成后恢复原有模式，不把一次排查结果当作长期配置依据。
- 路由与 DNS 一起检查。域名解析结果会影响地址类规则的匹配。遇到部分网站异常，应同时查看域名规则、解析方式和运行日志，逐项缩小范围。
多平台配置与网络接管
桌面端和安卓端可以使用相同来源的服务器信息，但界面入口、权限和网络接管方式不同。迁移时重点核对协议参数与路由意图，不要把某个平台的整个配置目录直接覆盖到另一个平台。
- 先使用系统代理验证。桌面浏览器通常适合从系统代理开始测试。它依赖应用遵循系统设置，不能据此推断设备上的所有程序都已进入代理。
- 有需要再启用 TUN。TUN 通过虚拟网络接口接管流量，可能涉及管理权限、DNS 和路由冲突。先让基础连接正常，再逐步扩大接管范围。
- 分别保留设备设置。本地监听端口、启动行为和电池策略属于设备环境。共享订阅时，也应为每台设备单独检查这些选项，避免把环境问题误判为订阅问题。
按当前问题查看配置顺序
如果服务器列表为空，先检查订阅分组是否已经保存地址，再手动更新该分组。更新失败时，区分地址访问失败与内容解析失败：前者检查网络、地址有效期和访问权限，后者核对订阅格式及客户端支持范围。不要在日志截图中公开完整订阅地址，其中可能包含访问凭据。列表正常加载后，选中一个服务器进行实际连接测试；订阅更新成功只说明配置已取得，并不能保证每个服务器都可连接。
查看订阅导入步骤如果只有部分站点异常，先保持同一服务器不变，比较规则分流与代理出站下的访问结果。仅在规则模式失败时，应检查目标域名匹配了哪条规则，以及 DNS 返回的地址是否符合预期。修改规则前保存现有配置，一次只调整一个条件，再用相同目标复测。连接可能复用旧会话，必要时关闭目标应用后重新打开。代理出站仍然失败时，继续查服务器连接和协议参数，不要无限追加路由规则。
查看路由配置说明如果浏览器可用而某个应用无法连接，先查看该应用是否支持系统代理或独立代理设置，再决定是否需要 TUN。系统代理是一项供应用读取的设置，TUN 则改变流量进入内核的路径，两者不能简单视为同一个开关。启用 TUN 前确认权限、虚拟接口和其他网络工具的状态，避免多个工具同时修改路由。若启用后出现整体断网，先关闭 TUN 恢复基础网络，再逐项检查 DNS 与路由，保留可回退的配置。
查看进阶网络设置v2rayN 常用设置位置示意
先确认当前服务器，再检查流量如何进入内核、由哪条规则选择出站。
此处为静态示意，端口仅作说明；具体名称、位置与端口以实际客户端设置为准。
快速上手
从导入配置到验证连接
已有可用订阅时，可以按下面的顺序完成首次设置。客户端不附带服务器，订阅与服务器参数需要由使用者自行准备。
-
导入订阅，更新服务器列表
安装并打开客户端后，进入订阅管理界面，新增分组并保存订阅地址，然后更新该分组。桌面端与安卓端的菜单名称可能略有不同，重点是完成“保存来源”和“拉取内容”两个动作。若使用单个分享链接，则选择对应的导入功能。导入完成后，检查服务器名称、协议类型与分组是否符合预期，不要把订阅地址粘贴到服务器地址字段。
-
选择服务器，确认接管方式
从列表中选定一个服务器作为当前连接目标。桌面端先根据教程启用系统代理，安卓端在启动连接时确认系统 VPN 授权。初次测试保留基础路由方案，不同时开启多套代理软件，也不要一次修改 DNS、TUN 与路由规则。这样出现异常时，才能判断是服务器连接、应用代理设置还是规则匹配出了问题。
-
实际访问，结合日志验证
打开需要访问的目标页面，观察是否能完成加载，而不是只看客户端图标是否变化。列表中的连通性测试只覆盖特定测试目标，不能代表所有站点的表现。若访问失败，先确认本地网络可用、当前服务器选对、系统代理已生效，再查看同一时间段的运行日志。每次只改变一项条件并复测，通常比连续更换多项设置更有效。
开源生态
Project V、内核与图形客户端
“V2Ray”常被用来概括一组相关工具。选择客户端时，应分别看平台、内核与配置能力，而不是仅凭名称判断是否兼容。
Project V
代理工具与模块化网络处理的项目背景
- V2Fly
- 社区维护的 V2Ray 内核体系
- Xray
- 与 V2Ray 有历史渊源的独立内核分支
- 图形客户端
- 管理订阅、路由与本地运行设置
示意用于区分职责，不表示各项目存在统一的发布或管理关系。
从项目背景理解内核职责
Project V 围绕模块化代理工具形成了相关生态。V2Ray 的核心职责是接收连接、处理协议，并按照配置将流量交给相应出站。V2Fly 延续社区维护的 V2Ray 体系，Xray 则在共同历史基础上独立发展。两者有相近的概念和部分配置形式，但功能支持、字段含义与更新节奏并不完全一致，不能把名称相近理解成配置可以任意互换。
客户端界面与内核并不是同一层
v2rayN 面向桌面平台，提供服务器管理、订阅更新与路由配置等图形操作，并根据所选功能调用相应内核。v2rayNG 面向安卓，主要基于 Xray；v2flyNG 则以 V2Fly 为基础。三款客户端均属于开源软件，代码与发布由各自项目维护。开源说明了代码的开放方式，却不能替代对订阅来源、服务器运营方和设备权限的判断。
协议支持要连同传输与安全设置判断
VMess、VLESS、Trojan 与 Shadowsocks 是常见协议名称，WebSocket、gRPC 等则属于传输相关选项，TLS 与 REALITY 又涉及不同的安全配置。仅看到协议名称相同，并不足以确认一份配置能正常运行。客户端需要能识别订阅格式，所用内核也需要支持配置中的具体能力；证书名称、传输路径等参数同样应与服务端保持一致。
开源协议与更新的实际含义
客户端及所依赖的内核可能采用不同的开源许可证。阅读、修改或分发代码时，应以各项目随附的许可文本为准，不把生态中的某一份许可概括为全部项目的统一条款。客户端界面更新、内核更新和订阅更新也属于不同操作：更新订阅只会刷新服务器配置，不会自动补齐所有新增协议能力。
更新客户端前，建议先保存分组、路由规则与必要的本地设置，并阅读有关运行环境及配置兼容性的说明。若当前问题只涉及某个网站，优先定位规则和解析行为；若日志明确提示配置字段无法识别，再检查内核支持范围。按问题所在层级处理，比单纯追求更新更容易得到可重复的结果。
进阶配置手册：订阅管理、DNS 与 TUN 设置技术笔记
客户端安装与内核选择
下面三篇笔记分别从内核兼容、首次安装和项目关系入手，适合在基础连接建立后继续阅读。
Xray 内核与 V2Fly 内核差异：协议支持、配置兼容与取舍建议
对比两款内核在 VLESS、REALITY 等协议支持、配置字段兼容性与更新节奏上的差异，说明不同使用场景下该如何取舍。
v2rayN 首次安装与初始设置：Windows 与 macOS 通用要点和常见坑
覆盖解压位置、运行环境、首次启动权限、系统代理与本地端口设置，并整理杀软拦截、端口冲突等新手常踩的问题。
Project V 开源生态梳理：社区分支、核心项目与图形客户端的关系
按时间线梳理 Project V 的起源、社区维护的 V2Fly 与 Xray 两条分支，以及 v2rayN、v2rayNG、v2flyNG 各自依托的内核与定位。