client packages

V2Ray 客户端下载与平台选择

按操作系统、处理器架构与界面类型选择安装包。桌面端使用 v2rayN,Android 可在 v2rayNGv2flyNG 之间按内核需求选择。

Windows / macOS / Android / Linux 图形客户端 中文安装说明
platform

按平台选择客户端

切换平台后只显示对应客户端、安装包入口与系统要求。页面地址会同步平台锚点,可直接保存当前平台入口。

windows packages

Windows:v2rayN

同一客户端提供两种界面路线。先选 Desktop 或 WPF,再下载对应的 x64 安装压缩包。

v2rayN
首推 7.24.1

v2rayN for Windows

适用于订阅管理、节点切换、路由分流、系统代理与 TUN 配置。Desktop 使用新一代跨平台 UI;WPF 使用 Windows 经典界面,设置入口与既有操作习惯更接近。

建议优先

Desktop 桌面版

新一代跨平台界面,适合首次安装或希望桌面端界面保持一致的用户。

下载 Desktop 桌面版
经典界面

WPF 版

Windows 经典稳定界面,适合熟悉旧版菜单结构与既有配置路径的用户。

下载经典 WPF 版

Windows 系统与选择说明

检查项 建议 判断路径
处理器架构 当前入口为 x64 打开“设置 → 系统 → 系统信息”,查看系统类型。
界面类型 新安装优先 Desktop 已有 WPF 使用习惯或配置流程时,可继续选择 WPF。
安装权限 按系统提示完成安装 TUN 等接管系统流量的功能可能需要提升权限。
decision path

安装包选择检查表

下载失败之外,更多安装问题来自平台、架构或包格式选择错误。以下顺序可用于桌面端与移动端的统一判断。

system

确认操作系统,而不是只看设备品牌

先确认设备当前运行 Windows、macOS、Android 还是 Linux,再进入对应平台面板。双系统、虚拟机和远程桌面场景应以实际执行客户端的系统为准。例如在 Windows 主机中运行 Linux 虚拟机时,客户端安装在虚拟机内就应选择 Linux 包;安装在宿主系统则选择 Windows 包。平台判断决定安装格式、权限提示与系统代理的配置入口。

architecture

区分 x64、arm64 与 Apple Silicon

处理器架构决定安装包能否直接运行。Windows 当前页面提供 x64 桌面包;macOS 按 Apple Silicon 与 Intel 拆分;Android 提供 arm64 和通用包;Linux 同时提供 x64 与 arm64。架构名称在不同系统中可能显示为 x86_64、amd64、aarch64 或 arm64,应按对应关系选择,而不是根据设备购买年份单独判断。

package

识别安装格式与界面路线

Windows 的 Desktop 与 WPF 是界面路线差异;macOS 的两个 DMG 是芯片差异;Android 的 arm64 与通用版是目标架构范围差异;Linux 的 deb 与 rpm 是包管理体系差异。文件扩展名不是版本高低排序,不能把 rpm 当成 deb 的新版,也不能把通用 Android 包理解为功能更多。选择标准应回到系统和架构。

configure

安装完成后继续导入配置

客户端程序安装完成并不等于连接链路已经建立。还需要导入有效订阅或手动添加服务器,更新订阅列表,选择节点与代理模式,然后启用系统代理或按需配置 TUN。首次连接建议先使用基础系统代理模式验证浏览器流量,再逐步加入 DNS、分应用代理与自定义路由,便于在出错时定位具体环节。

查看订阅导入与连接教程
after download

下载后的安装与首次启动

不同平台的安装界面不同,但配置链路一致:安装客户端、确认权限、导入订阅、选择节点、启用代理、验证访问路径。

01

完成平台安装

Windows 解压下载文件后运行安装程序,并根据所选 Desktop 或 WPF 版本完成安装。macOS 打开 DMG,将应用放入应用程序目录。Android 打开下载的安装包并按照系统提示继续。Linux 使用与发行版对应的软件包工具安装 deb 或 rpm,避免只解压文件后直接运行其中的单个组件。

02

确认系统权限

客户端首次启动可能触发网络访问、防火墙、VPN 接管或虚拟网卡相关权限。权限类型取决于平台与启用的功能。只使用系统代理时通常先处理基本网络权限;启用 TUN 时还需允许客户端创建和管理虚拟网络接口。遇到权限提示应先阅读对应功能,再决定是否启用。

03

导入订阅并更新节点

