安装包索引GUI

V2Ray 客户端下载

桌面选 v2rayN,安卓按配置选 v2rayNG 或 v2flyNG。先匹配系统,再核对架构和包格式。

  1. 选择操作系统
  2. 核对系统架构
  3. 确认包格式或界面版本

按系统选择安装包

选项卡按安装目标切换。替另一台设备下载时,以那台设备的系统信息为准。

Windows 安装包

v2rayN

v2rayN

首推 7.24.1

桌面版采用新一代跨平台界面,适合首次安装或需要在不同桌面系统间保持操作一致的用户。经典 WPF 版保留熟悉的 Windows 布局,适合继续沿用原来的界面和操作习惯。两者是可单独使用的发行包,选一个即可。

两个入口外层都是 ZIP。先完整解压到可写目录,再按包内文件运行安装程序。不要在压缩包预览窗口里直接双击。如果从旧版迁移,先退出托盘里的旧客户端,再安装和测试,避免两个实例同时占用本地端口。

系统要求

检查项适用条件
系统与架构建议使用仍受支持的 64 位 Windows 10 或 11 环境;本页两包均为 x64。
识别方式查看「设置 → 系统 → 关于」的系统类型,确认处理器架构和系统位数。
运行环境若出现运行库提示,按提示核对所需组件、版本和位数。

安装程序能打开,不代表客户端已经启动。首次运行时检查托盘和主窗口,确认可以进入设置后再导入配置。

安装、升级与回退检查

先确定故障发生在哪一步:下载、安装、启动,还是连接。前一步已经通过,就在下一步查,不要把所有异常都归到安装包。

01 · 安装前

记下系统信息与旧版来源

给自己或同事装机时,先记下目标设备的系统版本、架构和所选文件名。用同一台电脑给多台设备准备安装包,很容易从下载记录里点错架构相近的文件。把文件名与目标设备一一对应,尤其要区分桌面版与经典版、芯片架构,以及同一客户端的两个移动包。

新装只需准备安装包和自己的配置来源。升级则要先打开旧客户端,记下版本、界面版本、安装渠道及自定义数据位置。分开记录订阅、手工节点、路由和本地端口。只记住订阅地址,通常不足以复原整套设置。配置和导出文件可能含敏感信息,应留在自己可控的位置,不要附在公开的排障截图中。

如果电脑由组织集中管理,先弄清账号是否有安装权限、应用应该装在哪个目录,以及代理设置是否由组织统一下发。权限不足时重复解压或更换同架构的包,通常不能解除安装限制。把完整报错交给设备管理员,比在不同目录里反复尝试更容易定位问题。

02 · 安装时

按报错区分架构、依赖与覆盖冲突

安装器提示应用与设备不兼容时,先回到系统信息复核架构。架构正确但仍提示不支持,再查系统版本或包所需的运行组件。软件包管理器若明确列出依赖及版本范围,就以这条信息为线索,而不是笼统地把问题归为「系统太旧」。

如果下载完成后压缩工具报告无法打开,先确认浏览器下载任务已经结束,并核对打开的是本次下载的文件,而不是同名旧副本或未下载完的临时文件。外层归档应先完整解压;磁盘映像应先打开再复制应用;软件包应交给系统安装器。文件扩展名不能靠手动改名来转换格式。

同一应用覆盖失败,先比较新旧安装渠道和版本。报错指向签名冲突时,换成通用包也无济于事;报错指向版本回退时,检查是否误点了较早的包。涉及卸载时,先确认数据已导出且有办法恢复。卸载应用可能同时删除本地数据,不宜拿它作为第一步测试。

03 · 首次启动

先确认界面启动,再测试配置

安装后从本次安装位置打开客户端,确认能进入主界面并查看版本信息。桌面窗口关闭后,程序可能仍驻留在托盘或菜单栏;再次打开前先检查是否已有实例。若程序一开就退出,记录报错以及退出前执行的操作,不要先把旧配置全部导入再排查。

界面可用后,按订阅导入步骤添加配置。先选择一条已知可用的配置,确认客户端能够启动连接。能看到配置列表只说明导入成功,不能证明网络流量已按预期经过代理。连接无法启动时先看客户端日志;能启动却打不开网页,再对照无法上网排查。

如果只有个别应用表现不同,先记录哪些应用受影响,以及是否开启了系统代理。部分应用有自己的代理设置,不一定读取系统选项。保持其他条件不变,用同一应用对比连接前后的结果,再查路由分流。在连接层和路由层同时改设置,会让结果难以解释。

04 · 升级

保留可恢复的数据,再替换旧版

有备份功能时优先使用客户端提供的备份或导出入口。把生成的文件存到程序目录之外,记下创建时使用的版本、包含哪些配置,以及哪些设置需要手工重建。跨客户端迁移时,不要把整份应用数据直接覆盖到新客户端目录;不同客户端的备份结构与字段未必相同。

切换前退出旧程序,停用由它设置的系统代理,再启动新版。恢复后先检查配置是否完整、原来的自定义端口是否保留、开机启动项是否仍指向旧位置。测试通过前不要立即清理旧目录。若两套程序必须暂时保留,也不要同时启动并让它们写入同一份配置。

回退时,优先用与旧版本匹配的备份。新版写过的数据未必能被旧版读回。回退完成后先恢复一条配置测试,再恢复分组与自定义路由。如果旧版和新版在同一网络都出现相同症状,继续反复换包的价值不高,应转到连接、订阅或系统代理的对应章节查原因。

下载与安装常见问题

Windows 首次安装选桌面版还是 WPF 版?

首次安装可先选桌面版。已有经典 WPF 版且希望沿用原有界面和操作习惯,可以继续选 WPF 版。两个入口都对应 x64 包,先在系统信息里核对系统类型。

在 macOS 上怎么区分 Apple Silicon 和 Intel?

打开苹果菜单里的「关于本机」。「芯片」显示 Apple M 系列时选 Apple Silicon;「处理器」显示 Intel 时选 Intel。换机器后重新核对,不要照抄旧机器的下载记录。

Android 的通用包能解决签名冲突吗?

不能。通用包用于覆盖多种处理器架构,签名冲突属于覆盖安装条件不满足。优先沿用原安装渠道;必须迁移时,先确认配置可恢复,再卸载旧应用并重装。

Linux 按包格式选,还是按处理器架构选?

两项都要匹配。先按发行版选择 deb 或 rpm,再按当前系统的 x86_64 或 arm64 架构选择对应入口。能识别文件格式不代表依赖一定满足,还需核对发行版版本。

配置已经导入,安装新版前还需要备份吗?

需要。订阅可以重新拉取的条目,不等于手工节点、分组和路由设置也能恢复。升级前先使用客户端提供的备份或导出功能,并把备份保存在旧程序目录之外。

为什么客户端发布版本和安装包文件名不同?

卡片版本取自清单的应用版本字段,安装包名称来自各入口的文件记录,两者可能暂时不同。需要指定版本时,先核对入口对应的文件名;若文件名无法确认版本或两处信息不一致,不要据此做覆盖升级。