跳到主要内容

Clash / Mihomo 内核启动失败怎么办:端口占用、配置错误与权限

Clash Verge Rev、Mihomo Party 提示内核启动失败、Core exited 或 bind: address already in use,原因集中在端口被占用、订阅配置字段不合法、TUN 服务未授权与安全软件拦截四类。本文给出错误信息对照表、逐步排查与 Windows / macOS 两组命令。

发布于 约 4 分钟 · 1647 字入门
Clash / Mihomo 内核启动失败排查

直接答案

内核启动失败几乎都能从日志的第一行错误定位:bind: address already in use 是端口被占用,改混合端口或关掉占用程序;yaml: unmarshal 或 proxy x: unsupported 是订阅配置字段不合法,更新订阅或切换到 Mihomo 内核;需要管理员权限或服务未安装是 TUN 相关的权限问题,安装系统服务后重启;安全软件删除内核文件时加入白名单。按日志而不是凭感觉排查,五分钟内能解决大多数情况。

Clash Verge Rev 或 Mihomo Party 启动后提示「内核启动失败」「Core exited」,或者界面正常但所有节点测不出延迟,根源都在内核进程没有跑起来。这类问题和线路、机场无关,换订阅、换机场都不会好,正确做法是打开客户端日志,看内核退出前的第一条错误信息。本文把内核启动失败的原因归为四类,每类都给出日志关键词、判断方法与处理步骤,最后附 Windows 与 macOS 两组命令。

四类原因与日志关键词

原因日志关键词典型表现处理
端口被占用bind: address already in use / Only one usage of each socket address上次没退干净、开了多个代理软件时出现改混合端口或结束占用进程
配置不合法yaml: unmarshal errors / proxy 0: unsupported type / line N: ...更新订阅后突然失败,回退旧订阅正常切换 Mihomo 内核、修正字段或联系机场
权限不足permission denied / 需要管理员权限 / service not installed开启 TUN 后失败,关 TUN 正常安装系统服务,以管理员身份运行
内核文件缺失或被拦截core not found / exit status 0xc0000005 / 进程立即退出安全软件刚扫描过,内核文件消失加入白名单后重新安装客户端

日志位置:Clash Verge Rev 在「设置 → 日志」或「设置 → 打开核心目录」里的 .log 文件;Mihomo Party 在「日志」页面,级别调到 debug 可以看到更多细节。

第一类:端口占用

混合端口(默认 7890 或 7897)、SOCKS 端口、控制器端口(9090 或 9097)任意一个被占用,内核都会直接退出。常见占用者是上一次没完全退出的内核、同时运行的 v2rayN 或 sing-box、以及某些下载工具。

先查谁占了端口,再决定是结束它还是改端口:

# Windows PowerShell:查看占用 7890 的进程
Get-NetTCPConnection -LocalPort 7890 -State Listen | Select-Object OwningProcess
Get-Process -Id <上一步得到的 PID>
# macOS / Linux:查看占用 7890 的进程
lsof -nP -iTCP:7890 -sTCP:LISTEN

如果占用者是残留的 verge-mihomo 或 mihomo 进程,直接结束它再启动客户端;如果是另一个需要同时运行的软件,在客户端「设置 → 混合端口」改成 7891 之类的空闲端口,并同步修改浏览器或终端里引用的端口。

ℹ️ 说明

改端口后系统代理设置会自动更新,但终端里手动导出的 HTTPS_PROXY 变量、IDE 的代理设置不会跟着变,需要手动改成新端口。

第二类:配置文件不合法

内核在启动时会完整解析配置,任何一个不认识的字段、缩进错误或不支持的协议类型都会让启动失败。订阅更新后突然启动失败、换回上一份订阅就正常,基本可以确定是这一类。

排查步骤:

  1. 在日志中找到 line N 或 proxy N 的提示,N 是出错的行号或节点序号。
  2. 在客户端「订阅 → 编辑文件」中跳到对应位置,常见问题是新协议字段(如 hysteria2、tuic、reality-opts)被旧内核拒绝。
  3. 确认客户端使用的是 Mihomo 内核而不是老 Clash 内核。Clash Verge Rev 在「设置 → Clash 内核」中切换。
  4. 如果是你自己写的覆写脚本或 Merge 配置引入了错误,先停用全部覆写再启动,逐个启用定位。
  5. 以上都正常但依然报错,复制错误行发给机场客服,多数情况是订阅模板的字段写法问题。

一个能通过解析的最小配置长这样,可以用来验证内核本身是否正常:

