客户端安装包

V2Ray 客户端下载

先选目标设备的操作系统,再核对处理器架构与安装包格式。

Windows 安装包

v2rayN

首推 清单版本 7.24.1

桌面版(Desktop)采用新一代跨平台界面。经典 WPF 版沿用稳定的 Windows 经典界面,适合已有使用习惯或按旧教程查找菜单的用户。两版的主要区别是界面与菜单布局,不需要为了切换界面而更换订阅。

两个入口下载的都是包含安装程序的 ZIP。先将压缩包完整解压到本地文件夹,再运行其中的安装程序。升级前先退出正在运行的客户端,包括通知区域里仍驻留的实例,避免让新旧实例同时争用本地监听端口。

系统要求

核对项适用条件
系统与架构64 位 Windows,x64 处理器
查看位置设置 → 系统 → 关于 → 系统类型
包格式ZIP,解压后运行安装程序

「64 位操作系统」与「基于 x64 的处理器」应一起核对。本页两个入口都是 x64 包;更换界面版型不会改变架构要求。

选包、安装与升级

安装包由目标设备决定;安装后的连接方式由客户端配置决定。按顺序检查,避免把两个阶段的问题混在一起。

  1. 01 下载前

    在目标设备上查架构

    替另一台设备下载时,查那台设备的系统信息,不要按当前浏览器所在设备选择。尤其要分清处理器能运行的指令集与系统实际支持的应用架构:硬件是六十四位,并不保证当前系统能安装所有六十四位应用。

    同一客户端的不同架构包不能凭文件大小判断适用性。通用包更大,通常是因为包含多套组件,并不表示协议更多。先确认架构,再比较同一平台提供的界面或包格式。

  2. 02 安装时

    先读取安装器的第一条错误

    文件无法打开、安装器拒绝安装、客户端启动后退出,是三个不同阶段。先区分文件是压缩包、磁盘映像还是可交给系统安装器的软件包,再记录第一条明确的错误提示。它通常比最后一行「安装失败」更有用。

    如果提示系统版本或依赖过低,核对当前系统是否满足要求;如果提示应用已存在或不能覆盖,先确定是旧实例仍在运行、版本降级,还是移动端安装包与现有应用的来源不同。不要先卸载旧版再查原因。

  3. 03 升级前

    保留能恢复的配置

    有自定义路由、手动添加的节点或改过本地端口时,先通过客户端支持的方式备份配置。订阅地址通常只能用于重新获取该订阅中的节点,不一定能恢复单独添加的节点、本地路由规则或当前选中的配置。

    备用文件放在可控位置,不把订阅地址或导出的配置发到公开讨论区。升级后先确认应用能独立启动、原有节点仍在,再检查路由和代理状态。换界面版型或换客户端时,也不要假定设置会自动迁移。

安装后的首次检查

确认能正常打开客户端后,再导入已有的订阅或单个节点。第一次测试时只选择一个已知可用的配置,保留其协议和传输参数,一次只调整一个设置。这样遇到错误时,可以判断故障是发生在配置导入、客户端接管流量,还是远端连接阶段。

有节点列表不等于连接已建立

导入成功说明客户端收到了节点配置,不代表远端服务可用,也不代表当前应用已经把流量交给客户端。先确认当前选中的节点与预期一致,再看客户端日志是否出现连接请求。如果订阅能更新,但业务连接失败,订阅地址和节点服务器是两条不同连接,应分开排查。

区分代理入口和路由规则

系统代理把支持该设置的应用流量引向本地代理入口,并不保证每个应用都读取同一份代理设置。路由规则则决定已进入客户端的连接走哪个出站。如果一个应用能连、另一个不行,先查后者有没有发出本地代理请求,不必立刻重装客户端或改成全局路由。

在 Android 上首次通过客户端启动连接时,系统通常会请求建立 VPN 连接的授权。如果已有另一个应用占用这类连接,先确认当前生效的是哪个应用;客户端里选中的节点并不能替代系统层面的授权与连接状态。

重装前按报错定位

启动日志如果指向本地端口占用,先检查是否有旧实例或其他应用正在监听同一个端口。确需改端口时,同时更新手工填写过的应用代理设置。若日志已经显示请求到达客户端,再按报错核对远端地址、协议、传输和路由,不要同时更换安装包、节点和分流规则。

完整的导入与验证流程见入门指南;本地监听冲突可对照端口占用排查,要理解配置项之间的关系可查阅JSON 手册。

下载与安装常见问题

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

首次安装可选采用新一代跨平台界面的桌面版。已有使用习惯,或需要按经典界面的截图查找菜单,可选经典 WPF 版。两款入口均为 x64,界面选择不会改变安装包的处理器架构。

如何判断 Mac 应该下载哪一个 DMG?

打开苹果菜单中的「关于本机」。看到 Apple M 系列芯片就选 Apple Silicon(arm64),看到 Intel 处理器就选 Intel(x64)。给另一台 Mac 下载时,以那台机器显示的信息为准。

Android 通用版和 arm64 版有什么区别?

arm64 版面向支持 arm64-v8a 的 Android 系统。通用版包含多种架构的组件,通常更大。架构不明确可先选通用版,但通用版并不代表支持所有 Android 版本,也不能解决应用签名冲突。

Linux 安装包如何对应发行版?

Debian 系优先查 DEB,采用 RPM 的发行版再查 RPM;同时核对系统架构和发行版兼容性。本页 RPM 文件名带有 el10,不能仅凭同为 RPM 格式就推断其他发行版或较早系统可以安装。

为什么卡片上的清单版本和文件名里的版本不同?

清单版本是客户端条目记录的版本,下载入口则按各架构单独映射到具体文件,这两处的值可能不同。要确认下载的是哪个包,请看实际保存的文件名;要确认正在运行的版本,请看客户端的版本信息。

安装完成后为什么还需要导入订阅或节点?

安装包提供客户端程序。建立代理连接前,还要导入已有的订阅或节点配置,选中可用节点,再按设备设置选择流量接入方式。安装成功、配置导入成功和连接成功是三个不同的状态。