官方客户端安装包

V2Ray 客户端下载与版本选择

按操作系统选择 v2rayN、v2rayNG 或 v2flyNG。页面列出桌面界面版本、处理器架构、软件包格式和安装前检查项,下载前先确认设备信息。

四个平台 三款图形客户端 架构选择说明 安装与升级步骤
选择平台

对应系统的客户端安装包

切换平台后,仅显示该系统可用的图形客户端。每张卡片中的主按钮对应常用架构或推荐界面版本,次级入口用于其他架构与兼容选择。

Windows:v2rayN

Windows 提供桌面版与经典 WPF 版。两者都用于管理订阅、服务器配置、路由规则和系统代理,主要区别在界面技术与使用习惯。

v2rayN
首推

v2rayN for Windows

当前版本 7.24.1

桌面版 Desktop 新一代跨平台 UI,适合首次安装或希望使用当前桌面界面的用户。
下载桌面版
经典 WPF 版 沿用成熟的 Windows 原生界面,适合已有操作习惯或需要经典布局的用户。
下载经典 WPF 版

Windows 系统要求与选择依据

检查项 建议 说明
处理器架构 x64 本页 Windows 安装包面向 64 位桌面系统。可在“设置 → 系统 → 系统信息”中查看系统类型。
界面版本 首次使用选 Desktop Desktop 是新一代跨平台 UI;WPF 是经典稳定界面。已有配置的用户可按原有使用习惯选择。
升级准备 退出旧进程并备份配置 安装前关闭正在运行的 v2rayN,保存订阅、路由、DNS 与本地端口等重要设置。
安装流程

从下载到首次连接

安装包只是客户端程序。完成安装后,还需要导入有效配置、选择路由方式、启动连接并验证系统代理是否按预期工作。

  1. 01

    核对平台、架构与包格式

    先确认当前设备运行 Windows、macOS、Android 还是 Linux。桌面系统继续检查 x64、Intel 或 arm64;Linux 还需区分 deb 与 rpm。架构选错时,常见结果是安装程序拒绝执行、应用无法启动,或软件包管理器提示格式不匹配。

  2. 02

    退出旧客户端并保留配置副本

    升级已有客户端时,先结束正在运行的连接和后台进程。订阅地址、手动服务器条目、自定义路由、DNS 设置、本地监听端口和分应用范围都属于需要保留的配置。不同大版本的配置目录可能存在差异,保留副本有助于在迁移后逐项核对。

  3. 03

    按系统方式完成安装

    Windows 安装包按界面版本执行;macOS 打开 DMG 后按系统引导放置应用;Android 打开对应架构的安装文件;Linux 使用发行版的软件包管理工具处理 deb 或 rpm。安装过程中出现系统权限提示时,应先确认应用名称与当前操作一致。

  4. 04

    导入配置并检查基础参数

    打开客户端后,可通过订阅链接、二维码或手动方式导入配置。导入完成不等于已经建立连接,还应检查服务器条目是否出现、路由模式是否符合使用需求、本地监听端口是否被其他程序占用,以及 DNS 设置是否沿用预期方案。

  5. 05

    启动连接并查看日志

    选择需要使用的服务器配置,启动客户端核心,再按平台启用系统代理或应用连接。若连接未生效,先查看客户端状态与日志中的明确错误,不要连续修改多个设置。按订阅、端口、时间、DNS、路由的顺序逐项排查,更容易定位具体环节。

客户端选择

三款客户端的适用范围

客户端名称相近,但目标平台和内核实现不同。选择时先看操作系统,再看配置提供方要求,不需要同时安装所有客户端。

v2rayN

v2rayN

Windows · macOS · Linux

v2rayN 是桌面平台的主要图形客户端,提供订阅管理、服务器编辑、路由规则、DNS、系统代理与日志查看等功能。Windows 可在新一代 Desktop 界面和经典 WPF 界面之间选择;macOS 与 Linux 则需要额外核对芯片架构或软件包格式。

v2rayNG

v2rayNG

Android · Xray 内核

v2rayNG 是 Android 平台的首选客户端,适合通过订阅、二维码或手动参数管理配置。客户端支持分应用代理与移动端常见连接方式。大多数近年设备可使用 arm64 版本,只有架构不明确或兼容安装失败时才需要改用通用版。

v2flyNG

v2flyNG

Android · v2fly 内核

v2flyNG 是 Android 平台的备选客户端,适用于明确需要 v2fly 内核的配置环境。其安装包同样区分 arm64 与通用版。若配置提供方没有指定内核实现,通常先使用 v2rayNG;需要切换时先停止原客户端连接,避免两个应用同时接管系统连接。

下载常见问题

安装包、架构与升级

以下问题覆盖下载前最常见的版本判断。具体配置和连接问题可继续查阅使用文档与配置字段参考。

Windows 应该下载 v2rayN 桌面版还是经典 WPF 版?

桌面版采用新一代跨平台界面,适合首次安装或希望使用当前桌面体验的用户;经典 WPF 版沿用成熟的 Windows 界面与操作方式。两者都可以完成订阅管理、路由配置与系统代理设置。已有 WPF 使用习惯时可继续选择经典版,新安装则可先使用桌面版。

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

打开系统菜单中的“关于本机”,查看芯片或处理器一栏。显示 Apple M 系列芯片时选择 Apple Silicon 安装包;显示 Intel 处理器时选择 Intel 安装包。设备年份只能作为辅助信息,不应替代系统信息中的芯片字段。

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

2015 年后的主流 Android 手机通常使用 arm64 架构,可优先选择 arm64 安装包。架构不明确、设备较旧或 arm64 包无法安装时,再使用通用版。通用版的兼容范围更宽,但选择前仍建议从设备信息中确认处理器 ABI。

Linux 应该选择 deb 还是 rpm 软件包?

Debian、Ubuntu 及其衍生发行版通常使用 deb;Fedora、RHEL、Rocky Linux、AlmaLinux 等发行版通常使用 rpm。确定格式后还要运行 uname -m 检查架构:x86_64 选择 x64,aarch64 选择 arm64。

安装新版本前需要删除现有配置吗?

一般不需要主动删除配置。升级前应先退出客户端,并备份订阅、路由与 DNS 等重要设置。安装后先确认原配置是否被正确读取,再启动连接。跨越较大版本时,应逐项核对配置目录、系统代理模式与本地监听端口。

下载后无法启动客户端应先检查什么?

先核对操作系统、处理器架构和安装包格式是否匹配,再确认旧进程已经退出、系统权限允许启动。Windows 需确认所选界面版本符合当前环境;macOS 需核对芯片;Linux 需同时检查包格式与架构;Android 则先确认安装包 ABI。若仍无法运行,可记录完整错误提示并按使用文档逐项排查。