桌面平台选择 v2rayN，Android 可选择 v2rayNG 或使用 v2fly 内核的 v2flyNG。先确认操作系统、处理器架构与安装包格式，再进入对应平台下载。
平台选项会同步到页面地址。下载前请先阅读卡片中的架构说明；如果设备信息不明确，优先查看系统设置或系统信息页面，不要根据文件名猜测。
Windows 平台固定提供 v2rayN。桌面版采用新一代跨平台 UI，适合首次安装或希望界面体验与其他桌面平台接近的用户；WPF 版是 Windows 上长期使用的经典界面，托盘与设置布局更接近既有操作习惯。两个版本都可管理订阅、路由、DNS、系统代理和本地监听端口，主要差异在界面技术与桌面交互方式。
如果此前没有使用过 v2rayN，可先下载桌面版。已有 WPF 配置和操作习惯的用户，可继续选择经典 WPF 版。更新前建议记录订阅分组、路由规则、本地 SOCKS 端口与系统代理模式。
| 检查项目 | 建议选择 | 说明 |
|---|---|---|
| 处理器架构 | x64 | 本页 Windows 安装包对应 64 位 x86 架构，下载前可在“系统信息”中确认系统类型。 |
| 界面类型 | Desktop 或 WPF | 首次使用优先考虑桌面版；熟悉经典 v2rayN 工作流时可选择 WPF 版。 |
| 安装后设置 | 订阅、路由、系统代理 | 程序启动后仍需导入有效配置，并根据应用场景选择系统代理模式。 |
macOS 平台使用 v2rayN 桌面版，安装包按处理器架构区分。搭载 Apple M 系列芯片的设备选择 Apple Silicon 版；系统信息中显示 Intel 处理器的设备选择 Intel 版。架构必须与设备匹配，订阅导入、路由设置、DNS 和系统代理操作则使用同一套客户端逻辑。
打开系统菜单中的“关于本机”或系统信息页面，查看芯片或处理器字段。Apple M 系列使用 arm64 安装包，Intel 处理器使用 x64 安装包。不要仅根据设备购买年份判断架构。
| 系统信息 | 对应安装包 | 判断方式 |
|---|---|---|
| Apple M 系列芯片 | Apple Silicon DMG | 系统信息的芯片字段显示 Apple M 系列型号，使用 arm64 架构包。 |
| Intel 处理器 | Intel DMG | 系统信息的处理器字段显示 Intel 型号，使用 x64 架构包。 |
| 首次启动 | 确认系统权限 | 首次打开时按系统提示处理应用启动与网络访问权限，再配置系统代理。 |
Android 平台先选择 v2rayNG，它采用 Xray 内核并覆盖 VMess、VLESS、Trojan、Shadowsocks 等常见配置。需要使用 v2fly 内核工作流时，可选择 v2flyNG。两款客户端都提供 arm64 与通用安装包；2015 年后的主流手机通常优先选择 arm64，无法确认架构时再选择通用版。
适合需要使用 Xray 内核及其相关协议能力的 Android 用户。首次下载优先选择 arm64；如果设备较旧、架构未知或 arm64 包无法安装，再改用通用版。
适合明确需要 v2fly 内核行为或已有对应配置工作流的用户。客户端选择应以配置兼容性为依据，不需要同时安装两款应用来完成同一套日常连接。
| 检查项目 | 优先选择 | 说明 |
|---|---|---|
| 主流 64 位 ARM 设备 | arm64 | 多数 2015 年后的主流手机使用此架构，安装包体积与目标架构更集中。 |
| 架构无法确认 | 通用版 | 通用包覆盖范围更广，适合系统信息不完整或 arm64 包提示不兼容的设备。 |
| 客户端路线 | v2rayNG 优先 | 常规使用先选 v2rayNG；明确需要 v2fly 内核时再选择 v2flyNG。 |
Linux 平台使用 v2rayN 桌面客户端。Debian、Ubuntu 及其衍生发行版通常选择 deb；Fedora、Rocky Linux、AlmaLinux 与 RHEL 系发行版通常选择 rpm。确定格式后，还需要在 x64 与 arm64 之间选择正确架构。本页不提供通用压缩包，优先使用发行版的软件包管理机制完成安装和升级。
常见桌面电脑通常选择 x64，采用 ARM 处理器的设备选择 arm64。再根据发行版的软件包格式选 deb 或 rpm。下载前可运行系统自带的架构查询工具，也可在系统信息界面确认处理器类型。
| 发行版或设备 | 安装包 | 架构说明 |
|---|---|---|
| Debian、Ubuntu 及其衍生版 | deb | 普通 Intel 或 AMD 桌面设备通常选择 x64；ARM 设备选择 arm64。 |
| Fedora、Rocky Linux、AlmaLinux、RHEL 系 | rpm | x86_64 对应 x64，aarch64 对应 arm64。 |
| 桌面会话 | 图形环境 | v2rayN 是图形客户端，需要可用的桌面会话与系统托盘或等效桌面能力。 |
安装包只解决客户端程序的部署问题。能否正常建立连接，还取决于配置格式、客户端支持范围、本地监听设置、路由规则与系统代理状态。
卡片中的版本号由同源版本清单更新。升级前可记录当前设置，并阅读新版本界面中的字段变化。若只是更换同一客户端的安装包架构，不应把旧架构程序与新架构程序同时作为日常入口。
x64、arm64、Apple Silicon 与 Intel 描述的是处理器或程序架构。架构选错时，常见结果是安装器拒绝执行、程序无法启动，或系统提示应用与设备不兼容。先查系统信息，再下载对应文件。
v2rayN 面向桌面平台，v2rayNG 与 v2flyNG 面向 Android。客户端名称相近，但运行平台、界面和内核路线不同。不要把桌面客户端的安装步骤直接套用到移动设备，也不要把安装包选择等同于协议选择。
安装成功不代表连接流程已经结束。首次启动建议按固定顺序完成配置，便于在出现问题时快速定位到订阅、路由、端口或系统代理中的具体环节。
Windows 按所选界面版本完成安装；macOS 打开对应架构的 DMG；Android 使用与设备架构匹配的安装包；Linux 通过发行版对应的软件包工具安装 deb 或 rpm。首次启动时，根据系统提示处理必要的应用运行与网络访问权限。
在客户端的订阅分组或导入功能中添加有效地址，也可以导入客户端支持的分享链接或配置文件。导入后先检查服务器条目是否完整，再确认协议、传输方式与安全字段没有因格式不兼容而缺失。
常见设置包括本地 SOCKS 监听端口、允许局域网连接、流量探测、DNS 与路由模式。默认端口被其他程序占用时，需要调整端口，并同步修改所有调用该端口的应用。路由规则应先从简洁配置开始，再按实际需求增加域名或 IP 匹配条件。
选择有效配置后启动连接，再根据使用方式启用系统代理或在目标应用中填写本地代理地址。验证时应分别检查客户端日志、系统代理开关、应用代理设置与 DNS 行为。若只有个别应用无法连接，优先检查该应用是否绕过系统代理。
以下问题覆盖界面版本、处理器架构、Linux 包格式、首次连接与升级准备。客户端运行问题可继续前往疑难解答页按日志和设置逐项排查。
桌面版采用新一代跨平台界面，适合希望在不同桌面系统之间保持相近操作方式的用户；WPF 版仅面向 Windows，界面、托盘与设置布局更接近经典 v2rayN。首次安装可先选择桌面版，已有 WPF 使用习惯或需要延续既有工作流时可选择经典版。两者都提供订阅、路由、DNS、本地端口与系统代理等核心设置。
打开系统信息并查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon 版；显示 Intel 处理器时选择 Intel 版。两种安装包的主要区别是处理器架构，订阅与路由配置方式基本一致。如果安装后出现架构不匹配提示，应返回系统信息重新确认，而不是反复覆盖安装同一个文件。
2015 年后的主流 Android 手机通常优先选择 arm64 版，它面向常见的 64 位 ARM 架构。无法确认设备架构、系统信息没有提供明确标识，或安装时提示不兼容时，可改用通用版。通用版覆盖范围更广，但客户端功能与同版本 arm64 包并不会因此增加。
Debian、Ubuntu 及其衍生发行版通常使用 deb；Fedora、Rocky Linux、AlmaLinux、RHEL 系发行版通常使用 rpm。格式确定后还要检查架构：常见 Intel、AMD 桌面设备通常为 x64，ARM 设备则选择 arm64。软件包格式和处理器架构是两个独立条件，必须同时匹配。
客户端安装完成只代表程序能够运行。还需要导入有效订阅或配置，选择可用条目，设置合适的路由模式，启动连接，并根据使用场景启用系统代理。如果应用使用独立代理设置，还要确认代理类型、地址与端口和客户端本地监听一致。排查时先看客户端日志，再检查系统代理与应用代理，避免一次修改多个变量。
建议先记录订阅分组、路由规则、DNS 设置、本地监听端口、系统代理模式和自定义启动选项。覆盖安装通常不要求重新创建全部配置，但跨界面版本或跨较大版本更新时，字段名称与默认行为可能变化。安装完成后应逐项核对关键设置，并先用单个配置验证连接，再恢复复杂路由。