CLIENT ROUTING GUIDE

V2Ray下载站
客户端与配置指南

按设备选择 v2rayN、v2rayNG 或 v2flyNG,再依次完成 订阅导入、节点选择与路由设置。页面同时梳理桌面端与 Android 客户端的功能边界,便于在安装前确定合适的软件和内核。

永久免费 代码开源 Xray · V2Fly 中文配置文档
CLIENT GUIDE

客户端、订阅与路由的完整链路

V2Ray 的实际使用过程并不只包含安装。客户端负责管理配置,订阅负责提供节点集合,路由决定流量去向,内核则执行协议、DNS 与连接处理。按这条链路理解各层职责,遇到问题时才能准确判断应该修改客户端选项、订阅内容还是内核配置。

01 / CLIENT
v2rayN · v2rayNG · v2flyNG

先按平台选择客户端

Windows、macOS 与 Linux 的桌面入口统一以 v2rayN 为主。它把订阅更新、服务器列表、系统代理、路由规则、日志和内核管理放在同一套图形界面中,适合需要在桌面环境里持续维护多组配置的用户。Windows 页面同时提供新一代桌面界面与经典 WPF 界面,两者面向不同的操作习惯;macOS 需要按处理器架构选包;Linux 则按发行版的软件包格式选择。

Android 平台可在 v2rayNG 与 v2flyNG 之间选择。v2rayNG 使用 Xray 内核,适合已经采用 Xray 相关配置和协议组合的场景;v2flyNG 使用 V2Fly 内核,可作为需要对应生态实现时的备选。两款应用的基本流程相近,都是导入订阅或单条分享链接、选择服务器、启动连接,再检查实际网络访问结果。不同之处主要在内核支持范围和部分高级字段,而不是按钮位置。

选择客户端时不应只看系统名称,还要确认处理器架构、安装包格式和当前配置依赖的内核。本站下载页将这些判断放在每个平台的安装卡片旁,避免把软件包下载与后续配置割裂。初次使用可先完成标准安装和订阅导入,确认基础连接后再启用 TUN、FakeDNS 或自定义出站,排查路径会更清晰。

02 / SUBSCRIPTION
URL · SHARE LINK · LOCAL PROFILE

订阅导入与分组管理

订阅地址通常返回一组可更新的服务器配置,单条分享链接只描述一个节点,本地配置文件则可能同时包含入站、出站、DNS 与路由规则。三者都能进入客户端,但管理方式并不相同。订阅适合由提供方持续维护的节点集合;单条链接适合临时补充或独立测试;本地配置更适合需要精确控制字段、并了解内核配置结构的用户。

v2rayN 订阅导入后,应先为不同来源设置容易辨认的分组名称,再执行更新并观察是否生成服务器列表。多订阅场景可以按用途拆分分组,避免把测试节点、长期使用节点和临时配置混在同一列表。更新订阅通常会覆盖由该订阅生成的条目,因此需要长期保留的手工修改应独立保存,不要直接依赖订阅条目中的临时编辑结果。

导入成功不等于已经建立连接。客户端仍需要选中具体服务器,并根据使用范围开启系统代理或 TUN 模式。若更新后列表为空,应先判断订阅响应格式是否被客户端识别,再检查地址有效性和本机网络,而不是立刻修改所有路由与 DNS 项。相比只提供一个输入框的简化工具,完整客户端会保留分组、更新日志和节点来源,使配置变化更容易追踪。

03 / ROUTING
SYSTEM PROXY · TUN · RULES

系统代理、TUN 与路由规则

系统代理主要影响遵循操作系统代理设置的应用,适合浏览器和常规桌面软件。TUN 模式通过虚拟网络接口接管更广的流量范围,适合不读取系统代理设置的程序,但它同时会引入更多 DNS、路由优先级和权限变量。两种模式不是速度档位,也不需要同时开启才能工作;选择依据应是哪些应用需要被接管,以及当前系统环境是否允许创建虚拟接口。

