Windows
v2rayN 首推提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留熟悉的桌面操作布局。先在系统设置里确认设备类型,再到下载页查看安装说明;不要仅凭安装包名称相近就替换正在使用的程序。
首次运行后,先保存订阅地址并更新分组,再选择节点、配置系统代理。已有配置的用户可以先做备份,保留原来的分组、路由与本地端口,避免迁移时同时改变多项设置。
CLIENT SHELF / 下载入口
桌面端先看 v2rayN,安卓端先看 v2rayNG。下载前确认系统与处理器架构,再按教程导入配置。
提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留熟悉的桌面操作布局。先在系统设置里确认设备类型,再到下载页查看安装说明;不要仅凭安装包名称相近就替换正在使用的程序。
首次运行后,先保存订阅地址并更新分组,再选择节点、配置系统代理。已有配置的用户可以先做备份,保留原来的分组、路由与本地端口,避免迁移时同时改变多项设置。
按芯片选择 Apple Silicon 或 Intel 安装入口。点系统菜单中的「关于本机」,查看显示的是芯片名称还是 Intel 处理器,再选择对应的包。下载页集中说明两种架构,方便与当前设备逐项对照。
初次启动时,按系统提示确认权限。先用系统代理验证浏览器能否访问目标页面,再考虑是否需要 Tun。虚拟网卡模式的权限、路由接管范围与普通系统代理不同,不必在首次配置时一起开启。
v2rayNG 使用 Xray 内核,v2flyNG 是使用 v2fly 内核的备选。常见设备可先查看 arm64 入口;无法确认处理器架构时,再阅读通用版说明。选择客户端时还要看订阅所用的协议参数,而不只是应用名称。
导入订阅后,点选一个节点,再启动连接并确认系统的 VPN 授权提示。如果退出界面后连接中断,到系统的电池和后台管理中检查限制。后台权限影响连接能否持续,并不能替代对节点配置本身的检查。
按发行版的软件包体系选择 deb 或 rpm,再确认设备是 x64 还是 arm64。软件包格式与处理器架构是两件事:前者决定交给哪个包管理器安装,后者决定程序是否能在当前处理器上运行。
图形界面启动后,先检查本地监听端口和桌面环境的代理设置。部分应用不会自动跟随系统代理,需要在应用中单独指定。启用 Tun 前再核对权限要求,避免把权限问题误判成订阅失效。
CONFIGURATION / 配置流程线
先让一条配置正常工作,再调整接管范围。下面按实际配置顺序整理入口;界面名称可能随客户端与系统略有变化。
订阅是供客户端读取配置的地址,不等于已经建立连接。在 v2rayN 打开「订阅分组设置」,填写分组名和订阅地址,保存后执行更新。分组能把不同来源分开,排查时也更容易确认是哪一组返回了错误。若更新失败,先检查链接是否过期、是否复制完整,再尝试「更新订阅(不通过代理)」。这项操作只改变获取订阅时的网络路径,不会替你修正失效地址。不要反复导入同一链接,以免产生重复条目。
查看订阅导入步骤 →订阅分组设置
订阅地址可能包含访问凭据,请勿公开分享。
先选中节点,再在「系统代理」中点「自动配置系统代理」,让遵循系统设置的应用连接本地代理端口。它并不表示所有程序都已接管;某些应用需要单独填写代理,另一些场景才需要 Tun,也就是通过虚拟网卡处理流量的模式。初次使用先保持一种接管方式,验证浏览器访问后再增加设置。退出客户端前可选择「清除系统代理」,避免程序停止后系统仍指向本地端口。Tun 所需的权限与组件应按对应平台教程处理。
查看连接与验证步骤 →静态示意,选项不会修改当前设备。
路由分流决定流量交给直连、代理还是阻断出口,与系统代理是否开启不是同一个开关。在客户端的路由设置里先选适合的预设,保留局域网直连,避免访问路由器、打印机时绕到远端。需要新增域名规则时,先确认规则顺序,再用目标网站验证;较早匹配的规则可能让后续规则不再生效。若只有个别域名异常,还应检查 DNS,也就是域名到地址的解析过程。一次只改一项,才能区分是解析失败还是出口选择不符。
阅读路由与协议参考 →绕过局域网
规则预设名称与具体行为以当前客户端为准。
内核负责实际建立连接,客户端负责把界面里的设置转成配置。看到相同协议名称,并不代表不同内核支持完全相同的传输与安全参数。使用包含 REALITY 或特定流控参数的配置时,应先核对客户端和 Xray 的支持情况;已有 v2fly 配置则按原有字段检查兼容性。切换前记录当前选择,保存后查看启动日志,再验证同一目标页面。不要把所有协议同时换一遍:连接失败也可能来自地址、时间设置或服务器端参数不一致。
比较 V2Fly 与 Xray →先核对协议、传输、安全层与流控参数,再选择对应内核。
多端同步的重点是复用有效订阅,而不是直接覆盖另一台设备的全部配置。在 v2rayN 与 v2rayNG 中分别保存同一个订阅地址,再各自执行更新;这不代表两端会自动同步系统代理、应用分流或后台权限。导入后核对协议与安全参数是否保留,选择节点后独立测试。迁移设备前可使用客户端提供的备份功能,但订阅地址与导出的配置都可能包含访问凭据,应存放在受控位置。共享截图时遮住地址和身份字段,只保留排查所需信息。
查看桌面与安卓配置说明 →同步订阅内容,不等于同步设备的系统设置。
PROJECT V / 开源生态
把三层概念分开,下载与排查都会更清楚:客户端提供操作界面,内核执行连接,协议约定通信方式。
Project V 是理解 V2Ray 生态的起点。它围绕代理通信、传输与路由组织功能,而日常看到的图形客户端是在这些能力上增加订阅、节点列表和设置界面。因此,搜索 V2Ray 官网或客户端下载时,需要先区分是在找项目资料、内核说明,还是用于日常操作的应用。本站将常用下载入口与中文操作参考放在一起,不把社区整理页面等同于所有上游项目的官方发布页面。
V2Fly 延续 V2Ray 的社区开发,Xray 则从相关代码基础发展出自己的功能路线。二者有共同背景,但已经不能简单理解为名称不同、配置完全相同的程序。部分基础配置概念相通,新增的传输、安全机制和字段支持仍应分别确认。把某个内核的配置直接交给另一个内核,可能遇到字段不识别或行为差异;这时应先阅读错误信息,而不是只更换客户端外观。
v2rayN、v2rayNG 与 v2flyNG 都属于开源图形客户端。v2rayN 面向桌面操作,便于管理分组、系统代理和路由;v2rayNG 为安卓设备提供基于 Xray 的连接入口;v2flyNG 则提供基于 v2fly 的安卓选择。客户端和内核由不同项目维护,发布节奏不一定一致,所以应用能打开、订阅能导入、连接能建立,是需要分别验证的三件事。
开源意味着源代码按相应许可证公开,并不表示项目之间的代码与发布物可以不受条件地混用。生态里既有 GPL 系列许可证,也有 MPL 2.0 等不同约定,具体适用范围以各项目和依赖的许可声明为准。普通用户可以永久免费使用这些客户端;准备修改、再分发或集成代码时,则应进一步阅读对应许可,而不是把整个生态视为同一种授权。
VMess、VLESS、Trojan 与 Shadowsocks 等名称描述不同的协议设计,REALITY 则属于安全层相关机制,不能把这些词都当成可以互换的节点类型。实际连接通常还包含传输方式、服务器名称、证书验证或其他参数。客户端里只选对协议名称仍不够,其他字段也要与服务端一致。导入后若发现参数缺失,优先确认订阅格式是否能表达这些字段,以及当前客户端是否支持解析。
延迟、吞吐与资源消耗还受到线路、服务器负载、设备性能和应用行为影响。不能仅凭协议名推断哪个节点一定更快,也不宜把单次测试结果当成持续体验。日常选择时先看配置是否兼容,再看实际访问是否稳定,最后才按需要比较目标应用的表现。移动端还要考虑后台管理与电池限制,频繁断连未必来自协议本身。
更新客户端、更新内核、更新订阅是三个不同动作。客户端更新主要改变应用功能和界面;内核更新会影响协议能力与连接行为;订阅更新则重新获取配置内容。遇到订阅解析错误,优先检查地址和返回格式,不必马上重装应用。遇到内核启动失败,查看日志中指出的配置项;只有浏览器不能访问时,再沿系统代理、本地端口、路由和 DNS 的顺序缩小范围。
修改设置前记录原状态,更新程序前保留配置备份,验证时固定同一节点和同一目标页面。这样每次变化都能对应一个观察结果,也更容易恢复。向他人描述问题时,说明客户端、操作系统、所选内核、错误提示和已经做过的动作即可;不要公开订阅链接、完整身份字段或带凭据的截图。可继续阅读协议与内核参考,或按首次连接教程逐项操作。
READING / 配置与排查
按问题所在的环节阅读:订阅无法更新、连接后无法访问,或需要进一步理解协议与流控。
归纳订阅链接过期、格式不兼容、更新时走代理受阻等常见原因,配合客户端里的设置项,一步步定位订阅解析失败的问题。
阅读订阅排查步骤 →按「系统代理状态 → 本地端口 → 路由规则 → DNS 设置 → 节点可用性」的顺序,给出一份可逐项勾选的上网故障排查清单。
阅读连接排查清单 →用通俗图解讲清 REALITY 如何借用真实站点的 TLS 握手,以及 Vision 流控怎样减少 TLS 内层的重复加密,从而降低开销、提升速度。
阅读协议原理说明 →