桌面选 v2rayN，安卓先选 v2rayNG。确认系统与处理器，再下载对应安装包。
先选桌面版；需要经典界面时，再选 WPF 版。
两个入口均为 ZIP 压缩包。下载完成后先解压，再按包内安装程序与提示继续，不要直接在压缩包预览窗口中运行。
Desktop 是新一代跨平台 UI。首次安装可以从这个版本开始，订阅分组、服务器选择和设置入口都在图形界面中完成。WPF 是经典稳定版。如果已经熟悉经典布局，或需要沿用相应的操作习惯，可以选择 WPF。两者不是两个订阅服务，同一个有效订阅能否使用，取决于协议和当前内核的支持情况。
下载前打开「设置 → 系统 → 系统信息」，查看系统类型。本页两个 Windows 入口都是 x64 包，不应仅凭电脑外观判断架构。安装后先完成订阅更新，再选择服务器和路由模式；最后开启系统代理。不要同时运行两个版本并修改系统代理，否则退出其中一个时，另一个的代理设置也可能受到影响。
| 检查项 | 选择与准备 |
|---|---|
| 处理器 | x64 系统与处理器；在系统信息中确认，不将 x64 包当作其他架构的原生安装包。 |
| 系统环境 | 确认当前发布版本支持所用 Windows 版本；运行时组件按安装程序提示准备。 |
| 目录权限 | 解压到可正常读写的位置，保留配置文件所需权限；升级前退出正在运行的客户端。 |
| 代理权限 | 普通系统代理与 TUN 的权限需求不同；启用 TUN 前按客户端提示授予相应权限。 |
先在「关于本机」查看芯片，再选择对应 DMG。
M 系列芯片选 Apple Silicon；显示 Intel 处理器时选 x64。不要根据购买年份推测芯片类型。
点击系统菜单中的「关于本机」。如果芯片字段显示 M 系列名称，下载 arm64 包；如果显示 Intel 处理器，下载 x64 包。选对原生架构可以减少兼容层带来的额外变量。两份安装包提供同一客户端的不同架构构建，不需要为同一台电脑同时安装两份。
打开 DMG 后，按窗口提示将应用放入「应用程序」，再从该位置启动。首次打开遇到系统安全提示时，先核对应用来源与下载过程，再到系统设置中查看针对该应用的处理选项。不要为了启动单个应用而关闭整机安全机制。启动后导入订阅，确认更新成功，再设置代理。
macOS 的系统代理通常按网络服务生效。切换无线网络、有线连接或其他网络环境后，如果浏览器没有采用预期代理，检查当前网络服务的代理设置。退出客户端前先清除其设置的系统代理，避免本地代理端口停止监听后，应用仍尝试连接旧端口。需要接管更多应用时，再阅读 TUN 的权限与路由说明。
| 检查项 | 选择与准备 |
|---|---|
| 处理器 | Apple Silicon 使用 arm64；Intel 使用 x64，以「关于本机」显示的信息为准。 |
| 系统兼容 | 安装前确认当前构建对 macOS 版本的要求；旧系统不能仅靠更换芯片包解决兼容问题。 |
| 应用位置 | 将应用放入「应用程序」后启动，不长期从挂载的磁盘映像内运行。 |
| 网络设置 | 允许所需网络配置变更；只在理解流量接管范围后启用 TUN。 |
优先 v2rayNG；已有 V2Fly 配置时，可按实际需求选择 v2flyNG。
采用 Xray 内核。2015 年后的主流手机通常先选 arm64；仍需确认系统支持 64 位应用，无法确认时选通用版。
v2rayNG 将订阅更新、配置选择和连接开关集中在安卓图形界面中。第一次安装先完成 APK 安装，再打开订阅设置，填写备注和完整订阅地址。保存后执行订阅更新，回到配置列表选中要使用的服务器。仅粘贴地址但没有更新，并不会自动生成可连接的配置。
首次连接会出现系统 VPN 授权对话框，确认后才能建立本地流量接管通道。这是安卓客户端的工作方式，不表示订阅已经可用。若设备还运行其他 VPN 类应用，先停止其中一个再测试。后台容易中断时，检查系统对 v2rayNG 的电池优化与后台运行限制，只调整与持续连接有关的项目。
采用 v2fly 内核。先核对订阅中的协议与传输配置，再决定是否使用该备选客户端。
v2flyNG 适合需要 V2Fly 内核环境的使用场景。客户端名称相似，不等于内核功能完全一致；订阅中出现较新的协议、传输方式或特定扩展时，要按实际内核支持情况判断。不要把切换客户端当作所有连接故障的通用修复方式，先阅读更新结果与连接日志更有效。
从其他客户端迁移时，优先重新添加已有订阅链接，再检查路由与 DNS 设置。两个应用的数据目录彼此独立，安装 v2flyNG 不会自动接收另一个应用的所有配置。需要对照测试时，先断开原应用，再启动新的连接，避免两个 VPN 会话互相替换而误判为节点故障。
| 检查项 | 选择与准备 |
|---|---|
| 应用架构 | 支持 64 位应用时优先 arm64；架构不明确时选择通用版，不把处理器名称当作唯一依据。 |
| 系统兼容 | Android 版本需满足对应发布构建的安装要求；通用版主要解决架构选择，不保证兼容所有旧系统。 |
| 安装权限 | 通过系统提示允许当前浏览器或文件管理器安装应用；完成后可关闭该来源的安装权限。 |
| 连接授权 | 首次启动连接时确认系统 VPN 授权；需要持续运行时检查后台与电池管理设置。 |
按发行版选择 deb 或 rpm，再核对 x64 与 arm64。
deb 常见于 Debian、Ubuntu 系列；rpm 常见于 Fedora、RHEL 系列。包格式匹配只是第一步，还要确认发行版版本与依赖兼容。
先在系统信息中查看发行版名称和处理器架构。常见的 amd64、x86_64 对应本页 x64；aarch64 通常对应 arm64。不要仅凭设备属于台式机或开发板判断架构。下载后使用发行版的软件安装器打开软件包，让系统处理依赖；如果提示库版本不满足，应先确认构建面向的发行版，不要强行忽略依赖。
Linux 桌面环境对系统代理的应用范围并不完全一致。设置代理后，浏览器可能采用桌面代理，而某些终端工具或独立应用仍使用自己的网络配置。因此，安装成功、界面正常打开和所有应用都经过代理，是三个需要分别确认的环节。先用一个遵循系统代理的应用验证，再决定是否需要额外配置。
需要 TUN 时，按文档检查虚拟网卡权限、路由与 DNS。不要一开始就同时修改桌面代理、网络管理服务和防火墙规则；先保留能恢复的基线，再逐项开启功能。升级前关闭旧进程并备份配置，避免包管理器完成更新后，仍由旧进程占用本地端口。
| 检查项 | 选择与准备 |
|---|---|
| 软件包格式 | 根据发行版选择 deb 或 rpm；不通过修改扩展名转换包格式。 |
| 处理器架构 | x64 使用 amd64 或 x86_64 构建；arm64 使用 arm64 或 aarch64 构建。 |
| 桌面与依赖 | 需要可用的图形桌面及当前构建依赖；由系统安装器提示具体缺失项目。 |
| 网络权限 | 普通桌面代理与 TUN 分开配置；TUN 所需权限按客户端与发行版要求处理。 |
客户端安装完成后，还需要订阅、服务器选择和代理设置。按顺序处理，便于定位问题发生在哪一步。
准备升级时，先记录当前客户端使用的订阅分组、路由模式和本地监听端口。自定义路由、手动添加的服务器与界面偏好，未必都包含在订阅链接中；仅保存订阅地址不能替代完整配置备份。使用客户端提供的导出功能，或按文档备份配置目录，并将备份放在只有自己能访问的位置。完成后退出旧客户端，再安装或启动新版。
首次使用不需要为了完成安装就调整大量高级选项。先保留默认的本地监听设置，避免与正在运行的其他网络工具争用端口。若提示端口已被占用，查看是否有旧进程仍驻留在托盘或后台，不要连续启动多个副本尝试解决。安装形式变化较大时，保留旧配置备份，等待新版本能够正常启动后再清理旧目录。
打开订阅分组设置，填写便于辨认的备注，并粘贴完整地址。注意去掉复制时混入的空格和换行，不要删除地址中的参数。保存只是登记更新来源，还需要执行更新订阅，才能获得服务器配置。更新失败时先看客户端提示，区分地址无法访问、内容格式不匹配与账户状态问题，避免反复重装与问题无关的客户端。
订阅地址通常包含访问凭据，应按账户信息保管。向他人询问问题时，隐藏地址参数、账户标识和其他敏感信息，只保留错误类型与必要环境说明。客户端永久免费与订阅服务的费用是不同事项；安装软件本身不会创建服务账户，也不会自动分配可用服务器。
选中服务器后，再开启系统代理或安卓连接。桌面端的系统代理只影响采用该设置的应用，不代表整台设备的所有流量都已经被接管。路由模式则决定进入客户端的请求使用直连、代理还是阻断出站。遇到部分网站可用、部分应用不可用时，先确认请求是否进入客户端，再检查规则命中情况，不要直接把所有情况归因于订阅。
需要 TUN 时，先阅读权限和 DNS 说明。TUN 扩大流量接管范围，但不会让失效订阅恢复，也不能替代正确的路由规则。验证阶段一次只改一项设置，记录修改前后的结果；如果问题出现，恢复刚才的改动，通常比连续更换客户端更容易找到原因。
首次使用先选 Desktop 桌面版，它采用新一代跨平台界面。WPF 是经典稳定版，适合希望沿用经典操作习惯的用户。两者都属于 v2rayN，不要同时运行并接管同一套系统代理；切换前先备份配置。
2015 年后的主流手机通常先选 arm64，但仍需确认系统能够运行 64 位应用。无法确认架构或 arm64 安装时提示不兼容，再选择通用版。通用版包含多种架构组件，文件通常更大，不代表连接更快。
客户端是管理配置和发起连接的工具，安装包不等于订阅服务。准备自己有权使用的订阅链接，在订阅分组中添加地址，再执行更新订阅。订阅地址可能包含访问凭据，不要公开分享。
先退出旧版并备份订阅分组、路由规则及其他配置。是否能够直接覆盖取决于安装形式、原版本与新版本的迁移要求，不要默认所有版本都能覆盖。更换安装形式或界面分支时，建议使用独立目录并按新版本提示导入配置。
页面版本文字与安装包路径是版本清单中的独立字段，可能暂时不同步。不要手动改写下载地址中的版本数字。安装后在客户端的关于页面确认实际版本，再根据功能需求判断是否更新。
先确认订阅已更新并且选中了可用服务器，再检查系统代理或 Android VPN 连接是否启用。桌面端只设置系统代理时，部分应用不会采用该设置；需要进一步接管流量时再参考 TUN 文档。排查期间只保留一个代理客户端运行，结合日志逐项检查。