Verge Rev 升级失败:报错原因与手动升级

Clash Verge Rev 升级不成功时,多半是点“更新”后弹出 error sending request for url,或者下载进度条停在那里半天不动。先看报错里的地址是不是指向软件安装包;要是确认问题出在下载这一步,直接去项目发布页手动下载对应的安装包升级即可,不用反复点更新按钮。

当前版本还能正常用的话,没必要急着卸载。先把新安装包下载好、把配置备份一份,再退出旧程序去装。下载报错、安装报错、升完仍显示旧版本,这是三种不同的情况,要分别应对。

Clash Verge Rev 更新失败:几种类型和排查顺序

更新弹窗能弹出来,仅仅说明客户端拿到了新版本的信息。安装包还得另外下载,下完才会启动安装程序。看报错里的地址和弹窗内容,就能判断是哪一环出了问题。

现象 先看什么 接下来做什么
报错地址以 update.json 或 update-proxy.json 结尾 获取版本信息的请求没有成功 去发布页核对一下,有没有适用于你的新版本
地址里带 releases/download,结尾是 .exe 或 .app.tar.gz 软件的更新包没有下载下来 改用浏览器去下载发布页上的安装包
进度条走得很慢,或者干脆不动 下载连接是否还在传输数据 拿浏览器下载做对比,不行再换个网络试
提示 invalid Zip archive 收到的文件没法按预期当作压缩包读取 重新获取正确的安装包,别继续用那个有问题的文件
装完了,打开仍是旧版本 实际启动的程序在哪个路径,是不是装了不止一份 核对真正被打开的位置

报错出现在订阅卡片上、地址是机场提供的订阅接口时,处理办法见订阅请求失败与超时排查。同样的报错文字可能来自不同的请求,区分的依据是你在哪里操作,以及完整的请求地址。

error sending request for url:更新包没下载成功

截图里的下载地址先经 download.clashverge.dev 中转,最终指向 GitHub 上的 macOS 更新包。error sending request for url 的含义是请求没有成功,具体缘由还得结合网络连接和日志来判断。此时压根还没进入安装环节,订阅配置不必去动。

先开代理,改用浏览器下载安装包

下载之前,选好一个可用节点并打开系统代理,确认浏览器能访问 GitHub、能把安装包下下来。还没有订阅的话,可以参考Clash 机场推荐。

  1. 客户端保持运行,选一个可用的节点,再打开“系统代理”。只是选中节点,并不代表浏览器已经走了代理;浏览器里另外装了代理插件的话,还要核对插件的设置。
  2. 确认浏览器可以通过代理打开 GitHub,然后访问Clash Verge Rev 正式版发布页。
  3. 展开 Assets,挑出与你的系统和处理器架构相符的安装包。
  4. 要确认下载真能完成,别只看发布页打得开。GitHub 的页面和附件下载可能走的不是同一个域名。

浏览器可以下完:拿下好的安装包手动升级就行。浏览器和客户端用的下载地址、代理路径可能不一样,所以浏览器下得了,不代表应用内更新也能成功。

浏览器也下载失败:先把报错记下来,再换一个可用节点或换个网络对比。每次只变动一个条件,看能否完整下载;DNS、代理模式、系统设置不要同时改,否则分不清是哪一项起了作用。

切到全局模式管用吗?

全局模式只管进入代理的那些请求。更新请求若没有走代理,或者下载服务本身有故障,切换模式也不一定有效。可以临时切一次再试,测完把原来的模式切回来。几种模式的区别,见规则、全局与直连模式说明。

手动升级:下对安装包,再替换程序

手动升级跳过的是应用内的下载环节。下载期间让旧版客户端和系统代理保持开启,等安装包完整落到电脑上,再退出客户端去安装。当前客户端若已经连不上网,就借助其他能用的代理工具,或者找一个能访问 GitHub 的网络来下载,不要先把现有版本卸了。

第一步:备份配置

把订阅地址、自定义规则、脚本以及需要保留的设置各存一份副本。当前版本带有备份功能的话,先生成备份并检查一遍;同时记下程序版本和原先的安装位置。订阅链接里含有访问凭据,别出现在公开的截图、评论或问题反馈里。

第二步:挑出适合你设备的文件

设备 一般该选的安装包
Windows,Intel / AMD 64 位处理器 x64 的 setup.exe
Windows,ARM 设备 arm64 的 setup.exe
Mac,Apple M 系列芯片 aarch64 的 .dmg
Mac,Intel 芯片 x64 的 .dmg

Source code 不能选;自动更新使用的 .app.tar.gz 和签名文件,也不是给人手动安装用的。Windows 可到“设置 → 系统 → 系统信息”里查看系统类型,Mac 则在“关于本机”里看芯片或处理器型号。系统的最低要求,以项目安装说明为准。

第三步:退掉旧程序,再安装

Windows:通过托盘菜单把客户端退出,光关窗口是不够的。然后运行下好的安装程序,核对目标目录与原安装位置一致,照安装向导走完。如果提示程序仍在运行,先看看是不是另有窗口或会话在用它,不要直接删安装目录。

macOS:先退出正在运行的客户端,打开下好的 DMG,把应用拖进“应用程序”目录;遇到同名应用的提示就选择替换。之后从“应用程序”里启动,别继续运行磁盘映像中的那份。

原本是通过包管理器装的,或者用的是便携目录,那就沿用当初的升级方式,以免装出多份副本。首次安装的步骤见客户端下载与安装教程。

第四步:核对版本和原有配置

到设置里的版本信息处,确认已经变成刚装的这个版本,再检查订阅、规则和连接。订阅或规则没有显示的话,先确认启动的是新装的程序,以及用户目录、配置目录与升级前一致。确认无误再恢复备份,原始的备份文件也留着。

下载卡住,或者提示压缩包有问题

下载进度长时间停着,就观察传输速度还有没有变化,并拿浏览器下载同一个发布版本做对比。浏览器顺利下完的话,走手动升级就好,不用守着应用内的重复下载。

invalid Zip archive: Could not find central directory end 说明收到的内容无法按预期的 ZIP 格式读出来。下载不完整,或者服务器返回的东西根本不是压缩包,都可能引发这个报错。应当先重新下载,不要一上来就怪到磁盘故障头上。

不要靠改扩展名来硬装。回到发布页重新取适用的安装包,并确认下载已经完成。发布页若给出校验值,可以用它核对文件是否一致;下载没问题、安装依然失败,就留好完整的错误信息,转去排查安装环节。

装完了,为什么打开的还是旧版本

先查启动入口。桌面快捷方式、任务栏固定项和原安装目录,可能各指向不同的副本。Windows 上看快捷方式的目标路径,与新安装位置比对;Mac 上则要看打开的是不是仍是下载目录或已挂载映像里的旧应用。

有些旧版本升级时认不出原先的安装目录,结果新旧版本分装在两个位置。确认存在多份安装之后,先备份配置,再清掉多余的副本,重新装一遍最新版。

仍然解决不了,要准备哪些信息

提交反馈前,请先写下当前版本、目标版本、操作系统与处理器架构,再补上这几项:

  • 失败发生在哪一步:检查版本、下载、安装,还是启动后版本没变。
  • 完整的报错文字和对应截图,特别是请求地址里的域名与文件名。
  • 浏览器能不能下载发布页上的安装包,换了网络以后结果有没有变化。
  • 与失败时间对得上的应用日志片段。

截图和日志发出去之前,请遮住订阅链接里的 token、账号、密钥,还有带个人信息的路径。这些内容与软件更新故障没有关系,用不着给别人看。