mihomo 报错与 Clash Meta 内核崩溃：2026 启动失败错误信息对照
优选科普
内核层的报错和「节点连不上」是两类问题：这里说的是内核压根没跑起来，或者跑起来又自己退出了。 节点列表打不开、客户端提示「内核启动失败」「Core terminated」，都属于这一类。
⚠️ 先分清一件事，这决定你该读哪篇：
- 启动就失败 / 启动几秒后退出 / 报配置错误 → 本文。
- 能正常跑几小时到几天，然后内存越涨越高、路由器断流、被系统杀掉 → 那是内存与 GC 的问题，见 Clash Meta (mihomo) 内存泄漏导致路由器断流的 GC 参数调优，本文不重复。
- 软路由上 sing-box / Xray 被 OOM → 见 软路由内存不足下的 sing-box 与 Xray。
第一件事：找到日志，别靠猜
内核报错几乎总会写在日志里，而绝大多数人是在没看日志的情况下开始瞎试的。
- Clash Verge / Verge Rev：界面里有「日志」标签页。启动失败时把日志级别调到
debug再复现一次。 - 命令行直接跑：这是最有效的诊断方式——绕过客户端封装，错误直接打在屏幕上。
mihomo -d /你的配置目录 -f /你的配置文件.yaml- OpenWrt / ShellCrash：
logread | grep -i mihomo，或看客户端指定的日志文件。 - Windows 客户端：日志通常在客户端安装目录或
%APPDATA%下对应的文件夹里。
拿到那一行报错，再往下对照。
常见报错对照
yaml: line N: did not find expected key / mapping values are not allowed
配置文件的 YAML 语法错了。 最高频的三个原因：
- 用了 Tab 缩进。 YAML 只允许空格。编辑器里开「显示空白字符」看一眼。
- 缩进层级不对。 少两个空格或多两个空格，含义就变了。
- 值里有特殊字符没加引号。 密码或 UUID 里含
:、#、@、{、以*或&开头，都必须用引号包起来。#尤其阴险——YAML 里它是注释起始符，password: abc#123会被解析成abc。
⚠️ 报错行号未必是真正出错的行。 YAML 解析器往往是在下一个结构处才发现前面不对，所以要往上看几行。
unsupported / unsupported proxy type / unknown field
配置里用了当前内核不认识的字段或协议类型。 两个方向：
- 内核版本太老，配置太新。 机场下发的配置用了 Hysteria2、TUIC v5、Reality 这类较新协议，而你的内核是旧版本。升级内核。
- 配置是给旧版 Clash 写的，内核是 mihomo。 mihomo 在演进过程中改过一些字段名，老配置直接喂进去会报未知字段。这种情况下最稳的做法是从机场重新拉一份订阅（机场会按你的客户端 UA 下发对应格式），而不是手工改字段。
⚠️ 本站不列「字段改名对照表」，因为这些字段名随内核版本变化，写死一份对照表很快就会过期并误导人。正确做法是查你所用内核版本的官方配置文档，或直接重新拉订阅。
listen tcp 127.0.0.1:7890: bind: address already in use
端口被占用了。 要么是上一个内核实例没退干净，要么是另一个代理软件在用这个端口。
# Windows
Get-NetTCPConnection -LocalPort 7890 | Select-Object OwningProcess
Get-Process -Id <上面的 PID># macOS / Linux
lsof -i :7890处理：把占用的进程结束掉，或者在配置里换端口（mixed-port、port、socks-port、external-controller 的 9090 都可能撞）。
注意：不少客户端点窗口的关闭按钮只是最小化到托盘，内核还在跑。检查托盘和任务管理器。
operation not permitted / TUN 相关的权限错误
TUN 模式需要特权。 创建虚拟网卡是系统级操作。
- Windows：客户端必须以管理员身份运行。另外 TUN 依赖 Wintun 驱动，报错提到
wintun.dll加载失败时，需要客户端把驱动放到正确位置。 - Linux：要 root，或给二进制授权：
sudo setcap cap_net_admin+ep /usr/bin/mihomo - macOS：需要授权网络扩展，系统设置里会弹出确认。
GEO 数据库相关：can't initial GeoIP / geosite.dat 下载失败
内核启动时要加载 GeoIP / GeoSite 数据库来做地理和域名分流。它默认会去网上下载——而下载源本身可能不通，于是内核卡在启动阶段或直接退出。
这是个和订阅更新一样的死锁：要下载数据库需要网络，而网络需要内核先起来。
处理办法：
- 手动下载数据库文件，放到配置目录。 文件名通常是
geoip.dat/geoip.metadb/geosite.dat，具体取决于内核版本要哪些。 - 在配置里指定一个能访问的下载源（
geox-url）。 - 如果你不需要 GEO 分流，直接关掉：配置里
geodata-mode相关项按你的内核文档关闭。
启动正常，但几秒后自己退出、没有明显报错
优先怀疑这几个：
- 配置里引用了不存在的策略组或节点名。 比如规则里写了
PROXY但策略组叫Proxy——大小写敏感。 - 策略组循环引用。 A 组里包含 B 组，B 组里又包含 A 组。
- 订阅里的节点名含特殊字符（emoji、引号、换行），在被规则引用时对不上。
把日志级别调到 debug，退出前的最后几行通常直接指出是哪个名字找不到。
一个通用的收窄办法：用最小配置启动
如果对着报错也定位不出来，用一份极简配置试试——它能立刻区分「内核本身有问题」和「你的配置有问题」：
mixed-port: 7890
mode: rule
log-level: debug
proxies: []
proxy-groups: []
rules:
- MATCH,DIRECT- 最小配置能起来 → 内核和环境都没问题，是你那份完整配置的内容错了。往里逐段加回去，加到哪段崩就是那段。
- 最小配置也起不来 → 内核二进制、权限、端口或系统环境的问题，跟配置内容无关。
换客户端不等于换内核
这一点经常被搞混：Clash Verge、ClashX、FlClash 这些是图形界面，它们底下跑的往往是同一个 mihomo 内核。所以：
- 换客户端不能解决内核层的报错（配置错误、端口占用、权限不足）。
- 能解决的只是「这个界面自己有 bug」这一类问题——概率不高。
真正该做的是升级内核版本，或者按上面的对照修配置。
内核起来了但节点全红，见 Clash 节点全部变红的六层排查。节点绿了但打不开网页，见 节点是绿的却无法上网。想了解协议本身，可以看 Trojan 协议原理 和 Shadowsocks 协议原理。
顶级 IPLC 专线网络加速体验
稳定、高速、无忧解锁全球流媒体。采用企业级 SLA 在线率保证，是晚高峰 4K 观影和重度外网工作者的绝佳首选。
- 纯净内网专线高峰期不降速
- 原生 IP 节点秒开 Netflix 4K
- 无设备限制全家共享网络
- 特惠高配小包极致性价比之王