v2rayN
Windows · x64 7.24.1
桌面版 Desktop 使用新一代跨平台 UI；经典 WPF 版是保留传统操作布局的经典稳定版。首次安装可从桌面版开始，熟悉旧界面的用户可选 WPF 版。
ZIP 压缩包下载完成后，先完整解压，再运行其中的安装程序。不要直接在压缩包预览窗口中启动。
客户端安装包 / 平台与架构
V2Ray 客户端下载
先选系统，再核对芯片架构。桌面端使用 v2rayN，Android 优先选择 v2rayNG。
按操作系统选择安装包
下载入口按系统分组。切换平台后，页面地址会保留对应位置，便于下次直接打开。
Windows 安装包
同一款客户端，两种界面。以下入口均为 x64 安装包。
Windows 安装与首次打开
先退出正在运行的旧客户端，确认托盘图标也已关闭，再解压下载文件。安装程序需要写入系统位置时，按系统提示确认权限；日常使用不必为了普通订阅导入而长期以管理员身份运行。遇到安全提示时先核对程序来源与下载文件，不要为了完成安装而关闭整套系统防护。
桌面版与 WPF 版的菜单位置可能不同，但订阅分组、更新订阅和系统代理仍是首次配置的关键环节。切换界面前先保存原配置，迁移时检查路由、自定义 DNS 和本地监听设置。不要让两个界面版本同时运行并争用相同端口，也不要让两个客户端轮流修改系统代理。
打开主界面不代表已完成连接。先添加订阅分组并执行更新，确认列表出现配置，再选择需要使用的一项。随后设置系统代理与路由模式，用实际网页访问确认结果。若日志提示端口占用，先查找仍在运行的客户端进程，不必立即重新安装。
macOS 安装包
在“关于本机”中确认芯片，再选择 Apple Silicon 或 Intel。
v2rayN
macOS · DMG 7.24.1
“关于本机”显示 Apple 芯片时选 Apple Silicon，也就是 arm64；显示 Intel 处理器时选 Intel，也就是 x64。不要用购买年份替代芯片信息。
打开 DMG 后，将应用复制到“应用程序”再启动。更新前退出旧进程，避免继续使用磁盘映像中的临时副本。
macOS 安装与权限处理
下载后打开磁盘映像，将应用复制到“应用程序”。复制完成后可以推出磁盘映像，再从“应用程序”启动。这样可避免更新时替换了一个副本，实际仍在运行另一个副本。若先前已经安装过，先退出菜单栏中的旧进程，再处理替换提示。
首次打开遇到系统安全提示时，先阅读完整提示并确认文件来源，再按“系统设置 → 隐私与安全性”中可用的操作处理。系统版本不同，按钮名称和位置可能变化。不要把所有启动失败都归因于权限；架构不匹配、系统版本不满足要求或应用复制未完成，也需要分别排查。
安装后先导入订阅并选择配置，再决定是否由客户端接管系统代理。系统代理只影响遵循相关系统设置的应用，并不等于所有流量都会使用同一路径。退出客户端前若发现其他应用仍无法联网，检查系统网络设置是否遗留代理项，再按实际使用方式恢复。
Android 安装包
优先选择 v2rayNG；已有 V2Fly 配置需求时，再考虑 v2flyNG。
v2rayNG
Android · Xray 内核 2.2.6
适合在手机上导入订阅、选择配置并建立代理连接。2015 年后的主流手机通常优先选 arm64；不确定设备应用架构时，可考虑通用版。
页面版本文字与包文件名可能有更新时差。此处清单版本文字为 2.2.6，当前下载文件名标记为 2.3.11；实际安装版本请在客户端内确认。
v2flyNG
Android · V2Fly 内核 1.10.31
适合需要沿用 V2Fly 内核配置的用户。选择前先核对订阅中的协议与传输设置，不要假设它与 v2rayNG 的全部功能和配置字段完全相同。
更换客户端前保留原订阅地址，并单独记录分应用代理与 DNS 设置。这些设置不一定随订阅一起迁移。
Android 系统与安装条件
| 项目 | 检查内容 |
|---|---|
| arm64 | 适用于支持 arm64-v8a 应用的设备；不能仅看处理器宣传名称。 |
| 通用版 | 包含多种架构，适合架构不确定时选择，仍需满足应用的系统要求。 |
| 安装权限 | 如系统要求，为实际打开 APK 的浏览器或文件管理器允许安装应用。 |
| 连接权限 | 首次启动连接时，阅读并批准系统 VPN 连接请求。 |
下载 APK 后，从浏览器下载记录或文件管理器打开。安装权限通常授予“打开这个文件的应用”，而不是给所有应用统一开启。安装完成后可按需要收回该权限。若显示解析失败，先检查下载是否完成、架构是否匹配，以及系统版本是否达到当前包的要求。
首次建立连接时，系统会请求创建 VPN 连接；这是 Android 客户端接管流量的方式，不代表需要另外购买一个系统功能。若另一款使用相同系统通道的应用正在连接，先断开再启动当前客户端。订阅导入与连接授权是两件事，完成其中一项不会自动完成另一项。
手机熄屏后连接中断时，再检查后台运行与电池管理限制，不要一开始就关闭所有省电设置。不同设备的菜单名称不完全相同，可以先允许客户端按需要后台运行，再观察是否改善。分应用代理、路由和 DNS 的选择应逐项调整，避免一次修改多处后无法判断原因。
Linux 安装包
先确认发行版使用 deb 还是 rpm，再核对 x64 或 arm64 架构。
v2rayN
Linux · 图形桌面 7.24.1
Debian、Ubuntu 系通常选择 deb；使用 RPM 包管理体系的发行版选择 rpm。以下主入口为 x64，arm64 设备使用下方对应入口。
arm64 设备安装包
使用发行版的软件安装器打开安装包。包格式相同并不保证所有发行版版本都具备所需依赖。
Linux 安装与桌面代理设置
从文件管理器打开对应安装包，交由系统软件安装器处理。若系统关联了归档工具而非安装器，可在文件的打开方式中选择软件安装应用。安装过程中需要的授权用于写入系统应用位置；日常运行客户端应使用普通桌面用户，避免配置文件变成只有管理员可写。
rpm 文件名中的发行版构建标记需要结合本机环境判断，不能仅凭“支持 rpm”认定一定兼容。若安装器提示缺少依赖或运行库版本过低，优先查阅该发行版的软件包说明，不要通过替换系统基础库来强行启动。deb 包也应遵循相同原则，先确认系统条件再安装。
首次打开后，先导入订阅并选择配置，再检查桌面环境中的网络代理设置。不同桌面环境对系统代理的处理方式可能不同，部分应用还会使用自己的代理选项。浏览器可访问而其他应用失败时，应检查应用是否遵循系统代理，而不是直接把问题归结为安装包错误。
安装前后检查清单
安装包解决的是客户端部署。订阅、代理模式与连接验证，需要继续在客户端中完成。
先保存已有配置
已有客户端的用户，先记录订阅分组、更新方式、路由模式和自定义 DNS。若客户端提供备份或导出功能，按其界面操作保存。订阅通常只包含服务器配置，不会自动携带所有本地设置，因此只复制订阅地址不等于完整迁移。
退出旧客户端再开始更新，避免文件占用或后台进程仍运行旧版本。更新后先查看配置是否保留，再测试连接。不要在尚未确认迁移成功时删除原配置目录；也不要把完整备份上传到公开位置。
再区分客户端与订阅
v2rayN、v2rayNG 和 v2flyNG 是读取配置的工具。下载客户端不会自动生成订阅或可用配置。准备好有效订阅地址后，在客户端的订阅分组中保存，再执行更新；只有更新得到配置并选中其中一项，才进入后续连接步骤。
更新订阅失败时，先核对地址是否完整、是否过期，以及当前更新方式是否能访问订阅来源。安装包与订阅地址的用途不同，不要把安装包下载链接粘贴到订阅地址栏。
安装完成后的操作顺序
导入订阅 → 更新分组 → 选择配置 → 设置代理模式 → 验证实际访问。
客户端、内核与配置兼容
判断能否使用某份配置，需要同时看客户端界面与内核能力，不能只比较软件名称。
界面负责管理，内核负责连接
Project V 是相关开源代理生态的重要起点，V2Fly 与 Xray 是其中不同的内核发展方向。图形客户端把订阅管理、配置选择和代理设置集中到界面中，实际连接能力仍取决于当前使用的内核及其支持的协议。
v2rayN 提供桌面端配置管理；Android 的 v2rayNG 以 Xray 为内核，v2flyNG 使用 V2Fly 内核。它们具有开源属性，但并不意味着菜单、字段和支持范围完全相同。选包先看系统与架构，选配置再看协议与内核。
订阅可导入，不等于每项都兼容
订阅格式能被客户端读取，只说明完成了解析。具体配置中的协议、传输方式、安全层与扩展参数，还需要当前内核支持，并与服务端一致。尤其在不同内核家族之间迁移时，不应通过删除不认识的字段来盲目尝试。
遇到不支持的配置类型，先确认订阅提供的说明与客户端内核设置，再决定是否更新或更换配置。需要了解 VMess、VLESS、Trojan、Shadowsocks 与 REALITY 的区别时，可阅读协议参考，不必另外寻找独立内核安装入口。
查看协议与内核选型说明 →下载与安装常见问题
先核对安装包，再处理配置。以下问题可直接展开查看。
Windows 桌面版与经典 WPF 版怎么选？
首次安装可先选桌面版 Desktop，它使用新一代跨平台界面。经典 WPF 版保留 Windows 经典界面，适合已有操作习惯的用户。两者均需自行导入有效订阅；迁移前先备份配置，不要让两个客户端同时接管系统代理。
Android 的 arm64 与通用版有什么区别？
2015 年后的主流手机通常优先选择 arm64，但仍需以设备支持的应用架构为准。通用版包含多种架构，适合不确定架构或 arm64 包不兼容时尝试。通用版不代表连接更快，也不能绕过系统版本要求。
下载客户端后会自动获得订阅吗？
不会。客户端负责读取和使用配置，订阅地址需要另外准备。安装完成后，在订阅分组设置中保存地址，再执行更新订阅。不要把下载完成或客户端启动成功当作连接已经可用。
页面显示版本与安装包文件名不一致时怎么办？
版本文字与安装包链接由清单中的不同字段提供，可能存在更新时差。先确认下载入口对应的客户端、系统与架构，再查看实际安装包及客户端内的版本信息。不要仅凭页面版本文字判断该包与现有安装是否属于同一次发布。
更新客户端前需要卸载旧版吗？
优先按照安装程序和当前版本的更新提示操作，不要直接删除原有数据。更新前退出客户端并备份订阅分组、路由和自定义设置。切换界面类型或内核家族时，先确认配置兼容性，再决定是否迁移。
安装完成但网页仍打不开，应先检查什么？
先确认订阅更新后有可用配置，并已选择其中一项。桌面端检查系统代理是否启用；Android 端检查是否批准 VPN 连接请求。再检查路由模式、系统时间和客户端日志，不要反复重装来代替定位问题。