v2rayN
覆盖 Windows、macOS、Linux 的桌面客户端,集中管理订阅、服务器与路由。
下载v2rayN 查看配置说明 →安装包选择
先确认操作系统,再确认处理器架构。桌面设备统一从 v2rayN 开始,安卓设备优先查看 v2rayNG,需要 V2Fly 内核时再考虑 v2flyNG。安装包只是运行客户端的起点,服务器地址、端口、认证信息与订阅链接仍需由服务提供方给出;已经保存的配置也要确认与所选内核兼容。
v2rayN 提供跨平台桌面版与经典 WPF 版入口。新安装可先看桌面版;习惯经典界面的用户可比较 WPF 版说明。切换界面版本前,先备份现有订阅分组和路由设置,避免在不同目录之间误用配置。
前往下载 →v2rayN 按 Apple Silicon 与 Intel 芯片分别提供安装入口。在“关于本机”中查看芯片或处理器信息后再选择。首次启动若出现系统安全提示,先核对下载来源与提示内容,再按系统允许的方式完成授权。
前往下载 →v2rayNG 对应 Xray,v2flyNG 对应 V2Fly。多数较新的设备可先查看 arm64 包,架构不确定时对照通用版说明。首次连接需要确认系统 VPN 授权,后续若后台连接中断,再检查电池优化与后台运行限制。
前往下载 →v2rayN 提供 deb 与 rpm 安装入口,并区分 x64 和 arm64。按发行版的包管理体系选择格式,再核对机器架构。桌面环境是否读取系统代理设置会影响应用表现,启用 TUN 前还需确认权限与虚拟网卡条件。
前往下载 →第一次使用时,建议把服务提供方给出的订阅链接、节点协议和适用客户端说明放在一起阅读。订阅是配置的分发方式,不等于客户端账号;导入成功也只说明内容能够解析,不能据此判断远端服务器已经可达。如果只有单个分享链接,可以先导入这一条服务器配置,再验证连接,暂时不必建立复杂的分组。
已有其他设备配置时,不要直接把所有设置逐项照搬。桌面系统代理、安卓 VPN 接管和不同系统的权限模型并不相同,局部设置需要结合设备重新确认。先使用默认路由完成一次基本连接,再迁移自定义 DNS、分流规则和其他进阶项,出现问题时更容易定位是哪一步引入了变化。
客户端设置
客户端把底层配置整理为可操作的设置项,但不同平台的菜单名称和功能范围仍可能不同。下面按实际任务说明使用顺序:先整理服务器来源,再决定请求走哪条出站,最后按应用是否遵循代理设置选择接管方式。切换条目可查看对应的配置场景。
订阅用于集中更新服务器配置,适合节点内容会变化的使用场景。先在 v2rayN 中建立订阅分组,填写链接并更新,再核对协议、备注与可用状态;安卓客户端也应先检查导入结果。按来源分组能减少重复条目和误选,手动修改的配置则建议单独保存,避免被更新覆盖。与逐条粘贴分享链接相比,订阅更便于维护,但解析成功不代表连接成功,仍需选中服务器并测试实际请求。
路由根据域名、IP 等条件决定请求使用代理、直连或其他出站,适合同时访问本地资源与远端服务的场景。先采用客户端已有的规则方案,再把确有需要的例外放到合适位置。相比让全部请求使用同一出站,分流能表达更具体的访问意图,但规则顺序和解析策略也会影响结果。DNS 应与路由配套调整,修改后结合日志检查域名匹配和实际出站,不要仅凭页面是否打开判断规则是否生效。
TUN 通过虚拟网卡接入流量,适合不读取系统代理设置的应用。先确认普通代理连接正常,再按系统要求授予权限并启用 TUN,随后检查本地网络、DNS 和目标应用。相比系统代理,TUN 接管范围通常更广,但并不意味着所有流量都会走远端节点,最终仍由路由规则决定。遇到连接异常时,先退出其他接管网络的工具,再检查接口与路由冲突;需要恢复时关闭 TUN,并确认系统网络状态已回到原来的设置。
内核负责实际连接与协议处理,图形客户端负责组织配置和操作入口。v2rayN 可按配置需求使用相应内核;安卓的 v2rayNG 与 v2flyNG 则分别面向 Xray 和 V2Fly。相比只看客户端名称,核对内核更能解释协议和参数的兼容问题。切换前先查看服务提供方的配置要求,保留可用设置,切换后重新启动并测试。不同内核的功能并非完全一致,不能假定同一份自定义配置在两边都能直接运行。
设置顺序比设置数量更重要。首次连接只需要先确认服务器配置、当前选中项和代理接管方式,暂时保留默认的路由与 DNS 方案。浏览器能正常访问后,再检查其他应用是否读取系统代理;只有确实存在接管需求时,才进一步尝试 TUN。每次修改一个变量,并记录修改前后的表现,比同时打开多个功能更容易发现原因。
系统代理和路由模式是两层不同的设置:前者决定应用是否把请求交给客户端,后者决定客户端收到请求后如何选择出站。系统代理已开启,但某个应用完全不使用系统设置时,调整域名分流规则通常不能解决接管问题;反过来,请求已经进入客户端却走错出站,就应检查规则、解析结果和当前模式。
DNS 设置也不是单独追求某个解析地址。需要先明确哪些域名由哪条路径解析、解析请求本身走代理还是直连,以及路由是否依赖解析后的 IP。某些故障看似服务器不可达,实际发生在域名解析环节。排查时先保留可用的基础方案,通过日志区分解析失败和连接失败,再有针对性地调整 DNS 或出站设置。
涉及 FakeDNS、自定义出站或多订阅过滤时,建议先阅读高级用法中的完整章节。这些功能需要配套条件,单独复制一段设置容易遗漏上下文。已经运行稳定的配置可以作为回退基线;调整后分别测试常用网页、本地资源和目标应用,确认符合预期再继续下一项。分享问题描述时保留报错类型即可,订阅地址与认证信息应先隐藏。
开源内核生态
Project V
代理核心与配置生态
V2Ray 的社区维护方向
从 V2Ray 发展出的内核分支
图形客户端把服务器、路由和 DNS 配置交给相应内核运行。
日常说的“V2Ray”有时指代理生态,有时特指核心程序。Project V 提供模块化的代理思路,V2Ray 是这一背景下的核心项目;V2Fly 延续 V2Ray 的社区维护,Xray 则从 V2Ray 发展而来,并在协议与功能上形成自己的演进方向。了解这层关系后,就不必把图形客户端的名字、节点协议和实际运行内核混为一谈。
v2rayN、v2rayNG 和 v2flyNG 是面向用户操作的客户端。界面中的添加服务器、订阅更新、路由选择等操作,最终会转换为内核能够使用的配置。客户端成功启动,只能说明界面已运行;内核是否启动、配置是否被接受、连接是否成功,还需要观察状态和日志。这也解释了为什么界面看起来相同,切换内核后连接表现仍可能不同。
桌面设备可以先选择 v2rayN:它面向 Windows、macOS 与 Linux,适合在图形界面中集中整理服务器和订阅。桌面跨平台界面与经典 WPF 界面的布局不同,已有用户应结合操作习惯和系统条件选择,而不是只根据界面截图判断功能。跨系统迁移时,可以先迁移服务器资料,再分别确认系统代理、权限和 TUN 行为,避免把某个系统的环境设置当作通用配置。
安卓设备优先查看 v2rayNG,它采用 Xray 内核;已有配置明确要求 V2Fly 时,可查看 v2flyNG。两款客户端都提供图形化操作,但内核功能与配置支持范围不应直接等同。尤其是涉及 REALITY 等特性时,要核对服务端给出的完整配置要求,不能仅把协议名称改为另一个选项。分享链接能导入,也不一定意味着其中所有扩展参数都被当前内核正确处理。
选择客户端时,可以依次问三个问题:设备运行哪个系统,现有节点要求哪个内核,常用应用需要哪种接管方式。前两项决定安装入口与兼容性,第三项决定连接后的使用设置。若这些条件已经满足,就没有必要为了名称相近而频繁更换客户端。遇到单个节点不可用时,先排查该配置和网络环境,不能直接把失败归因于整款客户端。
这三款客户端均以开源项目的方式发布,代码与修改记录能够被社区讨论和审阅。v2rayN、v2rayNG 和 v2flyNG 采用 GPL-3.0 许可;V2Fly 与 Xray 的核心代码采用 MPL-2.0 许可。客户端和所调用的核心是不同软件组件,各自遵循相应许可。日常个人使用与修改后再分发属于不同场景,涉及二次分发时,应阅读对应组件的许可文本与声明。
开源说明的是软件开发与发布方式,并不能代替具体的网络配置判断。实际请求会经过本机、服务端与目标服务,隐私和安全还取决于配置来源、访问协议以及运行环境。订阅链接可能包含可使用的服务凭据,应像账号资料一样保管;向他人求助时,不要把完整链接、二维码或认证字段直接贴入截图。
社区维护通常同时涉及界面、核心兼容、操作系统适配与问题修复。这些部分可能有不同的更新节奏,因此阅读发布说明比单纯追求“新”更有用。先看变更是否与自己的平台和配置有关,再决定是否更新。若环境依赖某个自定义路由或出站配置,应先留存当前设置,并用常用访问场景测试新的运行组合。
客户端更新替换软件程序,订阅更新替换或补充服务器配置,两者解决的问题不同。新增协议支持、界面调整或系统适配通常属于客户端与内核更新;服务器地址、认证参数和服务端配置变化通常通过订阅更新提供。只更新订阅,不会自动让旧内核支持新的特性;只更新客户端,也不会修复已经失效的订阅地址。
订阅更新后,先检查分组是否仍存在、当前服务器是否仍被选中,以及原来手动编辑的条目是否被覆盖。名称一致的条目也可能已经改变地址或传输参数,必要时对照服务提供方说明。若更新失败,可以分别确认链接有效期、当前网络是否能获取订阅内容,以及返回格式是否被客户端支持。不要在尚未确认原因时反复删除所有分组。
软件更新前,可以先保存现有订阅信息与自定义设置;完成更新后,再确认当前内核、系统代理状态和路由模式。有些设置在系统重启、权限变化或多个工具共同运行时会改变,不能仅凭界面中保留的开关状态判断实际流量路径。用于故障描述的日志应覆盖一次具体失败过程,并隐藏地址、认证字段等敏感内容。
配置与排查资料
入门、订阅异常与连接超时需要不同的处理顺序。先判断问题发生在安装、配置获取还是实际连接阶段,再选择对应文章。记录一次完整操作过程和明确的报错,比重复更换模式更便于排查;已经正常工作的配置先保留,不必为了测试把全部设置清空。
从 V2Ray 与 Xray 的关系讲起,梳理客户端怎么选、订阅由谁提供,以及系统代理与 TUN 的区别。适合已经找到安装入口,但还不清楚配置流程的用户按顺序阅读,先建立基本概念,再完成第一次连接。
阅读文章 →更新结果为空、无法解析或没有生成服务器条目时,先区分获取失败和内容格式问题。文章按链接有效性、更新路径、返回内容与客户端兼容性逐项说明,帮助保留原有可用配置,同时定位更新失败的环节。
阅读文章 →从本机网络与系统时间开始,再检查客户端模式、节点参数、传输安全、DNS 和内核日志。既适用于测试超时,也适用于显示已连接却打不开网页的情况;逐项改变设置,避免多个变量同时变化而失去判断依据。
阅读文章 →