跳转到内容
代理客户端知识库

mihomo 内核报错信息表

主题：参考 适用：通用 最后验证：2026-09-18 标记：信息说明

mihomo 内核在日志与配置报错里输出的英文原文，按场景整理。Clash Verge Rev、Clash Party、FlClash、 ClashMetaForAndroid 都以 mihomo（或其分支）为内核；每句适用哪些客户端见各行的适用范围，客户端界面是否展示、怎么展示未逐一核实。

  • 原文取自 MetaCubeX/mihomo v1.19.31 的源码，逐条人工校对，并追过调用链：只收会走到日志输出或错误返回的报错（被调用方丢弃、或触发不了的不收）。
  • 表中只收报错里固定不变的部分：动态内容在末尾时直接省略，夹在中间时用 <…> 标出（如 <名称>）。 拿整行日志来对照，包含表中那段文字即是同一条报错；冒号后面通常是更具体的原因。
  • 「尚未归类」表示还没有能处理这句报错的排错条目。一行归到某个排错条目的条件是：用户在客户端里看到这句报错的各种情况， 都落在那个条目的排查路径上，而且条目给的修复与验证在这些情况下都成立。

适用范围是怎么核的

每行标出的「已验证」，含义是：这句原文在下表「核对的内核」源码里逐字存在，并且按这个客户端运行内核的方式（独立进程或嵌入 App） 核过会走到输出它的那段代码。其中 Clash Party 2.0.2 内置哪个内核版本没有直接记录，表中的 v1.19.29 是按发版日期推断的， 它那一列的「已验证」以这个推断为前提。没有在客户端上实际触发过这些报错，也没有逐一核对界面怎么展示。

客户端核对的版本核对的内核怎么确定的
Clash Verge Rev2.5.2mihomo v1.19.29发版说明写明
Clash Party2.0.2mihomo v1.19.29（推断）发版说明未写；构建时取当时最新发版，按发版日期推断（v1.19.29 与 v1.19.30 之间只有这一个）
FlClash0.8.98作者维护的 mihomo 分支（commit 70f0570，2026-08-23）源码锁定
ClashMetaForAndroid2.11.34mihomo v1.19.31源码锁定

FlClash 与 ClashMetaForAndroid 把内核嵌在 App 里运行，按它们加载配置的方式，Parse config error 与 configuration file … is empty 这两句不会出现； 它们的 Android 版用系统的 VPN 接口建 TUN，TUN 那几句也不会出现。FlClash 配置出错时，会把原因写进一句自己的日志 config apply failed, falling back to the built-in default，冒号后面就是下面列出的原文。

读这张表之前

TUN

  • Start TUN listening error：内核通过 ReCreateTun 创建 TUN 失败时输出的总括日志，冒号后才是真正的原因。失败后内核会把记录的 TUN 启用状态设为关闭；客户端开关如何显示未核实。
  • [TUN] default interface lost by monitor：默认网卡监视器报告「当前没有默认网卡」时的记录（例如断网或切换网络的瞬间），通常不是故障本身。监视器随后报告有了默认网卡时，会输出 default interface changed by monitor。这两句记录的是网卡状态，不代表网络能否正常访问；若持续出现而网络确实正常，才值得排查。
  • Start Tun interface timeout：仅 Windows。一次 TUN 网卡创建失败、且这次失败耗时 1 秒以上时输出，冒号后是原因；耗时不足 1 秒的失败既不打这句也不重试。最多尝试三次，第三次的日志虽然仍写着 retrying，但不会再试。若最终仍失败，会接着出现 Start TUN listening error。

proxy-provider

  • initial proxy provider <名称> error：配置里某个 proxy-providers 源初始加载失败，冒号后是具体原因。只有配置里写了 proxy-providers 才会有这句；客户端界面里「导入 / 更新订阅」失败，未必对应这一句。
  • [Provider] <名称> pull error：配置里某个 proxy-providers 源自动更新失败时输出：包括按间隔的后台拉取，以及本地文件类型的源在文件变更后重新加载；冒号后是具体原因。若该源之前加载成功，本次失败不会替换已有节点，常见表现是「节点还能用但一直不更新」。
  • file must have a `proxies` field：内容解析后 proxies 为空值：例如缺少 proxies 键（订阅服务返回一段 JSON 格式的错误信息就会这样），或 proxies 的值写成了 null。YAML 解析失败时，内核会先尝试把内容当作节点链接或 base64 节点列表转换，转换成功就不会报这句。它会跟在 initial proxy provider … error: 或 [Provider] … pull error: 后面出现。
  • file doesn't have any proxy：filter 为空（未设置或为空字符串），且解析、筛选后一个节点都没剩时输出。可能是源给了空列表，也可能是 exclude-filter / exclude-type 把节点全部排除了，别只盯着订阅。filter 非空时，同样的空结果会改报 doesn't match any proxy, please check your filter。
  • doesn't match any proxy, please check your filter：filter 非空，且解析、筛选后一个节点都没剩时输出。不一定是 filter 写错：源本身为空、或 exclude-filter / exclude-type 排除了全部节点，也会报这句。依次检查原始节点列表、filter、exclude-filter、exclude-type。
  • parse proxy provider <名称> error：创建配置里某个 proxy-providers 源时失败：字段类型不对、type 不受支持、path 指到了允许的目录之外，或者内联节点（type: inline）/ 备用节点（payload）解析失败。这一步还没开始拉取远程订阅；拉取或读取订阅内容时的报错是 initial proxy provider … error。

