本文目录
进度条停住后,最需要知道的是程序仍在下载,还是安装器已经接手。安装开始后应等待结果;仍在下载时,保留原配置和可用连接,再决定取消或使用官方安装包,才能完成一次可核对的升级。
更新下载卡住时,进度、缓存与取消分别意味着什么
先保存进度、等待时间、首条错误和取消后的变化。安装器已启动时等待结果,不强制结束;仍在下载时,按后面的官方安装包流程处理。
截至本次核对,官方最新正式版为 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,完整退出应用,再按官方方式手动升级。
保留配置完成一次升级
确认版本与系统架构
记录完整应用版本、系统、架构、当前 Profile 和代理模式,保留已导出的升级前备份。安装器已打开时应等待结果。v2.5.8 的系统日志出现 Installing update v,也是进入安装处理的线索;旧版不保证有此提示,没有它不能认定仍在下载。
从官方 Release 选择安装包
打开文末 v2.5.8 官方 Release,按官方安装说明选择匹配系统与架构的包;macOS 还要核对最低系统要求。不要把本站历史备份版本当成这次修复版本。
按官方方式安装并重新启动
下载完成后按对应平台的正常安装方式升级,保留现有数据与安装位置;包管理器用户沿用官方对应渠道,不混用便携版或多个安装目录。不要运行临时缓存文件 pending_update.bin、绕过签名校验,或清空应用配置来促使更新。
在应用内核对并验证原配置
启动后确认真正运行的版本为 v2.5.8,核对原 Profile、节点、规则和代理模式,并用新的 HTTPS 请求验证正常访问。正常退出重启后再检查一次。
若官方安装包下载本身也失败,保留当前可用客户端和备份,检查该下载链路的首条网络错误,再按官方说明处理。安装包已取得而安装失败时停止重复下载,转查安装阶段;不要以关闭安全软件或来路不明的包绕过问题。
怎样确认恢复,怎样验证下一次真正的更新?
本次升级验收
- 应用内完整版本为 v2.5.8,原配置能正常加载
- 节点、规则和代理模式正确,新的 HTTPS 请求成功
当前显示“已是最新版本”只能证明版本核对,不能证明已经实测缓存复用或下载取消。等下一次确有官方更新时,再观察一次更新:匹配且签名有效的完整缓存应可复用;确需取消时只在准备或下载阶段操作,并确认状态结束后再试。
来源切换、签名失败或版本不匹配导致重新下载时,先保存错误与阶段,不能仅凭进度归零判定缓存复用失效。安装成功后正常重启并核对新版本,窗口关闭本身不是升级完成证据。
配置恢复与更新故障反馈
配置确实损坏时先保留当前数据,再在备份记录中导入此前导出的升级前文件,选择对应记录执行恢复备份;导入只加入记录,不会自动应用。恢复后重新核对订阅、规则、代理模式和真实请求。
优先恢复已验证可用的配置。若必须回退应用版本,先核对官方安全公告和备份兼容性,不假定新版生成的备份可供旧版读取,也不要照抄 issue 中的旧版本建议。没有可用配置时正常停止代理接管,检查普通网络;必须经代理的业务暂缓访问。
仍异常时向上游提供完整版本、系统与架构、目标更新版本、卡住阶段、等待时间、取消后的状态、首条错误以及正常退出重启结果。遮盖订阅令牌、私人地址和备份内容,不附安装包或凭据;分别说明自己观察到的下载与安装结果,不把未复测的修复写成已验证。
参考资料
- Clash Verge RevClash Verge Rev v2.5.8 缓存、慢速来源与取消下载修复
- Clash Verge Rev重复下载、下载慢与取消无效的报告及维护者回复 #8172
- Clash Verge Revv2.5.8 更新缓存校验、来源切换与取消阶段实现
- Clash Verge Rev DocsClash Verge Rev 官方安装与系统要求
- Clash Verge Revv2.5.8 备份归档包含的配置文件
- Clash Verge Rev回退前应核对的 Windows 服务安全公告
- Clash Verge Revv2.5.8 本地备份导入、恢复与配置重新加载
- Clash Verge Revv2.5.8 备份记录导出、恢复确认与自动重启
