v2rayN 首推
7.24.1桌面版采用新一代跨平台 UI；WPF 版是保留经典 Windows 界面的稳定选择。以下两个入口均为 x64 安装压缩包。
桌面版文件
v2rayN-Desktop-Setup-x64-7.24.1.zip
v2rayN · 设置示意
安装后导入配置，再设置代理接管方式。
V2Ray 下载
客户端安装包
桌面选择 v2rayN，安卓优先选择 v2rayNG。先确认操作系统，再按处理器架构下载对应文件。
免费使用
代码开源
图形界面
安装包不附带连接配置。首次使用可参阅使用文档。
客户端与安装格式
平台选项与地址栏锚点同步。切换平台后，查看该系统的安装入口和要求。
Windows 客户端
系统要求与安装准备
| 检查项目 | 选择依据 |
|---|---|
| 处理器架构 | 本页两个入口均为 x64。到系统“关于”中查看系统类型，不要把 x64 包当作其他架构的原生安装包。 |
| 系统与运行环境 | 优先使用仍在支持期的 Windows；具体最低系统版本与运行环境以所选发行包说明及安装提示为准。 |
| 文件格式 | ZIP 为安装压缩包。完整解压到可写目录后运行安装程序，不在压缩包预览窗口内启动。 |
| 网络接管 | 普通应用先使用系统代理；需要 TUN 时再按客户端提示准备相应权限与组件。 |
首次启动后，先检查界面是否能正常打开，再导入订阅或分享链接。导入完成只代表配置已进入列表，还需要选择实际使用的条目。随后设置系统代理与路由模式：系统代理决定应用是否把请求交给客户端，路由决定交给客户端的请求如何分流。两者不是同一个开关，也不应把安装成功直接等同于连接成功。
更新已有安装时，先退出托盘中的旧进程，避免两个实例争用本地监听端口。使用自定义路由、DNS 或配置文件的用户，应在更新前另存设置。桌面版与 WPF 版的菜单位置可能不同，迁移时按功能名称查找，不要仅凭旧截图逐项点击。启动异常时先记录弹窗原文，再到故障排查中对应处理。
macOS 客户端
v2rayN
7.24.1在系统菜单中打开“关于本机”。显示 Apple 芯片时选择 Apple Silicon，显示 Intel 处理器时选择 Intel。
系统要求与首次打开
| 检查项目 | 选择依据 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64，Intel 对应 x64；以“关于本机”显示的信息为准。 |
| 系统版本 | 确认当前 macOS 满足发行包要求；旧系统遇到兼容提示时，不通过改文件名绕过。 |
| 安装格式 | 打开 DMG，按磁盘映像中的提示将应用放入“应用程序”目录，再从该目录启动。 |
| 授权范围 | 修改系统代理或启用 TUN 时可能需要系统授权，只对明确需要的功能授予权限。 |
安装后不要长期从挂载的磁盘映像内运行。将应用放到固定位置，有助于保持更新路径和权限设置一致。如果系统阻止首次打开，应先确认下载来源、所选架构和系统提示，再到系统设置中查看对应说明；不要为了启动应用而整体关闭系统安全机制。若提示应用不适用于当前系统，先排查版本要求与芯片匹配。
桌面客户端能够导入配置，不代表所有应用都已采用系统代理。浏览器通常会读取系统设置，部分终端工具或应用则有独立代理选项。完成配置后，先用一个明确遵循系统代理的应用验证，再处理其他软件。需要更广的接管范围时，再了解 TUN 的权限要求与路由设置，避免同时叠加多套接管方式而增加排查难度。
Android 客户端
v2rayNG 首推
2.2.6采用 Xray 内核。2015 年后的主流手机通常选择 arm64；架构不明确或遇到架构不兼容提示时，可选择通用版。
v2flyNG 备选
1.10.31采用 V2Fly 内核，供已有配置与该内核兼容的用户选择。不要将客户端名称相近理解为协议功能完全一致。
系统要求与安卓授权
| 检查项目 | 选择依据 |
|---|---|
| 运行架构 | arm64 包要求设备系统具备相应运行环境；不能只根据处理器型号判断。 |
| 系统版本 | 最低 Android 版本以安装包要求为准。通用版解决架构选择问题，不解决系统版本过旧问题。 |
| 安装授权 | 系统要求时，为本次使用的浏览器或文件管理器允许安装应用，完成后可收回该权限。 |
| 连接授权 | 首次连接时确认系统 VPN 授权；检查是否已有其他应用占用同一 VPN 接管通道。 |
如果安装界面提示“应用未安装”，先区分架构不匹配、系统版本不满足、签名不一致和降级受限等情况。已经安装过同名应用时，不要直接删除旧应用尝试解决；先导出需要保留的内容，再判断是否需要迁移安装来源。卸载可能清除本地配置，重新安装也不会自动找回未备份的自定义设置。
安装成功后，在订阅分组设置中添加有权使用的地址并更新，或通过剪贴板导入分享链接。连接前确认当前选中的配置；首次启动连接时，系统 VPN 授权与订阅导入是两个独立步骤。若只希望部分应用使用代理，可继续了解分应用代理，而不是反复更换安装包。后台断连时先检查电池优化与后台运行限制。
v2rayNG 与 v2flyNG 的主要选择依据是配置兼容性，不是名称长短或安装包体积。使用 REALITY 等配置时，优先核对协议与内核支持，不要假设相同订阅在两款应用里会得到相同结果。关系说明见内核选型指南，首次导入与授权步骤见安卓使用教程。
Linux 客户端
v2rayN
7.24.1先按发行版选择 deb 或 rpm，再核对 x64 与 arm64。以下主入口为 x64 软件包，其他架构入口列在按钮下方。
系统要求与软件包兼容
| 检查项目 | 选择依据 |
|---|---|
| 软件包体系 | deb 与 rpm 按发行版包管理器选择，不能通过修改文件扩展名互相转换。 |
| 架构标识 | amd64、x86_64 对应 x64；arm64、aarch64 对应 ARM 64 位架构。 |
| 系统依赖 | 相同包格式不代表任意发行版都可安装；系统库版本与依赖须满足当前软件包要求。 |
| 桌面环境 | 本页提供图形客户端。安装后从桌面应用菜单启动，按需要配置系统代理和权限。 |
下载前可在系统设置的“关于”页面查看发行版与硬件信息。安装时使用系统的软件安装器，并阅读依赖提示；如果提示缺少系统库或要求更新版本的基础组件，先确认软件包与发行版是否匹配，不要强行忽略依赖。rpm 文件名中的发行目标信息也需要结合实际系统判断，不能把 rpm 格式理解为通用兼容承诺。
客户端启动后，先完成订阅导入与配置选择，再验证当前桌面环境是否读取系统代理。不同应用对代理环境和桌面设置的支持并不相同，某个浏览器可用而另一应用不可用时，应检查应用自身的代理设置。需要 TUN 接管时再处理权限与路由，避免把权限错误、配置错误和应用未接入代理混成同一个问题。
下载后的检查顺序
先确认程序能启动，再检查配置与网络接管，避免把不同阶段的问题混在一起。
- 确认包的适用范围。先看操作系统、处理器架构与安装格式，再看版本文字。文件名中的 x64、amd64 和 x86_64 属于同一类架构标记；arm64 与 aarch64 属于另一类。名称相似不表示可以互装，通用版也仍然有系统要求。
- 保存已有设置。更新前记录订阅分组、本地监听端口、路由和自定义 DNS。备份包含订阅地址或连接凭据时，应按敏感信息保存，不要贴到公开讨论区。跨客户端迁移时先保留旧环境，确认新客户端正常工作后再清理。
- 导入有权使用的配置。客户端不提供连接服务。单节点分享链接与订阅地址不是同一种内容：前者描述具体配置，后者用于拉取可更新的配置集合。导入后检查列表与分组，不要把网页地址或错误页面当作有效订阅。
- 选择接管和分流方式。桌面先检查系统代理，安卓先完成 VPN 授权；接入客户端后，再按需要选择路由。想了解全局与分流的区别，可阅读路由设置。验证失败时记录日志中的错误类型，不必首先重装。
如果下载请求没有完成，先检查浏览器的下载记录，确认是请求失败、下载被暂停，还是文件已保存到其他目录。若文件已经下载但无法安装，重点核对架构、系统兼容和安装授权；若程序已能启动却无法连接，继续排查配置、系统代理及 DNS。按阶段定位通常比反复下载不同包更容易保留有效线索。
订阅更新失败并不必然意味着客户端安装有问题。先核对地址是否完整、是否仍有效，以及更新请求使用的网络路径，再考虑配置兼容性。相关流程见订阅更新失败排查。分享日志或截图前应遮盖订阅地址、访问凭据和其他私人信息。
安装包选择问答
Windows 桌面版和经典 WPF 版选哪个？
首次安装可先选桌面版，它采用新一代跨平台界面。习惯经典 Windows 界面和操作路径时，可选经典稳定的 WPF 版。两者都属于 v2rayN；切换前应备份配置，不要让两个实例同时占用相同的本地监听端口。
安卓手机应该下载 arm64 还是通用版？
2015 年后的主流手机通常选择 arm64，但处理器支持 64 位不代表系统一定提供 64 位运行环境。优先查看设备架构；无法确认或 arm64 包提示架构不兼容时，可尝试通用版。通用版不代表能兼容所有 Android 系统版本。
v2rayNG 与 v2flyNG 可以互相替代吗？
v2rayNG 采用 Xray 内核，是本页安卓首推项；v2flyNG 采用 V2Fly 内核，作为备选。配置能否使用取决于具体协议、传输方式和内核支持，不能仅凭订阅地址相同判断兼容。使用 REALITY 配置时，应先确认所选客户端的协议支持。
下载客户端以后就能直接连接吗？
安装包只提供客户端程序，不附带连接服务或可用配置。需要准备有权使用的订阅地址或分享链接，导入后选择配置，再设置系统代理或授权 VPN 连接，并检查路由模式。
为什么卡片版本文字与文件名中的版本不同？
版本文字与各架构文件路径来自清单中的不同字段，更新时可能存在不同步。选择时以下载按钮对应的具体安装包为准，安装完成后在客户端内查看实际版本。本页不根据版本文字重新拼接文件路径。
更新客户端之前需要做什么？
先备份订阅分组、路由规则和自定义配置，再退出正在运行的客户端。更新时保持应用、架构与安装方式一致；跨界面版本或跨内核迁移时，先导出必要内容，确认新客户端可读取后再清理旧安装。