V2Ray CLIENT GUIDE

V2Ray 客户端指南

面向桌面与 Android 设备的中文操作资料,集中说明 客户端选择订阅导入路由分流,步骤按真实设置项组织。

永久免费 代码开源 中文文档 Xray · V2Fly
PRODUCT WALKTHROUGH

从订阅导入到系统级分流

配置顺序决定排查效率。先让订阅形成可用节点列表,再确认路由策略,最后按应用范围决定是否开启 TUN 模式。

真实设置项预览

切换标签查看订阅、路由与 TUN 三类界面结构。预览只展示字段关系,不生成节点或连接数据。

订阅分组设置subscription
分组名 默认分组
自动更新订阅
更新间隔 24 小时
01 / SUBSCRIPTION

订阅分组与更新边界

订阅地址承担的是节点列表分发,不等同于单个节点。v2rayN 可以把不同来源放入独立分组,并为每组设置备注、更新间隔与服务器过滤条件。初次导入时应先保持地址完整,手动执行一次更新,确认节点已进入对应分组,再考虑自动更新。多个订阅并存时,清晰的分组名比把全部节点混在一个列表里更容易维护;当某个来源发生变化,也能单独更新和排查,不影响其他分组。

查看订阅导入步骤 →
订阅分组3 项设置
备注日常订阅
分组名默认分组
自动更新
02 / ROUTING

路由规则按匹配顺序执行

路由分流用于决定哪些请求走代理、直连或阻断出站。规则通常按从具体到宽泛的顺序排列:先处理明确的域名、IP 范围与进程条件,再保留最终匹配规则。调整时需要关注规则顺序和目标出站名称,避免上方的宽泛条件提前截获后续请求。与只提供简单模式切换的工具相比,v2rayN 能直接管理规则集和自定义规则,适合需要区分办公服务、局域网资源与常规网络请求的桌面环境。

阅读路由规则实战 →
规则顺序top → bottom
域名匹配代理
私有地址直连
最终规则代理
03 / TUN

TUN 模式覆盖非代理感知应用

系统代理主要接管主动读取代理设置的程序,部分命令行工具、游戏启动器或独立网络组件可能绕过它。TUN 模式通过虚拟网络接口接收更广范围的系统流量,再交给内核执行 DNS 与路由规则。开启前应先在普通系统代理模式下确认节点可用,因为 TUN 同时涉及权限、虚拟网卡与 DNS 配置,排查链路更长。完成基础连接验证后再启用,可以把节点问题与系统接管问题分开判断。

查看 TUN 模式说明 →
TUN 模式advanced
启用 TUN
协议栈Mixed
自动路由
04 / DIAGNOSIS

测速结果需要对应测试目标

节点列表里的 Ping、真连接延迟和下载测速回答的是不同问题。Ping 更接近基础网络可达性,不能代表代理协议握手完成;真连接延迟会经过代理连接过程,更适合先排除失效节点;下载测速反映一段时间内的实际传输能力,但会受到服务端负载、本地网络和测试资源影响。排查连接时应先更新订阅,再做真连接测试,最后通过浏览器请求确认代理是否生效,不应只凭单一数字判断线路质量。

理解三种延迟测试 →
诊断顺序checklist
1更新订阅列表
2执行真连接测试
3验证代理请求
DOWNLOAD BY PLATFORM

按设备选择 V2Ray 客户端

桌面设备使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间选择。下载页会进一步区分处理器架构与安装包类型。

v2rayN

Windows

提供新一代桌面界面与经典 WPF 界面两种入口。适合需要系统代理、路由规则、订阅分组、真连接测试与 TUN 模式的桌面用户。

前往下载
v2rayN

macOS

按设备芯片选择 Apple Silicon 或 Intel 安装包。客户端界面与桌面端配置逻辑一致,可维护订阅、切换活动节点并设置系统代理。

前往下载
v2rayNG · v2flyNG

Android

v2rayNG 使用 Xray 内核,v2flyNG 使用 V2Fly 内核。主流设备通常选择 arm64 安装包,无法确认架构时可查看通用版入口。

前往下载
v2rayN

Linux

提供 deb 与 rpm 两类桌面安装入口,并按 x64、arm64 架构区分。适合希望通过图形界面管理订阅和路由的 Linux 桌面环境。

前往下载
QUICK START

首次连接的三个检查点

