安装包与系统要求

V2Ray 客户端下载

先选操作系统,再核对处理器架构。桌面使用 v2rayN,安卓优先选择 v2rayNG;已有 v2fly 内核配置时,可考虑 v2flyNG。

Windows 安装包

Windows 系统要求

检查项选择依据
系统类型在「设置 → 系统 → 关于」核对系统类型。本页提供 x64 安装包。
运行环境若启动提示缺少 .NET 桌面运行库,按提示核对所需版本与架构。
安装权限解压后再运行安装程序。受管理设备需要遵循组织的软件安装策略。

不要直接从压缩包预览窗口运行程序。先解压到有写入权限的目录,再启动安装程序;这样也便于在出错时区分解压问题、运行库缺失和安装权限不足。

对照桌面版与 WPF 版 →

安装包选择与更新

平台、架构和包格式分别决定能不能安装。原有配置能不能继续使用,需要另行确认。

按系统类型确认架构

不要只看设备型号或购买年份。台式机和笔记本可以从系统信息中确认架构;安卓设备则要看当前系统支持的应用架构。同一设备更换系统后,能够安装的包也可能变化。代他人下载时,应以目标设备的信息为准,而不是下载文件所用设备的信息。

amd64 和 x86_64 都指常见的 x86 64 位架构,前者不限定处理器品牌。arm64 与 aarch64 则指 ARM 64 位架构。认清这些命名后,再检查页面上所选的平台,避免把架构相同但系统不同的安装包混用。

换客户端前备份配置

备份时区分订阅、手动配置和客户端自身的设置。订阅重新导入后通常能恢复由订阅提供的条目,但不会自动找回本地添加的条目、路由规则或监听端口。若旧客户端支持导出,先导出需要保留的信息,并记录当前代理模式和活动配置。

订阅地址可能含有访问凭据,只保存在受控位置,不要连同截图公开发送。若只是换界面或换构建,先停止旧实例,再启动新实例,避免两个客户端占用相同端口或反复修改系统代理。确认基本连接和必要规则都正常后,再处理旧程序和备份。

识别安装与启动错误

安装程序不能打开、安装完成后应用退出、应用能打开但不能连接,是三个不同阶段的问题。第一类先看文件是否下载完整、包格式是否匹配,以及系统给出的权限提示。第二类先记录运行库、目录权限或程序启动日志,不必在此时重新导入订阅。

在旧系统上,处理器架构正确也可能遇到系统接口或依赖版本不匹配。把操作系统版本、选择的构建和报错原文放在一起排查,比反复换包更有效。安卓出现「应用未安装」时,还应区分签名不匹配、系统要求不符和存储空间不足。

查看启动闪退排查 →

更新时一次只改一项

已有可用配置时,先在升级前记录正在使用的客户端、代理模式和本地端口。升级后先用原配置测试。若同时更换内核、订阅和路由,即使发现异常,也难以确定由哪一项变化引起。

需要回到旧客户端时,先确认新版是否改写了配置格式,再考虑使用升级前的备份。不要把新旧程序随意解压进同一个目录。对于由软件包管理器安装的程序,区分卸载程序与删除用户配置,避免清理旧包时误删仍要使用的规则。

安装后首次配置

先确认应用可启动,再导入配置并验证连接。下载、安装和接管流量是三个独立步骤。

导入订阅并检查活动配置

打开客户端后,先为已有订阅建立分组,再执行一次手动更新。看到条目并不代表已经连接:还要选择活动配置,并通过客户端日志确认核心进程启动成功。已有手动配置时,把它和订阅条目分开管理,之后更新订阅不易混淆。

遇到订阅更新失败,先区分地址无法访问和内容无法识别。不需要为了测试而打开多个客户端:同时启用可能改变系统代理或 VPN 状态,反而使错误难以复现。需要求助时,可记录失败阶段和脱敏后的报错,不必提供完整订阅地址。

查看订阅导入步骤 →

验证应用是否使用代理

桌面端可先用遵循系统代理设置的浏览器验证。终端工具和部分桌面应用可能不读取系统代理,需要分别检查它们采用的代理地址。若更新后本地端口改变,曾手动填写代理地址的应用也要同步调整,不能只看客户端窗口中的连接状态。

安卓端在首次连接时留意系统 VPN 授权提示。若设备已有其他 VPN 会话,先明确需要保留哪一项,再切换客户端。只有当应用接管范围确实不够时,再阅读手册中的 TUN 与路由章节;初次验证不必同时改变接管方式和分流规则。

查看路由与分流说明 →

下载常见问题

安装包选择、覆盖更新与版本识别。

Windows 桌面版和 WPF 版需要同时安装吗?

不需要。首次安装可选桌面版;已有经典界面使用习惯时可选 WPF 版。切换前先退出旧客户端并备份配置。

安卓通用版能解决所有安装失败吗?

不能。通用版可减少架构选错的情况,但不会改变最低系统要求,也不能解决签名冲突或设备管理策略限制。

安装新版前需要卸载旧版吗?

先确认是否支持覆盖更新,并备份配置。安卓若提示签名不匹配,不要直接卸载;卸载可能清除应用数据。

安装包里是否包含订阅?

安装包提供客户端程序。安装后需要单独导入已有订阅或配置,客户端安装成功不代表代理连接已经建立。

卡片版本与下载文件名里的版本不同怎么办?

卡片显示应用级版本,下载项对应具体构建。两者不一致时,记录实际文件名,并在安装后通过客户端的关于页面确认运行版本。