客户端与配置文档入口

V2Ray官网入口:v2rayN 客户端与配置指南

集中查找 v2rayN 桌面客户端Android 客户端中文配置文档,按系统完成安装、订阅导入、代理模式选择和路由检查。

Project V 生态 V2Fly / Xray VMess / VLESS 中文操作文档

SYSTEM MODULES

系统模块注册表

从订阅数据进入客户端开始,配置会依次经过协议解析、路由判断、DNS 查询与本地代理接管。逐项查看每个模块负责的范围,以及修改设置时需要确认的边界。

路由引擎:按目标决定出口

路由引擎读取域名、目标地址、目标端口和进程等条件,再把连接交给指定出口。常见用法是让局域网与直连范围保留原路径,其余请求按规则进入代理出口。规则顺序会影响命中结果,因此调整前应记录当前模式,先用少量明确条件验证,再逐步扩大范围。v2rayN 提供预设路由与自定义规则入口,普通使用者通常先从预设模式开始,出现特定站点路径不符合预期时,再检查域名规则、地址规则与最终兜底项。

engine: domain / ip / port rules action: direct / proxy / block

PLATFORM ENTRY

四个平台下载入口

先按当前设备选择平台,再根据处理器架构和安装包格式进入对应客户端。首页只负责平台导航,具体文件、版本说明和系统要求集中在下载中心。

desktop / x64

Windows

桌面端首选 v2rayN。下载页分别提供新一代跨平台桌面界面与经典 WPF 界面,适合常规代理、订阅管理和路由配置。选择前可先确认系统架构,再按界面习惯决定安装入口。

前往下载

desktop / arm64 · x64

macOS

macOS 使用 v2rayN 桌面版,需要按 Apple Silicon 或 Intel 处理器选择安装文件。首次运行时应完成系统放行与网络权限确认,随后再导入订阅并切换系统代理,避免把权限问题误判为节点问题。

前往下载

mobile / arm64 · universal

Android

Android 可在 v2rayNG 与 v2flyNG 之间选择。v2rayNG 使用 Xray 内核,适合作为常规首选;v2flyNG 使用 V2Fly 内核,可按订阅兼容情况作为备选。主流设备通常选择 arm64,无法确认架构时可查看通用版说明。

前往下载

desktop / deb · rpm

Linux

Linux 桌面端使用 v2rayN,根据发行版选择 deb 或 rpm 安装包。Debian、Ubuntu 系通常使用 deb,Fedora、RHEL 系通常使用 rpm;同时还要区分 x64 与 arm64 架构,并在安装后检查桌面入口与自启动设置。

前往下载

OPEN SOURCE ECOSYSTEM

Project V、内核与客户端的关系

V2Ray 相关名称分布在项目生态、内核实现、图形客户端和协议配置多个层级。先分清每一层负责什么,安装与排查会更直接。

ECOSYSTEM Project V 协议与代理工具生态
CORE FAMILY V2Fly 社区维护的内核家族
CORE FAMILY Xray 独立演进的兼容内核家族
DESKTOP v2rayN 桌面图形客户端
ANDROID v2rayNG Xray 内核客户端
ANDROID v2flyNG V2Fly 内核客户端

生态历史:V2Ray 不是单一安装程序

Project V 形成了一套围绕代理协议、传输方式、路由规则和配置格式的开源技术生态。日常搜索中,“V2Ray”可能指协议能力、核心程序,也可能泛指能够读取相关配置的图形客户端。用户真正操作的通常是 v2rayN、v2rayNG 或 v2flyNG;客户端负责界面、订阅和系统集成,底层内核负责建立连接、执行路由与处理协议。把图形界面和内核视为两个层次,有助于理解为什么客户端更新、内核更新与订阅更新并不等同。

内核家族:V2Fly 与 Xray

V2Fly 延续 V2Ray 核心能力并由社区持续维护,Xray 则在兼容部分既有配置的基础上独立演进。两者都能处理常见协议与路由配置,但可用功能、字段细节和更新节奏可能不同。订阅提供的节点是否能够正常使用,不只取决于客户端名称,还取决于客户端所调用的内核是否支持对应协议、传输层和扩展参数。遇到导入成功却无法启动的情况,应查看客户端日志中的配置错误,再对照当前内核能力判断,而不是反复删除同一条订阅。

开源协议:代码、发布与文档各有边界

三款客户端及其相关内核均属于开源软件生态,源代码许可用于说明代码可以被查看、研究、修改和再分发的条件。不同组件可能采用不同许可,用户在二次分发或集成时应以对应项目附带的许可文本为准。开源属性不代表所有第三方订阅内容都由客户端项目维护,也不代表某个节点服务属于 Project V。客户端、内核、订阅提供方和本地网络环境是相互独立的环节,排查时需要分别确认责任范围。

更新机制:客户端、内核与订阅分别处理

客户端更新主要改变界面、平台适配和配置管理能力;内核更新可能加入协议能力、修正配置解析或调整网络行为;订阅更新则从已有地址重新获取节点列表。三类更新应分开理解。正常使用时,可先确认当前客户端能够启动,再更新订阅并测试已知配置;只有在日志明确提示内核不支持字段,或平台兼容问题已经被新版处理时,才需要考虑客户端或内核升级。升级前记录代理模式、路由方案和自定义设置,便于对照变化。

QUICK ANSWERS

常见问题精选

安装前先确认客户端、订阅与代理模式的区别,可以减少重复配置。更完整的分类问答位于常见问题页。

01 / CLIENT

v2rayN、v2rayNG 与 v2flyNG 怎么选?

Windows、macOS、Linux 桌面系统优先选择 v2rayN。Android 通常从 v2rayNG 开始;当配置明确需要 V2Fly 内核路径,或需要对照两种内核行为时,再使用 v2flyNG。客户端名称决定操作界面与平台,真正处理协议的是它所调用的内核。

查看客户端选择说明 →

02 / SUBSCRIPTION

分享链接和订阅地址有什么区别?

vmess://vless:// 通常描述单个节点,导入后形成一条服务器记录;订阅地址返回一组可更新的节点内容,并由客户端按分组管理。只有分享链接时直接从剪贴板导入;持有订阅地址时应进入订阅设置添加,再执行更新操作。

查看订阅导入步骤 →

03 / MODE

系统代理与 TUN 应该先用哪个?

初次配置建议先用系统代理,它的接管范围容易观察,也便于确认浏览器等常见应用是否正常。部分程序不读取系统代理时,再评估 TUN。启用 TUN 前应了解虚拟网络接口、系统权限、路由表和 DNS 接管的变化,不要同时叠加多个网络接管工具。

查看代理模式术语 →

04 / TROUBLESHOOTING

节点无法连接,应该先检查什么?

先确认客户端核心已经启动,再看订阅是否更新成功、当前节点是否被选中、系统代理是否开启。随后读取日志中的第一条明确错误,区分域名解析、端口不可达、配置字段错误和权限问题。一次只修改一个变量,比同时更换客户端、节点和代理模式更容易定位原因。

打开故障排查问答 →