客户端安装包 / 架构选择
v2rayNG 安卓版与 v2rayN 桌面端。先选系统，再选处理器架构。
三个客户端均为免费开源软件。安装完成后，需要导入有权使用的服务器配置或订阅地址。
查看安装与导入教程 →新安装优先选 Desktop；沿用经典界面可选 WPF。以下两个入口均为 x64 压缩包。
Desktop 是新一代跨平台 UI。适合首次安装，或希望在不同桌面系统上使用相近操作方式的用户。WPF 是经典稳定版界面。已经熟悉服务器列表、订阅分组和参数设置位置的用户，可以继续沿用。两者的区别主要在界面实现与交互组织，不应把切换界面当作修复服务器连接的通用办法。
下载 ZIP 后先解压到独立目录，再运行其中的安装程序；不要直接从压缩软件的预览窗口启动。安装路径尽量选择当前账户可读写的位置。若运行时提示缺少组件，按系统提示确认依赖，避免反复更换客户端包却忽略实际错误信息。
| 检查项 | 本页安装包 | 确认方法 |
|---|---|---|
| 系统与架构 | Windows 64 位、x64 | 在“设置 → 系统 → 系统信息”查看系统类型；不要把这两个包当成原生 ARM 包。 |
| 系统兼容性 | 优先在仍受支持的 Windows 10 / 11 环境使用 | 旧系统先确认具体版本要求与运行组件，不能仅凭“64 位”判断兼容。 |
| 文件形式 | ZIP 压缩包 | 完整解压后再安装，保留原有配置备份。 |
| 连接接管 | 系统代理或客户端支持的 TUN 模式 | 同一时间只让一个客户端接管代理；首次测试先用系统代理。 |
启动后先导入配置，再在服务器列表中选择一项，最后设置系统代理。系统代理只影响遵循该设置的应用；某个程序没有经过代理，并不能直接说明安装失败。需要接管更多流量时，再阅读 TUN 与路由配置说明。
在“关于本机”查看芯片名称。Apple Silicon 选 arm64，Intel 处理器选 x64。
Apple Silicon 机型的芯片名称通常以 M 开头，选择 arm64 包。若“关于本机”显示 Intel，选择 x64 包。不要通过外壳型号、购买年份或系统名称猜测架构；同一系列电脑可能存在不同芯片配置。选择原生架构有助于减少兼容转换带来的额外变量。
打开 DMG 后，将应用复制到“应用程序”目录，再从该目录启动。首次打开遇到系统安全提示时，先确认下载来源，再到“系统设置 → 隐私与安全性”查看具体提示；不需要为了运行一个客户端而关闭整个系统的安全机制。
| 检查项 | 选择依据 | 注意事项 |
|---|---|---|
| 芯片 | Apple Silicon / Intel | 通过苹果菜单的“关于本机”确认，不按设备外观判断。 |
| 系统版本 | 需满足所选应用包的最低要求 | 架构正确不代表旧系统一定兼容；以安装提示和应用要求为准。 |
| 安装目录 | 应用程序 | 复制完成后再启动，避免长期从挂载的磁盘映像运行。 |
| 网络权限 | 按启用功能授权 | 修改系统代理或启用 TUN 时，阅读权限说明再确认。 |
如果应用能打开，但浏览器仍走原有网络，先检查系统代理开关、当前网络服务以及浏览器自己的代理设置。更新前退出旧进程，再替换应用；保留订阅地址不等于保留所有本地规则，建议同时记录路由设置和自定义 DNS 参数。
优先选择 v2rayNG。2015 年后的主流手机通常选 arm64，仍需以系统支持的架构为准。
v2rayNG 使用 Xray 内核，适合在 Android 上管理常见分享链接、订阅配置、路由与分应用代理。需要使用 VLESS 或 REALITY 配置时，优先按配置提供方的参数要求选择并设置，不要只看协议名称就省略传输层、安全类型或服务器名称。
arm64 包适用于系统支持 arm64-v8a 应用的设备；通用版包含多种架构，适合无法确认架构时使用。部分设备虽采用 64 位处理器，系统却可能只提供 32 位应用环境，因此购买年份和处理器参数只能作为参考，不能代替实际兼容性判断。
v2flyNG 使用 v2fly 内核，适合继续使用已有且明确兼容该内核的配置。它是独立应用，不是 v2rayNG 的附加组件。两个客户端的功能范围和参数支持可能不同，不应假定同一份包含内核专有字段的配置能直接互换。
从另一个客户端迁移时，先导出需要的分享链接或订阅信息，再逐项检查路由、DNS 与分应用代理。不要同时启动两个应用的 VPN 服务。若只是某条配置无法连接，先看错误日志和参数支持情况，而不是频繁更换安装包。
| 检查项 | 要求或选项 | 操作说明 |
|---|---|---|
| 应用架构 | arm64 / 通用版 | 不确定系统架构时选通用版；架构匹配仍需满足应用最低系统要求。 |
| 安装权限 | 允许当前来源安装应用 | 仅为本次使用的浏览器或文件管理器授权，安装完成后可关闭该权限。 |
| VPN 授权 | 首次连接时确认 | 系统会显示连接请求；授权后客户端才能接管相应流量。 |
| 后台运行 | 按设备电池策略调整 | 仅在锁屏断连时检查后台限制，不必预先修改所有省电选项。 |
安装时出现“应用未安装”，应依次核对系统版本、应用架构、剩余空间及安装签名。通用版只能扩大架构覆盖，不能解决签名冲突或系统过旧。当前版本文字与文件名若暂时不同，实际安装版本请查看应用的“关于”页面或系统应用信息。
先看发行版使用哪种包管理格式，再区分 x64 与 arm64。主入口为 x64 安装包。
Debian、Ubuntu 及使用同类包管理系统的发行版通常选择 deb；使用 RPM 包管理体系的发行版选择 rpm。包格式正确只是第一步，发行版提供的系统库、桌面环境和软件依赖也必须满足安装要求。尤其不要把所有 RPM 系发行版视为完全相同的运行环境。
在图形文件管理器中打开安装包，并由系统的软件安装器处理依赖。若安装器报告缺少库或版本不满足，先阅读具体错误，不要强行忽略依赖。安装后从应用菜单启动 v2rayN，再导入配置；系统代理是否生效，还取决于桌面环境和目标应用是否读取该设置。
| 检查项 | 对应选择 | 注意事项 |
|---|---|---|
| 处理器架构 | x64 / arm64 | amd64 与 x86_64 指 x64；aarch64 通常对应 arm64。 |
| 包管理格式 | deb / rpm | 根据发行版选择，不能仅通过改扩展名转换格式。 |
| 运行环境 | 图形桌面与所需依赖 | 本页面向图形客户端使用；安装器能打开不代表所有运行依赖都满足。 |
| 网络权限 | 系统代理 / TUN | 先用普通代理验证配置；启用 TUN 时按客户端提示处理额外权限。 |
如果软件已经运行，却只有部分应用经过代理，应先核对桌面代理设置和应用自身的网络选项。需要 TUN 时，先排除其他 VPN、虚拟网卡和已有路由规则的影响。不要把图形客户端长期以高权限运行当作默认解决方式。
安装之后
安装包解决“运行客户端”，服务器参数解决“建立连接”。按顺序验证，减少同时修改多个设置造成的误判。
单节点分享链接和订阅地址不是同一种内容。复制分享链接后使用剪贴板导入；拿到订阅地址则新建订阅分组，填写地址并执行更新。不要把网页介绍地址当作订阅地址，也不要在导入时删掉链接尾部的传输与安全参数。
导入成功后选中一条配置，先保持路由与 DNS 的基础设置，再启动系统代理或 VPN。打开日常使用的测试页面，结合日志判断连接是否建立。客户端出现运行标记，只代表服务启动，不等于服务器、解析与目标站点整条路径都正常。
按步骤导入并验证连接 →更新前导出配置，单独保存订阅分组、路由规则、DNS 和分应用代理设置。订阅能重新拉取服务器参数，但通常不能恢复所有本地偏好。备份文件可能包含服务器凭据，应保存在受控位置，不要公开发送。
退出旧客户端后再安装，避免后台进程仍占用文件。相同应用且签名兼容时，通常可以覆盖更新；遇到冲突先确认原因，不要直接卸载并丢失数据。完成后先验证原有配置，再逐项启用新功能，便于判断问题是否与升级有关。
查看订阅、路由与 DNS 配置 →下载相关问题
首次安装优先选 Desktop，它使用新一代跨平台界面。已经使用经典界面且工作正常，可以继续选择 WPF 版。切换前先备份配置，不要让两个客户端同时接管系统代理。
2015 年后的主流手机优先检查并选择 arm64；设备年份只是参考，最终以系统支持的应用架构为准。不确定架构或 arm64 提示不兼容时，选择通用版。通用版不能解决系统版本或安装签名不兼容。
客户端负责读取配置和建立连接，安装包不包含可直接使用的服务器配置。需要导入自行管理或有权使用的分享链接、二维码或订阅地址，再选择服务器并启动连接。
相同应用、相同安装签名且系统允许升级时，通常可以覆盖安装。更新前先导出配置并记录订阅分组与路由设置。如果系统提示签名冲突，不要直接卸载；先确认安装包来源和备份是否可恢复。
页面版本文字和下载文件路径来自清单中的不同字段，更新时可能暂时不一致。判断实际安装版本应查看客户端的关于页面或系统应用信息，不要仅凭页面版本文字推断安装包版本。
先确认服务器配置有效、系统代理或 VPN 已启用，并检查日志中的 DNS、连接超时和证书错误。通常应先排查配置与网络路径；只有应用无法启动、文件损坏或包架构不匹配时，才优先考虑重新下载。