Clash Verge Rev 常见错误排查大全

代理软件出问题时，绝大多数报错都能归进有限的几类：端口被占用、配置文件写错、订阅拉不下来、系统代理残留、TUN 启动失败。真正麻烦的从来不是修复动作本身，而是先判断故障发生在哪一层。

判断的依据只有一个——日志。界面上的红色提示往往只是结果，日志里才有导致失败的那一行。本文按错误类型整理 Clash Verge Rev 与 mihomo 内核的常见故障，每类给出典型症状、原因和处理步骤，你可以对照着往下排。

排查第一步：找到日志并读懂它

图形客户端都有独立的日志页面（Clash Verge Rev 的日志与连接面板在主界面侧栏，位置随版本可能略有差异），把级别调到 info 或 debug 会输出更多细节。直接运行 mihomo 内核时，日志会打印在终端里：

mihomo -d /etc/mihomo

看日志时先回答一个问题：内核到底起来没有。启动阶段就退出，属于“内核没起来”，多半是端口或配置问题；内核在跑却打不开网页，属于“起来了但不通”，请按开了代理还是上不了网的分步排查指南逐层定位。

端口被占用：address already in use

症状是启动失败，日志里出现 address already in use 或“端口已被使用”字样。原因通常是上次的进程没退干净，或另一个软件占用了同一端口（默认混合端口可在客户端设置中查看，常见为 7890 或 7897）。

Windows 上先找出占用者，再根据 PID 确认是哪个程序：

netstat -ano | findstr 7890
tasklist | findstr 12345

macOS 与 Linux 用 lsof -i :7890 同样能定位。确认是遗留进程就结束它；若另一个常驻软件确实需要这个端口，在客户端设置里换个端口更省事，记得同步更新手工填过端口的地方。

内核启动失败：九成是配置写错了

内核闪退、日志停在解析配置那一行，基本都是 YAML 语法问题。不要靠肉眼找，用内核自带的校验参数：

mihomo -t -f config.yaml

它会指出出错的行号和原因。高频错误就那么几种：缩进用了 Tab、冒号后漏了空格、从网页复制时带进中文全角冒号、同层级出现重复的键、代理组引用了不存在的节点名。逐条改完再校验一次，直到没有报错。

订阅拉取失败怎么办

订阅更新报错，或者导入后节点列表是空的，按下面的顺序排查：

1. 把订阅链接复制到浏览器打开：能返回一段配置文本说明链接有效；返回错误页或登录页则说明已失效，需到服务商用户中心重新获取。
2. 部分订阅地址本身需要代理才能访问，先用一个能连通的节点或临时切到全局再更新。
3. 返回内容格式不对（例如只是一串分享链接）时，Clash 系客户端可能无法直接解析，向服务商索取 Clash/mihomo 格式的订阅地址。

系统代理残留与 TUN 启动失败

客户端退出后系统代理没还原

另一类典型症状是：客户端已经关掉，网页却全都打不开。原因是客户端异常退出时没能还原系统代理设置，系统仍把流量指向一个已经不存在的本地端口。

处理办法是手动复位。Windows 在 设置 → 网络和 Internet → 代理 中关闭“使用代理服务器”；macOS 在 系统设置 → 网络 → 对应接口 → 详细信息 → 代理 中关闭相关项。复位后重启客户端再打开开关即可。若每次退出都残留，检查是否有安全软件在阻止客户端修改系统设置。

TUN 模式打不开的三个原因

TUN 需要在网络层创建虚拟网卡，权限门槛比系统代理高，失败原因集中在三处：

• 服务未安装：Windows 需先安装客户端的服务模式（过程中弹出管理员授权），装好后 TUN 开关才可用。
• 权限不足：macOS 与 Linux 首次开启时会请求授权，曾经拒绝过就要到系统设置里重新允许。
• 与其他网络软件冲突：VPN、加速器、虚拟网卡类工具会争抢路由表，先完全退出再试。

如果问题发生在安装阶段就被拦下（Windows 提示不安全、macOS 提示应用已损坏），那和 TUN 无关，分别参考 Windows 安全提示与误报处理 和 macOS“已损坏”提示的解决方法。

求助前先收集这些信息

把问题描述清楚，往往比对方回答更能加速解决。发问前准备好这几项：

1. 操作系统与版本，以及 CPU 架构。
2. 客户端名称与版本号，使用的内核版本。
3. 当前模式：系统代理还是 TUN，规则还是全局。
4. 报错时机：启动时、导入订阅时，还是访问网页时。
5. 一段完整日志，注意先把订阅链接、节点地址等敏感信息打码。

这五项写清楚，问题常常在别人回答之前就已经明朗。若排查后决定重装，到下载中心取回对应系统的安装包即可，订阅和配置重装后仍可重新导入。