v2rayN 可以通过程序内的「检查更新」获取更新,也可以前往项目发布页获取文件,走手动更新这条路径。客户端、内核和 Geo 文件是不同的更新对象,不能把其中一项的更新结果当成全部完成。

截至 2026-11-08,最新正式版为 7.25.6。下面涉及的菜单、更新项目和下载规则,均以截至 2026-11-08 核对的该版本为准。

更新窗口里的项目分别管什么

截至 2026-11-08,更新窗口按程序条件列出客户端、内核项目,并另列 GeoFiles。它不是固定对所有安装方式显示相同内容。

项目对应的更新对象显示范围
v2rayN客户端自身受安装方式判断限制
XrayXray 内核受进程架构及系统条件限制
mihomomihomo 内核受进程架构及系统条件限制
sing-boxsing-box 内核受进程架构及系统条件限制
GeoFilesGeo 文件单独追加的更新项

这张表的适用条件是:截至 2026-11-08,源码对非 x86 进程列出上述客户端与内核项目,其中客户端还要通过安装方式判断;Windows 系统主版本低于 10 时,不列入表中的三个内核。

所以,看到「有更新」时,要先看它对应哪一行。客户端有更新,与某个内核有更新,是两件事。想分清内核之间的关系,可看了解 Xray、sing-box 与 mihomo 的选择关系。

从哪里打开,两个勾选项有什么区别

截至 2026-11-08,Avalonia 界面的入口位于「帮助」下,名称为「检查更新」。更新界面还使用「仅检查」「检查并更新」「有更新」这些文字。

客户端更新流程包含获取版本、下载和执行更新。内核更新成功后,提示会说明更新完成并正在重启服务;这条提示对应内核更新流程,不能据此认定客户端也已更新。

截至 2026-11-08,相关设置中有两个需要分清的选项:

  • 「检查 Pre-Release」影响检查的版本渠道。
  • 「通过代理更新」涉及更新时是否使用代理。

按截至 2026-11-08 核对的逻辑,正式版检查通过 GitHub 的 releases/latest 跳转取得版本标签。启用「检查 Pre-Release」,或内核存在最高版本限制时,检查逻辑会改为读取仓库的 Releases 列表。

截至 2026-11-08,「通过代理更新」已在 7.25.6 加入。它与是否检查预发布版本是不同设置,不能互相代替。

自更新下载的是哪种包

截至 2026-11-08,客户端自更新的下载模板只使用 zip,没有为 deb、rpm、dmg 设置对应条目,也没有带 -desktop 或 -86 的下载模板。

这解释了一个容易混淆的地方:发布页提供哪些文件,与程序内自更新会请求哪些文件,并不是同一份清单。发布页存在某种安装包,不代表自更新流程也会下载它。

Linux 还有一处差异。截至 2026-11-08,源码为 riscv64、loong64 写有 zip 下载模板,但 7.25.6 发布资产只列出这两类架构的 deb、rpm,没有对应 zip。前者来自更新源码,后者来自发布页,不能用模板推定文件已经发布。

要核对实际可获取的文件,可打开项目发布页,或阅读按发布页辨认版本与文件名。

Linux 安装版为何不能更新客户端

截至 2026-11-08,程序会检查 Linux 程序目录。目录位于 /opt/v2rayN、/usr/lib/v2rayN 或 /usr/share/v2rayN 时,会被识别为安装包安装,客户端自身更新不受支持。

这里限制的是 v2rayN 自身更新。内核项目另有判断条件,不能把客户端自更新受限理解成所有更新项都受限。

截至 2026-11-08,同一判断在 Windows、macOS 上返回非安装包状态。这是程序内部的判断方式;Wiki 对文件类型仍区分便携版与安装版。Linux 文件类型的区别,可看区分 Linux 安装版与便携版。

手动更新能确认到哪一步

手动获取文件的入口是项目发布页。打开后,应按自己的平台和文件类型查看发布资产。

截至 2026-11-08,Wiki 将 zip 归为便携版:数据放在所在文件夹内,多份副本可以各自保存数据。非 zip 则归为安装版,数据使用系统规定的用户文件位置。两类文件的数据位置不同,处理更新时不能直接套用同一套文件替换办法。

关于手动覆盖哪些文件、如何保留配置、更新前是否关闭程序,以及 -desktop、-86 用户通过程序内更新后的具体结果,官方没有说明。

可参照项目 Wiki 的发布文件介绍确认包类型;具体覆盖步骤没有明确依据时,不应把自行推断写成操作步骤。

Geo 文件需要跟着一起更新吗

截至 2026-11-08,GeoFiles 在更新窗口中单列。相关设置包含 Geo 文件自动更新的间隔,单位为小时,也有 Geo 文件来源和 sing-box ruleset 文件来源的可选设置。

因此,客户端、内核、Geo 文件应分别查看更新状态。更新了客户端,不能据此判断另外两类也已完成更新。

若需要查看更新过程的记录,项目 Faq 将客户端更新问题对应的日志位置指向 guiLogs。

第三方整理,与项目方无关。