在订阅管理界面添加完整订阅地址,保存后执行更新。节点列表出现后,先确认名称、协议与服务器信息已经正确解析。如果更新失败,应检查订阅地址是否完整、网络请求是否成功,以及系统时间是否准确。不要在订阅尚未更新成功时反复切换代理模式。

04

选择模式并验证链路

选中一个可用节点,先启用基础系统代理模式进行验证。浏览器能够通过客户端访问后,再设置路由分流、DNS 或 TUN。出现客户端已连接但应用无法访问的情况,应依次检查节点状态、系统代理、本地监听端口、DNS 与应用自身代理设置,避免同时修改多个选项。

package notes

客户端型号与使用边界

三个客户端面向不同平台和内核路线。选择时以操作系统、现有配置与日常管理方式为主,不需要同时安装全部客户端。

v2rayN

桌面平台统一入口

v2rayN 覆盖 Windows、macOS 与 Linux,适合在桌面系统中管理订阅、服务器、系统代理、路由规则和 TUN。Windows 同时提供 Desktop 与 WPF 两种界面;macOS 与 Linux 使用跨平台桌面界面。多台桌面设备可以采用同一订阅,但各平台的权限、系统代理与安装方式仍需分别配置。

v2rayNG

Android 常规首选

v2rayNG 采用 Xray 内核,移动端功能围绕 VPN 接管、应用分流、订阅更新与节点切换组织。常见 Android 配置可先从 v2rayNG 开始。导入桌面端订阅后仍应检查路由与 DNS,因为移动网络、无线网络和后台运行策略会带来与桌面系统不同的行为。

v2flyNG

v2fly 内核备选

v2flyNG 适用于配置明确要求 v2fly 内核,或现有使用环境已经围绕 v2fly 行为建立的场景。它与 v2rayNG 都能处理常见订阅和节点配置,但支持细节、默认选项与更新节奏可能不同。切换客户端前应先确认订阅包含的协议与传输配置是否由目标客户端支持。

download faq

下载与安装常见问题

以下问题对应安装包选择、架构判断、客户端型号和首次连接路径。

Windows 应该下载 v2rayN Desktop 还是 WPF 版?

Desktop 是新一代跨平台界面,适合首次安装、希望桌面端界面保持统一,或计划在多个桌面系统间切换的用户。WPF 是 Windows 经典界面,菜单结构和既有操作路径更适合熟悉旧版 v2rayN 的用户。两者都能完成订阅导入、节点选择、系统代理与路由配置。切换版本前应保存订阅地址并记录自定义设置。

macOS 如何判断应选 Apple Silicon 还是 Intel 安装包?

打开系统菜单中的“关于本机”,查看“芯片”或“处理器”字段。显示 Apple M 系列芯片时选择 Apple Silicon arm64 版本;显示 Intel 处理器时选择 Intel x64 版本。芯片架构与系统外观没有直接关系,同一型号系列也可能存在不同代际,应以系统实际显示为准。

Android 应该下载 arm64 还是通用版?

2015 年后的主流 Android 手机通常优先选择 arm64。arm64 包只包含目标架构所需组件,适合架构明确的设备。无法确认设备架构、安装时提示不兼容,或设备采用其他处理器架构时,可以改用对应客户端的通用版。通用版主要扩大架构兼容范围,不代表功能更多。

v2rayNG 与 v2flyNG 应该如何选择?

常规 Android 使用可先选择采用 Xray 内核的 v2rayNG。已有配置明确依赖 v2fly 内核,或现有环境需要保持 v2fly 行为时,选择 v2flyNG。两款客户端的订阅、路由和 DNS 设置入口并不完全相同,从一个客户端迁移到另一个客户端后应重新核对配置,不要只确认节点列表是否出现。

Linux 应该选择 deb 还是 rpm 安装包?

Debian、Ubuntu 及其衍生发行版通常选择 deb;Fedora、Rocky Linux、AlmaLinux 等采用 RPM 包管理体系的发行版选择 rpm。确定包格式后,还需要判断处理器架构:x86_64 或 amd64 选择 x64,aarch64 或 arm64 选择 arm64。包格式正确但架构错误时,同样无法正常安装或启动。

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

安装包只完成客户端程序部署。启动后还需要导入有效订阅或手动添加服务器,更新节点列表,选择可用节点与代理模式,再启用系统代理或 TUN。首次配置建议先用系统代理验证浏览器访问,确认基础链路正常后再加入复杂路由、DNS 和全局流量接管设置。

下载客户端