PROJECT V CLIENT GUIDE

v2rayNG官网
V2Ray 客户端与订阅配置

集中整理 v2rayN 桌面客户端v2rayNG Android 客户端v2flyNG 备选客户端的下载入口和操作说明。从订阅导入开始,按真实设置项讲清系统代理、TUN、路由规则与日志排查。

永久免费 代码开源 Xray · V2Fly VMess · VLESS · Trojan · REALITY

CLIENT WORKFLOW

订阅、路由与代理设置

四张设置画布对应客户端最常用的操作区域。每张卡片都提供可切换的界面示意,帮助先理解设置项之间的关系,再进入完整教程逐步操作。

订阅分组
默认订阅已启用
自动更新订阅
更新后保留选择

SUBSCRIPTION

订阅分组管理

订阅链接适合持续接收配置更新,但不应把所有地址混在同一个列表里。按用途建立分组后,可以分别控制更新频率、当前选择和停用状态。导入时先确认链接复制完整,再为分组填写容易辨认的名称;更新完成后检查新增、移除与当前选中项,避免在不知情的情况下切换配置。与只提供单次粘贴入口的简单客户端相比,分组方式更适合同时维护日常配置、测试配置和临时配置,也便于出现订阅更新失败时缩小排查范围。

查看订阅导入步骤 →
路由规则
域名规则优先匹配
IP 规则顺序匹配
未命中流量默认出口

ROUTING

路由规则与分流顺序

路由决定不同域名、IP 与进程应走哪个出口,规则顺序比规则数量更重要。客户端通常从上到下匹配,前面的宽泛条件可能覆盖后面的精确条件,因此应先放具体规则,再放兜底规则。设置前先明确哪些应用需要系统代理、哪些连接保持直连,然后用日志确认实际命中的规则。教程同时解释域名策略、IP 解析和默认出口的关系,避免只复制一套规则却不了解其作用。清晰的分流结构还能减少不必要的转发,让故障定位更直接。

阅读路由配置说明 →
系统代理
设置系统代理
代理模式按路由规则
退出时清理设置

PROXY MODE

系统代理与 TUN 模式

系统代理主要接管遵循操作系统代理设置的应用,配置简单,适合浏览器和常见桌面软件。TUN 则从网络接口层处理更多流量,覆盖范围更广,但需要额外权限,也更依赖路由和 DNS 设置。两种方式不是必须同时开启:初次配置建议先使用系统代理验证订阅与配置可用,再根据应用兼容性决定是否启用 TUN。切换前应关闭正在进行的重要连接,并记录原有设置,以便发生网络异常时快速恢复。完整教程按由简到繁的顺序说明两种模式。

查看连接与代理设置 →
运行日志
日志等级warning
显示时间
自动滚动

DIAGNOSTICS

日志等级与故障定位

连接失败时,先看日志比反复切换配置更有效。正常使用可保持 warning 等级,问题复现期间再临时提高详细程度,并重点观察时间、目标地址、协议阶段和错误关键词。timeout 往往指向网络路径、地址或端口问题,rejected 需要继续判断本地规则与远端响应,invalid 则通常与配置字段不一致有关。排查时一次只修改一项,并保留修改前后的日志对照,才能确认真正原因。本站把高频报错翻译成具体检查动作,减少没有方向的重复尝试。

进入故障排查问答 →

PLATFORM DOWNLOADS

按当前设备选择客户端

桌面端统一从 v2rayN 开始,Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。下载页会进一步区分处理器架构与安装格式。

DESKTOP

Windows

Windows 用户优先选择 v2rayN。下载页同时提供新一代跨平台桌面界面与经典 WPF 界面,前者适合希望保持统一操作体验的用户,后者适合熟悉传统 Windows 设置方式的用户。安装后先导入订阅,再启用系统代理完成基础验证。

前往下载

DESKTOP

macOS

macOS 使用 v2rayN 桌面客户端。下载前先打开系统信息确认处理器类型,再选择 Apple Silicon 或 Intel 对应安装文件。首次启动如果系统要求确认应用权限,应按系统提示完成;之后从客户端内导入订阅,不要把订阅地址直接粘贴到浏览器地址栏。

