客户端安装包先选系统，再选架构
按系统选择安装包。桌面端使用 v2rayN，安卓端首选 v2rayNG，另提供 v2flyNG 备选。
安装包不含服务器配置。安装后需导入有权使用的订阅地址或配置链接。
安装包货架
只下载与设备匹配的一种安装包。切换平台后，查看卡片下方的安装要求。
Windows x64 安装包分为桌面版与经典 WPF 版。首次使用可先选桌面版；习惯经典菜单布局时选 WPF 版。
新一代跨平台 UI。适合新安装，以及希望在不同桌面系统间保持相近操作方式的用户。
经典稳定版，保留熟悉的 Windows 桌面界面。已有配置时，升级前先记录原使用分支。
| 检查项 | 选择依据 | 安装前动作 |
|---|---|---|
| 系统与架构 | 面向 Windows x64；建议使用仍受支持的 Windows 10 或 Windows 11 | 在“设置 → 系统 → 系统信息”查看系统类型 |
| 安装包格式 | ZIP 压缩包，包含对应分支的安装程序 | 先完整解压，再运行其中的安装程序 |
| 运行环境 | 运行库需求取决于所选分支与发布包 | 遇到缺少运行环境提示时，按提示补齐对应组件 |
下载后先打开保存目录，将 ZIP 完整解压到可写文件夹。不要直接在压缩包预览窗口中启动程序，否则配套文件可能没有释放到预期位置。关闭正在运行的旧客户端，再执行安装；安装路径和配置位置并不一定相同，不能把复制程序目录当作完整备份。
第一次启动时，服务器列表为空属于正常状态。打开“订阅分组 → 订阅分组设置”，添加分组与订阅地址，再更新订阅。随后选中一个服务器，检查底部“系统代理”是否为“自动配置系统代理”。初次验证先使用系统代理，确认能够连接后再按需要调整 TUN 模式，避免一次改变多项设置而难以定位问题。
如果从 WPF 版切换到 Desktop，先保留原配置与程序，再确认新界面中的订阅、路由和监听端口。两个实例同时启动可能争用本地混合监听端口。出现端口占用时，先退出另一实例，而不是连续重装。更多操作见v2rayN 配置教程。
先在苹果菜单的“关于本机”中查看芯片名称。显示 Apple M 系列时选 Apple Silicon；显示 Intel 处理器时选 Intel。
适用于 Apple M 系列芯片。选择原生架构，减少通过兼容层运行带来的额外变量。
适用于 Intel 芯片的 Mac。不要仅凭电脑外观或购买年份判断处理器架构。
| 检查项 | 选择依据 | 安装前动作 |
|---|---|---|
| 芯片架构 | Apple Silicon 对应 arm64；Intel 对应 x64 | 打开苹果菜单 → 关于本机 |
| 系统兼容性 | 最低系统版本以当前安装包的兼容性提示为准 | 记录当前 macOS 版本，不把芯片匹配等同于系统兼容 |
| 包格式与权限 | DMG 磁盘映像；应用目录需可写 | 安装到“应用程序”，首次打开时检查系统提示 |
打开 DMG 后，按磁盘映像窗口中的提示将客户端放入“应用程序”，再从“应用程序”启动。不要长期在挂载的磁盘映像中运行。更新前退出旧客户端，确认菜单栏没有仍在工作的实例，再替换应用；若提示文件正在使用，先检查后台进程，不要强行覆盖。
首次启动受到系统安全机制拦截时，先确认下载来源与应用名称，再在“系统设置 → 隐私与安全性”中查看相关提示。不同系统版本的操作入口可能略有差别，不建议直接执行来源不明的终端命令，也不要为启动一个应用而关闭整机安全保护。
导入订阅后，确认客户端已选中服务器，再启用系统代理。网页仍无法访问时，检查浏览器是否有独立代理扩展，以及其他网络工具是否覆盖系统代理。需要 TUN 时，再根据客户端提示完成权限操作。退出客户端前清除系统代理，有助于避免程序已关闭但浏览器仍连接本地端口的情况。
使用 Xray 内核的安卓图形客户端。2015 年后的主流手机通常选 arm64；设备系统实际支持的架构仍是最终依据。
优先用于支持 arm64-v8a 的设备，按单一架构打包，通常比通用版更小。
无法确认架构时的备选。包含多种架构，不需要与 arm64 版同时安装。
需要 V2Fly 内核环境时使用的安卓备选。选择前确认现有配置所需协议与传输方式能够被该客户端支持。
适用于支持 arm64-v8a 的设备。已有另一客户端时，先停止其连接再进行测试。
架构不确定时选择。切换客户端前保留订阅地址，不要假定两款应用共用配置目录。
| 检查项 | 选择依据 | 安装前动作 |
|---|---|---|
| 处理器与系统架构 | 主流设备优先 arm64；不确定时选通用版 | 查看设备规格，注意部分设备可能运行较旧的系统架构 |
| 系统版本 | 最低版本要求以安装器对当前包的提示为准 | 在“设置 → 关于手机”查看 Android 版本 |
| 安装与连接权限 | 允许当前浏览器或文件管理器安装应用；连接时需要 VPN 授权 | 只为本次使用的来源开启安装权限，安装后可关闭 |
下载 APK 后，从浏览器下载列表或文件管理器打开文件。系统提示需要允许安装时，检查授权对象是否为刚才使用的浏览器或文件管理器。若提示“应用未安装”，先判断是架构不兼容、存储空间不足，还是旧版与新版签名不一致。通用版能处理部分架构选择问题，但不能解决签名冲突。
打开 v2rayNG 后，在“订阅分组设置”添加订阅地址，保存后执行“更新订阅”。列表出现配置后选中一项，再点击连接按钮。首次连接会弹出系统 VPN 授权，确认后才能建立设备级连接。手机通常不能同时维持多个同类 VPN 服务；测试前暂停其他占用该通道的应用，避免授权被来回接管。
锁屏后断连时，先检查应用电池管理、后台运行限制与系统的节电模式，而不是更换安装包。只在移动网络异常时，还应比较 Wi-Fi 下的表现。若需要在 v2rayNG 与 v2flyNG 之间测试，分别导入配置、分别查看日志，不要把一种内核能够读取配置等同于另一种内核支持全部参数。
面向 Linux 桌面环境。先确认发行版使用 deb 还是 rpm，再核对处理器是 x86_64 还是 aarch64。
用于兼容的 Debian、Ubuntu 等桌面发行版。包名中的 amd64 表示 x64 架构，并不限于某一处理器品牌。
用于兼容的 RPM 系发行版。还需确认依赖与系统版本能够满足该包要求，不能只看扩展名。
| 检查项 | 选择依据 | 安装前动作 |
|---|---|---|
| 处理器架构 | x86_64 选 x64；aarch64 选 arm64 | 在系统信息中查看架构，必要时运行 uname -m |
| 发行版与格式 | Debian 系通常用 deb；RPM 系通常用 rpm | 查看发行版版本与包管理器兼容性 |
| 桌面与依赖 | 需要可用的图形桌面、网络连接和满足要求的系统库 | 通过系统软件安装器处理依赖，记录失败提示 |
下载匹配的包后，优先使用发行版自带的软件安装器打开。系统提示依赖不满足时，先记录缺失库名称与最低版本，再判断是否需要更新系统。不要为了安装客户端而强制忽略依赖，也不要将其他发行版的系统库直接覆盖到当前环境。较旧发行版即使架构匹配，也可能缺少安装包要求的运行环境。
安装完成后，从应用菜单启动 v2rayN，以普通桌面用户身份配置订阅。系统代理通常影响当前桌面会话，不一定覆盖终端工具或所有应用。先在遵循系统代理的浏览器中验证，再分别检查其他程序的代理设置。TUN 涉及额外网络权限，不建议通过长期以高权限运行整个图形客户端来替代正确的权限配置。
需要开机后自动运行时，先确认手动启动、订阅更新和退出清理都正常，再使用桌面环境的启动应用设置。升级后若出现两个托盘图标，检查是否同时保留了旧快捷方式与新自启动项。更完整的桌面安装说明见deb/rpm 安装与开机自启动。
安装前后检查
把安装问题与连接问题分开处理。每次只改一项，保留能够复现问题的线索。
记录当前客户端名称、界面分支、监听端口和路由模式，按客户端提供的导出或备份方式保存配置。订阅地址可能包含访问凭据，备份应放在受控位置；截图和求助日志中不要展示完整地址。
退出旧程序后再安装，确认托盘或后台没有残留实例。切换架构、安装来源或桌面界面分支时，先核对迁移方式。不要因为安装器报错就立即删除原配置，能够返回原状态比反复覆盖更重要。
导入订阅后检查服务器列表是否更新，选中配置再连接。订阅是配置分发方式，不等于客户端附带服务；订阅地址失效、授权到期或配置内容不兼容，需要在对应环节处理。
更新失败时先看错误属于无法连接、地址拒绝访问还是内容无法识别。已有可用连接时，可以比较普通更新与“不通过代理”更新的结果。不要把订阅地址提交到来源不明的转换网页，以免泄露访问权限。
桌面端先确认本地监听成功，再开启“自动配置系统代理”。安卓端先确认 VPN 授权和连接状态。打开实际需要访问的网站验证，单次延迟测试只能反映某一种测试方式，不能代替完整访问结果。
浏览器正常而终端失败，通常要单独检查终端代理设置；只有部分域名失败，则继续检查路由和 DNS。先使用一种接管方式建立基线，不要同时启用多款客户端并叠加代理扩展。
保存系统版本、客户端名称、架构和错误原文。说明是安装器打不开、程序启动即退出、订阅更新失败，还是连接后无法访问。不同阶段的症状对应不同的排查入口。
端口占用先查其他客户端，解析失败先查 DNS，锁屏断连先查后台限制。提交日志前移除订阅地址、访问凭据和个人网络信息。按症状继续阅读疑难手册，避免把所有故障都归结为安装包问题。
下载与安装问答
安装包只提供客户端程序，不包含可用的服务器配置。准备有权使用的订阅地址或配置链接，在 v2rayN 的“订阅分组”中添加地址并更新订阅，或从剪贴板导入。安卓客户端可在“订阅分组设置”中添加地址，再执行“更新订阅”。
首次使用可先选桌面版 Desktop，它使用新一代跨平台界面。熟悉经典 Windows 菜单、希望沿用原操作习惯时，可选择经典稳定的 WPF 版。两者是界面分支，不代表下载后自带不同的服务器资源。切换前先备份配置，并退出正在运行的客户端。
2015 年后的主流手机通常先选 arm64，但仍需以设备系统实际支持的架构为准。若无法确认，或 arm64 包提示不兼容，可选择通用版。通用版包含多种架构，体积通常更大；同一客户端的两个包不需要同时安装。
通常先备份配置，再退出客户端并按同一应用、同一安装来源和相同架构升级，不要先删除旧配置。安卓若提示签名冲突，不要反复覆盖或立即卸载，应先确认应用来源和备份是否可恢复。不同桌面界面分支之间的配置迁移应单独核对。
先确认已经导入配置并选中服务器，再查看日志是否有本地端口占用或连接错误。桌面端检查“自动配置系统代理”是否启用，安卓端检查 VPN 授权和连接状态。只有程序文件损坏、架构不匹配或安装过程失败时，才优先处理安装包问题。
先查看浏览器下载列表是否已有任务，以及磁盘空间和保存目录权限。网络中断时可重新发起同一安装包的下载，避免把尚未完成的文件当作安装包打开。若仍失败，记录系统、架构、包格式和浏览器错误提示，换一个正常网络后再试。