V2Ray 客户端下载

Windows 安装要求

Desktop 与 WPF 的选择

两种入口都属于 v2rayN，不是两套订阅服务。Desktop 的主要区别是新一代跨平台界面；经典 WPF 版保留传统 Windows 操作方式。选型时先看操作习惯与实际兼容情况，不要把界面差异当成节点速度差异。节点协议、远端服务器和本地网络才是连接结果的重要因素。

切换版本前，保存订阅地址并导出自定义路由。退出原来的客户端，确认托盘进程结束后，再打开新版本。不要直接把旧目录中的所有文件覆盖到新安装目录，以免旧设置或依赖混在一起。首次启动后先完成订阅更新和节点选择，再设置“自动配置系统代理”；需要接管不遵循系统代理的应用时，再查阅 TUN 配置。

macOS 安装要求

从安装到首次连接

下载完成后打开磁盘映像，按窗口提示把 v2rayN 放入“应用程序”。完成复制后可以推出磁盘映像。首次打开如果遇到系统阻止提示，先阅读提示中的具体原因，核对应用来源、系统兼容性和下载是否完整；确认后再通过系统提供的允许打开入口处理，不要为了单个应用关闭整机的安全检查。

进入客户端后添加订阅分组，填入有权使用的订阅地址并执行更新。选择节点后再启用“自动配置系统代理”。这一步只影响遵循 macOS 代理设置的应用，并不等同于全局路由。开发工具、终端和部分桌面应用可能使用自己的代理配置，需要单独设置，或者在理解路由与权限后使用 TUN。

退出前可先清除系统代理，尤其是在切换其他网络工具时。若应用已退出但浏览器仍提示代理服务器不可用，进入系统网络设置检查代理地址，不必反复重装客户端。安装与权限问题的完整排查见全平台安装配置文档。

Android 安装要求

安装包选择与更新注意事项

arm64 与通用版不是功能等级之分。前者只携带对应架构的组件，后者覆盖更多架构；通用版不会改善节点质量，也不能突破应用本身的最低系统要求。如果安装器提示“解析失败”，先确认文件下载完成、系统版本与架构相符，再重试，不要连续更换订阅来处理安装问题。

覆盖更新前保存订阅与自定义设置。相同应用名称不代表安装签名一定相同，来自不同分发渠道的应用可能无法直接覆盖。遇到签名冲突时，先确认来源差异并备份，再决定是否卸载旧应用；卸载可能删除本地配置。v2rayNG 和 v2flyNG 也不应被当成同一应用的两个皮肤，切换前需重新确认协议支持情况。

安装后导入订阅，更新节点列表，再点击连接并同意系统 VPN 请求。连接状态出现并不代表每个应用都已走代理：应用分流、绕过列表和路由规则都可能改变结果。测试时先用一个明确遵循当前接管方式的应用，避免同时运行多个网络接管工具。

Linux 安装要求

包格式与桌面代理

deb 和 rpm 表示不同的软件包体系，不是不同的代理模式。先查看系统设置中的发行版信息和处理器类型，再选择对应文件。在文件管理器中打开安装包，让系统软件安装器处理依赖。如果报告系统库不匹配，应保留错误提示并检查兼容条件，不要混装其他发行版的基础库。

安装完成后，从应用菜单启动 v2rayN，导入订阅并更新节点。Linux 桌面环境对系统代理的处理并不完全一致，有些应用使用桌面代理设置，有些需要应用内单独配置。浏览器能连接而其他程序不能连接时，先确认后者如何读取代理，再考虑 TUN；重新下载相同安装包通常不能改变流量接管方式。

托盘图标是否显示也受桌面环境影响。窗口可以打开但托盘入口不可见时，先检查桌面是否提供托盘支持，不要立即判定内核未启动。系统依赖、网络权限和具体安装步骤可继续查阅完整文档。