v2rayN
7.24.1Desktop 采用新一代跨平台 UI，适合首次使用或希望在不同桌面系统上保持相近操作习惯的用户。WPF 是经典稳定版，保留熟悉的 Windows 界面。两者都是图形客户端，不需要手工编写配置才能开始导入订阅。
这两个下载文件都是 ZIP 压缩包。下载结束后先完整解压，再运行包内安装程序；不要在压缩软件的临时预览目录中直接运行。
客户端安装包 / 架构选择
V2Ray 客户端下载
按系统选客户端，再按处理器选安装包。
桌面使用 v2rayN；Android 优先使用 v2rayNG，需要 v2fly 内核时再选 v2flyNG。先确认设备，再下载对应文件。
免费开源
图形界面
订阅导入
Windows：v2rayN
同一款客户端，两种界面。首次安装优先选 Desktop 桌面版。
系统与安装要求
| 检查项目 | 选择依据 |
|---|---|
| 系统 | 建议使用仍获维护的 Windows 10 / 11；具体兼容性以安装程序提示为准。 |
| 架构 | 本页两种安装入口均为 x64，先在系统“关于”中确认系统类型。 |
| 安装方式 | 先解压 ZIP，再启动包内安装程序；出现运行环境提示时按要求处理。 |
| 权限 | 常规订阅操作与 TUN 所需权限不同；启用 TUN 时再按提示授权。 |
安装后先导入，再设置代理
打开 v2rayN 后，先添加订阅地址并执行更新，确认列表中出现节点，再把需要使用的节点设为活动项。订阅地址与单节点分享链接不是同一种内容，应分别使用订阅管理和剪贴板导入入口。只有把地址保存到分组、却没有执行更新时，节点列表仍可能为空。
浏览器等遵循系统代理设置的应用，可先使用系统代理测试。部分应用有独立的网络设置，不会自动跟随系统代理，这时再评估 TUN。TUN 涉及虚拟网卡与路由，不应仅因为页面打不开就同时开启多种接管方式。退出客户端前清除系统代理，可以减少其他应用继续访问已关闭本地端口的情况。
从 WPF 切换到 Desktop 前，先备份订阅、路由与自定义设置。不要让两个实例同时争用本地监听端口，也不要假定不同安装目录一定共享同一份配置。完成迁移后重新核对活动节点、系统代理状态和开机启动选项，再决定是否移除旧安装。
macOS：按芯片选择 v2rayN
打开“关于本机”，查看显示的是 Apple 芯片还是 Intel 处理器。
v2rayN
7.24.1M 系列芯片选择 Apple Silicon 包，Intel 处理器选择 x64 包。优先使用与硬件一致的构建，不要仅根据电脑购买年份判断；同一外观的设备可能使用不同处理器。
打开 DMG 后按窗口提示安装，并从应用程序目录启动。先结束磁盘映像里的临时运行实例，再进行后续配置。
系统与安装要求
| 检查项目 | 选择依据 |
|---|---|
| 芯片 | Apple M 系列选 arm64；Intel 处理器选 x64。 |
| 系统版本 | 使用仍获维护的 macOS；最低版本以应用实际要求为准。 |
| 安装格式 | DMG 磁盘映像，安装到应用程序目录后启动。 |
| 权限 | 系统代理和 TUN 可能触发不同授权提示，按实际功能逐项确认。 |
区分启动限制与连接问题
如果系统在首次打开时显示安全提示，先确认文件来自本页选定的入口，再查看系统设置中的“隐私与安全性”。应针对本次应用打开请求处理提示，而不是关闭整套系统防护。应用根本没有启动，与已经启动但网络不通是两类问题，排查时应分开记录。
成功打开后导入订阅，执行更新并选择节点。桌面应用是否使用代理，取决于它是否遵循系统设置；浏览器中单独配置的代理扩展也可能覆盖系统选择。验证连接时先固定一种代理入口，避免系统代理、应用自定义代理与其他网络工具同时改变流量方向。
需要 TUN 时，再根据客户端提示处理权限。若授权失败，先记录日志中的具体错误，再查看虚拟网卡与已有网络扩展是否冲突。更新客户端前退出正在运行的实例，保留原配置备份；替换完成后检查菜单栏状态与订阅分组，确认新实例读取了预期的配置位置。
Android：优先选择 v2rayNG
先选客户端，再选架构。2015 年后的主流手机通常优先选 arm64。
v2rayNG
2.2.6采用 Xray 内核，适合在 Android 上导入订阅、选择节点与设置路由。首次使用优先从这款客户端开始，协议与传输参数仍需和服务端配置一致。
arm64 包适用于支持对应应用架构的设备；无法确认架构时可选通用版。安装包与版本文字可能随发布渠道更新节奏分别变化，运行时以应用内显示为准。
v2flyNG
1.10.31采用 v2fly 内核，作为已有配置依赖该内核时的备选。不要仅凭分享链接的协议名称判断兼容性，还要核对传输、安全与扩展参数。
两款 Android 客户端分别管理应用数据。更换客户端后需要重新导入配置并确认路由；不应假定另一款应用会自动继承订阅或连接状态。
系统与安装要求
| 检查项目 | 选择依据 |
|---|---|
| 应用架构 | 主流设备优先 arm64；老设备或架构不明时尝试通用版。 |
| 系统兼容 | 以 APK 安装器的系统要求为准；通用版不能解决系统版本过旧的问题。 |
| 安装来源 | 向用于打开 APK 的浏览器或文件管理器授予本次安装所需权限。 |
| 连接授权 | 首次连接需要确认系统 VPN 请求；同一时刻通常只能运行一个 VPN 服务。 |
安装 APK 与首次连接
下载完成后从文件管理器打开 APK。如果系统拒绝安装，先看提示是来源权限、系统版本还是架构不匹配，不要反复下载同一个包。2015 年后的主流手机多数适合 arm64，但有些设备的硬件与系统支持的应用架构并不完全一致，应以实际安装能力为准。
导入订阅后，先更新并选中一个有效节点，再点击连接并确认系统 VPN 授权。出现 VPN 标识只说明接管服务已经启动，不代表远端节点一定可用；仍需访问正常的测试页面，并结合日志确认域名解析与连接结果。其他 VPN 应用正在运行时，应先退出再测试。
若锁屏后经常断开，可检查电池优化、后台活动与厂商的自启动管理。只针对所选客户端调整必要设置，不必一次放开所有后台权限。使用按应用代理时，还要核对目标应用是否在代理名单内；路由排除与节点故障会表现出不同的连接范围。
Linux：按发行版选择 v2rayN
先确认 deb / rpm 软件包体系，再确认 x64 / arm64 处理器架构。
v2rayN
7.24.1Debian、Ubuntu 等通常选择 deb；使用 RPM 软件包体系的发行版选择 rpm。格式匹配只是第一步，仍需确认发行版版本与依赖是否满足该构建要求。
这里提供的是图形客户端，适用于桌面会话。ARM 桌面设备请选择 arm64 小字入口，不要把 amd64 包当作通用包安装。
系统与安装要求
| 检查项目 | 选择依据 |
|---|---|
| 桌面环境 | 需要可用的图形桌面会话；托盘支持情况取决于桌面环境。 |
| 包格式 | 按发行版的软件包体系选择 deb 或 rpm。 |
| 架构 | amd64 / x86_64 对应 x64；aarch64 对应 arm64。 |
| 依赖与权限 | 由软件包管理器检查依赖；TUN 需要额外的网络设备与路由权限。 |
保留软件包管理器的错误信息
使用图形软件安装器打开下载文件，出现依赖错误时先核对发行版与软件包目标环境，不要强行忽略依赖继续安装。rpm 文件名包含构建环境信息，不能据此认定它适合所有使用 RPM 的系统。安装器给出的缺失组件与版本要求，是判断兼容性的直接依据。
首次启动后导入订阅并更新节点，再检查桌面环境的系统代理设置。Linux 上不同应用对系统代理的支持可能不同，图形浏览器、命令行程序与后台服务不一定共享代理入口。浏览器能访问而其他应用失败时，应先核对应用是否使用代理，再考虑调整节点。
启用 TUN 前，确认虚拟网络设备可用，并按客户端说明授予最小必要权限。已有容器网络、其他 VPN 或自定义路由时，应先保存原有配置。关闭 TUN 后若网络异常，检查路由与 DNS 是否恢复，不要通过反复安装客户端代替网络状态排查。
安装之后
导入订阅与验证连接
下载完成只是第一步。按配置、接管方式、实际访问的顺序检查，能更快定位问题。
准备有效配置
客户端负责读取配置、运行内核与管理代理，不提供可直接使用的节点。订阅地址应来自可信的配置提供方，复制时保留完整内容，避免混入空格、换行或聊天标点。
订阅中可能包含访问凭据，不要把完整地址发到公开讨论区。排查问题时只描述错误类型，并隐藏服务器地址、用户标识和订阅参数。
查看订阅导入 →选择接管方式
桌面端先用系统代理验证遵循系统设置的应用；确有其他流量接管需求时，再配置 TUN。Android 通过系统 VPN 接口接管流量，并可根据客户端设置限定应用范围。
全局路由与 TUN 不是同一个开关。前者描述流量进入客户端后如何选择出口，后者描述流量怎样进入客户端；是否直连还要看路由规则。
阅读全平台配置指南 →记录连接结果
先选择一个节点、保持一种代理模式，再测试目标应用。延迟测试成功只能说明对应测试过程有响应，不能代替实际网页访问，也不代表所有域名与应用都能正常连接。
遇到问题时记录客户端名称、系统架构、代理模式与日志报错。一次只改一个设置，便于判断是订阅、节点、DNS 还是应用自己的代理配置造成影响。
按现象查找常见问题 →下载与安装问答
安装包选择常见问题
先排除包格式与架构问题，再处理连接配置。
下载客户端后，可以直接连接吗？
不能仅靠安装客户端建立代理连接。还需要有效的节点配置或订阅地址；导入后更新订阅、选择节点，再开启合适的代理模式。客户端本身不附带订阅服务。
Windows 桌面版与经典 WPF 版怎么选？
首次使用可优先选择 Desktop 桌面版，它采用新一代跨平台界面。习惯经典 Windows 界面时可选择 WPF 经典稳定版。两种入口均为 x64 包，安装前确认系统架构，切换版本前备份配置。
Android 应该下载 arm64 还是通用版？
2015 年后的主流手机通常优先选择 arm64，但仍应以设备实际支持的应用架构为准。无法确认架构或 arm64 包提示不兼容时，可尝试通用版；通用版覆盖更多架构，文件通常更大。
更新客户端会保留订阅与路由设置吗？
在相同应用、相同配置位置上更新通常会保留设置，但安装方式与跨版本迁移可能影响结果。更新前使用客户端提供的备份或导出功能保存配置，不要先删除应用数据；更新后检查订阅、活动节点和代理模式。
安装包无法打开时应该先检查什么？
先确认下载已经完成，再检查文件格式、处理器架构与系统版本是否匹配。Windows 的 ZIP 包需要先解压，Android 需要允许当前安装来源，macOS 应查看隐私与安全性提示，Linux 应用软件包管理器查看依赖错误。不要通过关闭整套系统防护来处理安装问题。