路由规则在流量进入内核后决定使用代理出站、直连出站或阻断出站。规则可以依据域名、IP、端口、协议和进程信息进行匹配,顺序通常会影响最终结果。日常使用应从少量、目标明确的规则开始:先确认默认出站有效,再加入局域网直连、特定域名分流或指定应用策略。一次加入大量规则虽然看似完整,却会让冲突来源难以定位。

DNS 与路由需要配合考虑。域名先如何解析、解析结果是否进入规则匹配、请求由哪个出站发送,都会改变最终路径。遇到网页无法打开而 IP 连接正常时,应分别查看客户端日志、DNS 解析结果和路由命中情况。与只切换“全局”按钮的操作方式相比,按系统代理、TUN、DNS、路由四层逐级判断,更适合处理局部应用失效、域名解析异常或分流结果不符合预期的问题。

应用流量 代理入口 DNS 与规则 目标出站
04 / KERNEL
PROJECT V · V2FLY · XRAY

图形客户端与内核分层

图形客户端和代理内核属于不同层次。v2rayN、v2rayNG 与 v2flyNG 负责界面、订阅列表、参数组织、系统集成和运行状态展示;V2Fly 或 Xray 内核负责解析配置并执行协议、传输、DNS、路由和出站连接。界面中能够看到某个选项,并不表示所有内核版本都采用完全相同的字段;同样,内核支持某项能力,也可能需要客户端提供相应的配置入口后才能方便使用。

Project V 奠定了 V2Ray 配置模型和组件化设计基础,随后 V2Fly 社区继续维护 v2ray-core 及相关文档,Xray 则在相近配置思路上发展出独立内核实现。两条内核路线共享不少概念,但在协议扩展、传输能力、字段细节和版本演进上并不完全一致。订阅转换或手工迁移配置时,应保留服务器地址、端口、用户标识、传输层和安全参数,并核对目标内核是否识别对应字段。

日常排查可先确认问题位于哪一层:客户端无法保存订阅通常属于界面或输入问题;内核启动失败应查看配置解析日志;连接建立后访问异常则继续检查节点、DNS、路由和本机网络。明确分层后,不必因为一次连接失败就同时更换客户端、内核和全部规则。本站进阶手册进一步说明多订阅、服务器过滤、FakeDNS、自定义出站和复杂路由的组合方式。

PLATFORM PACKAGES

四个平台安装入口

平台入口只负责带到对应的下载标签页,具体安装包应继续按处理器架构和系统格式选择。桌面平台使用 v2rayN,Android 可按内核需求在 v2rayNG 与 v2flyNG 之间选择。安装完成后,建议先完成一次最小配置验证,再逐步加入订阅筛选和高级网络模式。

DESKTOP / WPF

Windows

Windows 使用 v2rayN。新一代桌面版采用跨平台界面,适合希望使用统一布局的用户;经典 WPF 版延续既有操作结构,适合熟悉传统菜单和列表管理方式的环境。两者都可完成订阅更新、节点切换、系统代理与路由设置。

进入下载页后再按操作习惯选择桌面版或经典 WPF 版,不需要同时安装两套界面。

前往下载
ARM64 / X64

macOS

macOS 使用 v2rayN,需要先确认处理器架构。较新的 Apple Silicon 设备选择 arm64 安装包,Intel 处理器设备选择 x64 安装包。架构选择错误通常会导致应用无法正常启动,因此应先在系统信息中查看处理器或芯片类型。

首次启动若被系统拦截,应按系统设置中的安全提示完成应用放行,并确认所需网络权限。

前往下载
XRAY / V2FLY

Android

Android 首选 v2rayNG,其 Xray 内核适合常见订阅和相关协议配置;需要 V2Fly 内核时可选择 v2flyNG。2015 年后的主流手机通常优先选择 arm64 包,无法确定架构或设备兼容范围较复杂时,可改用通用版。

安装后先导入订阅并选择节点,再启动连接;后台运行受限时,需要检查系统的电池与网络管理设置。

前往下载
DEB / RPM

Linux

