官方发行版本整理

V2Ray 客户端下载与安装包选择

按操作系统和处理器架构选择 v2rayN、v2rayNG 或 v2flyNG。页面列出桌面界面差异、移动端架构说明、系统要求和安装顺序。

选择当前平台 查看安装教程
Windows macOS Android Linux
平台安装包

系统优先，再选择架构与界面版本

每个平台面板只列出适用于该系统的图形客户端。切换标签会同步页面地址，刷新或分享链接后仍可直接打开对应平台。

WINDOWS · X64

Windows 版 v2rayN

桌面首推

Windows 提供 Desktop 与经典 WPF 两种界面。第一次安装、希望后续在不同桌面系统间保持接近的操作方式，可选 Desktop。已经熟悉旧版菜单、托盘与配置流程，可继续使用 WPF。两个版本不必同时安装，选择一种即可。

v2rayN Desktop

推荐

当前版本 7.24.1

Desktop 是新一代跨平台 UI，设置页面、订阅管理与路由入口采用统一布局。适合首次安装，或计划在 Windows、macOS、Linux 间使用相近操作逻辑的用户。安装包为 ZIP 封装的桌面安装程序，下载完成后先解压，再运行其中的安装文件。

下载 Desktop x64

适用于 64 位 Windows。文件：v2rayN-Desktop-Setup-x64-7.24.1.zip

v2rayN WPF

经典界面

当前版本 7.24.1

WPF 是 Windows 经典稳定版，保留用户熟悉的菜单结构、服务器列表和托盘操作。已有 v2rayN 使用经验，或现有工作流程依赖经典界面时可选此版本。升级前退出托盘中的旧进程，并记录当前配置目录位置。

下载经典 WPF x64

适用于 64 位 Windows。文件：v2rayN-Setup-x64-7.24.1.zip

Windows 系统要求与安装顺序

项目要求与操作
处理器架构当前安装包面向 x64 设备，可在系统设置的“系统类型”中确认。
写入权限安装到受保护目录时，系统可能要求确认管理员权限。
升级准备先退出客户端和托盘进程，再安装新版本；重要订阅与自建配置建议提前导出。
首次启动启动后先检查内核状态，再导入订阅，最后选择系统代理模式。
安装前检查

下载包选择的四个判断点

安装问题多由平台、架构、包格式或旧进程占用造成。下载前完成下面四项确认，可以减少重复安装和配置迁移。

01

确认操作系统

v2rayN 用于 Windows、macOS 与 Linux 桌面端；Android 端使用 v2rayNG 或 v2flyNG。桌面客户端与移动客户端的配置界面不同，但都可以通过订阅链接导入服务器配置。跨设备迁移时，优先使用同一订阅来源，不直接复制客户端内部目录。

02

确认处理器架构

Windows 当前入口为 x64。macOS 需要区分 Apple M 系列与 Intel。Android 主流手机通常使用 arm64，架构不确定时可选通用版。Linux 既要区分 x64 与 arm64，也要识别发行版使用 deb 还是 rpm 包管理体系。

03

记录现有配置

升级已有客户端前，先保存订阅地址、自建服务器配置、路由规则和本地端口设置。常规版本更新通常会继续读取原配置，但跨界面版本、跨安装目录或跨客户端迁移时，配置目录可能不同。保留一份可重新导入的配置更便于恢复。

04

退出正在运行的进程

桌面客户端关闭主窗口后可能仍停留在托盘或菜单栏。安装新版本前，应从客户端菜单执行退出，避免程序文件被占用。移动端覆盖安装前也应先断开当前连接，安装完成后再打开应用并检查订阅与路由状态。

安装与首次启动

从安装包到首次连接

下载只是第一步。客户端启动后还需要完成权限确认、订阅导入、节点选择和代理模式设置。以下流程适用于本页列出的图形客户端。

A

完成系统安装

Windows ZIP 包需要先解压，再运行安装程序。macOS 打开 DMG 后，将应用放入“应用程序”目录。Android 打开 APK 并按系统提示完成安装。Linux 使用与发行版匹配的软件安装器处理 deb 或 rpm，系统需要补充依赖时按包管理器提示执行。

安装目录应保持稳定。桌面端若频繁更换目录，旧快捷方式、配置路径和自动启动项可能指向先前位置。覆盖升级时优先沿用原安装方式，跨 Desktop 与 WPF 时则先确认配置目录和启动入口。

