桌面端选 v2rayN；安卓端先看 v2rayNG。核对系统与处理器架构后，再选择对应安装包。
下载入口按系统分组；切换平台后，地址栏保留对应锚点。
面向 x64 设备。首次使用从 Desktop 开始，保留经典操作习惯则选择 WPF。
两个入口的主要区别是界面技术与交互组织，不宜据此判断连接速度。节点质量、远端负载、路由和本地网络会共同影响体验。选择一个版本完成导入与连接验证后，再决定是否更换，避免把界面差异和配置差异混在一起排查。
文件保存到本地后，先完整解压到有写入权限的目录，再运行其中的安装或启动程序；不要直接在压缩包预览窗口中启动。若提示缺少运行环境，应按具体提示补齐对应组件，不要仅凭文件名安装任意旧运行库。
已有配置的用户应先导出备份，退出托盘中的旧客户端，再执行安装或迁移。Desktop 与 WPF 不建议同时运行：即使窗口彼此独立，也可能争用本地监听端口或反复改写系统代理。迁移后先检查订阅分组和路由选择，再进行一次实际访问测试。
| 核对项目 | 安装前确认 |
|---|---|
| 处理器架构 | 本页两个入口均为 x64；在“设置 → 系统 → 系统信息”核对系统类型，不能直接用于 32 位环境。 |
| 系统与运行环境 | 建议使用仍获系统维护的 Windows；具体最低系统版本及运行库要求，以所下载构建的安装提示为准。 |
| 目录与权限 | 选择可写目录并预留解压空间。普通使用先以常规权限启动，只有相关功能明确要求时再授权。 |
| 连接准备 | 保留已有订阅或节点配置；初次验证先使用系统代理，TUN 等功能在基础连接通过后单独测试。 |
在“苹果菜单 → 关于本机”查看芯片或处理器名称，再选择对应 DMG。
下载完成后打开 DMG，按映像中的指引将应用放入“应用程序”目录，再从该目录启动。不要长期直接从挂载映像中运行，否则退出映像或清理下载目录后，启动入口可能失效，也容易混淆正在使用的是哪一份程序。
芯片架构与系统版本是两项独立条件：选对 arm64 或 x64，并不代表当前系统必然满足构建要求。遇到无法打开或不兼容提示时，先记录完整提示、系统版本和芯片型号；若系统给出安全提示，应先核实文件来源与提示内容，通过系统提供的入口处理，不要直接关闭整套安全机制。
首次启动先导入一个已知可用的节点，再确认系统代理状态。浏览器能连接而某个应用不能连接时，应先确认该应用是否遵循系统代理，不要立即更换安装包。TUN 涉及不同的权限与接管路径，建议与系统代理分开验证，避免重复接管造成判断困难。
| 核对项目 | 安装前确认 |
|---|---|
| 芯片架构 | Apple M 系列使用 arm64；Intel 处理器使用 x64。优先选择与硬件匹配的原生构建。 |
| 系统版本 | 通过“关于本机”查看完整版本；最低要求随构建变化，以应用或系统的兼容性提示为准。 |
| 安装位置 | 需要能够写入应用安装目录，安装完成后从“应用程序”启动，而不是从 DMG 内长期运行。 |
| 系统授权 | 仅按实际功能授予必要权限；若网络接管功能提示额外授权，先阅读提示再决定是否启用。 |
先选 v2rayNG；需要 v2fly 内核配置时再考虑 v2flyNG。两个客户端分别管理自己的配置。
v2rayNG 适合需要订阅导入、节点切换和安卓 VPN 服务接管的用户。安装后进入订阅设置，添加分组并填入完整订阅地址，再执行更新。仅把链接复制到剪贴板不会自动建立订阅分组，单节点分享链接也不等同于可持续更新的订阅地址。
第一次点击连接时，系统会请求建立 VPN 连接。这是客户端接管网络流量的系统入口，应在确认当前操作后授权。若设备已经有其他 VPN 服务运行，先停止另一项服务再测试；同时检查客户端的分应用代理设置，避免测试应用恰好被排除。
卡片版本文字和安装包文件名可能因清单更新节奏而暂时不同，安装后的“关于”页面可用于确认实际版本。不要自行修改地址里的版本数字，也不要把文件名不同直接判断为架构不匹配。
v2flyNG 使用 v2fly 内核，可作为有相应配置需求时的备选。它与 v2rayNG 名称相近，但不是同一应用的不同外观；具体协议、传输方式和参数支持需要分别确认。不能因为一个客户端成功导入，就假定另一个客户端必然能够完整识别全部字段。
从 v2rayNG 迁移时，优先在新客户端重新添加有权使用的订阅，核对节点数量与参数，再测试连接。应用内部的完整备份不一定能跨客户端直接恢复。保留原配置直到新客户端验证通过，测试时只启动一个 VPN 服务。
| 核对项目 | 安装前确认 |
|---|---|
| 应用架构 | 优先 arm64；处理器支持 64 位不等于系统一定允许 64 位应用，存疑时选择通用版并查看安装结果。 |
| 系统版本 | 在系统设置中查看 Android 版本；最低要求以所下载 APK 的安装提示为准，通用版不会降低系统要求。 |
| 安装权限 | 系统可能要求为当前浏览器或文件管理器允许安装应用；只为本次使用的来源授权，完成后可收回。 |
| 升级冲突 | 遇到签名或应用冲突先备份配置，再核对原安装来源；不要在没有备份时直接卸载旧应用。 |
| 后台运行 | 如锁屏后断连，再检查电池优化和后台限制。先验证前台连接，避免过早修改大量系统设置。 |
先确认发行版的包管理体系，再确认处理器架构。deb 与 rpm 不是可以互换的文件扩展名。
在系统“关于”或硬件信息中查看架构：amd64、x86_64 通常对应这里的 x64，aarch64 通常对应 arm64。包管理器还会检查发行版依赖与软件包元数据，因此即便扩展名和架构一致，也不能据此保证所有发行版都能安装同一个构建。
下载后使用发行版的图形软件安装器打开安装包，先阅读依赖和变更摘要，再确认安装。如果提示依赖无法满足，应保留具体缺失项和系统版本，不要通过强制忽略依赖来绕过错误。图形界面客户端需要可用的桌面会话，不适合作为纯命令行服务器上的直接替代方案。
安装后的系统代理是否生效，取决于桌面环境与目标应用的代理支持。某个应用不跟随系统代理时，先查看应用自己的网络设置；若后续启用 TUN，再按功能提示处理权限。不要为了排查单个应用而把整个图形客户端长期以高权限运行。
| 核对项目 | 安装前确认 |
|---|---|
| 包格式 | 按发行版选择 deb 或 rpm；不要通过改扩展名、随意转换包格式来处理不兼容问题。 |
| 架构 | x64 对应 amd64 / x86_64；arm64 对应 aarch64。两个包格式均提供相应架构入口。 |
| 桌面与依赖 | 需要图形桌面环境；系统库、桌面组件及最低版本要求由安装器和构建依赖共同决定。 |
| 安装权限 | 由系统安装器请求安装授权；安装完成后优先在普通用户桌面会话中运行。 |
客户端下载与订阅服务是两件事。程序安装完成后，需要导入已有的订阅地址或单节点配置，选择一个节点作为当前服务器，再启动连接。订阅更新成功只说明取得了配置，并不能证明其中每个节点都能连接；应观察实际请求结果与内核日志，而不是只看列表是否出现。
桌面端先检查系统代理，安卓端先确认 VPN 服务建立。基础连接通过后，再逐项设置路由、分应用代理或 TUN。每次只改变一个变量，记录修改前后的现象，能够区分安装问题、配置问题和网络路径问题。
首次安装可先选 Desktop 桌面版，它采用新一代跨平台 UI；熟悉经典界面和操作习惯的用户可选 WPF 经典稳定版。两者先选一种安装，迁移前导出配置，不要同时启动并占用相同监听端口。
2015 年后的主流手机通常可优先选择 arm64，但最终应以设备支持的应用 ABI 为准。通用版包含多种架构，适合架构不明确的设备；若出现解析或安装错误，还应检查系统要求、签名冲突和存储空间。
安装包提供客户端程序，不附带可直接使用的节点或订阅服务。安装后需要导入有权使用的订阅或节点配置，再选择服务器、设置路由并验证连接。订阅地址属于敏感信息，不应公开分享。
版本文字与下载地址来自清单中的不同字段，更新过程中可能暂时不一致。不要通过改写文件名尝试下载其他版本；先核对所选平台和架构，安装后在客户端关于页面确认实际版本，再决定是否迁移原配置。
先使用客户端提供的备份或导出功能保存订阅分组、自定义节点、路由规则及必要设置，并将备份放在私人目录。关闭正在运行的客户端后再升级，首次启动先验证单个节点，不要立即覆盖原备份。
先检查内核能否启动、节点配置是否完整、本地端口是否被占用，以及系统代理或安卓 VPN 服务是否启用。安装成功不代表订阅或远端服务可用；保留脱敏后的首条错误日志，按排查手册定位，通常比反复重装更有效。