前往下载

MOBILE

Android

Android 用户通常先选择基于 Xray 内核的 v2rayNG;需要使用 V2Fly 内核时,可选择 v2flyNG。主流设备适合 arm64 架构,不确定处理器类型时可使用通用安装文件。导入完成后需要允许系统建立 VPN 连接,随后再检查后台运行与电池策略。

前往下载

DESKTOP

Linux

Linux 桌面可使用 v2rayN,并按发行版选择 deb 或 rpm 安装格式,同时留意设备是 x64 还是 arm64 架构。安装后应先确认桌面环境中的系统代理入口,再决定使用系统代理或 TUN。权限、DNS 与防火墙设置是 Linux 环境中较常见的排查重点。

前往下载

QUICK START

三步完成基础连接

先完成最小可用配置,再继续调整路由、DNS 与后台策略。一次改动过多会让问题来源难以判断。

  1. 选择平台与安装文件

    进入下载中心后,先切换到当前操作系统。Windows、macOS 与 Linux 使用 v2rayN,Android 可选择 v2rayNG 或 v2flyNG。桌面设备要区分处理器架构和安装格式,Android 设备则在 arm64 与通用安装文件之间选择。下载完成后按系统正常安装,不要同时启动多个同类客户端,以免它们争用本地代理端口或重复修改系统网络设置。

  2. 导入订阅并检查配置

    复制完整的 V2Ray 订阅链接,在客户端的订阅分组或订阅设置中新增地址,然后执行一次手动更新。更新完成不等于配置一定可用,还应检查分组是否出现项目、地址与端口是否完整、协议类型是否符合预期。若更新失败,先核对系统时间、本机网络和链接首尾是否缺失,再查看客户端日志,不要连续重复点击更新。

  3. 启用代理并进行验证

    选择一个配置后,桌面端先启用系统代理,Android 端按系统提示建立 VPN 连接。验证时先访问日常使用的网页或应用,再观察客户端日志是否产生对应连接记录。基础连接稳定后,才继续配置路由、TUN、DNS 或自动更新。出现异常时按“本机网络、系统时间、订阅状态、配置参数、代理模式”的顺序检查,比随机切换设置更容易定位原因。

PROJECT V ECOSYSTEM

V2Fly、Xray 与客户端的关系

图形客户端负责配置管理和系统集成,内核负责处理协议、传输、路由与连接。理解这一层关系,才能正确判断更新内容和兼容范围。

Project V 生态与内核分支

Project V 是围绕网络代理协议、传输方式与路由能力形成的开源技术生态。早期 V2Ray 项目建立了配置结构和核心能力,随后社区维护逐渐形成不同分支。V2Fly 延续 V2Ray 生态中的核心实现与文档体系,强调社区协作和持续维护;Xray 则在兼容既有配置思路的基础上发展了自己的内核路线,并持续扩展协议与传输相关能力。两者不是图形客户端,也不等同于某一个安装界面。

v2rayN、v2rayNG 和 v2flyNG 位于内核之上。客户端把复杂配置整理成订阅分组、服务器列表、系统代理开关、TUN 设置、路由规则和日志窗口,让用户能够通过图形界面管理运行过程。真正建立连接、解析协议字段并执行路由的工作由所搭载的内核完成。因此,判断某项协议或传输是否可用时,需要同时查看客户端是否提供对应设置,以及内核是否支持相关字段。

三款客户端的定位

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,提供订阅管理、系统代理、TUN、路由、DNS 和日志等常用功能。它适合需要在电脑上集中管理多个配置的用户,也便于通过可见日志排查连接问题。不同桌面系统的安装格式和权限处理有所差异,但主要配置流程保持一致。

v2rayNG 面向 Android,使用 Xray 内核路线,界面围绕移动设备的 VPN 接管方式、订阅更新、路由设置与后台运行展开。移动系统会主动限制后台任务,因此连接稳定性不仅取决于客户端配置,也与系统电池策略、后台权限和网络切换行为有关。