B

处理首次启动权限

图形客户端需要读取配置、启动本地监听端口，并根据选择修改系统代理或建立 VPN、TUN 连接。系统出现权限提示时，应先核对正在启动的应用名称，再按当前操作需要确认。桌面端若仅导入和编辑配置，部分网络权限会在第一次连接时才出现。

Android 首次连接会显示系统 VPN 配置确认。macOS 和 Linux 使用 TUN 时可能需要额外授权。Windows 安装到受保护目录或写入系统设置时，也可能触发权限确认。权限处理完成后再测试连接，避免把系统拒绝误判成节点故障。

C

导入订阅并更新

在客户端中打开订阅管理，填写服务方提供的订阅地址并保存，然后执行订阅更新。更新完成后检查当前分组中是否出现服务器条目。仅保存订阅地址不会自动产生可选节点，首次添加后需要主动更新一次。

订阅属于集中配置来源。服务方调整服务器或协议参数后，再次更新即可读取变化。自建节点则由用户逐项维护。两种来源可以存在于同一客户端，但建议按分组区分，便于排查某个订阅更新失败或配置字段不兼容的问题。

D

选择节点与代理模式

从服务器列表中选中一个节点，再设置系统代理或 TUN。系统代理主要接管遵循系统代理设置的应用；TUN 会覆盖更多网络程序，但需要更高权限。初次配置建议先使用系统代理完成连通测试，确认订阅和节点可用后，再根据应用范围决定是否启用 TUN。

路由模式决定哪些请求经过代理。常见的“绕过局域网及大陆”用于保留局域网访问并按规则分流；全局代理会让更多请求进入当前节点。修改路由模式后应重新连接当前节点，使新规则进入运行状态。

E

验证连接状态

连接后先观察客户端状态栏，确认系统代理、当前节点和路由模式与预期一致。然后使用实际需要联网的应用进行访问测试。单纯看到客户端已启动并不代表系统流量已经接管；系统代理关闭、VPN 权限被撤销或当前节点未选中，都会造成应用继续使用原网络路径。

遇到连接失败时，按“客户端状态—订阅内容—节点配置—系统代理—本地网络”的顺序排查。一次只修改一项，并在修改后重新连接。这样可以判断问题来自安装、权限、配置还是节点本身，避免同时改动多个设置后失去判断依据。

下一步：导入订阅与设置路由

教程页按操作顺序说明订阅添加、服务器选择、系统代理、路由模式和连接验证。

打开配置教程
下载常见问题

安装包、架构与升级说明

下面集中说明下载阶段最常见的选择问题。客户端已经安装但无法导入订阅或建立连接时，应继续查看配置教程与故障排查章节。

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

Desktop 是新一代跨平台界面，适合希望使用统一桌面体验的用户；WPF 是 Windows 经典界面，适合延续既有操作习惯与配置流程的用户。两者都使用 v2rayN 配置体系，不需要同时安装。首次使用可以先选 Desktop，已有 WPF 配置和固定操作流程则可继续使用经典版。

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

打开系统菜单中的“关于本机”，查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon；显示 Intel 处理器时选择 Intel 安装包。客户端功能保持一致，安装包差异只对应处理器架构。若下载了错误架构，系统通常会在打开时提示不兼容。

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

2015 年后的主流 Android 手机通常使用 64 位 ARM 处理器，可优先选择 arm64。设备架构不明确、安装时提示不兼容，或需要覆盖更多处理器类型时，改用通用版。通用版包含更多架构组件，因此文件通常更大，但配置与使用流程相同。

v2rayNG 与 v2flyNG 应该怎样选择？

一般先选使用 Xray 内核的 v2rayNG。订阅提供方明确要求 V2Fly 内核，或现有配置依赖对应实现时，再选择 v2flyNG。两款客户端的内核分支、部分协议特性和配置兼容范围存在差异，应按订阅要求选择，不建议同时连接或共用内部配置目录。

安装新版本前是否需要删除已有配置？

常规升级通常可以保留配置。操作前建议导出重要配置或记录订阅地址，退出正在运行的客户端后再安装新版本。跨界面版本迁移时，应先备份配置并确认新版本读取的配置目录。Android 覆盖安装通常保留应用数据，但仍应记录订阅来源，以便必要时重新导入。