桌面端选 v2rayN，安卓端首选 v2rayNG。先确认操作系统与处理器，再选择对应安装包。
Windows x64 · Desktop 桌面版 / 经典 WPF 版
桌面版使用新一代跨平台界面，适合希望在不同桌面系统间保持相近操作习惯的用户。服务器、订阅分组、路由与内核设置仍需分别核对；界面相近不代表系统代理机制完全相同。
WPF 版沿用经典 Windows 界面，适合熟悉原有菜单布局的用户。两版不是速度档位之分；实际连接表现主要取决于服务器、线路、协议组合和路由设置，而非界面框架。
| 检查项 | 对应要求 |
|---|---|
| 系统与架构 | 面向 Windows x64 环境；在“设置 → 系统 → 系统信息”确认系统类型。 |
| 安装包格式 | 入口为 ZIP 压缩包。先解压到独立目录，再按包内结构运行安装程序或客户端。 |
| 运行环境 | 具体系统版本和运行库要求随发行包变化；出现缺少运行环境提示时，按提示补齐匹配组件。 |
| 权限与接管方式 | 普通系统代理与 TUN 的权限要求不同；使用 TUN 时按客户端提示完成权限授权。 |
不要直接在压缩包预览窗口里启动程序。完整解压后再运行，可以让程序找到同目录的资源、配置与组件。安装位置应便于当前账户写入；遇到配置保存失败，先检查目录权限，不要把反复重装当作第一步。
安装完成后，先导入订阅或服务器配置，再选中需要使用的条目。系统代理只会影响采用系统代理设置的应用；某个程序没有经过代理时，应先检查该程序的网络设置。切换 Desktop 与 WPF 版前，先导出配置，退出旧程序并清理旧的系统代理状态，避免两个实例同时修改设置。
macOS · 按“关于本机”显示的芯片选择
“关于本机”中显示 Apple M 系列芯片时，选择 arm64 安装包。优先使用与芯片对应的原生架构，不要仅凭设备购买年份判断；同一时期销售的不同机型可能采用不同处理器。
“关于本机”中显示 Intel 处理器时，选择 x64 安装包。两种 DMG 对应的是处理器架构，不是功能等级。若系统提示应用无法运行，先确认架构和系统兼容条件，再检查安装过程。
| 检查项 | 对应要求 |
|---|---|
| 处理器 | Apple Silicon 对应 arm64；Intel 对应 x64，在系统菜单的“关于本机”查看。 |
| 包格式 | DMG 镜像。打开后按镜像中的安装引导放入“应用程序”目录。 |
| 系统兼容 | 以当前发行包的运行要求和系统提示为准；较旧系统需先确认兼容性。 |
| 系统授权 | 根据所用代理模式处理系统授权；网络扩展或接管功能的授权不等于订阅导入。 |
安装后从“应用程序”启动客户端，不要长期从挂载的磁盘镜像中运行。若出现安全提示，先确认下载入口及提示内容，再通过系统提供的隐私与安全设置处理；不要为安装一个应用而全局关闭系统安全功能。
从其他桌面系统迁移配置时，可以复用兼容的服务器参数，但本地路径、网络接口、系统代理和权限设置需要重新核对。先验证单条配置能够连接，再恢复完整路由规则，便于区分问题来自服务器参数还是本机接管方式。退出客户端前也应确认系统代理是否已恢复。
Android · Xray 内核 · arm64 / 通用版
2015 年后的主流手机通常选择 arm64，但仍应确认系统支持 64 位应用。处理器能力与系统运行环境并不总是一致；出现架构不兼容提示时，先核对设备信息，再考虑通用版。
通用版包含更多架构支持，通常体积更大。它不代表更快的连接速度，也不会自动修复订阅参数错误。首次启动后仍需导入有效配置，并允许系统创建 VPN 连接。
Android · V2Fly 内核 · 先核对协议兼容性
适合需要使用 V2Fly 配置能力的用户。选择前确认服务器要求的协议、传输与安全字段，不能仅按客户端名称推断兼容性；同属 Project V 生态，不代表所有扩展功能都相同。
不确定设备架构时可选通用包。由 v2rayNG 迁移时，先保留原有配置备份，逐项核对路由与 DNS；只切换安装包并不会自动转换不同内核的专有设置。
| 检查项 | 对应要求 |
|---|---|
| 系统兼容 | 需要支持当前 APK 的安卓系统；具体最低版本以安装器和发行要求为准。 |
| 设备架构 | 64 位安卓环境优先 arm64；不确定时选通用版，仍需满足系统版本要求。 |
| 安装授权 | 按系统提示允许当前浏览器或文件管理器安装应用，完成后可收回该权限。 |
| 连接授权 | 使用 VpnService 接管流量需要系统 VPN 授权；同一用户环境通常只能运行一个 VPN 服务。 |
| 后台运行 | 持续连接需要合理设置电池优化和后台权限，具体入口随设备系统变化。 |
安装器提示“应用未安装”时，要区分系统版本过低、架构不匹配、存储不足与签名冲突。通用版主要解决架构覆盖问题，并不能绕过其他安装条件。已有配置时先做备份，不要立即卸载旧应用，以免丢失仅保存在本机的服务器信息。
首次连接时的 VPN 确认框是系统流量接管授权，不是服务器登录。授权后再检查服务状态和日志。若锁屏后经常中断，核对电池优化与后台限制；若只有部分应用不走代理，检查分应用代理的包含或排除模式，而不是重复更换安装包。
两款安卓客户端可以分别保存配置，但测试时只启动其中一个 VPN 服务。需要了解内核差异时，可查看协议与内核参考；需要完整的后台设置路径，可阅读v2rayNG 授权、省电与分应用代理笔记。
Linux · 先选发行版包格式，再选 x64 或 arm64
采用 Debian 包管理体系时选择 deb。文件名中的 amd64 对应常见的 x64 架构，不只用于某一个处理器品牌。ARM 桌面设备应选择 arm64 包，并确认发行版提供相应运行依赖。
采用 RPM 包管理体系时选择 rpm。x86_64 对应 x64，aarch64 对应 arm64。包格式合适只是第一步，还要检查运行库与发行版兼容条件，避免强行忽略依赖继续安装。
| 检查项 | 对应要求 |
|---|---|
| 运行环境 | 需要图形桌面和当前客户端依赖，不适用于只有字符终端的运行场景。 |
| 架构对应 | amd64 / x86_64 选 x64；aarch64 选 arm64，不能只按发行版名称选择。 |
| 包管理体系 | 按发行版使用 deb 或 rpm，通过系统软件安装器查看依赖与兼容性提示。 |
| 网络接管 | 桌面系统代理是否被应用采用，取决于桌面环境与应用自身设置；TUN 另有权限要求。 |
下载后用发行版的软件安装器打开对应文件，先查看依赖提示，再完成安装。即使文件扩展名正确，较旧运行库或不同发行版分支仍可能导致安装失败；不要把包转换或忽略依赖作为默认处理方法。
启动后先验证客户端中的单条配置，再处理桌面环境的系统代理。浏览器、下载工具和其他应用未必读取同一组代理设置。若客户端能够建立连接而某个应用仍直连，应检查该应用采用的代理来源；若使用 TUN，则还需要核对权限、网络接口及已有的网络管理服务。
安装包解决程序运行问题。服务器配置、流量入口与路由规则需要分别完成。
订阅地址用于拉取一组服务器配置；单条分享链接用于导入一个配置条目。两者不要混放到错误的输入框。导入后检查协议类型、地址、端口、传输与安全参数，先选择一个条目做连接测试。订阅更新通常更新服务器列表，不等于同步本机路由、DNS 和代理模式。
桌面系统代理主要影响遵循系统设置的应用；安卓客户端通过 VpnService 接管流量，并可进一步设置分应用代理。路由规则只处理已经进入内核的连接，不能替代系统代理或 VPN 授权。先确认流量入口，再决定哪些域名和地址走 proxy、direct 或 block。
服务启动后，使用目标应用发起一次实际请求，并结合日志判断连接是否建立。延迟测试数字、界面运行状态和实际下载速度测量的对象不同。遇到超时，按系统时间、配置更新、传输参数、DNS 与日志的顺序检查，避免同时改动多项设置而失去判断依据。
客户端程序、服务器配置和本地设置是三类不同数据，更新时分别处理。
更新前导出需要保留的服务器配置，单独记录路由规则、DNS、监听端口和分应用代理。不同客户端的导出范围可能不同，不能把“导出服务器”理解为完整备份。备份文件与订阅地址都可能包含访问凭据，应存放在受控位置。
同一客户端覆盖更新通常可以沿用数据，但仍受系统安装规则、应用签名及安装方式影响。遇到签名或依赖提示时，先读清具体原因，再决定迁移方案；不要在尚未备份时删除旧程序和配置目录。
Project V 是相关代理工具的生态背景，V2Fly 延续 V2Ray 内核的发展，Xray 属于相关技术家族并有自己的功能扩展。v2rayN 管理桌面配置，安卓的 v2rayNG 与 v2flyNG 则需要结合各自内核能力选择。
这些客户端采用开源方式发布，具体许可范围以对应项目和组件的声明为准。选型时应检查协议、传输和安全字段的组合，而不是只看是否支持某一个协议名称。迁移后用单条配置验证，再恢复复杂规则。
先判断安装条件，再排查连接设置。更换安装包不是所有问题的共同解法。