安装与迁移 · Clash 技术博客

Clash Verge Rev 更新卡住:下载与取消修复

Clash Verge Rev 更新下载停住、点取消仍在下载?区分下载与安装,核对 v2.5.8 的缓存、来源切换与取消修复,导出备份后正常升级,并验证配置和失败回退。

  • Clash Verge Rev
  • 内置更新
  • 下载缓存
  • 取消更新
  • v2.5.8
本文目录

进度条停住后,最需要知道的是程序仍在下载,还是安装器已经接手。安装开始后应等待结果;仍在下载时,保留原配置和可用连接,再决定取消或使用官方安装包,才能完成一次可核对的升级。

更新下载卡住时,进度、缓存与取消分别意味着什么

先保存进度、等待时间、首条错误和取消后的变化。安装器已启动时等待结果,不强制结束;仍在下载时,按后面的官方安装包流程处理。

截至本次核对,官方最新正式版为 v2.5.8。旧版更新器必须先完成这次升级才能使用新实现,反复打开旧窗口不会把修复加载进去。无需通过降级来测试下一次更新。

v2.5.8 修了什么,哪些现象仍需单独排查?

官方 issue #8172 报告的是 Windows 上从 v2.5.6 升级至 v2.5.7:已下载内容再次下载,速度很慢,取消未真正停止。维护者随后链接了缓存复用和下载取消的修复提交,2026 年 10 月 9 日发布的 v2.5.8 已列出这三项修复。不能据此断言所有更新卡住都属于同一缺陷。

按阶段判断

观察到的现象该版本的处理方式应做的核对
完整下载后又从头开始v2.5.8 先核对缓存版本与当前更新版本,并验证安装包签名;合格才复用。缓存不匹配或校验失败仍会重新下载,不能把每次重下都当成缺陷。
下载很慢或进度停住下载按更新清单地址、其他镜像与 GitHub 顺序尝试;首轮会判断过慢来源并切换。来源切换是恢复尝试,不保证每个网络都能访问,也不保证短时间内完成。
点取消只关闭窗口v2.5.8 在准备和下载阶段调用真正的取消处理。安装已经开始后,不能承诺还能中止;不要反复点更新或强行结束安装器。
安装失败或服务异常已经超出上述下载修复范围。保存安装错误与完整版本,按对应平台的官方安装和服务说明处理。

固定版本源码中,首轮下载每 30 秒检查进展,新增不足 1 MiB 时会切换来源;所有来源首轮失败后的第二轮只按停顿判断。因此不能宣传“30 秒内自动修好”,也不能把 GitHub 始终优先当成实现规则。

新版也要区分取消按钮与关闭窗口:取消会调用后端处理,单纯关闭窗口只是隐藏界面。只在准备或下载阶段取消,等状态结束再重试;安装阶段不要把关窗当成中止。

保留下载停住时的进度、已等待时间、首条错误与是否仍在安装。浏览器能打开项目首页,只能说明网页可达,不能证明对应安装包以及下载中跳转到的地址可达。不要为抢进度同时启动多个更新窗口。

保留独立备份,用官方安装包完成升级

先在设置的 Verge 高级设置中进入备份设置,创建本地备份,再从查看记录导出升级前的记录,存到应用数据目录之外。只创建记录不等于已保存独立副本;外部配置文件与自管资源也要另存。备份及订阅凭据只留在自己的设备上。

安装器已经启动时,等待结果并保留错误,不强制结束。若仍在下载且取消无效,先确认手头已有官方安装包;需要通过当前代理获取时,保持可用连接完成下载。随后正常停止系统代理或 TUN,完整退出应用,再按官方方式手动升级。

保留配置完成一次升级

  1. 确认版本与系统架构

    记录完整应用版本、系统、架构、当前 Profile 和代理模式,保留已导出的升级前备份。安装器已打开时应等待结果。v2.5.8 的系统日志出现 Installing update v,也是进入安装处理的线索;旧版不保证有此提示,没有它不能认定仍在下载。

  2. 从官方 Release 选择安装包

    打开文末 v2.5.8 官方 Release,按官方安装说明选择匹配系统与架构的包;macOS 还要核对最低系统要求。不要把本站历史备份版本当成这次修复版本。

  3. 按官方方式安装并重新启动

    下载完成后按对应平台的正常安装方式升级,保留现有数据与安装位置;包管理器用户沿用官方对应渠道,不混用便携版或多个安装目录。不要运行临时缓存文件 pending_update.bin、绕过签名校验,或清空应用配置来促使更新。

  4. 在应用内核对并验证原配置

    启动后确认真正运行的版本为 v2.5.8,核对原 Profile、节点、规则和代理模式,并用新的 HTTPS 请求验证正常访问。正常退出重启后再检查一次。

若官方安装包下载本身也失败,保留当前可用客户端和备份,检查该下载链路的首条网络错误,再按官方说明处理。安装包已取得而安装失败时停止重复下载,转查安装阶段;不要以关闭安全软件或来路不明的包绕过问题。

怎样确认恢复,怎样验证下一次真正的更新?

本次升级验收

  • 应用内完整版本为 v2.5.8,原配置能正常加载
  • 节点、规则和代理模式正确,新的 HTTPS 请求成功

当前显示“已是最新版本”只能证明版本核对,不能证明已经实测缓存复用或下载取消。等下一次确有官方更新时,再观察一次更新:匹配且签名有效的完整缓存应可复用;确需取消时只在准备或下载阶段操作,并确认状态结束后再试。

来源切换、签名失败或版本不匹配导致重新下载时,先保存错误与阶段,不能仅凭进度归零判定缓存复用失效。安装成功后正常重启并核对新版本,窗口关闭本身不是升级完成证据。

配置恢复与更新故障反馈

配置确实损坏时先保留当前数据,再在备份记录中导入此前导出的升级前文件,选择对应记录执行恢复备份;导入只加入记录,不会自动应用。恢复后重新核对订阅、规则、代理模式和真实请求。

优先恢复已验证可用的配置。若必须回退应用版本,先核对官方安全公告和备份兼容性,不假定新版生成的备份可供旧版读取,也不要照抄 issue 中的旧版本建议。没有可用配置时正常停止代理接管,检查普通网络;必须经代理的业务暂缓访问。

仍异常时向上游提供完整版本、系统与架构、目标更新版本、卡住阶段、等待时间、取消后的状态、首条错误以及正常退出重启结果。遮盖订阅令牌、私人地址和备份内容,不附安装包或凭据;分别说明自己观察到的下载与安装结果,不把未复测的修复写成已验证。

参考资料