桌面选 v2rayN，安卓首选 v2rayNG。先确认系统与芯片架构，再选择对应安装包。
主入口优先展示常用架构；其他架构与版本放在同一卡片内。下载前请核对设备信息。
桌面版和经典 WPF 版都用于管理订阅、选择服务器与设置代理，主要差别在界面技术与交互布局。桌面版采用新一代跨平台界面，菜单组织与经典版不完全相同；WPF 版延续熟悉的 Windows 操作方式。版本名称不代表服务器质量，也不能替代对协议参数的确认。
下载后把压缩包完整解压到可写入的位置，再运行包内安装程序。不要在压缩软件的预览窗口中直接启动程序，否则关联文件可能没有正确展开。安装路径尽量保持稳定，便于升级和定位配置；遇到运行环境提示时，按安装程序或系统提示处理，不要从来历不明的页面寻找替代文件。
首次启动后，先添加订阅分组，再执行更新订阅。选择有效服务器后启用自动配置系统代理，并设置路由模式。系统代理只影响遵循该设置的应用，并不等于所有程序已经接入。若准备改用另一版界面，应先备份，再退出旧实例；同时运行两个实例容易产生本地端口占用或代理设置互相覆盖。
| 检查项 | 本页安装包要求 | 确认方法 |
|---|---|---|
| 处理器架构 | x64；这两项不是其他架构的专用包 | 打开系统设置中的“系统信息”或“关于”，查看系统类型 |
| 操作系统 | 需要满足当前客户端与运行环境的支持范围 | 记录系统版本，安装时留意兼容性与运行环境提示 |
| 文件与权限 | 完整解压，配置位置可写入，磁盘有可用空间 | 确认安装目录与用户配置目录没有被权限策略限制 |
本页提供的是 x64 包。处理器名称相近不代表应用架构相同；受管理的办公设备还需遵守本地安装与代理策略。
先打开系统菜单中的“关于本机”，读取芯片或处理器一栏。Apple Silicon 对应 arm64，Intel 对应 x64。不要用机器外观、购买年份或系统版本推断架构，同一系列产品可能使用不同处理器。选择匹配架构的原生包，有助于减少额外的兼容层依赖。
下载完成后打开磁盘映像，按包内提示把应用放入应用程序目录，再从该目录启动。不要长期从临时挂载的磁盘映像中运行，安装完成并关闭相关窗口后可推出映像。若系统提示安全限制，先确认文件来源与系统提示内容，再按系统提供的授权流程处理；不要为了启动一个应用而整体关闭系统防护。
导入订阅后，确认当前服务器与路由模式，再检查系统代理是否已写入正在使用的网络服务。无线网络与有线网络可能拥有独立的代理设置，切换网络后应重新确认。需要 TUN 模式时，还可能涉及额外权限与网络接管；首次使用先从系统代理开始，更容易区分安装、配置和应用流量接入的问题。
| 检查项 | 本页安装包要求 | 确认方法 |
|---|---|---|
| 芯片 | Apple Silicon 选 arm64；Intel 选 x64 | 查看“关于本机”中的芯片或处理器信息 |
| 系统版本 | 需要处于当前桌面版的支持范围内 | 确认系统版本，并按安装或启动提示判断兼容性 |
| 应用与网络权限 | 可安装应用；允许所需的代理设置变更 | 查看系统安全提示与当前网络服务的代理设置 |
若应用打不开，先核对架构和系统提示。订阅更新失败属于后续网络配置问题，不应直接归因于安装包选择。
v2rayNG 是安卓端的首选入口，采用 Xray 内核，适合使用该生态配置的用户。2015 年后的主流手机通常支持 arm64，但部分设备的系统只开放较旧的应用架构，因此仍应以设备系统实际支持情况为准。通用包用于扩大架构覆盖，并不表示它能绕过应用对系统版本的要求。
打开下载的安装包时，系统可能要求对浏览器或文件管理器授予“安装未知应用”权限。只对当前发起安装的应用按需授权，安装完成后可恢复原设置。首次连接会出现系统 VPN 授权提示，这是客户端通过系统接口接收应用流量的步骤；若已有其他 VPN 应用运行，先停止它，避免争用同一接入位置。
安装后添加订阅分组并更新，选择服务器，再启动连接。若切换到后台后经常断开，检查电池优化、后台活动与省电策略，而不是连续换装不同架构的包。订阅含访问凭据，截图时应遮住完整地址；客户端名称、架构和错误提示通常已经足够用于描述安装问题。
v2flyNG 采用 V2Fly 内核，作为已有配置与该内核兼容时的备选。两款安卓客户端的界面操作有相似之处，但协议支持、传输选项与配置字段不能简单视为完全相同。尤其是涉及 Xray 特有方案的配置，应先确认客户端与内核支持情况，不能通过更换通用包来补齐协议能力。
从 v2rayNG 切换时，先保留原订阅和设置记录，再在新客户端中重新导入。系统授权不会自动转移到另一款应用，首次连接仍需确认。测试时只启动一个客户端，按“能否更新订阅、能否启动服务、应用能否访问”的顺序检查，便于区分安装兼容性与网络参数问题。
| 检查项 | 安装与运行要求 | 确认方法 |
|---|---|---|
| 应用架构 | arm64 包需系统支持 arm64；不确定时考虑通用包 | 查看设备技术信息，留意安装器的架构不兼容提示 |
| 系统与安装权限 | 满足当前应用的系统要求，允许发起 APK 安装 | 查看系统版本及“安装未知应用”的授权状态 |
| 连接与后台 | 批准 VPN 权限；后台策略允许客户端持续运行 | 查看 VPN 授权、电池优化与其他 VPN 应用状态 |
“无法安装”与“安装后无法连接”是两个阶段的问题。先让应用正常启动，再排查订阅、传输参数与网络权限。
Linux 需要同时确认发行版的包管理体系与处理器架构。采用 DEB 体系的系统通常选择 deb，采用 RPM 体系的系统通常选择 rpm；x64 在文件名中可能写作 amd64 或 x86_64，arm64 也可能写作 aarch64。不要仅凭扩展名判断兼容性，包依赖与系统组件版本同样会影响安装结果。
下载后优先通过发行版的软件安装器或包管理工具打开对应文件，让系统处理依赖与安装记录。若提示依赖无法满足，先阅读具体缺失项与版本要求，不要强行忽略依赖，也不要把其他发行版的软件源随意混入当前系统。此处提供的是图形桌面客户端，需要可用的桌面会话；只有远程命令行的机器不属于本页的安装场景。
启动后先导入订阅，检查客户端本地监听与桌面环境的代理设置。不同桌面环境、浏览器和终端应用对系统代理的读取方式可能不同，因此“客户端已启动”不能直接证明每个应用都已接入。首次验证选择一个明确遵循系统代理的应用；需要 TUN 时，再按高级文档确认权限、路由与 DNS 接管，避免一开始同时修改多层网络设置。
| 检查项 | 本页安装包要求 | 确认方法 |
|---|---|---|
| 包管理体系 | 根据发行版选择 deb 或 rpm | 查看发行版说明，使用系统对应的软件安装工具 |
| 处理器架构 | x64 或 arm64，与包内组件一致 | 查看系统信息，区分 amd64、x86_64 与 aarch64 标识 |
| 桌面与依赖 | 可用的图形桌面会话，满足包声明的依赖 | 阅读软件安装器提示，确认图形与运行环境组件 |
相同包格式不代表所有发行版都兼容。安装器报告的依赖要求比“同属一个发行版家族”的推断更可靠。
把安装、导入与接入分开检查。每完成一个阶段，再进入下一步。
客户端是配置管理与连接处理工具，不会因安装完成而自动获得可用服务器。开始前需要准备自行取得的有效订阅地址，或一组完整、合法使用的服务器参数。订阅把多条配置集中成一个更新入口，手动导入则需要逐项确认地址、端口、协议、传输和安全设置。两种方式都依赖参数正确，不能只填一个服务器地址就期待连接成功。
订阅地址通常包含访问令牌，应当像账号凭据一样保存。添加分组时，备注只用于本地识别，可按用途或来源命名；不要把完整地址放进公开截图。导入分组后还需要执行更新，让客户端读取实际配置。若更新报错，应先核对复制内容、订阅有效期与当前网络可达性，避免把安装成功后的配置问题误认为下载包损坏。
从剪贴板或二维码导入时，也要核对识别后的协议与传输选项。有些链接能被解析，但其中的扩展字段并不一定由当前内核支持。REALITY 等设置需要与服务端保持一致，不能从其他配置随意借用参数。术语不熟悉时可先查阅REALITY 概念说明，再对照服务端提供的信息填写。
桌面端通常先启用系统代理，安卓端通过 VPN 模式接收流量。系统代理是应用把请求交给本地代理的入口；路由模式则决定已经接收的请求从哪个出口发送。它们是两个不同层面的设置。只改变路由模式而没有接入应用流量，客户端可能根本没有收到需要处理的请求。
第一次使用时，先选择有效服务器，再开启接入方式，最后用日常使用的应用进行验证。不要同时修改 DNS、TUN、自定义出站和复杂路由，否则失败时难以判断是哪一层导致。能正常访问后，再按实际需求调整分流规则，并留下一份可恢复的基础配置。网络设置像接水管，先确认每段接上，再考虑如何分支。
如果应用没有网络，先确认客户端服务已经启动、本地端口没有被其他实例占用、系统时间正确。随后检查服务器参数与订阅是否仍有效。桌面环境中的浏览器、命令行工具与其他应用可能使用不同代理机制，不宜用单个应用的结果推断全部网络状态。完整操作可参照快速上手教程，连接异常可查看连接排查章节。
升级前先保存当前配置。优先使用客户端提供的备份或导出功能，并另外记录订阅分组、路由例外、DNS 设置、本地监听端口与启动选项。只保留订阅地址并不能完整恢复自定义规则；只复制一个目录也不一定包含系统层面的代理和权限设置。备份文件同样可能含凭据，应放在受控位置。
安装新版本之前先退出旧实例，尤其是在两个界面版本之间切换时。确认旧实例的代理接管已经停止，再启动新版本并检查配置读取结果。若新界面使用不同配置结构，应通过受支持的导入方式迁移，不要直接覆盖不明用途的目录。保留原备份，完成订阅更新与应用访问验证后再整理旧文件。
从一款安卓客户端迁移到另一款时，协议能力与权限需要重新确认。订阅链接可作为迁移入口，但内核特有的传输设置未必通用，系统 VPN 授权也需要重新批准。桌面平台之间迁移时，还要留意文件路径、系统代理接口和权限差异。升级后的验证应围绕实际配置与应用访问进行，不以“安装程序没有报错”作为全部完成的标志。
先核对包类型，再处理权限与配置。保留原始错误提示，有助于减少重复尝试。
首次使用可先选桌面版，它采用新一代跨平台界面。经典 WPF 版沿用经典稳定的 Windows 界面，适合已有操作习惯的用户。两版菜单位置可能不同，迁移前应备份配置，不要让两个实例同时接管系统代理。
2015 年后的主流手机通常优先选 arm64，但实际选择应以系统支持的应用架构为准。较旧设备或无法确认架构时可选通用版；若系统版本不满足应用要求，换成通用包也不能解决兼容问题。
客户端负责读取配置与处理连接，安装包不等于可用的服务配置。需要自行准备有效订阅或完整服务器参数，导入后更新订阅、选择服务器，再设置系统代理或批准安卓 VPN 权限。
先通过当前客户端提供的备份或导出功能保存配置，并单独记录路由、DNS 与本地端口。退出旧实例后再升级。跨界面版本或跨客户端迁移时，应按新版本支持的导入方式操作，不要直接覆盖不明用途的配置目录。
卡片版本文字来自应用级版本字段，下载入口来自各安装包的独立字段，两者可能暂时不同步。判断当前安装包时，应结合下载文件名与安装后客户端的关于页面，不要自行修改下载地址中的版本数字。
先确认下载是否完成、磁盘空间是否充足，再核对操作系统、处理器架构与包格式。Windows 的 ZIP 文件需要先解压；安卓安装需要对发起安装的应用授权。若仍失败，记录系统提示与所选包名称，再按安装和连接排查说明定位。