先选系统，再选处理器架构。
桌面端使用 v2rayN；安卓端优先选 v2rayNG，需要 V2Fly 配置生态时再考虑 v2flyNG。安装后导入已有订阅，客户端本身不提供服务器。
以下两个入口均为 x64 包。首次安装先看 Desktop；沿用经典操作习惯可选 WPF。下载得到压缩包后，先解压，再运行其中的安装程序。
Desktop 是新一代跨平台 UI；WPF 是经典稳定版。两者都用于订阅管理与代理配置，界面布局和设置入口有所区别。
首次使用建议先装 Desktop，完成一次订阅导入与连接验证，再调整路由。已有 WPF 配置的用户不必只为更换界面而迁移；确需切换时，先从原客户端导出配置，再在新客户端中导入。不要把整个程序目录相互覆盖，也不要默认两种界面会实时共享设置。
安装时使用普通用户权限即可完成多数日常操作。系统代理通常不需要提权，TUN 则可能涉及管理员权限及虚拟网络组件。建议先保持 TUN 关闭，确认系统代理能够工作后，再按实际需求启用。若两个版本同时启动，监听端口可能冲突，应先退出旧实例。
| 核对项目 | 要求与选择 | 查看方法 |
|---|---|---|
| 处理器架构 | 本页提供 x64 安装包 | 设置 → 系统 → 系统信息，查看系统类型 |
| 系统兼容性 | 以当前安装程序提示为准，旧系统需特别确认运行环境 | 先完成系统更新，再处理安装程序给出的依赖提示 |
| 运行权限 | 普通代理与 TUN 的权限需求不同 | 先验证系统代理，需要 TUN 时再按提示授权 |
不要直接在压缩包预览窗口中启动程序。先解压到可写目录，完成安装后从应用入口运行。若系统提示缺少运行组件，记录提示中的组件名称与架构，按提示补齐；反复重装同一个安装包通常不能解决缺少依赖的问题。
先在苹果菜单的「关于本机」查看芯片信息。显示 Apple M 系列时选 Apple Silicon；显示 Intel 处理器时选 Intel，不按系统名称或电脑外观猜架构。
Apple M 系列优先使用原生 arm64 包；Intel 机型使用 x64 包。两个包是处理器适配不同，不代表功能等级不同。
打开 DMG 后，将应用拖入「应用程序」目录，再从该目录启动。不要长期从挂载的磁盘映像中运行，否则更新、权限记录和应用路径可能难以保持一致。首次启动若出现系统安全提示，先确认来源与应用名称，再到系统设置的「隐私与安全性」查看具体原因，不建议关闭整机安全机制。
订阅与路由设置可以参考桌面版教程，但菜单位置可能随界面版本调整。配置系统代理后，先用浏览器验证，再检查其他应用是否遵循系统代理。部分终端工具有自己的代理设置，浏览器可用而终端不可用，并不能直接说明订阅失效。需要接管更多应用时，再了解 TUN 的权限和路由影响。
| 核对项目 | 要求与选择 | 查看方法 |
|---|---|---|
| 芯片 | Apple Silicon 选 arm64；Intel 选 x64 | 苹果菜单 → 关于本机 |
| 系统版本 | 需满足当前应用声明的最低系统版本 | 在关于本机查看系统版本，结合启动提示判断 |
| 应用位置 | 复制到应用程序目录后运行 | 安装完成后推出 DMG，再启动应用 |
若提示应用不兼容，先检查芯片包是否选错，再检查系统版本。处理器架构正确不等于任意旧系统都能运行当前应用。升级系统前应考虑设备支持情况；不要通过随意修改应用文件来绕过明确的兼容性要求。
2015 年后的主流手机通常先选 arm64。无法确认系统架构，或 arm64 包提示不兼容时，再考虑通用版。两款客户端独立保存配置，切换应用不等于自动迁移订阅。
适合日常订阅管理与 Xray 相关配置。arm64 包面向对应系统架构，通用版包含多种架构的适配内容。
下载 APK 后，从系统文件管理器打开。若系统询问安装来源权限，只对当前负责安装的浏览器或文件管理器授权，安装结束后可关闭该权限。首次连接会请求建立 VPN 连接，这是安卓端接管流量所需的系统授权；确认应用名称后再允许。
导入订阅后先更新分组，再选择服务器并启动连接。不要只看到列表出现条目就认为已经接通。若后台连接经常中断，检查电池优化、后台活动与常驻通知设置，并留意设备是否已有其他应用占用系统 VPN 连接。开启更多功能前，先验证基础连接与域名解析。
面向需要 V2Fly 内核生态的配置。选择依据是协议与字段兼容性，不是应用名称是否相似。
已有适配 V2Fly 的配置时，可以把 v2flyNG 作为备选。不要默认它与 v2rayNG 的协议能力完全一致，尤其是涉及特定内核扩展的配置。导入失败时，先核对分享链接类型、传输方式与安全选项，再判断是否需要换用另一客户端。
从其他应用迁移时，优先重新添加订阅地址，再逐项核对路由与 DNS 设置。节点名称相同也不代表所有字段已经完整迁移。两个安卓客户端可以分别安装，但验证连接时应一次只运行一个，避免把系统 VPN 的切换误判为服务器不稳定。
| 核对项目 | 要求与选择 | 处理建议 |
|---|---|---|
| 系统架构 | 64 位系统通常选 arm64；不确定时可选通用版 | 以系统架构为准，不只依据处理器宣传参数 |
| 系统兼容性 | 需满足对应 APK 的最低系统要求 | 出现解析失败时同时检查系统版本与下载状态 |
| 安装与连接权限 | 安装来源授权、系统 VPN 连接授权 | 分别按系统提示确认，不必开放无关权限 |
安装提示「与现有应用冲突」时，不要立即卸载。先确认当前应用的来源和签名是否与新包一致，再导出配置。若必须重装，确保订阅地址与自定义规则已有备份；仅保存一张节点列表截图，通常不足以还原完整配置。
常规 x64 桌面先选对应包格式；ARM 桌面设备使用下方 arm64 入口。包格式由发行版决定，处理器架构由设备决定，两项都要匹配。
Debian、Ubuntu 等通常使用 deb；Fedora、RHEL 等通常使用 rpm。相同包格式不保证所有发行版版本都能满足依赖。
使用系统软件安装器打开下载包，先查看依赖与架构提示，再确认安装。当前 rpm 文件名带有构建目标信息，安装前尤其要检查发行版提供的运行库能否满足要求。不要为了绕过依赖错误而强制安装，也不要直接把其他发行版的软件源混入当前系统。
这是图形客户端入口，适用于带桌面环境的设备。安装后先从应用菜单启动，完成订阅与系统代理设置。不同桌面环境对系统代理的支持不同，终端程序也可能不读取桌面代理设置。需要 TUN 时再处理权限与路由，避免刚安装就以高权限运行全部日常操作。
| 核对项目 | 要求与选择 | 查看方法 |
|---|---|---|
| 包格式 | 按发行版选择 deb 或 rpm | 系统信息与软件管理器可显示发行版名称 |
| 处理器架构 | x64 对应 amd64 / x86_64；arm64 对应 aarch64 | 在系统信息中查看硬件与操作系统架构 |
| 运行环境 | 图形桌面与安装包所需依赖 | 由系统软件安装器检查依赖和兼容性 |
如果软件管理器拒绝安装，先阅读缺失依赖的名称，而不是立即更换节点或订阅。依赖问题发生在应用启动之前，与服务器连接无关。系统代理和 TUN 属于安装后的配置阶段，应在客户端能够正常打开后分别验证。
先跑通一条连接，再增加规则。安装包、订阅与代理模式是三件事，排查时也应分别确认。
订阅地址通常放在订阅分组中，保存后还要执行更新；以 vmess:// 或 vless:// 开头的单节点链接通常从剪贴板入口导入。不要把订阅地址发给陌生转换服务，地址中可能包含个人访问凭据。
选中有效服务器后再启用连接。桌面端先使用系统代理，安卓端按系统提示建立 VPN 连接。默认路由适合先验证基本功能；自定义分流与 TUN 留到基础连接正常后处理，便于判断问题来自哪一步。
查看使用文档 →用实际需要的应用测试访问，再查看日志有无明确错误。延迟测试只是参考，不能代替真实请求。确认配置可用后导出备份，升级、换机或切换客户端时先保存原设置，避免同时丢失订阅和自定义规则。
连接问题排查 →架构不匹配、安装失败和连接失败处在不同阶段。先定位阶段，再处理对应问题。
需要准备可用的订阅地址、单节点分享链接或已有配置。客户端负责管理配置和建立连接，安装包本身不附带可用服务器。订阅地址通常从订阅分组导入，单节点分享链接通常从剪贴板导入，两个入口不要混用。
首次安装可先选 Desktop，它采用新一代跨平台界面。习惯经典界面或需要延续原有操作流程时，可选经典稳定的 WPF 版。两者不是节点套餐的区别。切换前先导出配置，不要让两个客户端同时占用相同的监听端口。
2015 年后的主流手机通常先选 arm64，但仍应以设备的系统架构为准。通用版覆盖多种架构，适合无法确认架构或 arm64 包提示不兼容时尝试。部分设备的处理器支持 64 位，但安装的系统仍可能是 32 位。
同一客户端的正常升级通常会保留数据，但不同安装方式、签名或数据目录可能影响结果。更新前先通过客户端界面导出配置，并记录订阅分组和路由设置。不要先卸载旧版；若出现签名冲突或无法覆盖安装，应先确认备份可用，再决定后续操作。
先检查订阅是否成功更新、是否选中了有效服务器，再确认系统代理或连接开关已经启用。随后查看客户端日志，区分端口占用、认证失败、解析失败与连接超时。先使用系统代理验证，不要同时改动协议、路由和 TUN 设置。