客户端安装包 · 平台与架构

V2Ray 客户端下载v2rayN / v2rayNG

先选操作系统,再选处理器架构与安装格式。

桌面平台使用 v2rayN;Android 优先选择采用 Xray 内核的 v2rayNG,需要 V2Fly 内核时选择 v2flyNG。三款客户端均为免费开源软件,安装后还需导入有效订阅或节点配置。

安装包、客户端与订阅

安装包提供程序,订阅提供连接参数。

下载前确认设备信息;安装后添加订阅分组,更新节点列表,再设置路由与代理模式。不要把订阅地址填进下载按钮,也不要把安装包地址当成节点导入。客户端版本、内核能力和节点参数需要相互匹配。

按平台下载

选择当前设备,查看对应客户端和系统要求。

安装包链接会读取当前发布清单;页面中的版本信息仅用于识别客户端,实际文件名以下载入口为准。

v2rayN · Windows

首推7.24.1

Desktop 是新一代跨平台 UI,适合首次安装和希望保持桌面操作一致的用户;WPF 是经典稳定版,保留熟悉的 Windows 窗口操作。先按界面习惯选择,不需要为了导入同一条订阅同时安装两版。

桌面版 Desktop · x64

下载 Desktop 安装包

新一代跨平台界面。首次使用可从此入口开始,下载 ZIP 后先完整解压,再运行其中的安装程序。

经典 WPF 版 · x64

下载 WPF 安装包

经典 Windows 界面。适合沿用已有操作习惯;如果从旧版迁移,先备份订阅分组与自定义规则。

Windows x64图形界面管理订阅与节点路由与系统代理设置

Windows 系统要求与安装检查

检查项选择条件确认位置或处理方式
处理器与系统本页两个入口均为 x64 包打开设置 → 系统 → 系统信息,查看系统类型;其他架构不要直接套用本页 x64 包
系统版本优先在仍获系统更新的 Windows 10 / 11 环境使用具体最低要求以当前发行说明和安装程序检测为准,旧系统可能缺少所需接口
运行依赖取决于当前包是否自带所需运行环境若提示缺少 .NET 桌面运行库,按错误提示安装对应主版本与 x64 架构
写入与权限配置目录可写;普通连接先使用常规权限TUN 或服务功能可能需要额外权限,不应把全部启动问题都归因于权限不足

下载完成后,在资源管理器中打开保存目录,使用“全部解压缩”,不要直接从压缩包内部启动程序。运行安装程序时留意目标位置;若要保留旧版以便回退,应避免混用两个版本的配置目录。安装结束后先打开主窗口,确认程序能正常读取设置,再导入订阅。

遇到打开即退出,先看系统提示和客户端日志。缺少运行库、配置文件无法读取、目录写入被阻止是不同问题,处理路径也不同。Windows 的系统代理与 TUN 不是同一开关,第一次连接建议先使用系统代理验证节点,再按应用覆盖范围决定是否启用 TUN。

安装后的配置顺序

先确认程序能启动,再处理订阅、路由和连接验证。

添加订阅与更新节点

在 v2rayN 中进入“订阅分组设置”,新增分组,填写备注与“可选地址 (URL)”,保存后执行订阅更新。分组名称只是本地分类,不会改变服务端账户。订阅地址中的参数需要完整保留,删掉查询参数可能导致更新失败。

在 v2rayNG 中通过订阅分组设置添加地址,再更新订阅;如果拿到的是单个分享链接,应使用相应导入入口,而不是把它当成订阅地址。节点出现在列表中只说明配置已载入,是否能连接还要继续测试。

查看订阅导入路径

选择模式与验证连接

选中节点后,先使用能够理解的路由配置。系统代理主要影响遵循系统设置的应用;TUN 接管范围更广,但涉及额外权限、路由和 DNS 行为。首次配置不要同时更换内核、DNS 与规则,否则出现问题时难以确定原因。

连接后检查客户端日志,并测试实际访问。延迟数字只能反映特定测试方式下的结果,不等同于下载速度或全部应用的可用性。若部分地址异常,先定位到节点、DNS 或分流规则,再调整对应设置。

查看分流设置说明

下载与安装常见问题

按安装阶段定位问题,不把配置错误当成安装包问题。

Windows 应该下载 Desktop 还是 WPF?

首次安装可先选 Desktop,它采用新一代跨平台界面;已经习惯经典窗口操作的用户可选 WPF。两种入口都是 x64 安装包,订阅和节点参数仍需按服务端配置填写。切换界面前先备份配置,不要让两个实例同时接管系统代理。

Android 应该选 arm64 还是通用版?

2015 年后的主流手机通常优先选择 arm64,但最终取决于系统支持的应用架构。确认设备为 64 位系统时选择 arm64;架构不明确或提示安装包不兼容时可尝试通用版。通用版包含多种架构,包体通常更大。

macOS 怎样区分 Apple Silicon 与 Intel?

打开苹果菜单中的关于本机,查看芯片或处理器字段。显示 Apple M 系列芯片时选择 Apple Silicon;显示 Intel 处理器时选择 Intel。不要根据系统版本、机身外观或购买年份推断架构。

Linux 应该选择 deb 还是 rpm?

按发行版的包管理体系选择:Debian、Ubuntu 及相关发行版通常使用 deb,Fedora、RHEL 及相关发行版通常使用 rpm。还需要匹配 x64 或 arm64;包格式相同也不代表所有发行版版本都满足运行依赖。

安装客户端后为什么还没有可用节点?

客户端负责读取配置和建立连接,安装包不包含个人订阅或节点。准备有效订阅地址或分享链接,在订阅分组设置中添加地址并更新,再选择节点。订阅地址可能包含访问凭据,不要在公开截图或日志中展示。

更新客户端前需要保留哪些内容?

先使用客户端提供的备份或导出功能保留配置,记录订阅分组、路由模式、DNS 设置和自定义规则,再退出旧实例。升级后先确认配置能被读取,再测试订阅更新与实际连接。备份可能包含敏感参数,应保存在受控位置。