Linux 使用 v2rayN。Debian、Ubuntu 及同类环境通常选择 deb 包,Fedora、RHEL 系发行版通常选择 rpm 包;每种格式还要区分 x64 与 arm64 架构。安装前应先确认发行版包管理体系和命令输出中的机器架构。

图形界面启动后仍需检查桌面会话权限、系统代理写入结果,以及 TUN 模式所需的网络权限。

前往下载
OPEN SOURCE CONTEXT

Project V、V2Fly 与 Xray的关系

识别图形客户端、代理内核和配置格式之间的层次,比单纯记住软件名称更有助于选型与排查。

A / ORIGIN

Project V 的组件化基础

Project V 形成了 V2Ray 生态早期的重要技术基础,其配置模型将入站、出站、路由、DNS、传输与策略拆分成可以组合的模块。这样的结构使同一套内核能够承担不同类型的本地入口和远程出站,也让图形客户端可以把复杂 JSON 字段转换为订阅列表、下拉选项和规则编辑界面。用户在 v2rayN 或 Android 客户端中看到的服务器、路由和 DNS 设置,本质上是在组织内核可读取的配置。

组件化也意味着问题需要按层定位。订阅地址无法更新时,应先检查输入与响应格式;内核无法启动时,应检查配置字段和启动日志;已经连接但部分应用不生效时,则需要继续判断系统代理、TUN、DNS 与路由。把所有现象统称为“节点问题”会忽略客户端和本机网络层的影响。

B / CORE FAMILY

V2Fly 与 Xray 的内核路线

V2Fly 社区延续并维护 v2ray-core 及相关组件,保留 Project V 配置体系中的许多核心概念。Xray 在相近的模块化思路上形成独立实现,并持续发展自己的协议、传输与配置能力。两者在入站、出站、路由、DNS 等概念上存在大量共通点,但具体字段、默认行为和扩展功能可能不同,不能仅凭配置外观相似就认定可以直接互换。

订阅转换时尤其需要关注目标内核。基础的服务器地址、端口、用户标识和传输参数通常容易映射,但某些安全设置、流控参数或传输扩展可能只适用于特定实现。转换工具只能重组已提供的信息,无法补全原始配置中不存在的关键字段。遇到导入后无法连接的情况,应回到原始链接与目标内核的字段支持范围逐项核对。

C / CLIENTS

三款客户端承担的职责

v2rayN 面向 Windows、macOS 与 Linux 桌面环境,负责订阅维护、节点列表、代理模式、路由规则、日志查看和内核调用。v2rayNG 面向 Android,使用 Xray 内核并提供移动端连接管理;v2flyNG 同样面向 Android,但使用 V2Fly 内核。客户端名称相近并不代表三者共享完全相同的界面代码或内核,选择时应以设备平台和配置依赖为准。

图形客户端降低了编辑配置的门槛,但不会改变网络处理的基本逻辑。订阅仍需要返回可识别内容,服务器仍需要处于可连接状态,域名解析仍受到本地和远端 DNS 策略影响,路由规则仍按匹配条件决定出站。理解这些事实后,客户端中的“更新订阅”“设为活动服务器”“系统代理”和“TUN 模式”就能对应到明确的处理阶段。

D / LICENSE & UPDATE

开源许可与更新判断

V2Fly、Xray 及三款图形客户端均以公开源代码方式维护,各项目按照自身采用的开源许可发布。不同组件的许可并不一定相同:内核与客户端属于独立项目,发布节奏也各自决定。开源属性便于社区审阅实现、提交修复并验证配置行为,但具体版本能否适配当前系统和订阅格式,仍应结合更新说明与实际环境判断。

更新客户端前,建议先记录当前订阅分组、代理模式和自定义规则,了解新版本是否调整了配置目录、默认内核或界面结构。若现有环境运行稳定,不必在未阅读变化说明时同时升级客户端、内核并重写路由。分阶段更新能够保留清晰的对照条件:先更新一个组件并完成启动、订阅、连接和分流验证,再继续处理下一层。