客户端安装包
先选操作系统，再选处理器架构。
桌面使用 v2rayN；Android 首选 v2rayNG，另提供 v2flyNG 备选。安装包、适配说明与配置路径按平台集中列出。
桌面客户端
两个界面分支，均提供 x64 包。先确定界面偏好，再检查系统与运行环境。
Desktop 桌面版采用新一代跨平台 UI；WPF 是经典稳定版，保留熟悉的 Windows 界面与操作路径。首次使用可从 Desktop 开始，已有固定使用习惯时可选择 WPF。
包格式：两个入口均为 ZIP 分发包。下载后先完整解压，再打开包内的安装程序；不要直接在压缩文件预览窗口中运行。安装完成后，从系统应用列表启动客户端，便于后续更新与卸载。
版本切换：两版的界面布局不同，菜单名称和设置位置可能随发布调整。切换前保存订阅地址、路由规则与自定义配置，不要假定另一版会自动读取原目录。测试时只保留一个客户端实例运行，避免本地监听端口或系统代理设置冲突。
| 检查项 | 选择依据 |
|---|---|
| 处理器与系统 | 本页提供 x64 包；在“设置 → 系统 → 系统信息”查看系统类型。 |
| 系统版本 | 优先使用仍受维护的 64 位 Windows；具体最低版本取决于当前客户端及其运行库。 |
| 运行环境 | 按安装程序提示处理运行库需求；Desktop 与 WPF 的依赖条件可能不同。 |
| 权限与代理 | 常规启动先用普通权限；需要修改受限设置时，再按系统提示授权。 |
若程序无法打开，先确认已解压完整、系统架构匹配，并查看系统提示中的具体组件名称。不要仅凭“启动失败”就反复重装。能够打开界面但浏览器无法连接时，应转到订阅、当前服务器和系统代理设置排查，这与安装阶段属于不同问题。
Windows 安装后的配置步骤 →桌面客户端
按“关于本机”中的芯片信息选择，不以电脑外观或购入年份判断。
Apple M 系列芯片选择 Apple Silicon（arm64）；Intel 处理器选择 Intel（x64）。优先下载与本机芯片一致的包，避免把兼容转换当作默认安装路径。
芯片确认：打开系统菜单中的“关于本机”，查看“芯片”或“处理器”字段。Apple Silicon 与 Intel 使用不同的程序架构；即使应用名称相同，也应分别选择。若下载后提示应用不适用于这台电脑，先核对架构和系统版本。
安装路径：打开 DMG 后，按窗口提示将应用移入“应用程序”文件夹，再从该文件夹启动。更新时先退出旧实例，避免仍从已挂载的安装镜像中运行。系统阻止打开时，先阅读安全提示并确认下载来源，不要批量关闭系统安全功能。
| 检查项 | 选择依据 |
|---|---|
| Apple Silicon | Apple M 系列芯片，使用 arm64 DMG。 |
| Intel | Intel 处理器，使用 x64 DMG。 |
| 系统兼容 | 最低系统版本随客户端构建调整；以应用兼容提示为准。 |
| 代理设置 | 系统代理影响遵循该设置的应用，并不等同于接管所有网络流量。 |
首次启动后先导入已有配置，再选择服务器与路由模式。若启用系统代理需要授权，按系统对话框操作。退出客户端前检查是否已清除代理，尤其是在更换网络或停用客户端之后。个别应用使用独立代理设置时，还需要在应用内部确认连接方式。
macOS 安装后的配置步骤 →移动客户端
优先选择 v2rayNG。已有 V2Fly 配置使用需求时，再考虑 v2flyNG。
Android 图形客户端，使用 Xray 内核，提供订阅分组、服务器选择与路由设置。2015 年后的主流手机通常先选 arm64；设备系统架构不明确时可选通用版。
架构选择：arm64 包面向兼容的 64 位 Android 系统。处理器支持 64 位不一定代表设备系统也支持安装该包，部分设备仍需通用版。通用版覆盖更多架构，包体通常更大，但不会改变订阅内容或提升服务器速度。
首次启动：安装后添加订阅分组并更新订阅，确认列表中出现有效配置，再选择服务器启动。首次连接需要确认系统 VPN 授权。这是客户端在本机接收应用流量所需的系统接口，不代表安装包已经附带远程服务器。
采用 V2Fly 内核的 Android 备选客户端。适合需要沿用相应配置体系的场景；不能仅因两个客户端界面接近，就认为协议与传输选项可以完全互换。
迁移准备：导入前核对现有配置采用的协议、传输与安全选项。不同内核的能力边界存在差异，某些扩展配置需要使用匹配的客户端。保留原订阅地址与必要参数，不要只依赖截图迁移，更不要把含凭据的完整配置公开发送。
并行安装：可以保留不同客户端用于兼容性比较，但同一时间只启动一个 VPN 连接。切换前先停止当前连接，再启动另一个客户端。若切换后网络异常，先确认旧连接已结束，再检查新客户端的分应用规则与路由设置。
| 检查项 | 选择依据 |
|---|---|
| arm64 包 | 适用于支持 arm64 应用的系统；主流新设备通常优先选择。 |
| 通用版 | 架构不明确或专用包不兼容时使用，仍须满足应用最低系统要求。 |
| 安装权限 | 为本次使用的浏览器或文件管理器授权安装，完成后可收回该权限。 |
| 连接权限 | 首次启动连接时确认系统 VPN 请求；检查是否已有其他 VPN 占用。 |
| 后台运行 | 若锁屏后频繁断开，检查省电限制、后台活动权限与当前网络状态。 |
出现“应用未安装”时，依次检查存储空间、架构、系统版本及已有应用的签名兼容情况。不要立即卸载旧版；卸载可能清除本地订阅与路由设置，应先完成备份。安装成功但订阅更新失败时，转到订阅地址有效性与当前网络条件排查，不必反复更换安装包。
v2rayNG 与 v2flyNG 差异对照 →桌面客户端
先按发行版选择 deb 或 rpm，再按处理器选择 x64 或 arm64。
Debian、Ubuntu 及兼容发行版通常选 deb；Fedora、RHEL 系及兼容发行版通常选 rpm。下方主入口面向常见的 Intel、AMD x64 桌面设备，ARM 桌面设备使用对应 arm64 包。
包名识别：amd64 与 x86_64 通常表示这里的 x64 架构；arm64 与 aarch64 对应 ARM 64 位架构。这些名称描述处理器指令集，不是发行版名称。选择正确的包格式后，还要确认依赖库能够满足该构建的要求。
图形安装：使用发行版提供的软件安装器或包管理图形界面打开安装包，阅读依赖与权限提示后继续。安装完成后从应用菜单启动。此处为桌面图形客户端，不应把桌面安装流程直接套用到缺少图形会话的服务器环境。
| 检查项 | 选择依据 |
|---|---|
| deb 格式 | Debian、Ubuntu 及兼容包管理体系；需满足包声明的依赖。 |
| rpm 格式 | Fedora、RHEL 系及兼容包管理体系；需核对发行版与运行库兼容性。 |
| 处理器架构 | Intel、AMD 常见桌面选 x64；ARM 64 位桌面选 arm64。 |
| 桌面环境 | 需要可运行图形应用的桌面会话，托盘支持取决于桌面环境。 |
| 系统代理 | 桌面环境与应用对代理设置的遵循程度不同，需要分别验证。 |
依赖冲突时先阅读包管理器给出的缺失组件，不要强行忽略依赖安装。系统代理开启后，浏览器与其他应用的表现可能不同；这通常需要核对应用自身的网络设置。确认手动启动、导入和连接均正常后，再配置随桌面登录自动启动，避免开机后重复运行多个实例。
Linux 安装与桌面自启动说明 →安装之后
安装包提供客户端程序，服务器配置需要另行准备。已有订阅时，先建立订阅分组，填入完整地址并更新；已有单条连接配置时，使用客户端对应的导入入口。导入后检查协议、地址与必要参数是否齐全，再选择当前使用的服务器。
订阅地址可能包含访问凭据，不要放在公开截图、讨论区或共享文档中。遇到更新失败，先检查地址是否完整、是否仍在有效期内，以及当前网络能否访问订阅端点。反复安装同一个客户端通常不能解决地址失效问题。
查看订阅导入教程 →系统代理负责引导遵循该设置的应用把流量交给客户端；路由决定流量进入客户端之后走代理、直连还是其他规则。两者属于不同层次。桌面端只选择服务器而未启用相应代理入口时，浏览器可能仍使用原来的网络路径。
Android 启动连接后，还应检查分应用设置与系统 VPN 状态。验证时先用一个明确的应用场景测试，再逐步增加规则。遇到无法连接、解析失败或锁屏断开时，记录具体错误和触发条件，比连续切换多项设置更容易定位问题。
按症状进入故障排查 →下载常见问题
首次安装可先选 Desktop 桌面版，它使用新一代跨平台界面。WPF 是经典稳定版，适合习惯原有 Windows 界面与操作路径的用户。两个入口均为 x64 安装包，切换前先备份订阅、路由与其他自定义设置，不要让两个实例同时接管系统代理。
打开系统菜单中的“关于本机”，查看“芯片”或“处理器”字段。显示 Apple M 系列芯片时选择 Apple Silicon，也就是 arm64；显示 Intel 处理器时选择 Intel，也就是 x64。优先使用与本机芯片一致的安装包，安装前退出正在运行的旧客户端。
2015 年后主流手机通常可先选择 arm64，但仍需确认系统本身支持 64 位应用。设备架构不明确，或 arm64 包提示不兼容时，可改用通用版。通用版覆盖更多架构，包体通常更大；它不会因此提供更快的连接速度。
Debian、Ubuntu 及兼容发行版通常选择 deb；Fedora、RHEL 系及兼容发行版通常选择 rpm。随后按处理器选择 x64 或 arm64。包格式匹配不代表所有发行版版本都满足依赖要求，若图形软件安装器报告依赖缺失，应先确认发行版版本和运行库条件。
安装包提供客户端程序，不包含可用的服务器配置或订阅服务。需要先导入已有且有效的订阅或连接配置，选择服务器与路由模式，再启用系统代理或 Android VPN 连接。订阅地址可能包含访问凭据，应作为私密信息保存。
使用相同客户端、相同配置目录进行常规更新时，原有设置通常可以保留，但不应据此省略备份。更新前保存订阅地址、路由规则和自定义配置，退出程序后再安装。跨客户端迁移或更换配置目录时，可能需要重新导入；更新客户端与更新订阅是两项不同操作。