客户端安装包与架构说明

V2Ray 客户端下载

按操作系统选择 v2rayN、v2rayNG 或 v2flyNG。下载前先确认系统平台、处理器架构与安装包类型,避免把不同架构或不同包管理体系的文件混用。

桌面端:v2rayN Android:v2rayNG / v2flyNG 版本按发布清单更新
按平台选择

客户端与安装包

平台标签会同步到地址栏锚点,重新打开链接时可直接回到对应系统。版本文字与下载地址由同源发布清单更新;清单暂时不可用时,页面保留当前版本的完整下载路径。

Windows:v2rayN

Windows 平台固定提供 Desktop 与经典 WPF 两个入口。Desktop 是新一代跨平台界面,适合首次安装和希望保持桌面端界面一致的用户;WPF 延续经典布局,适合已经熟悉旧版菜单和操作路径的用户。

v2rayN

v2rayN for Windows

首推

桌面图形客户端,提供订阅管理、服务器选择、系统代理、路由配置与 TUN 模式等常用功能。

7.24.1
建议首次安装

Desktop 桌面版

新一代跨平台 UI。希望使用当前桌面界面与后续跨平台体验时,优先选择此包。

下载 Desktop 版
经典操作布局

WPF 经典版

沿用经典 v2rayN 窗口结构与菜单路径,适合需要保持既有操作习惯的用户。

下载 WPF 版

Windows 系统要求与安装说明

检查项 要求与判断方法
系统 使用仍在维护周期内的 64 位 Windows 桌面系统,并完成常规系统更新。
处理器 当前页面提供 x64 安装包。可在“设置 → 系统 → 系统信息”查看系统类型。
安装权限 安装程序需要写入应用目录;TUN 模式还可能要求提升权限以创建虚拟网络设备。
首次启动 先导入订阅或单个服务器配置,再选择配置、启动连接,并按需设置系统代理。

从另一版本迁移时,先记录订阅地址、路由规则和本地端口设置。不要在两个正在运行的客户端之间反复切换系统代理,否则浏览器可能继续引用已经停止监听的本地端口。

选择逻辑

从平台到安装包的判断顺序

安装失败通常不是客户端型号问题,而是平台、架构或包型选择不一致。按固定顺序判断,可以减少重复下载和配置迁移。

先确定操作系统

Windows、macOS 与 Linux 桌面端使用 v2rayN;Android 端优先使用 v2rayNG,需要 V2Fly 内核家族时选择 v2flyNG。不要把不同平台的文件扩展名作为同一类安装包处理。

再确认处理器架构

x64、arm64、Intel 与 Apple Silicon 描述的是处理器架构。应从系统信息读取,不建议依据设备品牌、外观或大致年份推断。Android 架构无法确认时,可使用通用版作为兼容选择。

最后选择包型与界面

Windows 在 Desktop 与 WPF 之间选择界面路线;Linux 在 deb 与 rpm 之间选择包管理体系。安装包确定后,再处理订阅导入、系统代理和路由规则,不要把安装阶段与连接阶段混在一起排查。

首次安装

安装、导入与连接的边界

下载并安装客户端只完成运行环境准备。客户端需要有效配置才能建立连接,系统流量是否进入客户端还取决于代理模式与路由设置。

安装阶段

确认文件属于当前平台和架构,退出同类客户端后再安装。升级现有客户端时,先记录订阅、路由规则、本地端口与 DNS 设置。安装程序完成不代表系统代理已经开启。

配置阶段

通过订阅地址、分享链接、二维码或手工参数导入配置。导入后执行订阅更新,检查服务器列表、分组与协议参数是否完整。空列表通常表示订阅没有成功解析,而不是安装包损坏。

连接阶段

选择配置并启动后,检查本地监听是否正常,再设置系统代理。需要接管更广流量范围时再配置 TUN 模式。两种模式的流量入口不同,不应在不理解规则时同时反复切换。

验证阶段

先查看日志中是否存在 DNS、端口、协议或连接超时错误,再测试浏览器。部分应用不遵循系统代理,此时应检查应用自身代理设置或评估 TUN 模式,而不是直接更换客户端。

需要完整配置流程

快速上手页按“导入订阅、选择模式、启动连接、验证结果”的顺序说明桌面端与 Android 客户端操作。

查看快速上手
下载常见问题

安装包选择与首次运行

以下问题集中处理版本路线、处理器架构、Linux 包型和安装后的连接条件。配置内容本身无效时,更换安装包通常不能解决问题。

Windows 应该选择 v2rayN Desktop 还是 WPF 版?

首次安装可优先选择 Desktop 版,它采用新一代跨平台界面。已经熟悉经典 v2rayN 操作布局,或需要沿用既有使用习惯时,可选择 WPF 版。两者不要同时运行,以免系统代理端口和配置状态相互影响。

macOS 如何判断应下载 Apple Silicon 还是 Intel 版本?

打开系统信息或关于本机,查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon 版本;显示 Intel 处理器时选择 Intel 版本。架构不匹配可能导致安装程序无法正常启动。

Android 应该选择 arm64 还是通用版?

2015 年后的主流 Android 手机通常采用 arm64 架构,可优先下载 arm64 版本。无法确认设备架构、安装时出现架构不兼容提示,或设备使用其他处理器架构时,再改用通用版。

v2rayNG 与 v2flyNG 应该怎么选?

Android 日常使用可优先选择采用 Xray 内核的 v2rayNG。需要使用 V2Fly 内核家族,或现有配置明确要求对应实现时,可以选择 v2flyNG。两款客户端的配置应分别管理,不建议直接覆盖彼此的数据目录。

Linux 应该下载 deb 还是 rpm 安装包?

Debian、Ubuntu 及其衍生发行版通常选择 deb;Fedora、Rocky Linux、AlmaLinux 等采用 RPM 包管理体系的发行版选择 rpm。还需要根据处理器架构区分 x64 与 arm64,不能只依据文件扩展名选择。

安装客户端后为什么还不能直接连接?

客户端只负责管理配置、内核与本地代理,需要先导入有效订阅或服务器配置,再选择可用配置并启动连接。之后根据使用范围开启系统代理或配置 TUN 模式,最后通过浏览器和客户端日志确认连接状态。