客户端下载与配置手册

v2rayNG下载站
v2rayN 客户端指南

集中整理 四平台客户端入口订阅与路由配置Xray 与 V2Fly 内核说明。先按设备选择客户端,再依照步骤完成导入、连接和网络验证。

按当前设备打开对应下载分类

PLATFORMS Windows · macOS · Android · Linux
CLIENTS v2rayN · v2rayNG · v2flyNG
CORES Xray · V2Fly
MODEL 代码开源 · 社区维护
01 / SUBSCRIPTION

用订阅分组维护服务器配置

订阅链接适合集中维护由服务提供方发布的服务器配置。导入时先为分组填写清楚的名称,再执行一次更新,让客户端解析链接内容并生成可选配置。以后服务端调整参数时,通常只需更新原分组,不必逐项重建。

v2rayN 桌面端将订阅管理、服务器列表和更新操作分开放置,适合同时处理多个来源;v2rayNG 安卓端把相关入口收在侧边菜单中,操作路径更紧凑。无论使用哪一端,都应先确认订阅地址完整,再检查更新结果和当前选中的配置。列表为空时,不要反复切换系统代理,应先排查链接访问、订阅格式和更新过程。

02 / ROUTING

按域名与地址规则决定连接走向

路由分流在连接建立后继续工作,根据域名、IP 地址、端口或规则集决定流量使用代理、直接连接还是阻止访问。常见的“绕过局域网及中国大陆地址”属于预设路由模式,适合希望本地服务和常用直连资源保持原路径的场景。

预设模式能覆盖多数日常需求,但规则越多并不代表结果越准确。出现某个网站访问异常时,应先确认命中的规则和解析结果,再决定是否添加自定义项。自定义规则需要注意顺序,因为较早匹配的规则可能提前结束判断。与只提供单一全局开关的简单工具相比,v2rayN 和 v2rayNG 能把域名规则、地址规则与内核路由能力组合起来,便于按业务需求逐步调整。

03 / CORE

根据协议能力选择 Xray 或 V2Fly

图形客户端负责配置管理和交互,真正处理连接、传输与路由的是底层内核。Xray 与 V2Fly 都源自 Project V 技术体系,基础配置思路相近,但二者在协议扩展、功能演进和部分字段支持上存在差异。选择内核时,应以现有配置所需能力为准,而不是只看名称。

v2rayN 可在桌面环境中管理不同核心配置,适合需要测试协议兼容性或维护多套方案的用户;v2rayNG 主要围绕 Xray 内核组织安卓端体验;v2flyNG 则提供基于 V2Fly 内核的替代路径。导入配置后若提示字段不支持,应先确认客户端和内核类型是否匹配,再核对协议、传输层与 TLS 参数,避免把内核兼容问题误判为服务器不可用。

04 / ACCESS

区分系统代理与 TUN 模式

系统代理通过操作系统提供的代理设置让兼容应用接入客户端,配置清晰、影响范围容易判断,适合浏览器和遵循系统代理的桌面程序。开启前需要先选择可用配置并启动内核;关闭客户端前也应恢复系统代理状态,避免应用继续指向已经停止的本地端口。

TUN 模式通过虚拟网络接口接管更广范围的流量,可覆盖不读取系统代理设置的程序,但同时涉及驱动权限、路由表、DNS 与其他网络工具的协作。首次配置建议先用系统代理验证订阅和节点是否正常,再根据应用需求启用 TUN。若启用后无法访问网络,应依次检查管理员权限、虚拟接口、DNS 策略和路由冲突,而不是同时改动所有参数。

按设备选择

四个平台的客户端下载入口

桌面平台使用 v2rayN,Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。下载页会继续提供架构、安装形式和系统要求说明。

Windows

Windows 用户可选择 v2rayN 桌面版或经典 WPF 版。桌面版采用跨平台界面体系,经典版延续熟悉的 Windows 操作方式。进入下载页后,再按使用习惯选择对应入口。

前往下载

macOS

macOS 使用 v2rayN 跨平台桌面版。下载前先在系统信息中确认处理器类型,Apple Silicon 与 Intel 需要选择不同构建,安装后再按系统提示授予网络相关权限。

前往下载

Android

Android 可首选采用 Xray 内核的 v2rayNG,也可按配置需求使用采用 V2Fly 内核的 v2flyNG。多数近年设备适合 arm64 架构,不确定架构时可在下载页查看通用版说明。

前往下载

Linux

Linux 使用 v2rayN 跨平台桌面版,可根据发行版的软件包体系选择 deb 或 rpm,并区分 x64 与 arm64 架构。安装前建议先确认桌面环境、架构和权限配置。

