先选系统，再选架构。桌面使用 v2rayN，Android 首选 v2rayNG，v2flyNG 作为内核备选。
以下两个安装入口均面向 x64 系统。首次安装优先考虑桌面版，保留经典操作习惯可选 WPF 版。
新一代跨平台 UI，适合首次使用及在多个桌面系统之间保持相近的操作方式。
经典稳定版，沿用 WPF 界面，适合熟悉传统服务器列表与设置布局的用户。
下载内容为 ZIP 压缩包。先完整解压，再按包内结构运行安装程序；不要直接在压缩文件预览窗口内启动。
| 确认项 | 选择依据 | 操作说明 |
|---|---|---|
| 系统架构 | x64 Windows | 在“设置 → 系统 → 系统信息”查看系统类型；不要只根据电脑品牌判断。 |
| 系统兼容性 | 受当前发行版支持的 Windows | 系统版本与运行环境要求以安装程序及发行说明为准，较旧系统应先确认兼容性。 |
| 安装环境 | 可写目录、足够存储空间 | 完整解压，按提示补齐运行环境；避免把两种界面的程序文件覆盖到同一目录。 |
| 权限范围 | 普通使用与 TUN 分别处理 | 常规配置不必预先提权；启用虚拟网卡功能时再按客户端提示授予所需权限。 |
桌面版与 WPF 版的区别首先是界面框架，不应据此推断某一种协议必然更快。实际协议支持还取决于所选内核及其版本。已有配置需要迁移时，先使用导出或备份功能保留服务器、订阅分组与路由规则，再在新界面中导入；不要把“复制程序文件”当成完整的数据迁移。
完成安装后，先确认客户端可以正常打开，再导入配置。需要让浏览器使用代理时，检查系统代理状态；需要接管不遵循系统代理的应用时，再评估 TUN 模式。两者接管范围不同，安装成功并不意味着所有应用流量已经改变。
从“关于本机”确认芯片。Apple Silicon 与 Intel 使用不同架构的安装包，优先选择与硬件一致的版本。
适用于 Apple M 系列芯片。查看“关于本机”的“芯片”一栏确认机型。
适用于 Intel 处理器机型。若设备信息显示 Intel，应选择此安装包。
打开 DMG 后按窗口提示安装到“应用程序”。首次启动的权限提示与网络权限应逐项确认。
| 确认项 | 选择依据 | 操作说明 |
|---|---|---|
| Apple Silicon | ARM64 DMG | 设备信息显示 Apple M 系列芯片时选择原生架构包。 |
| Intel 处理器 | x64 DMG | 设备信息显示 Intel 时选择对应包，不以机身外观区分架构。 |
| 系统版本 | 符合当前发行版要求 | 出现系统过旧提示时先查兼容要求，重复下载同一个包不会改变系统限制。 |
| 功能权限 | 按实际功能授予 | 启用 TUN 时可能需要额外授权，安装应用与启用虚拟网卡是两个步骤。 |
同为 Mac 电脑并不代表可以使用相同的二进制程序。原生架构包通常是最直接的选择，不应为了沿用旧安装习惯而优先使用另一种架构。安装完成后从“应用程序”启动，确认程序可运行，再进行订阅导入和路由设置，便于把安装问题与连接问题分开排查。
如果系统阻止打开应用，先阅读提示中的原因，确认是来源限制、兼容性还是权限问题，再通过系统提供的应用级入口处理。不要直接关闭整机安全功能。更换芯片架构的电脑时，配置数据可以通过受支持的导出方式迁移，但程序本体仍需重新选择对应安装包。
优先使用 v2rayNG；需要 V2Fly 内核路径时，再选择 v2flyNG。两款应用应分别确认协议和订阅兼容性。
2015 年后的主流手机通常可优先选择，仍需确认系统支持 64 位 ARM 应用。
覆盖更多处理器架构，适合架构不明确或需要兼顾不同设备的情况。
通过 Android VPN 接口接管流量，首次连接时需要确认系统授权。
面向支持 64 位 ARM 应用的设备，用于需要 V2Fly 内核兼容性的配置。
无法确定处理器架构时可考虑；是否能够安装还取决于系统版本等条件。
不要把 Xray 专有功能直接当成 V2Fly 通用能力，导入前确认配置所需功能。
| 确认项 | 选择依据 | 操作说明 |
|---|---|---|
| 处理器与系统 | arm64 或通用版 | 手机处理器支持 64 位，不等于系统必然支持 64 位应用；以设备系统能力为准。 |
| 安装权限 | 按来源应用授予 | 仅给用于打开 APK 的浏览器或文件管理器授予所需权限，完成后可收回。 |
| 系统兼容性 | 满足应用当前要求 | 解析软件包失败时检查系统版本、架构、剩余空间和下载是否完成。 |
| 网络接管 | Android VPN 授权 | 同一时间通常只能启用一个基于 VPN 接口的应用，注意其他网络工具的占用。 |
APK 是应用安装文件，安装后还要导入订阅或服务器参数。首次启动连接时，系统会提示建立 VPN 连接，这一步授予的是本机流量接管能力，不代表已经连接到可用服务器。应先确认当前选中的配置，再检查通知栏及客户端日志，避免把授权完成误认为连接验证完成。
arm64 包通常比包含多种架构的通用包更精简，但不能用包大小判断功能完整程度。若安装提示与已存在的应用冲突，先确认是否为相同应用及签名来源，保留配置备份后再处理。不要在不了解原因时直接卸载，因为卸载可能同时移除本地保存的订阅、服务器与路由设置。
移动端后台限制会影响连接保持。只有出现熄屏断连、后台被结束等实际问题时，再检查电池优化与后台运行权限；不必在安装阶段一次性放开所有权限。v2rayNG 与 v2flyNG 可以分别用于兼容性判断，但不要同时开启它们的网络接管，以免混淆当前生效的配置。
先按发行版的软件包体系选择 deb 或 rpm，再确认处理器是 x64 还是 ARM64。发行版名称与处理器架构是两个独立条件。
适用于使用 deb 包体系的兼容发行版，例如 Debian、Ubuntu 系列。
适用于匹配该包依赖要求的 rpm 系发行版，安装前确认系统兼容性。
使用系统的软件安装器打开对应软件包。相同扩展名不代表所有发行版都满足其依赖与运行环境要求。
| 确认项 | 选择依据 | 操作说明 |
|---|---|---|
| 图形环境 | 可运行桌面应用的系统 | 本页提供图形客户端，适合本地桌面使用；不要把它当作服务器服务包安装。 |
| 包管理体系 | deb 或 rpm | 依照发行版原生体系选择，优先让系统安装器检查依赖，而非手工混装。 |
| 处理器架构 | x64 或 ARM64 | x64 也常标为 amd64、x86_64；ARM64 也常标为 arm64、aarch64。 |
| 运行依赖 | 满足软件包声明 | 依赖无法满足时先确认发行版版本与包适配范围，不要强行忽略依赖。 |
deb 与 rpm 描述软件包的封装体系，不直接决定代理协议能力。即使两个发行版都使用 rpm，也可能因为基础库和依赖版本不同而不能安装同一个包。安装器出现依赖错误时，先保留具体提示，核对系统版本与架构，不要通过重命名扩展名或转换文件名尝试解决。
安装结束后从桌面应用菜单启动 v2rayN，先完成普通用户下的配置导入。系统代理能否覆盖应用取决于桌面环境和应用自身的代理支持；TUN 则涉及额外的网络权限与路由设置。建议先验证普通代理，再按需启用 TUN，逐步缩小问题范围，避免同时改变 DNS、路由和权限后难以定位异常。
把程序安装、配置导入和流量接管分开验证。每一步确认正常，再进入下一步。
客户端不提供连接目标。取得有使用权限的订阅后，在订阅分组中添加地址并更新；只有单个分享链接时，使用客户端提供的剪贴板导入功能。订阅链接可能包含账户标识，应视为敏感数据，不要粘贴到公开讨论区或截图中。
导入成功后检查协议类型、传输方式和安全层是否被完整识别。VLESS、VMess 与 Trojan 是不同的配置类型，不能只改名称就相互转换。遇到不认识的字段时，先对照配置提供方说明及所选内核能力，不要凭相近名称补填参数。
查看协议与内核技术参考 →从列表选定活动服务器后，再开启系统代理或移动端连接。系统代理主要服务于遵循系统代理设置的应用，TUN 通过虚拟网络接口扩大接管范围；它们不是简单的速度档位。先使用符合需求的最小接管范围，再根据应用行为调整。
验证时既要观察目标访问是否正常，也要查看客户端日志和路由命中情况。列表中的延迟测试不能代替完整访问测试，单次失败也不能直接归因于安装包。按配置、服务器、DNS、路由和应用代理设置的顺序检查，比反复重装更容易找到原因。
按步骤完成首次连接 →更新程序不等于迁移数据。更换界面、设备或内核前，先确认配置保存方式。
先使用客户端支持的导出或备份功能，保留订阅分组、手动服务器和自定义路由。订阅可以重新拉取，不代表手动修改的字段也能自动恢复。需要记录的还包括当前内核、DNS 策略、系统代理模式和 TUN 设置，便于更新后逐项核对。
退出客户端后再运行更新安装流程，避免文件仍被占用。不同安装方式可能把用户数据放在不同位置，因此不能默认“卸载程序”一定保留配置，也不能默认“复制程序文件夹”就是完整备份。迁移到新设备时，只通过可信方式传递配置文件，并妥善保存其中的敏感内容。
首次打开更新后的客户端，确认订阅分组和服务器列表仍然存在，再检查活动服务器、默认路由以及系统代理状态。内核升级可能带来字段或行为变化，配置能够导入不代表每项功能都已经按原样生效；应结合日志与实际访问进行确认。
如果只有某一类应用异常，先检查该应用是否遵循系统代理，而不是立即更换安装包。若导入同一订阅后两个客户端表现不同，应核对内核支持与订阅解析方式。确认配置恢复完整、连接工作正常后，再清理旧安装文件和临时导出的敏感资料。
集中说明安装包选择、系统权限与更新备份。
客户端负责管理配置与转发流量，安装包不包含可用服务器。需要自行准备有使用权限的服务器配置或订阅，导入后选择服务器，再设置系统代理或 TUN 模式。订阅地址属于敏感信息，不要公开分享。
首次安装可先选桌面版，它使用新一代跨平台界面；熟悉经典布局、希望延续原有操作习惯时可选 WPF 版。两种界面的菜单位置与配置保存方式可能不同，迁移前先导出配置，不要直接混用程序目录。
arm64 包面向支持 64 位 ARM 应用的设备，2015 年后的主流手机通常可优先选择。通用版覆盖更多处理器架构，但体积通常更大。设备年代不能完全代替架构判断；若 arm64 无法安装，应先确认系统是否支持 64 位应用，再考虑通用版。
先确认系统类型、处理器架构、可用存储空间及系统兼容性，再查看提示的具体原因。Android 只对实际用于打开安装包的应用按需授予安装权限；桌面系统按应用级提示处理。不要为完成安装而关闭整机安全防护，也不要在原因不明时反复强制安装。
先通过客户端导出或备份配置，记录当前使用的内核、路由方案及 DNS 设置，再退出客户端并更新。不要默认程序目录包含所有用户数据。更新后检查订阅分组、活动服务器、系统代理和 TUN 状态，确认连接正常后再清理旧文件。
页面版本文字与下载地址分别读取版本清单的不同字段，清单更新期间可能暂时不一致。文件名只用于辨认包类型，不应单独作为已安装版本的依据；安装后可在客户端的关于页面确认实际版本。遇到差异时先核对应用名称、平台和架构。