把导入、测试和验证分开执行,可以快速判断问题发生在订阅、节点还是系统代理环节。

  1. 01

    导入并更新订阅

    复制完整订阅地址,在客户端的订阅分组设置中新增地址并填写便于识别的备注。保存后手动更新一次,确认主界面出现节点列表。若列表为空,应先检查地址是否被截断、分组是否选对以及订阅是否仍可访问,不要直接进入 TUN 或 DNS 调整。

  2. 02

    选择节点并做真连接测试

    从当前分组中选中节点,执行真连接延迟测试。该测试会经过代理协议的连接过程,比单纯 Ping 更适合判断节点是否能完成握手。优先选择能够稳定返回结果的节点,不必只追求最低数字;地区、倍率、网络拥塞和服务端负载都会影响实际体验。

  3. 03

    启用代理并验证请求路径

    先使用系统代理模式完成基础验证,打开浏览器访问 IP 检测页面并进行普通网页请求。如果浏览器正常而其他程序未接管,再判断该程序是否读取系统代理;确有系统级接管需求时,按进阶手册开启 TUN。这样能避免一次改变多个变量导致定位困难。

查看完整教程 →
OPEN SOURCE ECOSYSTEM

Project V、V2Fly 与 Xray 的关系

Project V 是围绕网络代理协议、路由能力与可组合传输方式形成的开源技术生态。V2Ray 一词在日常使用中既可能指早期项目与内核,也常被用作整个客户端和协议生态的统称。客户端、内核、订阅服务并不是同一层组件:图形客户端负责设置与交互,内核负责协议处理和路由执行,订阅则提供服务器配置列表。

V2Fly 延续了 Project V 相关内核与工具的社区维护路线,v2flyNG 以 V2Fly 内核作为 Android 端实现基础。Xray 则是在相近配置体系上发展出的内核家族,持续扩展传输、协议与路由能力;v2rayN 和 v2rayNG 的常见配置通常围绕 Xray 内核展开。两条内核路线共享大量概念,但具体支持项仍应以客户端当前可见设置和内核文档为准。

v2rayN 是面向 Windows、macOS 与 Linux 的桌面图形客户端,负责订阅管理、节点切换、系统代理、路由规则、测速与 TUN 配置。v2rayNG 面向 Android,采用 Xray 内核,操作重点是订阅更新、活动配置选择、分应用代理与路由设置。v2flyNG 同样面向 Android,但使用 V2Fly 内核,可作为需要该内核路线时的备选客户端。

三款客户端均以开放源代码方式维护,软件更新通常包含客户端界面调整、内核适配、协议支持变化和问题修复。更新客户端前应阅读下载页的系统与架构说明;已有复杂路由、DNS 或多订阅配置时,先记录当前设置,再逐项确认新设置页面中的对应关系。配置格式随内核能力演进,旧教程中的字段位置可能与当前界面不同。

开源属性便于社区审阅实现、报告问题并持续改进,但它不替代正确配置。连接结果仍取决于订阅内容、节点服务状态、本地网络、系统代理接管范围与 DNS 路径。遇到问题时,应按“订阅是否更新、节点能否连接、代理是否启用、应用是否被接管、路由是否命中”的顺序逐层检查。

Project V 协议、路由与传输生态
Xray v2rayN v2rayNG
V2Fly v2flyNG 配置与内核工具
CLIENT 管理界面与系统接管 CORE 协议处理与路由执行 SUBSCRIPTION 服务器配置列表
TECHNICAL NOTES

V2Ray 配置与诊断文章

围绕测速指标、首次连接与协议差异整理的操作说明,重点解释判断依据,而不是只给出设置结论。

V2Ray 延迟测试数值怎么看:ICMP Ping、真连接延迟与下载测速的区别

拆解三种测速方式的测试对象:Ping 关注基础网络可达,真连接延迟经过完整代理握手,下载测速用于观察一段时间内的实际传输能力。

阅读全文

v2rayN 首次连接完整流程:选节点、跑真连接测速、确认代理已生效

从订阅列表中筛选能够完成连接的节点,再分别检查客户端代理状态与浏览器请求结果,避免把节点失效和系统接管问题混在一起。

阅读全文

VMess 和 VLESS 的区别是什么:普通用户一分钟搞懂两种协议

从用户能感知的加密方式、传输开销和服务端配置依赖切入,说明订阅中同时出现 VMess 与 VLESS 节点时应如何理解。

阅读全文
v2rayN下载