客户端安装包 · 按平台选择
桌面选择 v2rayN，安卓优先选择 v2rayNG。先确认操作系统与处理器架构，再下载对应安装包；订阅地址与服务器配置需要另行准备。
同一客户端，两种界面。以下入口均面向 x64 环境。
Desktop 使用新一代跨平台 UI；WPF 是 Windows 专用的经典稳定版。首次安装可先选 Desktop，已有 WPF 使用习惯时可继续选择 WPF。
跨平台界面 · x64 · ZIP 分发包
下载 v2rayN Desktop使用 Avalonia 界面，适合新建桌面配置。先解压到独立目录，再运行包内安装程序，避免直接在压缩文件浏览窗口中启动。
Windows 专用界面 · x64 · ZIP 分发包
下载 v2rayN WPF保留经典 Windows 操作方式。已有配置的用户应先完成备份，再按安装程序提示升级；不要把两个界面的程序文件覆盖到同一目录。
| 检查项 | 选择依据 |
|---|---|
| 系统架构 | 本页两个入口均为 x64。可在“设置 → 系统 → 系统信息”中查看系统类型。 |
| 系统与运行环境 | 以安装程序对当前 Windows 版本和运行组件的提示为准；缺少依赖时先补齐对应环境。 |
| 权限 | 安装按系统提示授权。TUN 可能需要管理员权限，普通系统代理配置不等同于启用 TUN。 |
| 文件处理 | 下载得到 ZIP 分发包，解压后再使用包内安装程序；配置目录需要具备写入权限。 |
安装后先打开主窗口，确认能够进入“订阅分组设置”。如果系统提示运行组件缺失，应按提示处理依赖；这与订阅失效、服务器超时属于不同阶段的问题。能够打开界面，并不代表服务器配置已经可用，也不代表系统中的所有程序都会自动使用代理。
Desktop 与 WPF 的主要选择依据是界面和操作习惯，而不是某个界面天然具有更好的连接质量。连接结果还取决于配置、内核支持、路由与实际网络环境。换版时应保留订阅来源和自定义规则，先在新环境中验证导入结果，再决定是否移除旧版。具体操作见使用指南。
通过“关于本机”识别芯片，优先使用本机架构。
macOS 使用跨平台桌面界面。Apple Silicon 与 Intel 包分别对应不同处理器，功能选择不以芯片名称区分；下载前只需确认本机架构。
Apple M 系列 · arm64 · DMG
下载 v2rayN · Apple Silicon“关于本机”的芯片一栏显示 Apple M 系列时选择此包。使用原生架构可避免不必要的转译，不必为了兼容习惯而优先选择 Intel 包。
Intel 处理器 · x64 · DMG
下载 v2rayN · Intel“关于本机”的处理器一栏显示 Intel 时选择此包。arm64 包并不是 Intel 设备的替代安装方案，架构不匹配时应返回此处重新选择。
| 检查项 | 选择依据 |
|---|---|
| Apple Silicon | Apple M 系列芯片选择 arm64 DMG。 |
| Intel | Intel 处理器选择 x64 DMG。 |
| 系统兼容性 | 安装与启动时确认当前发行版对 macOS 的要求，较旧系统可能需要先升级系统环境。 |
| 授权与目录 | 按 DMG 内指引安装到应用程序目录；系统代理、网络扩展等操作以实际出现的系统授权提示为准。 |
打开 DMG 后按其中的指引完成安装，再从应用程序目录启动。首次打开出现安全提示时，先确认下载来源与系统提示内容，再通过系统提供的正常授权流程处理。不要把关闭系统整体安全机制当作常规安装步骤；“架构不匹配”和“系统阻止打开”也应分别判断。
导入订阅后，先使用系统代理测试支持读取系统代理的应用。部分终端程序、独立网络工具或自行管理连接的应用可能不会采用同一设置。需要更广范围的流量接管时，再阅读 TUN 相关说明，确认权限、DNS 和路由。退出客户端前也应留意系统代理是否已经恢复，避免留下指向已关闭本地端口的设置。
优先选择 v2rayNG；需要 V2Fly 内核配置时，再考虑 v2flyNG。
基于 Xray 内核的 Android 图形客户端。2015 年后的主流手机通常可先选 arm64，最终以设备实际支持的应用架构为准；不能确定时可用通用版。
arm64-v8a · APK
下载 v2rayNG · arm64适合支持 64 位 ARM 应用的设备。现代手机通常采用此架构，但处理器支持 64 位不一定意味着系统允许安装对应应用。
面向 V2Fly 内核使用场景的 Android 客户端。按配置所需的协议和传输能力选择，不应仅根据客户端名称判断兼容性；Xray 专属功能不能默认在此使用。
arm64-v8a · APK
下载 v2flyNG · arm64适合已确认支持 arm64 应用的设备。安装后重新检查导入结果，特别是协议、传输方式和路由规则中的内核相关字段。
| 检查项 | 选择依据 |
|---|---|
| 应用架构 | 支持 arm64-v8a 时优先 arm64；不确定时选择通用版。 |
| Android 版本 | 以 APK 安装器对当前系统的兼容性判断为准，不能仅凭手机出厂年份确定。 |
| 安装权限 | 按系统提示，仅向此次使用的浏览器或文件管理器授予安装应用权限。 |
| 网络权限 | 首次启动连接时确认 Android VPN 授权；其他正在运行的 VPN 类应用可能与其占用同一入口。 |
打开 APK 时如提示无法安装，先区分系统版本不满足、架构不符、已有安装签名不同等原因。已有同名客户端但无法覆盖安装时，不要立即卸载；卸载可能同时移除本地订阅和自定义设置，应先在旧应用中备份。卡内版本信息与包名分别来自发布清单字段，不能只靠文件名判断能否覆盖现有应用。
安装成功后导入有权使用的订阅，选择服务器，再启动连接并处理系统授权。如果应用切到后台后容易断开，可检查电池优化和后台运行限制；这些限制由系统及设备厂商控制。v2rayNG 与 v2flyNG 的内核不同，切换客户端时应重新确认配置支持情况，详细差异见客户端对比。
先选发行版的包格式，再匹配 x64 或 arm64 架构。
Linux 使用跨平台桌面界面，需要可用的图形桌面环境。deb 与 rpm 是不同的软件包格式，不是两种连接模式；下面的主入口均为 x64 架构。
Debian 系发行版 · amd64
下载 v2rayN · x64 deb适用于使用 deb 包管理体系且满足依赖条件的系统。可通过发行版的软件安装器打开，遇到依赖提示时交由系统包管理器处理。
RPM 系发行版 · x86_64
下载 v2rayN · x64 rpm适用于满足此包构建目标与依赖条件的 RPM 环境。文件名含 el10，不能据此认定所有使用 RPM 的发行版都可以直接安装。
| 检查项 | 选择依据 |
|---|---|
| 处理器架构 | x86_64 对应 x64，aarch64 对应 arm64；amd64 是 deb 包中常见的 x64 标识。 |
| 包管理体系 | Debian 系环境选择 deb；RPM 系环境选择 rpm，并继续确认构建目标及依赖兼容性。 |
| 图形环境 | 用于图形桌面会话，不是面向仅命令行服务器的安装入口；托盘表现受桌面环境影响。 |
| 权限与依赖 | 由系统安装器处理软件依赖和安装授权；TUN 所需权限应按客户端与发行版的实际提示配置。 |
包管理器报告缺少共享库、发行版版本不符或架构错误时，应先解决兼容性问题，不要把其他格式的包强行转换后当作通用方案。图形界面能否启动、系统托盘是否显示，以及程序是否随桌面会话启动，属于不同层面的检查项，不能仅凭安装完成提示判断全部功能已就绪。
Linux 桌面的系统代理设置未必被每个应用采用。浏览器通常有自己的代理策略，终端工具也可能读取环境变量或独立配置。建议先使用一个明确支持系统代理的应用测试，再根据实际需求处理其他程序。若改用 TUN，应同步检查 DNS、路由和权限，避免把多个流量接管方式叠加后再盲目排查。
安装包提供客户端程序。订阅、流量入口与路由规则仍需分别设置。
打开客户端后，使用订阅分组保存订阅地址，填写便于识别的别名，再执行更新。订阅地址可能包含访问凭据，不要粘贴到公开讨论、日志截图或共享文档中。需要多个来源时建立独立分组，便于分别更新与定位错误。
列表中出现服务器后，选择实际要使用的一项。导入成功只说明客户端读取到了配置，不代表服务器一定可达。若更新失败，应检查地址是否过期、设备时间是否准确，以及当前网络能否访问订阅来源，而不是反复重装程序。
查看订阅导入与首次连接步骤 →系统代理决定支持该设置的应用如何进入客户端，路由规则决定进入客户端后的流量如何选择出口。两者作用不同。启用自动配置系统代理，不会自动把所有程序纳入代理，也不会替换既有的路由预设。
初次配置可先保持容易理解的设置，确认一个应用能正常访问后，再调整分流或启用 TUN。每次只改一个环节，并保留原有配置。出现问题时记录触发步骤与相关日志，比同时更换客户端、订阅和规则更容易找出原因。
查看入站、出站与路由配置参考 →先区分包选择、安装兼容性与连接配置。连接故障可继续查看疑难解答。
首次安装可先选 Desktop，它采用新一代跨平台界面。WPF 是 Windows 专用的经典稳定版，适合延续既有操作习惯。两者都提供 x64 入口，升级或换版前应备份现有配置，不要直接混用程序目录。
在苹果菜单中打开“关于本机”。芯片一栏显示 Apple M 系列时选择 Apple Silicon，也就是 arm64 包；处理器一栏显示 Intel 时选择 Intel，也就是 x64 包。优先安装匹配本机架构的包。
2015 年后的主流手机通常可先选 arm64，但仍应以设备实际支持的应用架构为准。无法确认架构，或 arm64 安装时提示不兼容，可改选通用版。通用版包含更多架构，文件通常更大。
客户端安装包不包含可用服务器或订阅。需要自行准备有权使用的订阅地址或服务器配置，再通过订阅分组或导入功能添加。导入成功后还要选择服务器、设置流量入口，并确认路由规则。
先退出客户端，并使用当前版本提供的备份或导出功能保存配置；如果通过程序目录迁移配置，应先确认当前版本实际使用的配置目录。安装后检查订阅分组、路由、自定义 DNS 和本地端口，确认正常后再清理旧文件。
先检查订阅更新、所选服务器、系统时间和日志，再确认应用是否读取系统代理。系统代理与 TUN 是不同的流量入口；能够正常启动但连接失败时，反复下载相同安装包通常不能解决配置或网络问题。