Windows / macOS / Android / Linux 桌面与移动客户端

V2Ray开源社区
v2rayN 下载与配置

下载v2rayN 查看教程

面向实际配置流程整理 免费开源客户端、Xray 与 V2Fly 内核、订阅导入和路由规则，从平台选择到连接验证均给出可复查的操作依据。

  • Xray 内核
  • V2Fly 生态
  • REALITY 协议
  • 中文配置文档
按操作系统进入对应下载区
Platform Downloads

按平台选择 V2Ray 客户端

桌面平台统一以 v2rayN 为主要入口，Android 可在 v2rayNG 与 v2flyNG 之间按内核需求选择。每个平台入口会直接打开下载页的对应标签。

Windows

可选择 v2rayN 跨平台桌面版或经典 WPF 版。桌面版适合希望使用一致界面的用户，WPF 版适合延续传统托盘与窗口操作方式的环境。

前往下载

macOS

v2rayN 提供适配不同处理器架构的桌面安装包。下载前先在系统信息中确认芯片类型，再进入对应入口，可减少安装包架构不匹配的问题。

前往下载

Android

v2rayNG 使用 Xray 内核，适合 VLESS、REALITY 等配置；v2flyNG 使用 V2Fly 内核，可作为偏向 Project V 原生实现的备选客户端。

前往下载

Linux

v2rayN 桌面版覆盖常见 deb 与 rpm 软件包格式，并提供不同处理器架构的入口。应先确认发行版的软件包体系与设备架构，再选择对应文件。

前往下载

查看全部客户端 →

Configuration Flow

订阅、路由与连接验证

客户端可用性不只取决于安装是否完成。订阅内容能否被正确解析、路由规则是否按预期命中、系统代理是否接管目标应用，都是需要逐项确认的配置环节。

1导入订阅 2选择路由 3连接验证

先建立可更新的订阅分组

在 v2rayN 中进入订阅分组设置，新增分组名称与订阅地址，保存后对当前分组执行更新。分组方式比逐条粘贴分享链接更适合长期维护：服务端内容发生变化时，只需更新对应分组，不必重新整理全部配置。导入后应先检查条目能否被客户端识别，并确认协议、地址、端口、传输方式等字段已经出现。订阅更新失败时，不宜连续重复点击，应按链接有效性、更新方式、格式兼容性和本地网络状态依次检查。

订阅分组设置
分组名称：日常配置
更新方式：不使用代理更新
自动更新间隔：按实际需要设置
操作顺序：添加地址 → 保存 → 更新当前订阅
Quick Start

v2rayN 三步快速上手

快速流程用于建立一个可检查的基础配置。首次使用时不建议同时修改大量高级参数，先让订阅、路由和系统代理形成完整链路，再按实际需求调整 DNS、Mux 或更细的规则。

01

安装并导入订阅

根据操作系统与处理器架构下载客户端。完成安装后打开订阅分组设置，填写分组名称和有效订阅地址，再执行更新。若采用单条分享链接，也应先确认客户端支持对应协议与传输组合。导入成功只表示配置已经进入客户端，不代表连接参数一定有效，因此还需要检查协议类型、服务器地址、端口、传输层、安全层和内核支持情况。

02

选择路由与系统代理模式

日常使用可先采用规则模式，将私有网络和符合 geosite、geoip 条件的流量交给 direct，其余流量使用 proxy。需要所有遵循系统代理的应用统一走代理出口时，可切换全局相关模式，但仍应理解部分应用可能忽略系统设置。v2rayN 的“自动配置系统代理”负责写入系统代理参数，本地监听端口则由客户端入站配置决定，两者需要保持对应。

03

连接并检查日志

选择一条配置后启动客户端，先观察内核是否正常运行，再确认系统代理状态。连接异常时从 warning 或 error 信息中定位域名解析、协议字段、证书时间、传输路径与端口占用等问题。不要一次改变多个参数，否则很难判断是哪项修改产生影响。较稳妥的方法是每次只调整一个变量，重新连接并记录结果，直到能够明确复现问题或确认修复。

完整教程进一步说明 Windows、macOS、Android 与 Linux 的安装差异，并包含订阅更新、路由选择、局域网连接和常见故障的连续操作步骤。

查看完整教程 →
Open Source Ecosystem

Project V、V2Fly 与 Xray 内核关系

客户端、内核与协议属于不同层次。理解各层职责，有助于判断配置兼容性，也能避免把图形界面中的选项与底层协议实现混为一谈。

从 Project V 到不同内核家族

Project V 形成了以 V2Ray 配置模型为基础的网络工具生态。其核心思想是把入站、出站、路由、DNS、策略和传输配置拆分为相对独立的模块，再由规则把这些模块连接起来。VMess 是较早期的代表协议，后续生态又逐步扩展出 VLESS、Trojan、Shadowsocks 兼容实现以及多种传输方式。配置文件中的 inbounds、outbounds 和 routing 等结构，至今仍是理解相关内核工作方式的重要入口。

