v2rayN · v2rayNG · v2flyNG

V2Ray中文下载站 客户端下载与配置教程

从订阅导入开始,按路由分流与TUN 设置逐项配置桌面及 Android 客户端。

永久免费 代码开源 Xray · V2Fly

订阅、路由与内核设置

先让基础连接可用,再逐项调整接管范围与解析方式。

v2rayN · 订阅分组设置示意
订阅分组
添加分组
地址(URL)
填写订阅地址
更新订阅
不通过代理
服务器过滤
按需设置

订阅分组把不同来源的配置分开保存,方便单独更新、筛选和停用。在 v2rayN 的“订阅分组”中打开“订阅分组设置”,添加备注与订阅地址,保存后对该分组执行更新。首次导入先保留默认过滤条件,确认有内容再设置关键词,避免规则过严导致列表为空。与逐条粘贴分享链接相比,分组更新能保留来源关系;但订阅内容仍由提供方决定,手动修改的参数也可能在下次更新时被替换。

配置顺序:先导入,再分流

首次使用不必把所有高级选项一次打开。完成订阅更新后,先选中一条有效配置,确认内核能够启动,再设置系统代理或授予 VPN 连接权限。基础连接正常后,才调整路由和 DNS。这样每次改动都有明确的测试对象,出现异常时也能回到上一项设置,而不是在多个开关之间反复尝试。

设置名称与实际界面

不同客户端的菜单位置会随界面更新调整,本文用“订阅分组”“路由设置”“参数设置”等常见名称定位功能。图中的开关仅用于说明设置关系,并非所有设备的推荐组合。遇到名称不同,先按功能寻找对应选项;需要逐步操作时可阅读入门指南,需要自定义规则时再查阅进阶配置。

按平台选择客户端

桌面使用 v2rayN;Android 优先选择 v2rayNG,按内核需求选择 v2flyNG。

Windows

v2rayN:桌面版与经典 WPF 版。桌面版采用跨平台界面,WPF 版保留经典 Windows 操作方式。两者的选择重点是界面习惯、系统要求与所需功能,不应把界面差异理解为订阅来源不同。下载前在系统“设置 → 系统 → 系统信息”中确认设备信息,再阅读安装包说明。

首次运行先选择一个有写入权限的配置保存位置,避免系统目录的权限影响设置保存。导入订阅后,在主窗口选择“自动配置系统代理”,让遵循系统设置的应用使用客户端。需要接管其他应用时,再单独检查 TUN;退出前留意系统代理是否恢复,避免应用继续指向已停止的本地代理端口。

前往下载

macOS

v2rayN:按芯片选择安装包。打开系统菜单中的“关于本机”,查看芯片或处理器信息,再选择 Apple Silicon 或 Intel 对应入口。架构选错可能导致程序无法运行或需要额外兼容层,不能单靠安装包名称中的客户端名来判断是否合适。

安装后先完成基本导入与连接测试,再配置系统代理和需要权限的网络功能。系统弹出的权限提示应结合正在执行的操作判断,不要照搬其他系统的驱动安装步骤。若浏览器可用而其他应用仍异常,先确认该应用是否读取系统代理,以及当前是否需要 TUN 接管,再检查路由规则。

前往下载

Android

v2rayNG 首推,v2flyNG 作为备选。前者以 Xray 为核心,后者适合需要 V2Fly 配置兼容性的场景。优先选择与设备架构对应的安装包,无法确定时再阅读通用版说明。分享链接中包含 REALITY 等参数时,应先核对客户端与内核支持情况,而不是轮流安装后凭连接按钮判断。

导入订阅或剪贴板内容后,选中配置并启动连接,首次启动需确认系统 VPN 授权。已经连接其他 VPN 时,先处理接管冲突。后台被系统停止会造成连接中断,可到系统电池管理中检查客户端后台运行权限。DNS、应用分流和路由选项应在连接可用后逐项调整。

前往下载

Linux

v2rayN:按发行版与架构选择包格式。使用 deb 包管理的发行版选择对应 deb 入口,使用 rpm 包管理的发行版选择 rpm 入口,同时区分 x64 与 arm64。图形界面的运行依赖、桌面环境和权限策略可能不同,安装前应阅读下载页的系统要求。

程序能启动并不代表桌面环境中的每个应用都会使用系统代理。浏览器、终端工具与后台服务可能分别读取不同的代理设置,测试时要明确是哪一个应用发起请求。TUN 模式还涉及网络设备与路由权限;若只需要图形应用代理,可先完成普通代理方式的配置,再决定是否扩大接管范围。

前往下载

客户端安装包与连接配置是两件事:安装客户端只提供配置管理和连接能力,订阅地址、服务器参数与使用权限需要另行准备。订阅链接可能包含访问凭据,导入时应确认来源,分享截图或日志前先隐藏地址、标识与认证字段。下载页集中说明安装包类型,首页不展示具体版本信息。

查看全部客户端
客户端与内核 · 职责对照
图形界面
导入 · 编辑 · 查看日志
代理内核
协议 · DNS · 路由
Project V
V2Ray 项目生态
内核家族
Xray · V2Fly

界面能保存参数,与内核能处理参数,需要分别确认。

Project V 开源生态
客户端与内核的区别

