先选操作系统，再选芯片架构。桌面设备使用 v2rayN；安卓设备优先使用 v2rayNG，也可按配置需求选择 v2flyNG。
首次使用？查看安装与配置步骤切换平台后，查看对应客户端、安装格式与系统要求。版本信息显示在客户端卡片内。
新一代跨平台 UI，首次安装优先选这一版。
下载桌面版 · x64 ZIP 压缩包 · 解压后安装经典稳定的 Windows 界面，适合延续原有操作习惯。
下载 WPF 版 · x64 ZIP 压缩包 · 解压后安装Desktop 与 WPF 的区别主要在界面技术和交互布局，不是两种连接协议。两版都需要导入有效配置；订阅服务是否可用，不由界面版本决定。首次使用可从桌面版开始，已有 WPF 使用习惯时可保留经典界面，不必为了连接失败反复切换版本。
下载后先将压缩包完整解压到可写入的文件夹，再运行其中的安装程序。不要在压缩包预览窗口内直接启动。若系统提示缺少运行环境，按提示确认所需组件与架构；不要把其他版本的程序文件混入当前目录。
| 检查项 | 选择与要求 | 确认位置 |
|---|---|---|
| 处理器架构 | 本页两个入口均为 x64 包。 | 设置 → 系统 → 系统信息，查看系统类型。 |
| 系统与环境 | 使用仍受维护的 64 位 Windows；具体最低要求以当前安装程序提示为准。 | 运行安装程序，记录兼容性或运行环境提示。 |
| 安装与权限 | 安装目录需可写；系统代理与 TUN 的权限要求不同。 | 先以普通权限启动，只有启用需提权功能时再授权。 |
安装完成后，先用系统代理验证浏览器连接。TUN 是通过虚拟网卡接管流量的模式，通常还涉及额外权限；不必在首次启动时同时打开所有接管功能。
使用 M 系列芯片的 Mac，选择原生 arm64 包。
下载 Apple Silicon 版 DMG 磁盘映像 · arm64“关于本机”显示 Intel 处理器时，选择 x64 包。
下载 Intel 版 DMG 磁盘映像 · x64打开苹果菜单中的“关于本机”，查看“芯片”或“处理器”一栏。M 系列对应 Apple Silicon；显示 Intel 型号则选择 Intel 版。不要只根据电脑外观或购买年份判断，同一产品名称可能跨越不同芯片代际。
打开 DMG 后，按窗口说明将应用移入“应用程序”文件夹，再从该位置启动。若出现系统安全提示，先阅读提示并确认应用来源，再通过系统提供的授权入口处理。不要为解决单个应用的启动问题关闭整套系统安全设置。
首次连接时，分别确认客户端已启动、配置已选中、代理范围已设置。程序窗口可见并不代表系统代理已经启用。更新前退出旧程序，避免仍在运行的旧实例占用监听端口。
| 检查项 | 选择与要求 | 确认位置 |
|---|---|---|
| 芯片 | Apple Silicon 选 arm64；Intel 选 x64。 | 苹果菜单 → 关于本机。 |
| 系统兼容性 | 使用仍受维护的 macOS；最低系统要求以当前应用提示为准。 | 关于本机中的系统版本与启动提示。 |
| 安装位置 | 将应用放入“应用程序”，并保留可写入的配置存储空间。 | 访达 → 应用程序。 |
如果下载了错误架构，先退出应用，再换用匹配的包。不要把转译运行视为默认选择，优先使用与芯片一致的版本。
2015 年后的主流手机优先选择，仍需确认系统支持。
下载 v2rayNG · arm64 APK 安装包 · arm64-v8a不确定架构或 arm64 提示不兼容时，选择此包。
下载 v2rayNG · 通用版 APK 安装包 · 多架构v2rayNG 使用 Xray 内核，适合在安卓设备上导入订阅、设置路由与管理分应用代理。内核负责处理连接，客户端负责提供配置界面；下载后仍需要已有的连接参数。协议与传输设置应与服务端一致，不要仅凭协议名称自行补齐其他字段。
打开 APK 时，系统可能要求为当前浏览器或文件管理器开启“允许安装未知应用”。只对实际执行安装的应用授权。首次启动 VPN 模式时，阅读并确认系统连接请求；该授权用于建立本地流量接管接口，不代表客户端已自动取得有效订阅。
需要 v2fly 内核且设备支持 arm64 时选择。
下载 v2flyNG · arm64 APK 安装包 · arm64-v8a用于无法确定架构、需要更广架构覆盖的设备。
下载 v2flyNG · 通用版 APK 安装包 · 多架构v2flyNG 是使用 v2fly 内核的备选客户端，不是 v2rayNG 的另一个架构包。只有配置能力与实际需求相符时再选择，不要把两款应用的内核特性视为完全相同。切换应用后，应重新检查订阅导入结果、路由规则和代理模式。
迁移时先保存原订阅地址和自定义设置，再在新应用中导入。不要用一款应用的数据文件直接覆盖另一款的数据目录。两款应用测试连接时，只启动其中一个的 VPN 模式，避免系统切换当前 VPN 后造成误判。
| 检查项 | 选择与要求 | 确认位置 |
|---|---|---|
| 应用架构 | 主流设备优先 arm64；无法确认时选通用版。 | 设备规格与安装时的兼容性提示。 |
| 系统版本 | 以当前 APK 声明的最低版本和系统安装提示为准。 | 设置 → 关于手机 → Android 版本。 |
| 安装权限 | 安装来源应用需获得相应授权。 | 系统“安装未知应用”设置。 |
| 连接权限 | VPN 模式需确认系统连接请求。 | 首次启动时的系统授权窗口。 |
后台断连与安装失败是不同问题。只有确认客户端在锁屏后被系统停止，才继续检查电池优化与后台运行限制，不要先反复卸载应用。
适用于使用 deb 软件包体系的发行版。
下载 deb · x64 arm64 设备：下载 deb 包适用于使用 rpm 软件包体系的发行版。
下载 rpm · x64 arm64 设备：下载 rpm 包先看发行版的软件包格式，再看处理器架构。deb 与 rpm 表示打包体系，不表示连接功能高低；amd64、x86_64 通常对应本页的 x64，aarch64 对应 arm64。不要因为文件名包含不同架构别名就将其理解为另一款客户端。
使用发行版的软件安装器打开下载的包，并阅读依赖与兼容性提示。属于同一打包体系，也不意味着所有发行版版本都满足该包的依赖。若安装器提示库版本不足，先确认发行版支持情况，不要强行跳过依赖检查或混用另一体系的安装包。
本页提供图形桌面客户端。安装后从应用菜单启动，先导入配置并验证系统代理，再按需考虑 TUN。桌面环境如何应用代理、应用自身是否读取系统代理，都会影响接管范围，不能只看客户端启动状态判断所有程序都已走代理。
| 检查项 | 选择与要求 | 确认位置 |
|---|---|---|
| 包格式 | 按发行版选择 deb 或 rpm，具体依赖需满足安装器要求。 | 发行版的软件中心与系统说明。 |
| 处理器架构 | x64 与 arm64 分别使用对应包。 | 系统设置中的设备或处理器信息。 |
| 运行环境 | 需要图形桌面环境与可写入的用户配置目录。 | 桌面会话及软件安装器的依赖提示。 |
从包管理器完成升级后，退出并重新启动客户端，再在关于页面确认实际运行的版本，避免继续使用仍驻留在后台的旧进程。
安装成功只是准备工作。按下面的顺序检查，能把安装问题与配置问题分开处理。
先打开客户端，找到设置与关于页面。记录客户端名称、实际运行版本和系统版本。若程序立即退出，应先处理架构、运行环境、安装路径或权限提示，不要此时反复修改订阅。
订阅是用于批量获取连接配置的链接。将链接粘贴到订阅分组，保存后执行更新，再检查列表是否出现配置。链接可能含访问凭据，不要把完整地址放进公开截图、求助帖子或共享日志。
选中一条配置，确认代理模式与路由预设，再启动连接。先使用浏览器完成一次实际访问测试，然后检查其他应用。延迟测试只反映测试目标与测试方式下的结果，不能替代真实访问验证。
先备份，再更新。保留订阅地址、自定义路由、分应用代理名单，以及手动添加的配置。优先使用客户端提供的导出功能；保存的文件可能包含访问凭据，应放在可信的本地位置。客户端升级与订阅更新是两件事，更新程序不会自动续期或修复失效的服务配置。
更新时先停止连接、退出旧实例，再运行安装程序。需要更换安装位置时，不要直接把新旧程序混在同一个目录。重新启动后检查配置是否保留、监听端口是否改变、系统代理是否恢复；先验证基础连接，再逐项恢复自定义功能。
如果更新后出现异常，记录发生在哪一步以及完整错误提示。能启动但无法访问时，先检查配置和模式；完全无法启动时，再排查程序环境。沿着问题出现的位置逐项定位，比同时改动多个设置更容易找到原因。
先确认问题发生在下载、安装、启动还是连接阶段，再按对应步骤处理。
还需要有效的连接配置。安装包只提供客户端程序，不包含可直接使用的服务配置。导入已有订阅链接或配置文件，更新列表并选中配置，再启动代理。首次使用请按入门指南完成模式选择与连接验证。
2015 年后的主流手机优先尝试 arm64，但仍应以设备支持的应用架构为准。若系统提示架构不兼容，或无法确认设备情况，再选通用版。通用版覆盖更多架构，文件通常更大；相同客户端的两种包不需要同时安装。
不需要。Desktop 使用新一代跨平台界面，WPF 使用经典 Windows 界面，两者都属于 v2rayN。首次使用优先选桌面版；熟悉经典布局时可选 WPF 版。切换前先备份配置，退出原程序，避免两个实例同时占用本地代理端口。
先使用客户端提供的备份或导出功能，单独保存订阅地址与自定义路由，再停止连接并退出程序。使用与原客户端相同的应用和架构进行更新。若切换到另一款客户端，不要直接覆盖其数据目录，应使用双方支持的导入方式迁移配置。
版本文字读取应用级版本信息，下载按钮读取具体架构的包路径，两者可能分批更新。判断已安装版本时，以客户端关于页面为准。若正在处理兼容问题，同时记录已安装版本、系统版本和使用的包类型，便于对照排查。
先区分启动失败与连接失败。程序打不开时，检查架构、解压位置、系统提示和运行环境；程序能打开但无法连接时，检查订阅更新结果、选中配置、系统时间与代理模式，再查看日志。不要用反复更换安装包代替配置排查。