客户端更新后用不了
升级完客户端就连不上、报配置错误、界面也怪怪的?新版本有可能改了配置格式,或者提高了对内核的要求。这里讲怎么排查,以及怎么稳妥地退回旧版本。
简单讲,升级后失灵就走三步:第一步,重新导入服务商现在提供的订阅,因为本地保存的老格式配置可能已经过时;第二步,把 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 重新打开,触发服务安装,再按提示授权就好。