v2rayN
首推 7.24.1经典 WPF 版 经典稳定版
下载经典 WPF 版 · x64保留经典 Windows 桌面布局，适合已熟悉旧版菜单的用户。两版界面位置可能不同，阅读教程时按“订阅分组”“系统代理”等功能名称对应查找。
客户端 / 安装包选择
V2Ray 客户端下载
桌面选 v2rayN，Android 首选 v2rayNG。先选系统，再确认芯片与安装包格式。
永久免费
代码开源
图形界面配置
下载前准备安装包提供客户端程序。首次连接还需要有使用授权的订阅地址或分享链接；已有配置的用户，先在旧客户端中保存备份。
查看订阅导入步骤 →Windows 安装包
同一款客户端，两种界面。首次使用先选 Desktop；习惯经典布局，再选 WPF。
安装与迁移顺序
先在 Windows“设置 → 系统 → 系统信息”中确认系统类型。本页两个安装入口均为 x64 包，不要只根据电脑品牌判断架构。现代 64 位 Windows 桌面环境更适合使用当前客户端；旧系统还需确认应用框架和运行库要求，不能仅凭压缩包能够解压就判断兼容。
首次安装时，给客户端保留一个明确的安装位置。不要直接在压缩软件的临时预览窗口中启动程序，否则后续保存配置、调用组件或升级时容易出现路径问题。若系统提示需要补充运行环境，先阅读安装提示，确认缺少的具体组件，再通过系统认可的安装方式处理。
从已有版本迁移时，先导出设置并关闭托盘中的旧进程。Desktop 和 WPF 不需要同时启动；两个进程若使用相同本地监听端口，后启动的程序可能无法提供代理入口。完成导入后，先选择一个有效条目，再设置系统代理，最后打开浏览器验证。退出测试时，也检查系统代理是否已恢复。
Windows 系统要求与检查项
| 检查项 | 选择依据 |
|---|---|
| 系统环境 | 优先使用 Windows 10 / 11 的 x64 环境；具体最低要求以当前安装包提示为准。 |
| 处理器架构 | 本页提供 x64 包，安装前查看系统信息中的“系统类型”。 |
| 运行环境 | 按安装器提示补齐所需框架或运行库；不要忽略缺失组件提示。 |
| 代理与权限 | 普通系统代理与 TUN 是不同工作方式；TUN 可能需要提升权限及虚拟网卡组件。 |
macOS 安装包
打开苹果菜单中的“关于本机”，按“芯片”或“处理器”字段选择。
v2rayN
桌面客户端 7.24.1Apple Silicon M 系列芯片
下载 Apple Silicon 版“关于本机”显示 Apple M 系列芯片时选择 arm64。直接使用与芯片匹配的构建，更容易减少架构转换带来的兼容问题。
安装位置与首次授权
下载 DMG 后打开磁盘映像，按窗口提示将应用放入“应用程序”目录，再从该目录启动。不要长期在挂载的映像中运行客户端，以免弹出映像后路径失效。首次打开前，再核对一次 Apple Silicon 与 Intel 的选择是否正确；架构不匹配与系统安全提示属于不同问题，应分开处理。
若系统拦截首次打开，先确认下载入口与应用身份，再在“系统设置 → 隐私与安全性”中阅读对应提示。只处理已确认的这一次打开请求，不需要为了安装客户端而全局关闭系统安全功能。若提示系统版本过旧，应核对应用的实际兼容要求，而不是反复下载另一个架构的包。
导入订阅后，先使用普通系统代理完成首次验证。系统代理只影响遵循该设置的应用，终端程序或自带代理设置的应用可能需要单独配置。需要 TUN 时，再阅读权限提示并检查是否已有其他网络工具占用相同功能。更换网络环境后若访问异常，可先停止代理、确认普通网络正常，再重新启动连接。
macOS 系统要求与检查项
| 检查项 | 选择依据 |
|---|---|
| 芯片类型 | Apple M 系列选择 arm64；Intel 处理器选择 x64。 |
| 系统版本 | 在“关于本机”查看版本，并以当前应用提示的最低系统要求为准。 |
| 安装位置 | 使用“应用程序”目录，不从临时挂载的磁盘映像长期运行。 |
| 网络权限 | 按实际启用的代理方式授权；TUN 相关权限与普通系统代理分开确认。 |
Android 安装包
先看 v2rayNG；有明确 V2Fly 兼容需求时，再考虑 v2flyNG。
v2rayNG
首推 Xray 内核 2.2.6arm64 主流手机优先
下载 v2rayNG · arm642015 年后的主流手机通常可先选择 arm64，但仍需确认手机运行的是 64 位系统。处理器支持 64 位，不代表设备固件一定采用同一架构。
v2flyNG
备选 V2Fly 内核 1.10.31安装授权与首次连接
打开 APK 时，Android 可能要求允许当前浏览器或文件管理器安装应用。按系统界面给实际使用的来源授权即可，安装完成后可以收回这项权限。若出现“应用未安装”，先查看系统版本、可用存储空间和包架构，再检查是否已经安装过签名不同的同名应用。
已有配置时，不要为了消除签名冲突立即卸载。先在原应用中保存可恢复的备份，再决定后续迁移方式。订阅地址和分享链接可能携带访问凭据，备份文件也应按敏感资料保存。v2rayNG 与 v2flyNG 的名称相近，但使用的内核不同，导入成功后仍要确认具体协议与传输设置是否兼容。
首次启动连接时，系统会显示 VPN 连接请求，这是客户端接管设备流量所需的授权步骤。确认应用名称后允许，并避免同时启动其他使用同一 VPN 通道的应用。如果锁屏后连接中断，再检查电池优化和后台活动限制；先完成一次前台连接验证，再调整后台策略，排查过程会更清楚。
Android 系统要求与检查项
| 检查项 | 选择依据 |
|---|---|
| 系统与架构 | 在设备设置中查看 Android 版本；arm64 需 64 位 ARM 系统，最低系统版本以安装器要求为准。 |
| 安装权限 | 允许实际使用的浏览器或文件管理器安装应用，完成后可收回授权。 |
| 连接权限 | 首次启动连接需确认系统 VPN 请求；同一时间避免运行其他 VPN 类应用。 |
| 后台运行 | 前台验证正常后，再按需要调整电池优化、后台活动及自启动设置。 |
Linux 安装包
先按发行版选择 deb 或 rpm，再按设备架构选择 x64 或 arm64。
v2rayN
图形桌面环境 7.24.1deb 安装包 Debian / Ubuntu 系
下载 deb · x64 arm64 设备：下载 deb →使用 deb 包管理体系时选择。安装前查看系统设置中的处理器与系统信息；包名里的 amd64 对应常见 x64 桌面架构，不只适用于某个处理器品牌。
rpm 安装包 Fedora / RHEL 系
下载 rpm · x64 arm64 设备：下载 rpm →使用 rpm 包管理体系时选择。包格式只是第一步，还需核对发行版版本与依赖要求；aarch64 与 arm64 在这里指向同一类 64 位 ARM 架构。
通过图形软件安装器安装
先打开系统的“设置”或“关于”页面，记录发行版、版本和处理器架构。下载匹配的软件包后，用发行版自带的软件安装器打开，阅读依赖与权限提示再确认安装。这里的客户端面向图形桌面环境，不能把能够下载软件包理解为所有精简系统都具备运行条件。
如果安装器提示缺少依赖、版本不满足或架构错误，先停在这一步。不要强行忽略依赖，也不要把不同包格式反复转换来尝试。不同发行版即使同用 rpm 或 deb，提供的基础运行库也可能不同。应先确认发行版是否满足当前构建的要求，再继续安装。
启动后先导入订阅、选择条目并验证本地代理入口。Linux 桌面环境对系统代理的读取方式并不完全一致：浏览器可能跟随桌面设置，也可能保留独立配置。若只有某个应用无法访问，应先检查该应用的代理选项，而不是立刻重装客户端。TUN 涉及额外网络权限，建议在普通代理路径验证正常后再启用。
Linux 系统要求与检查项
| 检查项 | 选择依据 |
|---|---|
| 桌面环境 | 需要可运行图形应用的桌面环境，以及当前构建要求的基础运行库。 |
| 包管理体系 | Debian / Ubuntu 系通常选择 deb；Fedora / RHEL 系通常选择 rpm。 |
| 架构对应 | x64 对应 amd64 / x86_64；arm64 对应 arm64 / aarch64。 |
| 依赖与权限 | 由图形安装器检查依赖；TUN 的权限需求与普通应用启动权限分开处理。 |
安装包 / 升级 / 首次连接
下载常见问题
架构、界面与配置是三件事。先判断卡在哪一步，再选择对应的处理方法。
下载客户端后，还需要准备订阅吗？
需要准备有使用授权的订阅地址或单条分享链接。客户端负责读取配置和处理连接，安装包本身不包含可直接使用的远端服务。订阅地址通常包含访问凭据，不要放到公开截图、聊天记录或排查日志中。
Windows 桌面版与经典 WPF 版怎么选？
首次安装可先选择 Desktop 桌面版，它使用新一代跨平台界面。习惯经典 Windows 布局的用户可选择经典稳定的 WPF 版。两者都用于管理连接与订阅；迁移前先备份，首次使用只运行其中一个版本，避免本地端口被同时占用。
Android 的 arm64 与通用版有什么区别？
arm64 包面向 64 位 ARM 系统，2015 年后的主流手机通常可先选这一项，但仍需以设备实际系统架构为准。通用包包含多种架构所需内容，体积通常更大。若提示与设备不兼容，先检查系统架构，再考虑通用包。
升级客户端时，怎样保留订阅和路由设置？
先使用客户端提供的备份或导出功能，记录订阅分组、路由预设和自定义设置，再退出正在运行的旧客户端。尽量沿用原来的安装方式进行升级。Android 覆盖安装还要求应用签名一致；遇到签名冲突时不要立即卸载，先确认配置已经备份。
安装成功后，为什么网页仍不能通过代理打开？
安装完成不等于配置已经生效。先导入订阅并选择有效条目，启动客户端后再检查系统代理或 VPN 授权。系统代理只影响遵循该设置的应用；若仍失败，查看日志中的端口占用、DNS 或握手提示，逐项排查，不要同时修改多个设置。
Linux 应该选 deb 还是 rpm？
先看发行版使用的包管理体系：Debian、Ubuntu 系通常选 deb，Fedora、RHEL 系通常选 rpm；再确认处理器是 x64 还是 arm64。包格式匹配并不代表系统依赖一定满足，安装器若提示缺少运行库，应核对发行版版本和软件包依赖，不要强行忽略错误。