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

直接答案
内核启动失败几乎都能从日志的第一行错误定位: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 的代理设置不会跟着变,需要手动改成新端口。
第二类:配置文件不合法
内核在启动时会完整解析配置,任何一个不认识的字段、缩进错误或不支持的协议类型都会让启动失败。订阅更新后突然启动失败、换回上一份订阅就正常,基本可以确定是这一类。
排查步骤:
- 在日志中找到
line N或proxy N的提示,N 是出错的行号或节点序号。 - 在客户端「订阅 → 编辑文件」中跳到对应位置,常见问题是新协议字段(如
hysteria2、tuic、reality-opts)被旧内核拒绝。 - 确认客户端使用的是 Mihomo 内核而不是老 Clash 内核。Clash Verge Rev 在「设置 → Clash 内核」中切换。
- 如果是你自己写的覆写脚本或 Merge 配置引入了错误,先停用全部覆写再启动,逐个启用定位。
- 以上都正常但依然报错,复制错误行发给机场客服,多数情况是订阅模板的字段写法问题。
一个能通过解析的最小配置长这样,可以用来验证内核本身是否正常:
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 内核就会以权限错误退出。
处理:
- 关闭 TUN,确认内核能正常启动,锁定问题在权限。
- 在「设置 → 服务模式」中点击安装或重装服务,Windows 会弹出 UAC 提示,macOS 要求输入密码。
- 安装后重启客户端再开 TUN。
- 仍失败时,检查是否有其他 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 模式 · 服务安装与权限说明