配置

  • Parse config error：解析配置失败，冒号后是具体原因。独立运行的内核在首次启动时遇到它会退出；收到 SIGHUP 重新加载配置失败时也会打这句，但不退出。客户端通过配置接口热加载失败时，错误作为接口响应返回、不带这个前缀，客户端怎么展示未核实。
  • configuration file <路径> is empty：读取到的配置文件为 0 字节，本次配置加载失败：独立运行的内核在首次启动时会因此退出，通过配置接口按路径热加载时则返回错误。先检查客户端当前使用的配置或订阅是否真的下载成功了。
  • proxy <名称> is the duplicate name：配置的 proxies 列表里有两个节点同名。节点名与内置名称（DIRECT、REJECT、PASS 等）相同也会报这句，即使没有真正的重复。同一个 proxy-providers 源在一次解析里出现重名时，后出现的会被跳过、不报这句；多个源之间的重名不在此列。
  • rules[<序号>] [<规则>] error: proxy [<名称>] not found：某条规则最后一段指定的策略组或节点不存在。按名字精确匹配，差一个字符（包括 emoji、空格）也算不存在；策略组改名或删除后，引用它的规则就会报这句。写在子规则里时，开头是 sub-rules[<名>]。
  • proxy group[<序号>]: <组名>: '<名称>' not found：某个策略组引用了不存在的名字：proxies 里写了不存在的节点或策略组，或 use 里写了不存在的 proxy-providers——两种情况报的是同一句。按名字精确匹配，差一个字符（包括 emoji、空格）也算不存在；订阅改了节点名、而自定义策略组还写着旧名字时，就会报这句。
  • The `global-client-fingerprint` configuration is removed, please set `client-fingerprint` directly on the proxy instead：配置里还写着已废弃的 global-client-fingerprint。内核照常启动，但这项全局设置不再生效；起作用的是各节点自己的 client-fingerprint 字段。

Geo 数据

  • can't download GeoSite.dat：配置里用到了 GEOSITE 匹配（最常见的是规则），但本地没有 GeoSite.dat 或文件已损坏，内核去下载也失败了，本次配置加载因此失败：独立运行的内核在首次启动时会退出，通过配置接口热加载时返回错误，FlClash 会改用不含原配置节点的内置默认配置。默认下载地址在 GitHub，连不上 GitHub 时就会失败；冒号后是具体原因。

  • can't download GeoIP.dat：配置里用到了 GEOIP 匹配（最常见的是规则），且开了 geodata-mode，但本地没有 GeoIP.dat 或文件已损坏，内核去下载也失败了，本次配置加载因此失败：独立运行的内核在首次启动时会退出，通过配置接口热加载时返回错误，FlClash 会改用不含原配置节点的内置默认配置。默认下载地址在 GitHub，连不上 GitHub 时就会失败；冒号后是具体原因。

  • can't download MMDB：配置里用到了 GEOIP 匹配（最常见的是规则），且没开 geodata-mode，但本地没有 MMDB 或文件已损坏，内核去下载也失败了，本次配置加载因此失败：独立运行的内核在首次启动时会退出，通过配置接口热加载时返回错误，FlClash 会改用不含原配置节点的内置默认配置。默认下载地址在 GitHub，连不上 GitHub 时就会失败；冒号后是具体原因。

  • Start TUN listening error → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash · windows/macos/linux · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18）

  • [TUN] default interface lost by monitor → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash · windows/macos/linux · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18）

  • Start Tun interface timeout → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash · windows · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18）

  • initial proxy provider <名称> error → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • [Provider] <名称> pull error → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • file must have a `proxies` field → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • file doesn't have any proxy → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • doesn't match any proxy, please check your filter → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • parse proxy provider <名称> error → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • Parse config error → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18）

  • configuration file <路径> is empty → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18）

  • proxy <名称> is the duplicate name → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • rules[<序号>] [<规则>] error: proxy [<名称>] not found → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • proxy group[<序号>]: <组名>: '<名称>' not found → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • The `global-client-fingerprint` configuration is removed, please set `client-fingerprint` directly on the proxy instead → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • can't download GeoSite.dat → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • can't download GeoIP.dat → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

  • can't download MMDB → 尚未归类 ［来源 mihomo-repo］（适用 clash-verge-rev/clash-party/flclash/clash-meta-android · any · any；已验证 clash-verge-rev 2.5.2@2026-09-18，clash-party 2.0.2@2026-09-18，flclash 0.8.98@2026-09-18，clash-meta-android 2.11.34@2026-09-18）

（error-catalog，共 18 行）

相关条目

来源

最后修订：282add7 2026-09-19