V2Ray 起源于 Project V 的网络代理工具体系。日常所说的“V2Ray 客户端”常把图形界面与代理内核放在一起讨论,但两者并不相同:v2rayN、v2rayNG、v2flyNG 提供便于操作的配置入口,内核则读取配置并处理实际连接。理解这一层关系,有助于分清“导入失败”“内核启动失败”和“远端握手失败”分别发生在哪里。

V2Fly 延续 V2Ray 的社区维护路线,Xray 则从相关代码基础发展出另一条内核分支。它们保留部分共同的配置概念,也各自演进协议与传输能力。内核名称不是性能排名;选择时应以服务端参数、协议支持和客户端集成为依据,不能把一端能用的配置原样套到所有内核。

三款开源客户端的定位

v2rayN 面向桌面配置管理,适合在窗口中维护订阅、调整路由并查看内核日志。v2rayNG 面向 Android,使用系统 VPN 接口承接流量,以 Xray 为核心;v2flyNG 则提供 V2Fly 路线的 Android 图形入口。这三款客户端均采用开源方式发布和维护,名称相近并不意味着功能完全相同,也不意味着配置字段可以跨端无条件互换。

如果订阅只提供标准分享链接,优先确认链接所描述的协议、传输方式和安全层,再选择客户端。VMess、VLESS 与 Trojan 是协议层面的名称,REALITY 属于连接安全机制相关能力;它们不能只用“支持 V2Ray”一句话概括。可在术语表先辨清概念,再到配置界面逐项核对。

开源许可与组件边界

开源许可规定代码的使用、修改和再分发条件。V2Fly 的 V2Ray 核心和 Xray 核心采用 MPL 2.0 许可;图形客户端以及随附的其他组件可能采用各自的许可,不能把某个内核的许可直接当成整个安装包的统一许可。涉及二次分发或修改时,应分别阅读对应组件的许可文本与声明。

代码公开便于社区审阅与协作,但不会代替设备权限管理、订阅来源判断或配置检查。客户端内的服务器地址、身份标识、私有订阅链接都可能具有敏感性。向他人描述故障时,应保留错误类型和必要的设置关系,去除认证信息;对外公开整份配置通常并不是排查问题的必要步骤。

更新界面与更新内核

图形客户端更新可能调整菜单、订阅解析和系统集成,内核更新则可能改变协议实现、配置字段或网络行为。遇到新协议不兼容时,应同时查看客户端是否能生成相应配置、内核是否支持该字段。只更新界面不一定解决内核能力缺失,只替换内核也可能与现有配置生成方式不匹配。

更新前保存现有配置与路由设置,记录当前可用的组合;更新后先进行基础连接测试,再恢复自定义规则。若出现异常,先阅读日志中的第一处明确错误,并与改动项对照。反复更新订阅无法修复本地权限问题,反复切换路由也无法解决错误的 SNI。维护记录越具体,恢复过程越可控。

从报错类型缩小范围

订阅更新后列表为空,先检查链接有效性、返回内容与过滤条件;内核无法启动,先看配置字段和本地端口冲突;出现证书相关错误,先检查系统时间、SNI 与证书域名是否对应。连接已建立但部分应用无法访问时,再区分系统代理接管范围、DNS 解析和路由匹配,不要直接把所有异常归因于服务器。

测试应围绕一个可复现的现象进行:同一应用、同一目标、一次只改一项。桌面与 Android 出现不同结果时,先比较内核、DNS 与本地接管设置,而不是仅比较订阅名称。常见现象可从疑难解答查起;需要解释规则顺序、FakeDNS 与自定义出站时,再阅读进阶配置手册。

V2Ray中文下载站整理客户端入口与中文操作说明,是独立的资料站。站点文档与客户端项目各自维护,本文中的设置示意用于理解操作关系;实际菜单、协议能力和系统要求以所用客户端的说明为准。站点定位与内容维护原则见关于页面。

使用心得与配置专题

从内核选型、DNS 行为和订阅报错,理解设置背后的判断依据。

选型对比

Xray 与 V2Fly 内核差异梳理:v2rayNG 和 v2flyNG 如何取舍

梳理 Project V 生态里 V2Fly 与 Xray 两条内核分支的来历,对比 VLESS、REALITY 等协议支持和配置兼容性,帮助判断 Android 端该选 v2rayNG 还是 v2flyNG。选择重点是服务端字段与内核能力是否对应,而不是客户端名称是否相近。

进阶配置

FakeDNS 工作原理与适用场景:什么时候该在 v2rayNG 里开启

FakeDNS 用保留地址段先应答域名查询,再在出站时还原真实域名。文章解释它在配套接管条件下如何帮助保留域名信息,以及它与 TUN、分流规则和应用 DNS 缓存的关系。理解适用前提后,再判断是否需要开启,避免把解析问题变成新的兼容问题。

故障排查

V2Ray 订阅更新失败、节点解析为空的原因与自查步骤

订阅更新后列表为空或提示解析失败,常见原因有链接过期、编码格式不符、更新经过不可用代理和过滤规则写错。按链接、网络路径、返回格式与筛选条件依次检查,可以先分清“没有取得内容”还是“取得内容但无法解析”,减少无关的重装操作。

查看全部文章