v2flyNG 同样面向 Android,采用 V2Fly 内核路线,适合作为需要该内核生态时的备选。它与 v2rayNG 的基本使用逻辑相近,但内核实现、部分配置能力和更新节奏并不完全相同。选择时不必只比较界面,应先确认订阅中使用的协议和传输参数,再决定更合适的内核路线。

开源协议与社区维护

这三款客户端及其相关内核采用开源方式维护,源代码和变更过程由项目社区持续审阅。开源并不意味着所有版本之间都能自动兼容:配置字段会随着功能演进而调整,客户端界面也可能在不同平台采用不同实现。稳妥的更新方式是先阅读更新说明,保留当前可用配置,再更新客户端并执行一次基础连接测试。

社区维护的软件通常没有单一厂商式的固定发布节奏。客户端、内核和文档可能分别更新,某个新协议参数先进入内核,再由客户端补充图形设置,也可能先以手动配置形式出现。因此,遇到“设置项找不到”或“导入后字段缺失”时,应先区分问题来自客户端界面、内核支持还是订阅内容,而不是笼统判断整个 V2Ray 客户端不可用。

协议名称不等于完整配置

VMess、VLESS、Trojan 与 REALITY 等名称只描述配置的一部分。一次可用连接还会涉及服务器地址、端口、用户标识、传输方式、TLS 相关参数、域名、路径以及路由策略。客户端导入订阅后会把这些字段交给内核处理,任何关键字段不一致都可能造成超时、握手失败或配置无效。本站的协议说明侧重字段关系和客户端中的对应位置,不提供脱离服务端参数的“通用最优配置”。

COMMON QUESTIONS

常见问题精选

先看直接结论,再进入疑难解答页按分类继续排查。

v2rayN 订阅更新失败先查什么?

先确认普通网络连接与系统时间正常,再检查订阅地址是否完整、是否被复制出额外空格。随后打开日志观察请求阶段的错误信息。如果同一地址在其他设备也无法更新,应优先确认订阅状态;如果只有当前设备失败,则继续检查系统代理、DNS 与防火墙设置。

查看安装配置问答 →

VMess 与 VLESS 应该怎么选?

客户端不能脱离服务端配置自行替换协议。应以订阅或服务端提供的协议类型为准,并保持用户标识、传输方式、TLS 参数与域名等字段一致。VLESS 的配置通常更依赖配套传输与安全参数,VMess 也需要正确的时间和身份字段。

查看基础认知问答 →

系统代理与 TUN 有什么区别?

系统代理只影响主动读取操作系统代理设置的应用,配置轻量且便于恢复;TUN 从虚拟网络接口处理更广范围的流量,需要更多权限和更细致的路由配置。建议先用系统代理完成连通性验证,再根据具体应用是否被覆盖来决定是否启用 TUN。

查看代理模式步骤 →

节点超时为什么不应先反复切换?

超时可能来自本机网络、系统时间、订阅过期、地址端口、协议参数或路由设置。连续切换会同时改变多个变量,反而难以确认原因。固定当前配置,按网络、订阅、参数、代理模式和日志的顺序逐项检查,更容易找到稳定的修复动作。

查看故障排查问答 →

LATEST ARTICLES

客户端配置与排查文章

围绕移动端后台运行、内核选型和新手高频问题,补充教程之外的具体场景。

故障排查

v2rayNG 耗电快怎么办:Android 后台运行与省电策略排查

从系统电池统计入手定位耗电来源,逐项检查后台保活设置、路由规则粒度与订阅自动更新频率,并给出兼顾续航与稳定在线的配置思路。

阅读全文 →
内核与选型

Xray 与 V2Fly 内核有什么区别:版本关系梳理与客户端选型建议

梳理 Project V 生态中 V2Fly 与 Xray 两支内核的关系、协议支持差异与更新节奏,并说明 v2rayNG 与 v2flyNG 各自适合的使用场景。

阅读全文 →
入门指南

V2Ray 新手十问:订阅导入、协议选择与连接失败一次讲清

整理客户端选择、V2Ray 订阅链接填写、VMess 与 VLESS 配置关系、代理模式差异等常见问题,每个问题都给出可执行的检查顺序。

阅读全文 →