客户端安装包 / 平台与架构
桌面选 v2rayN，安卓先选 v2rayNG。先确认系统和处理器，再选安装包。
三款客户端均为免费开源软件。安装包用于安装图形客户端，连接前还需要准备有效订阅或服务端参数。已有配置的用户，升级前先做一次配置备份。
第一次安装？查看图形客户端配置教程 →同一客户端，两个界面分支。以下安装包适用于 x64 系统。
桌面版 Desktop采用新一代跨平台 UI，适合新安装，或希望在不同桌面系统保持相近操作方式的用户。经典 WPF 版是保留 Windows 经典界面的稳定分支，适合已经熟悉原有菜单与设置路径的用户。界面分支不同，不代表节点质量或协议速度分档。
上面的下载文件是 ZIP 压缩包。下载完成后先完整解压，再打开其中的安装程序；不要直接从压缩软件的预览窗口运行。安装过程中若提示缺少运行组件，先读取提示中的组件名称、架构和所需版本，再按系统说明补齐，不要反复更换订阅来处理安装错误。
准备更换界面分支时，先导出订阅和自定义路由，关闭正在运行的旧客户端，再打开新版本检查设置。两个实例如果使用同一个本地端口，后启动的实例可能报监听失败。完成安装后再按教程启用系统代理，并选择适合当前使用场景的路由模式。
先看“关于本机”的芯片或处理器信息，再选 DMG 安装包。
Apple Silicon 选 arm64，Intel 处理器选 x64。打开苹果菜单中的“关于本机”，如果显示 Apple M 系列芯片，选择第一个入口；如果处理器一栏写着 Intel，选择第二个入口。系统版本和芯片架构是两件事，更新系统不会把 Intel 设备变为 arm64 设备。
下载 DMG 后打开磁盘映像，按其中的安装引导把应用放入“应用程序”，再从该目录启动。首次运行如果出现系统安全提示，先确认文件来源和提示内容，再在系统提供的安全设置中处理。不要为了跳过一个提示而关闭整套系统安全机制。
从其他桌面系统迁移时，可以优先转移订阅地址，再逐项恢复路由与 DNS 设置。文件路径、权限和系统代理接口并不完全相同，不宜直接覆盖整个旧配置目录。连接前确认客户端已经启动内核，然后在客户端中启用所需的系统代理方式；测试结束后，退出时也要留意代理是否正确恢复。
先选 v2rayNG。需要 v2fly 内核兼容环境时，再考虑 v2flyNG。
v2rayNG 是使用 Xray 内核的 Android 图形客户端。2015 年后的主流手机通常先选 arm64，但具体仍取决于处理器和系统提供的应用运行架构；部分入门设备即使处理器支持 64 位，系统也可能只提供 32 位应用环境。不能确认时可选通用版，它覆盖更多架构，文件体积通常更大。
打开 APK 后，系统可能要求为当前浏览器或文件管理器开启安装应用的权限。只按当前安装流程授权，不要随意放宽其他来源的权限。首次建立连接时，Android 会显示 VPN 连接授权提示，这是客户端通过本机 VPN 接口处理流量的系统步骤，需要阅读后确认。
安装完成后导入订阅、更新配置并选中一个服务器，再启动连接。手机状态栏出现 VPN 标识，只能说明本机接口已建立，仍需打开目标应用验证实际访问。如果连接一段时间后停止，可检查电池优化和后台限制，而不是先删除全部配置。
v2flyNG 使用 v2fly 内核，适合作为现有 V2Fly 配置环境的备选。它与 v2rayNG 的名称相近，但不是同一应用的两个外观主题。内核支持的协议、传输方式和配置字段可能不同，尤其不能把面向 Xray 扩展能力的配置直接视为通用配置。
如果订阅提供方明确要求某种内核能力，先核对协议要求，再选择客户端。更换应用时优先重新导入订阅，不直接复制另一款应用的全部内部数据。两款客户端进行对照测试时，先停止其中一款的 VPN 连接，避免系统连接切换让排查结果混在一起。
先按发行版选择 deb 或 rpm，再确认 x64 与 arm64。
Debian、Ubuntu 系发行版通常选择 deb；使用 RPM 包管理体系的发行版选择 rpm，但包格式匹配不等于所有发行版都兼容。还需要满足当前包的系统库与依赖要求。尤其是 RPM 包，安装前应查看软件安装器给出的发行环境和依赖提示，不建议强制忽略依赖。
常见 Intel、AMD 桌面电脑通常选择 x64，对应包名中的 amd64 或 x86_64；ARM 64 位桌面设备选择 arm64，对应包名中的 arm64 或 aarch64。amd64 是架构名称，不表示只能在 AMD 品牌处理器上运行。可以在系统的“关于”或硬件信息中确认，不按发行版名称猜测处理器类型。
下载后用系统图形软件安装器打开软件包，读取依赖说明并完成安装。这些入口面向有图形桌面环境的设备，不应把桌面应用包直接当成路由设备或纯命令行服务器的部署方案。首次启动后先导入配置，确认本地监听正常，再设置系统或应用代理。
不同桌面环境对系统代理的支持不完全一致。如果浏览器正常而另一款应用仍直连，检查该应用是否读取桌面代理设置。需要单独指定本地代理地址时，按客户端当前显示的监听地址、端口与协议填写，不要把 SOCKS 端口当成 HTTP 端口使用。
准备完整的订阅地址，在客户端中添加订阅分组并执行更新。如果拿到的是单条连接分享地址，应使用相应的导入功能，而不是填进订阅更新地址。导入后先查看是否出现服务器配置，再选择其中一项启动。订阅地址往往包含访问凭据，排查时只提供错误信息，不公开完整地址。
客户端主窗口打开，只能说明图形界面已运行。接着确认内核启动与本地监听，再检查系统代理或 Android VPN 是否启用，最后检查路由模式。每次只调整一项设置，调整后立即验证。同时改动内核、DNS 和路由，会让问题来源变得难以判断。
已经在使用的客户端，先记录当前分支、订阅分组和自定义规则，再通过应用提供的导出功能保存配置。跨客户端迁移时，订阅地址通常比完整内部配置更便于转移，但具体协议仍需目标内核支持。配置中的本机路径、监听端口和权限设置，要按新系统重新检查。
具体菜单操作见客户端安装与配置教程；对协议或内核名称不熟悉，可以先看术语手册，再用协议与内核技术参考核对兼容性。安装阶段的报错与连接阶段的报错应分别记录。
需要有效的订阅地址或服务端连接参数。客户端负责导入配置、选择路由并建立连接，安装包本身不附带可用节点。先确认订阅来源与使用权限，再按教程导入；不要把订阅地址发到公开页面。
新安装可先选 Desktop 桌面版，它使用新一代跨平台界面。习惯原有 Windows 界面与操作路径的用户可选经典 WPF 稳定版。两者是界面分支，不是连接速度档位；迁移前先导出配置，避免同时启动争用本地监听端口。
2015 年后的主流手机通常先选 arm64，但较早设备或仅提供 32 位应用环境的系统可能不匹配。可先查看设备处理器与系统架构；无法确认或遇到架构不兼容提示时，再选通用版。通用版覆盖更多架构，安装包通常更大。
卡片中的版本文字读取清单的 latest 字段，下载按钮读取对应平台的文件地址，两者是独立字段，更新节奏可能不同。文件名不作为统一改写版本的依据。安装或升级时，以实际安装界面和客户端关于页面显示的信息确认已安装版本。
同一客户端、同一分支的覆盖更新通常会沿用原有用户数据，但跨分支、跨内核或更换配置目录时不能直接假定兼容。更新前先通过客户端导出配置或备份用户数据，退出旧进程后再安装；首次启动检查订阅分组、路由模式与本地端口。
先检查文件是否下载完成、处理器架构是否匹配，以及系统是否满足该发行包的运行要求。Windows 的 ZIP 包应先完整解压；macOS 检查芯片类型与系统安全提示；Android 查看安装权限和现有应用签名提示；Linux 查看包格式与依赖错误。保留系统报错原文，再按教程定位。