• 开源客户端 · 中文配置指南

V2Ray开源社区 客户端下载与配置

整理 开源客户端下载入口,用中文步骤说明订阅导入、路由分流与内核选择。

  • VMess
  • VLESS
  • REALITY

CLIENT SHELF / 下载入口

按平台选择客户端

桌面端先看 v2rayN,安卓端先看 v2rayNG。下载前确认系统与处理器架构,再按教程导入配置。

Windows

v2rayN 首推

提供桌面版与经典 WPF 版入口。桌面版采用跨平台界面,WPF 版保留熟悉的桌面操作布局。先在系统设置里确认设备类型,再到下载页查看安装说明;不要仅凭安装包名称相近就替换正在使用的程序。

首次运行后,先保存订阅地址并更新分组,再选择节点、配置系统代理。已有配置的用户可以先做备份,保留原来的分组、路由与本地端口,避免迁移时同时改变多项设置。

macOS

v2rayN

按芯片选择 Apple Silicon 或 Intel 安装入口。点系统菜单中的「关于本机」,查看显示的是芯片名称还是 Intel 处理器,再选择对应的包。下载页集中说明两种架构,方便与当前设备逐项对照。

初次启动时,按系统提示确认权限。先用系统代理验证浏览器能否访问目标页面,再考虑是否需要 Tun。虚拟网卡模式的权限、路由接管范围与普通系统代理不同,不必在首次配置时一起开启。

Android

v2rayNG 首推

v2rayNG 使用 Xray 内核,v2flyNG 是使用 v2fly 内核的备选。常见设备可先查看 arm64 入口;无法确认处理器架构时,再阅读通用版说明。选择客户端时还要看订阅所用的协议参数,而不只是应用名称。

导入订阅后,点选一个节点,再启动连接并确认系统的 VPN 授权提示。如果退出界面后连接中断,到系统的电池和后台管理中检查限制。后台权限影响连接能否持续,并不能替代对节点配置本身的检查。

Linux

v2rayN

按发行版的软件包体系选择 deb 或 rpm,再确认设备是 x64 还是 arm64。软件包格式与处理器架构是两件事:前者决定交给哪个包管理器安装,后者决定程序是否能在当前处理器上运行。

图形界面启动后,先检查本地监听端口和桌面环境的代理设置。部分应用不会自动跟随系统代理,需要在应用中单独指定。启用 Tun 前再核对权限要求,避免把权限问题误判成订阅失效。

企鹅图形:Font Awesome,CC BY 4.0。

CONFIGURATION / 配置流程线

订阅、代理与路由设置

先让一条配置正常工作,再调整接管范围。下面按实际配置顺序整理入口;界面名称可能随客户端与系统略有变化。

订阅分组与更新路径

订阅是供客户端读取配置的地址,不等于已经建立连接。在 v2rayN 打开「订阅分组设置」,填写分组名和订阅地址,保存后执行更新。分组能把不同来源分开,排查时也更容易确认是哪一组返回了错误。若更新失败,先检查链接是否过期、是否复制完整,再尝试「更新订阅(不通过代理)」。这项操作只改变获取订阅时的网络路径,不会替你修正失效地址。不要反复导入同一链接,以免产生重复条目。

查看订阅导入步骤 →
设置示意

订阅分组设置

分组名日常使用
更新订阅不通过代理

订阅地址可能包含访问凭据,请勿公开分享。

系统代理与 Tun 接管

先选中节点,再在「系统代理」中点「自动配置系统代理」,让遵循系统设置的应用连接本地代理端口。它并不表示所有程序都已接管;某些应用需要单独填写代理,另一些场景才需要 Tun,也就是通过虚拟网卡处理流量的模式。初次使用先保持一种接管方式,验证浏览器访问后再增加设置。退出客户端前可选择「清除系统代理」,避免程序停止后系统仍指向本地端口。Tun 所需的权限与组件应按对应平台教程处理。

查看连接与验证步骤 →
系统代理
  • 清除系统代理
  • 自动配置系统代理
  • 不改变系统代理

静态示意,选项不会修改当前设备。

路由规则与局域网访问

路由分流决定流量交给直连、代理还是阻断出口,与系统代理是否开启不是同一个开关。在客户端的路由设置里先选适合的预设,保留局域网直连,避免访问路由器、打印机时绕到远端。需要新增域名规则时,先确认规则顺序,再用目标网站验证;较早匹配的规则可能让后续规则不再生效。若只有个别域名异常,还应检查 DNS,也就是域名到地址的解析过程。一次只改一项,才能区分是解析失败还是出口选择不符。

阅读路由与协议参考 →
路由设置示意

绕过局域网

局域网地址直连
规则匹配按顺序处理

规则预设名称与具体行为以当前客户端为准。

协议参数与内核能力

内核负责实际建立连接,客户端负责把界面里的设置转成配置。看到相同协议名称,并不代表不同内核支持完全相同的传输与安全参数。使用包含 REALITY 或特定流控参数的配置时,应先核对客户端和 Xray 的支持情况;已有 v2fly 配置则按原有字段检查兼容性。切换前记录当前选择,保存后查看启动日志,再验证同一目标页面。不要把所有协议同时换一遍:连接失败也可能来自地址、时间设置或服务器端参数不一致。

比较 V2Fly 与 Xray →
核心设置示意
内核类型 Xrayv2fly

先核对协议、传输、安全层与流控参数,再选择对应内核。

多端复用订阅,分别检查设置

多端同步的重点是复用有效订阅,而不是直接覆盖另一台设备的全部配置。在 v2rayN 与 v2rayNG 中分别保存同一个订阅地址,再各自执行更新;这不代表两端会自动同步系统代理、应用分流或后台权限。导入后核对协议与安全参数是否保留,选择节点后独立测试。迁移设备前可使用客户端提供的备份功能,但订阅地址与导出的配置都可能包含访问凭据,应存放在受控位置。共享截图时遮住地址和身份字段,只保留排查所需信息。

查看桌面与安卓配置说明 →
配置迁移清单
订阅地址各端分别保存
路由与权限各端分别确认

同步订阅内容,不等于同步设备的系统设置。

PROJECT V / 开源生态

客户端、内核与协议的关系

把三层概念分开,下载与排查都会更清楚:客户端提供操作界面,内核执行连接,协议约定通信方式。

v2rayN → 按配置选内核 v2rayNG → Xray v2flyNG → v2fly

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 / 配置与排查

近期技术文章

按问题所在的环节阅读:订阅无法更新、连接后无法访问,或需要进一步理解协议与流控。

v2rayN下载