v2rayN
首推Desktop 桌面版 · x64
下载v2rayN · 桌面版新一代跨平台 UI。适合首次安装，以及需要在不同桌面系统间保持相近操作习惯的用户。
经典 WPF 版 · x64
下载v2rayN · WPF 版经典稳定版，采用 Windows WPF 界面。已经熟悉原有布局、菜单与设置位置时，可继续选择这一版。
两个入口均为 ZIP 文件。下载后先完整解压，再运行其中的安装程序；不要在压缩软件的预览窗口内直接启动。
V2Ray 客户端下载
系统与安装包选择
桌面选 v2rayN，安卓优先选 v2rayNG。先确认系统，再核对处理器架构；安装后按教程导入订阅、设置代理并验证连接。
- 永久免费
- 代码开源
- 按架构选包
WINDOWS / X64
v2rayN Windows 安装包
同一客户端，两种桌面界面。首次安装可先选 Desktop。
安装前确认
| 检查项 | 选择依据 |
|---|---|
| 系统与架构 | 本页 Windows 两个入口均为 x64。打开“设置 → 系统 → 系统信息”，确认系统类型与处理器信息。 |
| 运行环境 | 具体最低系统与运行库要求以安装器提示为准。若提示缺少 .NET 桌面运行时，按提示补齐对应架构，不要仅凭名称相似选择。 |
| 安装目录 | 使用当前账户可写的目录；先完整解压，避免把配置放进临时解压目录。 |
| 首次运行 | 先导入配置并验证本地代理；TUN 可能需要额外权限，不必在首次启动时一并开启。 |
Desktop 与 WPF 的区别主要在界面体系，不代表节点配置可以省略。两版都要读取有效的服务器参数，订阅地址也需要自行准备。已有客户端能正常连接时，不必为了界面变化立刻迁移；先保存配置，再选择一个版本试用，能够减少设置丢失后的排查成本。
如果安装后打开即退出，先检查是否漏解压文件，再查看运行库提示、目录写入权限与安全软件的拦截记录。不要同时运行两份客户端测试同一个监听端口，否则第二份程序可能因端口占用而无法启动代理。具体排查顺序可查阅常见问题。
MACOS / APPLE SILICON · INTEL
v2rayN macOS 安装包
在“关于本机”查看芯片，不按购买年份猜架构。
v2rayN
Apple Silicon · arm64
下载v2rayN · Apple Silicon“芯片”一栏显示 Apple M 系列时选此包。优先使用与机器架构一致的应用，减少转译环境带来的差异。
Intel · x64
下载v2rayN · Intel“处理器”一栏显示 Intel 时选此包。下载完成后打开磁盘映像，将应用复制到“应用程序”。
复制完成后从“应用程序”启动，不要长期从已挂载的 DMG 中运行。
安装前确认
| 检查项 | 选择依据 |
|---|---|
| 处理器 | Apple M 系列对应 arm64；Intel 对应 x64。在苹果菜单的“关于本机”中确认。 |
| 系统兼容性 | 最低系统版本以当前应用要求与系统打开提示为准。架构匹配不代表旧系统一定可运行。 |
| 安装位置 | 将应用放入“应用程序”，再退出磁盘映像；保留个人配置的备份。 |
| 网络授权 | 根据系统提示确认代理或网络相关权限。先验证常规代理，再考虑 TUN 的额外授权。 |
首次打开若出现开发者验证提示，应先确认下载来源与应用名称，再到“系统设置 → 隐私与安全性”查看本次拦截是否提供继续打开的入口。只处理当前应用的授权，不要为了启动一个客户端关闭整个系统的安全机制。若系统明确提示应用已损坏，先重新下载并确认架构，不要直接忽略提示。
启动后先检查菜单栏或主窗口中的系统代理状态。浏览器是否使用代理，取决于系统代理设置及浏览器自身选项；命令行程序则可能需要单独配置代理环境变量。一次只改变一项设置，能更容易判断是应用安装、权限还是代理接管出了问题。详细流程见macOS 安装与权限说明。
ANDROID / ARM64 · UNIVERSAL
安卓客户端安装包
优先使用 v2rayNG；已有 V2Fly 配置需求时再考虑 v2flyNG。
v2rayNG
首推arm64 · 常用架构
下载v2rayNG · arm642015 年后的主流手机通常选择 arm64。设备仍需运行支持该架构的系统，较老机型建议先查厂商规格。
通用版 · 多架构
下载v2rayNG · 通用版不确定设备架构时可尝试通用版。它包含多种架构组件，但不能绕过最低系统版本等安装要求。
适合需要 Xray 配置能力的安卓使用场景。导入后仍要核对传输方式、TLS 与服务端参数。
v2flyNG
备选arm64 · 常用架构
下载v2flyNG · arm64适合已确认需要 V2Fly 内核、且手机架构为 arm64 的用户。先核对配置支持范围，再迁移日常连接。
通用版 · 多架构
下载v2flyNG · 通用版用于架构尚未确认的设备。通用包只解决包内架构覆盖问题，不会让两种内核的配置字段自动等价。
安装前确认
| 检查项 | 选择依据 |
|---|---|
| 包格式 | APK 安装包；系统可能要求给浏览器或文件管理器授予“安装未知应用”权限。 |
| 处理器架构 | 主流手机优先 arm64；无法确认时查看设备规格，或尝试通用版。 |
| 系统要求 | 以安装器的兼容性提示为准。通用版同样受系统版本、签名和设备策略限制。 |
| 连接授权 | 首次建立连接时确认系统 VPN 请求；通常不能同时启用另一款占用该通道的应用。 |
安装权限是按来源应用分别授予的。比如从浏览器下载、再用文件管理器打开 APK，最终请求安装权限的可能是文件管理器。完成安装后可以收回不再需要的来源权限。若提示包解析失败，先检查下载是否完成、系统版本是否满足要求，再判断是否选错架构，不要反复更换订阅来解决安装阶段的问题。
v2rayNG 与 v2flyNG 是两款独立应用，不是同一个安装包的轻量版与完整版。内核家族不同，特定协议与传输功能的支持也会不同。测试备选客户端时先断开原有连接，分别导入配置并验证，避免系统 VPN 通道互相争用。连接正常后再检查后台电池策略，防止锁屏后应用被系统暂停。
LINUX / DEB · RPM
v2rayN Linux 安装包
先看发行版包格式，再选 x64 或 arm64。
v2rayN
deb · x64 / amd64
下载v2rayN · debDebian、Ubuntu 及其衍生发行版通常选择此格式。双击后用系统软件安装器处理依赖与安装。
arm64 设备：下载 deb →rpm · x64 / x86_64
下载v2rayN · rpmFedora、openSUSE 等采用 RPM 包管理体系的发行版可先查看此包，并确认依赖符合本机环境。
arm64 设备：下载 rpm →amd64 与 x86_64 都指 x64 架构；aarch64 对应 arm64。不能仅凭文件扩展名判断兼容性。
安装前确认
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 需要能运行图形应用的 Linux 桌面会话。此处提供图形客户端，不是服务器后台服务的部署包。 |
| 软件包体系 | 使用发行版本身的软件安装器。deb 与 rpm 不应通过改扩展名或强制转换来混装。 |
| CPU 架构 | 系统显示 x86_64 时选 x64；显示 aarch64 时选 arm64。确认系统架构与处理器能力一致。 |
| 依赖与授权 | 安装依赖以包管理器提示为准；安装软件所需权限与运行 TUN 所需权限应分别处理。 |
同样使用 RPM 的发行版，也可能因为系统库版本、桌面组件和软件包依赖不同而出现兼容性差异。遇到依赖无法满足时，应保留安装器给出的完整错误，确认发行版版本与架构后再处理；不要忽略依赖强行安装，也不要把其他发行版的系统库直接复制进本机。
安装完成后从应用菜单启动 v2rayN，先使用本地监听与常规代理验证配置。Linux 桌面中的系统代理通常只对遵循相应设置的应用生效，终端工具不一定自动跟随。TUN 涉及虚拟网络接口、路由与权限，建议在普通代理能连接之后单独配置。配置字段的含义可继续查阅V2Ray 配置文件参考。
安装、升级与首次连接
下载之前只需要确认三个信息：系统名称、系统架构、现有配置是否需要保留。安装包的文件名能帮助辨别平台与架构，但连接能力最终取决于客户端支持的配置和服务器端参数。不要为了某个协议名称盲目更换系统安装包；先确定当前配置需要的内核功能，再选择适合的客户端。
客户端程序与服务器配置分开准备
安装完成并不等于已经具备连接条件。本页提供程序入口；订阅地址、分享链接或配置文件需要自行取得，并确认有权使用。订阅中可能含有访问凭据，不要把完整地址放进公开截图、论坛帖子或排错日志。
升级前先退出旧客户端
先记录当前的本地监听端口、路由模式、DNS 设置，以及是否启用了系统代理或 TUN。按客户端现有功能导出配置，或在退出后备份实际使用的数据目录。不同系统与界面版本的数据位置可能不同，不应假定所有平台都把配置放在安装目录。保存备份后，再关闭旧程序和托盘进程，避免升级时文件仍被占用。
升级后第一次打开，先检查订阅分组和自定义规则是否还在，再核对监听端口。若出现空白列表，不要立即覆盖备份，先确认是否启动了另一份安装、切换了账户或使用了不同的数据目录。恢复配置时也应保留当前副本，这样遇到格式差异仍能回退到原来的设置。
首次连接按顺序验证
- 导入配置。在客户端中添加订阅地址或导入分享链接。导入成功后查看服务器信息，确认地址、端口、传输与 TLS 等参数没有缺失。订阅更新失败时先看更新日志，不要先改系统代理。
- 选定服务器。从已导入的配置中选择一个准备测试的项目。桌面端按需要启用系统代理，安卓端确认系统 VPN 授权；测试过程中先保持路由规则简单，避免多个代理应用同时接管连接。
- 确认代理生效。测试客户端的真连接功能，再检查浏览器访问。客户端本地端口能监听，只能说明程序已启动；还需要确认实际请求能够通过服务器完成。遇到错误时记录日志原文，再区分 DNS、认证、连接超时或端口冲突。
如果浏览器可用但其他程序无法访问，先确认该程序是否读取系统代理，而不是立刻更换节点。反过来，命令行测试成功也不代表浏览器一定使用相同代理设置。首次排错时固定一个服务器、一个应用和一种代理模式，逐项改变配置，通常比同时打开多个接管开关更容易定位原因。
查看完整安装与订阅导入步骤 →下载与安装常见问题
Windows 桌面版与经典 WPF 版怎么选？
首次安装可以先选 Desktop 桌面版，它使用新一代跨平台界面。经典 WPF 版面向 Windows，适合已经熟悉原有界面与操作习惯的用户。两者都需要导入可用配置；切换界面前先备份订阅、路由与自定义设置，避免同时启动造成监听端口冲突。
怎样判断应该下载 x64 还是 arm64？
Windows 在设置的系统信息中查看系统类型；macOS 在“关于本机”中查看芯片，Apple M 系列选择 Apple Silicon，Intel 处理器选择 Intel。Linux 的 x86_64 对应 x64，aarch64 对应 arm64。Android 设备可查厂商处理器规格，2015 年后的主流手机通常选择 arm64，架构不明确时可尝试通用版，但仍需满足应用的系统要求。
Linux 应该下载 deb 还是 rpm？
先看发行版使用的包管理体系。Debian、Ubuntu 及其衍生系统通常使用 deb；Fedora、openSUSE 等使用 rpm。格式相同不代表依赖一定兼容，安装时仍要查看软件安装器或包管理器的提示。处理器架构也必须匹配，不要把 x64 包安装到 arm64 系统。
v2rayNG 与 v2flyNG 能直接互换吗？
v2rayNG 使用 Xray 内核，v2flyNG 使用 V2Fly 内核。基础订阅或分享链接可能都能识别，但协议字段、传输选项与新特性的支持范围并不完全相同。已有配置明确依赖 Xray 特性时优先使用 v2rayNG；选择 v2flyNG 前，应确认服务端参数与该客户端支持的格式一致，不能只凭导入成功判断连接可用。
升级前需要保留哪些配置？
先记录本地监听端口、系统代理模式、路由规则与 DNS 设置，再按客户端提供的导出或备份功能保存配置。订阅地址可能包含访问凭据，应存到个人可控的位置。退出旧客户端后再升级，首次启动确认配置仍在，并重新测试连接；不要直接删除旧数据目录。
安装完成后为什么还不能连接？
安装包提供客户端程序，不附带可直接使用的服务器配置。需要先导入自行取得且有权使用的订阅或节点参数，选择服务器，再按需要启用系统代理或安卓 VPN 连接。若仍不能访问，依次检查节点是否有效、本地端口是否冲突、代理模式是否正确，并查看日志中的具体错误。