V2Ray 客户端下载

先选操作系统,再按处理器架构和安装格式取包。桌面端使用 v2rayN;Android 可按配置所需内核选择 v2rayNG 或 v2flyNG。

Windows 安装包

首推7.24.1

v2rayN

Desktop 使用新一代跨平台界面,适合初次安装或经常在不同桌面系统间切换的用户。WPF 是经典稳定版,已熟悉原有菜单位置和操作流程时可继续使用。界面版本不决定节点是否兼容,还要看客户端实际调用的内核和节点参数。

下载得到的是 ZIP。先解压到当前用户可以写入的目录,再运行其中的安装程序。更换界面版本前退出正在运行的客户端,备份配置和自定义规则;不要把新版本直接覆盖到唯一一份工作目录上。安装后先打开主界面确认配置正常,再重新启用系统代理或 TUN。

Windows 系统要求
检查项要求与确认方法
系统与架构面向 64 位 Windows 10/11 的 x64 安装入口。在「设置 → 系统 → 关于」确认系统类型和处理器;ARM 设备不等同于 x64 设备。
运行环境如启动时提示缺少 .NET,请按提示确认所需主版本和架构;WPF 所需的是桌面运行时,而非仅安装基础运行时。
目录权限解压目录应可写;安装到受管理的目录或启用虚拟网卡时,按系统权限提示处理。

安装与升级前的检查

客户端、内核和配置分别核对

客户端负责显示节点、管理订阅以及控制系统代理,内核负责按协议参数建立连接。更换客户端并不会改变服务器已经采用的协议。同一条配置能显示在列表里,却可能包含当前内核不支持的安全层或流控字段。首次安装时,先从配置提供方确认协议类型,再按设备选择安装包;从旧客户端迁移时,另外记下工作正常的那条配置所用的传输协议与安全层。需要比较字段时,可查阅协议手册。

备份到客户端目录以外

有正在使用的配置时,先记录客户端名称、当前版本和代理模式,再备份节点、订阅与自定义路由。订阅通常能重新拉取服务端条目,但手动添加的节点、节点备注和规则顺序不一定随订阅恢复。备份应保存在应用数据目录之外;在 Android 上,卸载可能同时删除本地数据。订阅地址和节点配置可能带有访问凭据,备份应留在自己能够控制的位置,不要把完整链接或配置截图发到公开讨论区。

区分新装、覆盖升级与换客户端

新装时按平台表选择安装包即可。覆盖升级时,应先退出旧客户端,记下原安装来源,不要为了消除安装提示就直接移除旧版本。换客户端时,不要假定两个应用的数据库格式或规则语法相同;先用应用支持的导出格式迁移,再核对导入后是否保留了传输层字段和路由规则。若打算暂时保留两个客户端做对照,测试时只启动一个,避免同时占用本地监听端口或争用系统代理。

按失败发生的阶段排查

文件还没打开就收到格式错误,先检查是否进入了正确的平台标签。安装程序拒绝运行,则优先核对系统版本、CPU 架构和安装权限;Linux 还要看包管理器指出的具体依赖。安装完成却启动失败,需要看首条运行时错误,而不是先换节点。能打开界面但无法使用配置时,再检查节点参数、所选内核、系统代理或 VPN 的状态。把安装问题和连接问题分开,可以保留每次尝试前后的可比性。

首次运行先验证一条路径

启动客户端后,先导入一条参数明确的配置,确认选中的节点和本地监听状态,再选择与当前应用匹配的接入方式。桌面端使用系统代理时,先用一个遵循系统代理设置的应用验证;Android 端则查看系统是否接受了 VPN 连接请求。确认基本连接后,再逐项增加分流规则、调整 DNS 或启用 TUN。若同时改变多个设置,连接异常时很难判断是哪一项影响了访问。

查看导入订阅、设置代理与验证连接的步骤 →

下载常见问题

Windows 桌面版和经典 WPF 版怎么选?

新装可先选 Desktop,使用新一代跨平台界面;习惯经典界面或正在维护既有 WPF 配置时,可以继续选 WPF。两者都是 Windows x64 包,换版前先备份配置。

Apple Silicon 和 Intel 安装包可以混用吗?

按「关于本机」显示的信息选择:标为 Apple 芯片就选 arm64,标为 Intel 处理器就选 x64。即使系统能通过转译运行部分 Intel 应用,也优先选匹配本机芯片的包。

Android 通用包能解决覆盖安装失败吗?

通用包主要解决处理器架构选择问题。已有安装的应用签名不同、目标版本低于已装版本,或系统版本不符合要求时,换通用包也不能解决。需要卸载时,先导出配置再操作。

Linux 安装包架构正确,为什么仍报依赖错误?

架构匹配只说明二进制对应处理器类型。还要核对发行版、发行版版本和软件源能提供的依赖;例如本页 RPM 文件带有 el10 标识,不能据此认为它适用于所有 RPM 系统。

为什么卡片版本与安装文件名可能不同?

卡片显示应用级版本,安装入口对应具体文件,两者可能因清单更新节奏而不同。需要确认实际安装版本时,以安装完成后客户端的关于页面为准;已有配置时,升级前先备份。

下载客户端