CLIENT SHELF / 安装包选型
先选操作系统，再核对处理器架构。桌面平台使用 v2rayN；Android 首推 v2rayNG，另提供 v2flyNG 备选。
三款客户端均为免费开源软件。安装包负责提供图形界面与连接能力；订阅地址、服务器参数及路由规则需要另行准备。下面的入口按平台划分，不把配置导入与软件下载混为同一步。
WINDOWS / x64
Desktop 与 WPF 是同一客户端的不同界面版本。选择其中一种安装，避免多个实例同时修改系统代理。
桌面版 Desktop 采用新一代跨平台 UI；经典 WPF 版采用 Windows 桌面界面，是保留经典操作习惯的稳定版选择。
两个入口均为 ZIP 分发包。先将压缩包完整解压到单独目录，再按包内内容运行安装程序；不要直接从压缩文件预览窗口启动。首次运行后检查托盘中的程序状态，确认客户端已经启动，再处理订阅与代理模式。
Desktop 与 WPF 的界面、菜单名称和配置存储方式可能不同。已有配置需要迁移时，先使用客户端提供的备份或导出功能；不要直接覆盖另一版本的配置目录。若系统提示缺少运行组件，应按当前安装包提示处理，而不是反复切换节点。
| 检查项 | 要求与操作 |
|---|---|
| 处理器架构 | 本页两个包均为 x64。在“设置 → 系统 → 系统信息”查看系统类型，先确认架构适配。 |
| 系统与依赖 | 具体最低系统版本、运行组件和驱动要求以所选包的说明及安装提示为准。 |
| 安装位置 | 选择当前账户可写的独立目录；升级前退出旧实例，保留已有配置备份。 |
| 连接模式 | 系统代理与 TUN 的权限要求不同。先用系统代理完成基础连接，再按实际需求启用其他模式。 |
下载完成后的导入步骤见 v2rayN 使用教程 →
MACOS / arm64 · x64
从“苹果菜单 → 关于本机”查看芯片信息。Apple Silicon 与 Intel 分别使用对应的 DMG 安装包。
芯片栏显示 Apple M 系列时选 Apple Silicon；显示 Intel 处理器时选 Intel。按芯片选择原生架构，不根据电脑外观或购买年份判断。
打开 DMG 后，将应用拖入“应用程序”目录，再从该目录启动。不要长期在挂载的磁盘映像中运行客户端，否则退出映像、升级和权限处理可能互相干扰。移动完成并关闭应用后，可以推出安装映像。
首次启动若出现开发者验证提示，先确认安装包来源和文件类型，再根据系统提供的“隐私与安全性”路径处理。系统代理授权与网络扩展授权属于不同环节；只批准当前模式确实需要的权限。升级后若连接异常，应先检查原有权限是否仍然生效。
| 检查项 | 要求与操作 |
|---|---|
| Apple Silicon | “关于本机”显示 Apple M 系列芯片，选择 arm64 DMG。 |
| Intel | “关于本机”显示 Intel 处理器，选择 x64 DMG。 |
| 系统兼容性 | 最低系统版本以当前安装包说明为准；无法启动时保留系统原始错误提示。 |
| 权限与目录 | 应用放入“应用程序”目录；首次启动按需处理系统代理及网络相关权限。 |
权限处理路径见 macOS 安装与权限说明 →
ANDROID / arm64 · universal
先选内核生态，再选架构。2015 年后的主流手机通常优先选择 arm64；安装前仍需确认系统支持该架构。
Android 首选入口。采用 Xray 内核，具体协议、传输与安全参数的支持情况取决于包内内核版本及客户端界面。
arm64 包适合系统支持相应架构的设备。无法确认架构时，可以选择包含多种架构的通用版；通用版不代表对所有系统版本都兼容。若安装器提示解析失败，先检查文件是否下载完成，再查看系统兼容性和架构，不要修改文件扩展名尝试安装。
首次启动连接时，Android 会显示 VPN 连接授权。该授权用于创建本地网络接管通道，不等于订阅已经有效。导入配置、选择服务器并启动后，再检查日志和实际访问结果；设备上其他 VPN 应用可能与当前连接冲突。
采用 v2fly 内核的备选客户端。已有配置明确依赖 V2Fly 行为或需要对照内核差异时，再考虑此入口。
v2rayNG 与 v2flyNG 不是只换名称的同一个安装包。配置中的协议、传输方式和安全选项需要分别核对，不能因为订阅能够被导入就认定所有字段都可用。涉及 REALITY 等特性时，先查所用内核的实际支持情况。
切换客户端前记录原来的路由模式、DNS 设置和按应用代理范围。测试另一款客户端时先停止当前连接，避免两个应用争用系统 VPN 通道。两者的配置存储互相独立，导入订阅后还需要重新核对当前选中的配置。
| 检查项 | 要求与操作 |
|---|---|
| 处理器架构 | 通常优先 arm64；不能确认设备支持情况时考虑通用版，并检查安装提示。 |
| 系统版本 | 最低系统要求以对应 APK 的说明为准，通用版不会绕过系统版本限制。 |
| 安装来源 | 安装 APK 时按系统提示允许当前浏览器或文件管理器安装应用，完成后可收回该权限。 |
| 后台运行 | 若切换应用后连接停止，再检查电池优化与后台限制，不必先重装客户端。 |
首次使用可从 v2rayNG 使用教程 → 继续。
LINUX / deb · rpm
先确定发行版使用的包格式，再确定系统架构。deb 与 rpm 不是两个功能版本，不能互相替代。
常见 x64 桌面环境从下列主入口选择。Debian 系发行版通常使用 deb，RPM 系发行版使用 rpm；具体依赖与兼容性仍由包管理器确认。
包名中的 amd64、x86_64 通常对应 x64；arm64、aarch64 对应 ARM 64 位。不要仅凭设备厂商品牌判断架构，也不要通过重命名安装包改变适配对象。图形软件安装器会报告依赖、架构或包格式问题，应优先读取这些提示。
通过发行版的软件安装工具打开对应包，确认依赖解析结果后再安装。包名中的发行版标记不代表所有同格式系统均可直接运行。若依赖无法满足，先查看当前系统与包的适配情况，不要强制忽略依赖，也不要替换系统基础库。
启动后检查桌面环境是否接受系统代理设置。某些应用不会读取桌面代理配置，需要在应用内单独指定代理地址和端口。TUN 模式还涉及权限与路由接管，建议先完成普通代理连接，再按当前客户端支持情况启用。
| 检查项 | 要求与操作 |
|---|---|
| 包管理格式 | 按发行版选择 deb 或 rpm，通过对应软件安装工具处理依赖。 |
| 系统架构 | x64 使用 amd64 或 x86_64 包；ARM 64 位使用 arm64 或 aarch64 包。 |
| 桌面与依赖 | 这是图形客户端入口；桌面运行环境、系统库与最低系统要求以安装包说明为准。 |
| 权限与网络 | 先以普通账户运行并验证基础代理；涉及 TUN 或系统路由时再按需授权。 |
配置字段说明见 V2Ray 配置参考 →
INSTALL → IMPORT → CONNECT
安装成功、配置可读、连接可用是三个不同的检查点。按顺序处理，能够减少重复下载和无效重装。
首次安装时，先查看客户端是否能正常打开，以及日志中是否出现内核启动错误。已有客户端的设备则应先退出旧实例，避免本地监听端口被占用。安装失败属于系统和软件包问题；启动失败属于客户端、配置或运行环境问题；访问失败才需要进一步检查节点、路由与 DNS。把三类现象分开记录，比直接替换所有设置更容易定位原因。
在客户端的订阅管理或导入菜单中填写有权使用的地址，保存后执行更新，再从列表中选择配置。订阅地址可能包含账户标识，应按凭据管理，不要粘贴到公开截图或问题描述中。导入单个连接时，协议、地址、端口、传输、安全参数需要与服务端一致；客户端不会通过安装过程自动补齐这些信息。已有自定义规则时，先保留原配置副本，再测试新导入的内容。
桌面端可先从系统代理模式开始，Android 则按系统提示批准 VPN 连接。启动连接后，使用实际需要的应用进行验证，同时查看客户端日志。浏览器可用并不代表所有程序都经过代理；测试工具的结果也不能代替应用访问。出现域名解析失败时检查 DNS，出现直连或阻断结果时检查路由顺序，出现握手错误时检查连接参数和系统时间。
PACKAGE / UPDATE NOTES
升级前备份订阅分组、自定义路由、DNS 设置及本地端口记录。客户端提供导出功能时优先使用该功能，并妥善保存包含订阅信息的备份文件。不要在确认新版本可用前删除旧配置，也不要默认两种界面版本能够直接共用配置目录。升级完成后先查看原配置是否加载，再检查系统代理和网络权限，最后进行连接测试。
卡片中的版本文字读取版本清单的发布字段，安装包入口按平台独立解析。发布更新期间，显示文字与文件名可能暂时不同步；不要通过手动改写 URL 或文件名寻找其他包。客户端安装后的“关于”或版本信息才是确认实际已安装版本的直接位置。下载记录保留文件名和错误提示即可，分享排查材料前应隐藏订阅地址、服务器凭据与个人目录信息。
v2rayNG 与 v2flyNG 分别采用不同内核分支，桌面客户端的内核选择也应结合实际功能判断。切换内核不是解决所有连接问题的通用步骤，尤其不能把协议名相同理解为安全参数和传输字段完全兼容。需要比较支持情况时，先阅读 Xray 与 V2Fly 内核差异，再决定是否调整客户端或内核。
客户端负责读取配置和建立连接，安装包不等于可用的服务器配置。安装后仍需准备有权使用的订阅地址或连接参数，导入后选择配置，再启用适合当前环境的代理模式。订阅地址可能包含访问凭据，不要公开分享。
先查系统报告的处理器架构，再选择安装包。Apple Silicon 使用 macOS arm64，Intel Mac 使用 x64；Linux 根据系统架构选择 x64 或 arm64。2015 年后的主流 Android 手机通常优先选 arm64，但仍需确认系统支持；无法确认时可考虑通用版。
通常只需选择一种。Desktop 使用新一代跨平台界面，WPF 是经典稳定版。切换界面版本前先备份配置，不要让两个实例同时接管系统代理或监听同一个本地端口。界面与配置存储位置以实际版本为准。
先检查浏览器下载记录，确认任务已经完成，再核对文件扩展名与系统平台是否对应。Windows 的 ZIP 文件需要先解压，Android 的 APK 需要允许当前安装来源，macOS 的 DMG 需要挂载后将应用拖入应用程序目录。若仍失败，记录系统原始提示再按安装教程排查。
先通过客户端支持的导出或备份功能保留订阅分组、自定义路由、DNS 设置和本地端口记录，备份文件应妥善保存。退出旧实例后再升级；升级完成先检查原配置是否可读取，再检查系统代理、网络权限和订阅更新。不要在未确认恢复方式前删除旧配置目录。
版本文字来自版本清单中的 latest 字段，下载入口来自对应平台的 download 字段，两者可能在发布更新期间不同步。不要通过改写文件名推测其他安装包。安装后在客户端的关于或版本信息中确认实际版本，并根据具体包的提示决定是否更新。