客户端安装包 · 按平台选择
先选操作系统，再选处理器架构。桌面设备使用 v2rayN；Android 首推 v2rayNG，v2flyNG 作为备选。
首次安装？查看订阅导入与连接教程 →两个界面版本均为 x64 安装包。按使用习惯选择一个即可，不必同时安装。
桌面版 Desktop
下载v2rayN 桌面版经典 WPF 版
下载v2rayN WPF 版桌面版使用新一代跨平台 UI，适合首次使用或希望在不同桌面系统间保持相近操作体验的用户。WPF 版保留经典窗口布局，适合熟悉原有服务器列表、菜单和设置路径的用户。界面不同不代表订阅可以省略，两版都要先导入有效的服务器配置。
这里下载的是 ZIP 压缩文件。先把内容全部解压到可写目录，再运行其中的安装程序，不要在压缩包预览窗口里直接启动。升级时先退出托盘中的旧客户端；若提示文件被占用，确认相关进程已经结束，再继续操作。
| 检查项 | 要求与确认位置 |
|---|---|
| 系统与架构 | 本页提供 x64 包。在“设置 → 系统 → 系统信息”查看系统类型；32 位系统不适用这些入口。 |
| 运行环境 | 系统版本和桌面运行库需满足所选版本要求。缺少运行库时，以启动错误提示所写的版本和架构为准。 |
| 目录权限 | 解压与数据目录需要可写空间。避免从临时压缩目录启动，也不要覆盖正在运行的程序文件。 |
| 网络权限 | 系统代理与 TUN 是不同入口。先完成普通连接验证，需要 TUN 时再按系统提示处理权限。 |
如果启动即退出，先记录弹窗文字，再检查运行库与目录权限。不要把反复切换界面版本当作排查步骤；可阅读启动闪退处理说明。
先在“关于本机”确认芯片。Apple Silicon 与 Intel 各有对应的 DMG 安装包。
Apple Silicon
下载v2rayN · Apple SiliconIntel
下载v2rayN · Intel打开苹果菜单中的“关于本机”。如果显示“芯片”并标有 Apple M 系列名称，选择 Apple Silicon；如果显示 Intel 处理器名称，选择 Intel。不要依据外壳型号、购买年份或屏幕尺寸推断架构，同一产品系列可能使用不同处理器。
下载后打开 DMG，按照磁盘映像内的提示将应用放入“应用程序”，再从该位置启动。首次打开如出现安全提示，先确认文件来源和提示内容，再到“系统设置 → 隐私与安全性”查看相应操作。不要为启动单个应用而关闭整套系统安全保护。
| 检查项 | 要求与确认位置 |
|---|---|
| 芯片类型 | Apple Silicon 对应 arm64，Intel 对应 x64。在“关于本机”确认，不依赖文件名猜测设备类型。 |
| 系统版本 | 需满足当前应用构建要求。若提示系统版本不兼容，先核对设备系统，不要反复尝试另一种架构。 |
| 安装位置 | 保留足够的可用空间，并具备“应用程序”目录的安装权限。关闭旧实例后再替换应用。 |
| 连接权限 | 首次修改代理或使用 TUN 时可能出现授权提示。先确认功能用途，再批准所需权限。 |
应用能启动但浏览器不能访问目标网站时，先确认已选服务器和系统代理状态。安装包架构主要影响能否安装与运行，不能代替连接配置检查。
先看 v2rayNG，再按现有配置考虑 v2flyNG。2015 年后的主流手机通常选 arm64，最终以设备支持的架构为准。
arm64
下载v2rayNG · arm64通用版
下载v2rayNG · 通用版v2rayNG 使用 Xray 内核，适合在 Android 上导入订阅、分享链接和二维码配置。首次选择可从这款客户端开始，再检查配置中使用的协议、传输和安全参数。客户端支持某个协议名称，并不代表服务端的每一种参数组合都能直接使用。
APK 下载完成后，从浏览器下载列表或文件管理器打开。如果系统要求允许当前来源安装应用，只对本次使用的浏览器或文件管理器授予相应权限。安装完成后可收回这项权限。首次连接时出现 VPN 连接请求属于系统授权环节，确认应用名称后再继续。
arm64
下载v2flyNG · arm64通用版
下载v2flyNG · 通用版v2flyNG 使用 v2fly 内核，适合已有 V2Fly 配置需求的用户作为备选。它与 v2rayNG 同属 Android 图形客户端，但内核能力和支持参数并不完全相同。不要把两款应用视作只更换名称的相同安装包；迁移前应逐项确认配置兼容性。
在两款客户端之间切换时，先停止原客户端的连接，再启动另一款。需要迁移的内容优先通过有效订阅或单节点分享方式重新导入，不直接假定整份应用备份可以互通。更新订阅后，重新检查所选服务器、路由和 DNS，避免沿用另一款客户端的状态判断连接结果。
| 检查项 | 要求与确认位置 |
|---|---|
| 处理器架构 | arm64 包要求系统支持对应架构。硬件为 64 位不一定代表系统也提供对应运行环境；不确定时可尝试通用版。 |
| 系统兼容 | 以安装器显示的最低系统要求为准。通用版解决架构选择问题，不会降低应用本身的系统要求。 |
| 安装权限 | 允许当前来源安装应用，并保证存储空间足够。企业管理策略或设备限制可能阻止安装。 |
| 后台运行 | 连接依赖系统 VPN 授权。遇到熄屏断连时，再检查电池优化和后台活动设置，不必预先放开所有权限。 |
若安装器提示签名冲突，先确认现有应用的来源和备份方式。不要立即卸载；卸载可能移除本地配置。保留错误信息，再决定是否需要迁移数据。
先按发行版选择 deb 或 rpm，再核对 x64 与 arm64。扩展名对应包管理体系，不能通过重命名互换。
deb · x64
下载v2rayN · debrpm · x64
下载v2rayN · rpm使用 deb 包管理体系的桌面发行版选择 deb，使用 rpm 体系的发行版选择 rpm。包格式匹配只是第一步，还需要满足当前构建的依赖和系统环境要求。尤其是 rpm 包，不应仅凭发行版能够打开 rpm 文件，就认定所有依赖都已满足。
优先用系统图形软件安装器打开下载的文件，查看架构、依赖和安装确认信息。安装完成后从应用菜单启动 v2rayN。桌面环境对系统代理的读取方式可能不同：浏览器可用而其他程序不可用时，先检查应用是否读取桌面代理设置，而不是立即重装客户端。
| 检查项 | 要求与确认位置 |
|---|---|
| 桌面环境 | 本页提供图形客户端，需要可运行相应桌面应用的系统环境，不按服务器后台服务方式安装。 |
| 架构名称 | amd64、x86_64 对应本页 x64；aarch64 通常对应 arm64。在系统信息中核对后再选择。 |
| 依赖与权限 | 通过图形包管理器查看缺失依赖，安装时使用系统要求的授权方式。不要长期以管理员身份运行图形客户端。 |
| 代理入口 | 桌面系统代理不一定被所有应用采用。需要覆盖其他流量时，再阅读 TUN 的权限和路由说明。 |
若软件安装器显示依赖无法满足，记录缺失组件名称和发行版版本，再核对适用环境。改文件扩展名、忽略依赖或混用另一套包管理体系都不是合适的修复方法。
首次安装与覆盖更新是两种情况。已有可用配置时，先在客户端中使用备份或导出功能，保存订阅分组、自定义路由以及需要保留的设置；备份文件可能含有连接信息，应放在自己可控的位置。只记住服务器别名，通常不足以在新环境恢复配置。
更新前退出主窗口与托盘进程，等待连接停止，再运行新安装程序。更新完成后先检查订阅是否仍在、默认服务器是否正确、本地端口是否改变，然后测试实际访问。若使用多个设备，不要把桌面端整份数据目录直接覆盖到 Android 应用；跨客户端优先使用兼容的订阅或分享链接。
需要进一步比较三款客户端，可查看客户端横向评测。路由规则、DNS 和 TUN 的配置方法放在高级用法中，建议在基础连接已可用后再逐项调整。
首次安装可先选桌面版 Desktop，它使用新一代跨平台界面；习惯经典窗口和原有操作路径的用户可选经典稳定的 WPF 版。两者都需要导入有效配置。更换界面版本前先备份现有配置，退出正在运行的客户端，再启动新版本。
2015 年后的主流手机通常可先选 arm64，但仍需以设备系统实际支持的架构为准。若提示安装包与设备不兼容，可改用通用版。通用版包含多种架构，文件通常更大；它不能解决系统版本过低、签名冲突或存储空间不足。
需要。客户端负责读取配置、管理服务器和设置流量入口，安装包本身不提供可直接连接的服务器。使用有权访问的订阅地址、分享链接或配置文件导入；订阅地址可能包含访问凭据，不要公开发送，也不要放进问题截图。
是否保留取决于安装方式、数据目录和版本迁移行为，不能只凭安装包名称判断。更新前使用客户端提供的备份或导出功能保存配置，并记录当前使用的数据目录。退出旧版本后再更新；确认订阅、路由和本地端口恢复正常后，再清理旧文件。
先核对操作系统、处理器架构和下载文件是否完整保存。Windows 压缩包应先解压，运行库缺失按错误提示处理；macOS 检查芯片类型和系统安全提示；Android 查看安装器给出的兼容性或签名信息；Linux 查看图形包管理器的依赖提示。保留具体错误文字，不要反复覆盖安装。
先打开浏览器的下载列表，确认任务是否被暂停、拦截或等待保存位置。页面会尝试读取同源版本清单更新下载地址，读取失败时保留页面内已有的安装包链接。可以刷新后重试；若仍然失败，记录所选平台、包类型和浏览器错误，不要随意改写文件路径或扩展名。
先匹配平台与架构，再导入配置；更新前保留一份可恢复的备份。