客户端更新后用不了

升级完客户端就连不上、报配置错误、界面也怪怪的?新版本有可能改了配置格式,或者提高了对内核的要求。这里讲怎么排查,以及怎么稳妥地退回旧版本。

简单讲,升级后失灵就走三步:第一步,重新导入服务商现在提供的订阅,因为本地保存的老格式配置可能已经过时;第二步,把 TUN 或服务模式重新开一遍,系统服务在升级时常会失效;第三步,仍不行,再退回上一个稳定版本。前两步能解决大部分问题,回退只是兜底,不要当成首选。

看日志确定是哪一类

好在升级之后出的问题,翻一下日志的第一行就大致能归类。Clash Verge Rev 到「日志」页看,sing-box 则要看它启动时输出的内容:

日志关键字说明去哪一步
unknown field / decode error / yaml: unmarshal配置字段改过,旧的配置读不懂重新导入订阅
core exited / 内核已退出内核与界面版本对不上,或者内核文件被杀毒软件拦了内核无法启动
service not installed / 服务未安装 / TUN 弹回系统服务要重新安装重新打开 TUN
一点日志都没有,界面白屏缺少运行库Windows 客户端打不开

第一步:重导订阅,别沿用旧配置

新版本调整字段格式时,服务商通常已经同步更新了订阅模板,而你本地缓存的还是旧格式。办法是:删掉原来的订阅条目,到服务商的用户中心重新复制链接,导入一份全新的。自己改过的规则,请用「订阅覆写」来保存,不要直接去改订阅文件,这也是升级后自定义内容丢失的常见原因。

sing-box 对配置写法的要求尤其严格,大版本更新时几乎都会调整字段;具体错误可查阅 sing-box 配置启动故障。

第二步:重装系统服务

Windows 版 Clash Verge Rev 的 TUN 靠的是「服务模式」,macOS 靠的是系统扩展,软件一升级,这两样往往一起失灵。进入设置,先关再开 TUN,客户端会重新装一遍并要求授权;在 Windows 上,请用管理员身份启动客户端后再操作,授权过程详见TUN 模式开启失败。

第三步:回退到上一个稳定版

旧版安装包只认项目自己的发布页:Clash Verge Rev、sing-box 都挂在各自的 GitHub Releases 上,下载中心给出的直链定期同步自那里。覆盖着装就行,你的数据存在配置目录,不会被清掉:

  • Windows:%APPDATA%\io.github.clash-verge-rev.clash-verge-rev\
  • macOS:~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/

动手之前先把配置目录拷一份留底,万一新旧版本的配置格式不兼容,还可以还原。还有个小窍门:系统刚推出大版本的前几周,各客户端通常没适配完,这时候按兵不动反而最省事。

其他客户端的类似故障可查网络故障排查 · 系统及客户端;需要从官方渠道获取客户端时,可参阅客户端使用指南。

常见问题

升级后配置报错,怎么处理?

多半是新版本改了配置字段的格式。不要沿用旧的本地配置,重新导入服务商当前提供的订阅,一般模板已经适配了新版。

可以回到旧版本吗?

没问题。去项目的发布页拿上一个稳定版,覆盖安装,先把可用状态恢复,再等新版把问题修好。旧版本别从来源不明的网站下载。

升级后 TUN 或服务失效,怎么办?

新版可能要求重新安装系统服务。到设置里把 TUN 重新打开,触发服务安装,再按提示授权就好。