mixed-port: 7890
mode: rule
log-level: info
proxies: []
proxy-groups:
  - name: PROXY
    type: select
    proxies: [DIRECT]
rules:
  - MATCH,PROXY

把这份配置作为本地配置导入并启动,内核能跑说明程序没问题,再回头检查订阅内容。订阅本身的更新与格式问题见订阅更新失败怎么办。

第三类:权限与系统服务

TUN 模式需要创建虚拟网卡,这是系统级操作。Clash Verge Rev 通过安装系统服务来获得权限,Mihomo Party 也有类似的「安装服务」步骤。没有服务或服务损坏时,开启 TUN 内核就会以权限错误退出。

处理:

  1. 关闭 TUN,确认内核能正常启动,锁定问题在权限。
  2. 在「设置 → 服务模式」中点击安装或重装服务,Windows 会弹出 UAC 提示,macOS 要求输入密码。
  3. 安装后重启客户端再开 TUN。
  4. 仍失败时,检查是否有其他 VPN 软件的驱动残留,它们会占用虚拟网卡名称。

TUN 开启后能启动但没有网络,是另一类问题,见 TUN 模式不生效或开启后无网络怎么办。

第四类:内核文件被安全软件处理

Windows 上部分安全软件会把内核可执行文件当作可疑程序隔离,表现为启动时报「找不到内核」或进程瞬间退出且日志为空。到安全软件的隔离区找回文件,并把客户端安装目录加入白名单,然后重新安装一次客户端以恢复完整文件。

⚠️ 注意

不要为了绕过拦截而关闭整个安全软件。把客户端目录加入白名单即可,内核文件来源以客户端官方发布渠道为准,不要从论坛或网盘下载单独的内核替换。

预防与习惯

  • 退出客户端时用托盘菜单的「退出」而不是直接关窗口,避免内核残留占用端口。
  • 更新订阅前记一下当前能用的版本,Clash Verge Rev 支持多份订阅并存,出问题可以快速切回。
  • 新协议节点较多的机场,统一使用 Mihomo 内核,不要再用老 Clash 内核。
  • 覆写脚本改动后先在本地配置上测试,再应用到订阅。
  • 客户端与内核定期更新,但不要在重要工作前更新。

Clash Verge Rev 的完整设置见 Clash Verge Rev 使用教程,Windows 平台的其他客户端问题在客户端问题排查分类。如果你准备换一家对 Clash 系客户端支持更完整的机场,可以从机场排行中按客户端兼容性筛选。

总结

  • 先看客户端日志的首条错误,内核失败的四类原因在日志里都有明确关键词
  • 端口占用最常见,改一个混合端口比找占用程序更快
  • 配置错误多来自订阅里的新协议字段,用 Mihomo 内核或让机场更新订阅
  • TUN 相关的权限问题要安装系统服务,重装客户端不一定能解决

常见问题

Q机场是否支持 Clash Verge?

主流机场都提供 Clash 格式订阅,Clash Verge Rev 可以直接导入。需要注意的是,如果订阅里用了 Hysteria2、TUIC 等新协议,必须使用 Verge Rev 内置的 Mihomo 内核才能解析,老版本 Clash 内核会直接报配置错误。

Q机场是否支持 Mihomo?

Mihomo 是 Clash Meta 的延续,兼容全部 Clash 格式订阅并支持更多协议。机场在用户中心提供的 Clash 或 Clash Meta 订阅链接都可以在 Mihomo 内核上使用,Mihomo Party 与 Clash Verge Rev 默认就是这个内核。

QClash 导入订阅失败怎么办?

先区分是订阅下载失败还是内核解析失败。前者看订阅链接与网络,后者看客户端日志里的 yaml 错误行号。导入失败但内核能启动,多半是链接问题;导入成功但内核启动失败,多半是配置内容不被当前内核支持。

Q机场是否支持 Clash Meta?

支持。Clash Meta 与 Mihomo 是同一套内核的前后名称,Clash Meta for Android 和桌面端的 Mihomo 内核使用相同的订阅格式。机场标注支持 Clash 的订阅都能用,标注 Clash Meta 专用的订阅则不能在老 Clash 内核上使用。

Q机场节点全红怎么办?

节点全红首先要确认内核是否真的在运行,内核启动失败时所有节点都无法测延迟,看起来就像全红。客户端日志显示内核正常,再去检查订阅是否过期、本地网络是否正常,这时才是线路问题。

参考资料与信息来源

  • Mihomo 文档:配置文件与启动参数 · 配置字段要求与内核日志含义
  • Clash Verge Rev 文档:系统服务与 TUN 模式 · 服务安装与权限说明