前往下载
快速上手

先导入,再连接,最后验证

把首次配置拆成三个阶段,每完成一步就检查结果。这样出现问题时,可以明确定位在订阅、内核启动还是系统接入环节。

查看完整教程
  1. 01

    导入订阅或单项配置

    在客户端中找到订阅管理入口,填写完整链接和便于识别的分组名称,然后执行更新。若使用单项配置,可通过剪贴板、二维码或手动表单导入。完成后先查看服务器列表是否产生有效条目,并确认协议与传输字段没有缺失。此时暂时不要修改路由和 DNS,让初始环境保持简单。

  2. 02

    选择配置并启动内核

    从列表中选中需要使用的配置,将其设为活动项,再启动客户端内核。桌面端通常需要继续开启系统代理,Android 端则需要确认系统网络连接授权。若内核无法启动,优先查看客户端日志中的配置解析信息,并核对当前内核是否支持订阅使用的协议字段。

  3. 03

    验证访问并逐项调整

    先用浏览器打开熟悉的网站,确认域名解析和基础访问正常,再测试需要代理的目标。只有基础连接稳定后,才继续启用自定义路由、TUN 模式或更复杂的 DNS 设置。若调整后出现异常,可撤回最近一次变更并重新测试,避免多个变量同时变化导致判断失焦。

开源生态

Project V、V2Fly 与 Xray 的关系

理解客户端、内核和协议配置之间的分工,有助于正确选择软件,也能在订阅导入失败或连接异常时更快定位问题。

技术体系 Project V

协议配置、传输能力与路由机制的共同技术来源

V2Fly

延续 V2Ray 核心能力与社区规范

Xray

在同源基础上扩展协议与传输特性

生态历史与组件分工

Project V 奠定了 V2Ray 配置模型和模块化网络处理思路。随着社区发展,V2Fly 与 Xray 形成各自维护路线,但两者仍共享许多基础概念,例如入站、出站、路由、传输层与 DNS 配置。用户日常接触的 v2rayN、v2rayNG 和 v2flyNG 属于图形客户端,它们负责呈现设置界面、保存订阅、组织服务器列表并调用内核。实际协议握手、流量转发和规则匹配由内核完成。

因此,“客户端能打开”不等于“配置一定可用”。当日志提示协议字段无法识别时,问题可能位于内核兼容性;当只有部分应用无法联网时,问题更可能位于系统代理、TUN 接管或路由规则。把界面层与内核层分开判断,比反复安装客户端更有效。

三款客户端的定位

v2rayN 面向 Windows、macOS 和 Linux 桌面环境,提供订阅管理、服务器列表、系统代理、路由设置和多核心配置能力,适合需要在桌面端集中维护连接方案的用户。v2rayNG 面向 Android,围绕触屏操作和系统网络连接流程组织功能,通常配合 Xray 内核使用。v2flyNG 同样面向 Android,但采用 V2Fly 内核路线,可作为特定配置或内核偏好的备选。

选择客户端时先看操作系统,再看内核要求。桌面设备直接进入 v2rayN 分类;Android 配置若依赖 Xray 特性,可优先选择 v2rayNG,若明确需要 V2Fly 行为,则选择 v2flyNG。客户端之间不需要用功能数量简单排名,匹配当前平台和配置格式更重要。

开源许可与可审阅代码

三款客户端与相关内核均采用公开源代码的社区维护模式,项目的许可文件、代码变更和发布记录构成可追踪的技术资料。开源许可明确了复制、修改和再分发的条件,也使开发者能够审阅网络请求、配置处理和内核调用方式。对普通用户而言,实际价值在于软件行为可以被技术社区持续检查,问题修复和兼容性讨论有明确依据。

开源属性不替代正确配置。订阅内容、服务器管理和本地设备权限仍由用户自己的使用环境决定。安装后应按最小必要范围开启系统权限,避免从来源不明的文本中直接导入无法解释的复杂规则,并在调整网络设置前保留原有配置。

更新机制与兼容性判断

客户端、内核和订阅格式的更新节奏并不完全一致。客户端更新可能带来界面调整与系统适配,内核更新通常涉及协议能力、传输实现和规则处理,订阅服务则可能改变编码方式或下发字段。出现“过去可用、更新后异常”的情况时,应先确认变化发生在哪一层,再阅读对应错误信息。

合理的更新顺序是先保存现有配置,再更新客户端或内核,启动后用原有配置完成基础测试,最后更新订阅并检查新增字段。若连接失败,可从系统时间、域名解析、TLS 参数、SNI、协议字段和路由命中顺序逐项检查。一次只改变一个条件,能让排查结果更可靠。