V2Fly 延续 Project V 的社区维护方向，V2Ray Core 常被简称为 v2fly 内核。它保持模块化配置思路，并围绕协议支持、传输组件、路由资源和跨平台运行持续演进。v2flyNG 采用这一内核家族，适合需要 V2Fly 实现路径的 Android 用户。选择 V2Fly 不等于只使用 VMess，实际可用协议仍应以客户端内置内核与配置字段支持为准。

Xray 从相近的配置体系发展而来，在 VLESS、XTLS、REALITY 等方向提供了更集中的实现。v2rayN 与 v2rayNG 通常使用 Xray 内核，因此相同订阅在这两类客户端之间往往具有较接近的字段理解方式。不过，桌面端和移动端的系统代理、VPN 接管方式、DNS 行为与后台运行机制并不相同，不能仅凭内核一致就假设全部设置完全通用。

内核负责解析配置、建立连接、执行路由与处理数据传输；图形客户端负责订阅管理、参数编辑、系统代理切换、日志查看和内核进程管理。出现问题时，应先判断故障位于界面层还是内核层。例如订阅按钮无法解析内容，通常属于订阅格式或客户端解析环节；内核启动后提示字段无效，则更接近配置结构或内核兼容问题；只有部分应用不工作，则应检查系统代理或应用自身设置。

桌面客户端

v2rayN

v2rayN 是面向 Windows、macOS 与 Linux 的图形客户端，负责管理订阅分组、服务器配置、路由规则、DNS、系统代理和 Xray 等内核。跨平台桌面版与 Windows WPF 版在界面技术和托盘行为上存在差异，但核心使用流程都围绕导入配置、选择服务器、设置代理模式和检查日志展开。

Android · Xray

v2rayNG

v2rayNG 将 Xray 内核能力整合到 Android 客户端中，可导入常见分享链接和订阅内容，并通过系统提供的 VPN 接口接管应用流量。它适合需要 VLESS、REALITY、VMess、Trojan 或 Shadowsocks 配置的移动设备，路由、分应用代理和 DNS 行为应结合系统限制进行设置。

Android · V2Fly

v2flyNG

v2flyNG 采用 V2Fly 内核，可作为 Android 平台的另一种开源客户端选择。它与 v2rayNG 的界面思路相近，但底层内核家族不同。若订阅依赖 Xray 特有字段，应优先核对兼容性；若配置基于 V2Fly 支持范围，则可按相同的导入、连接和日志检查流程完成设置。

开源协议与更新机制

相关项目以公开源代码和开源许可证进行协作，客户端与内核通常采用各自独立的发布节奏。客户端更新可能集中在界面、订阅解析、系统集成和兼容性；内核更新则可能涉及协议实现、路由资源、传输组件、安全修复和配置字段。两者并非始终同步发布，因此排查新协议或新字段时，需要同时确认客户端是否能够传递配置，以及内核是否已经实现对应能力。

订阅服务提供的配置也有独立变化周期。更新客户端不会自动修正失效订阅，更新订阅也不会改变本地程序能力。较清晰的维护方式是分别记录客户端更新、内核变化与订阅调整，在出现异常后先确定最近发生变化的层次。这样可以减少盲目重装或反复覆盖配置，并保留可回退的判断路径。

  • 客户端界面
  • 内核进程
  • 订阅解析
  • 路由资源
  • 系统代理
Technical Notes

V2Ray 配置与协议文章

围绕协议原理、订阅故障和平台权限整理可执行的检查方法。文章优先解释参数之间的关系，再给出适合实际操作的处理顺序。

协议科普

REALITY 与 XTLS Vision 为什么快：握手复用与流控原理科普

从 TLS 握手成本讲起，解释 REALITY 的握手方式、XTLS Vision 减少重复处理的思路，以及两者在 Xray 内核中的配合前提。文章同时区分协议、安全层和流控参数，避免只根据名称判断性能。

阅读全文 →
故障排查

V2Ray 订阅更新失败怎么排查：链接、解析与格式自查清单

按链接有效性、更新方式、Base64 内容、分享链接格式和客户端支持范围整理检查顺序。重点说明为何重复点击更新通常不能解决格式或兼容问题，以及怎样区分网络失败与解析失败。

阅读全文 →
平台专题

v2rayN macOS 安装被拦截：未验证开发者与网络权限处理步骤

说明隐私与安全性面板中的放行流程、隔离属性处理思路，以及系统代理未生效时的检查方法。步骤区分程序启动权限与网络代理权限，便于定位提示来自哪个系统层次。

阅读全文 →

查看全部文章 →

v2rayN下载