手账正文

节点能连但规则集下载失败?Mihomo 地址、格式与更新排查

机场节点能连接,客户端却提示规则集下载失败,先确认失败的是哪一个规则来源,再区分下载、解析和加载阶段。节点参数与远程规则是不同内容,不能因为节点延迟正常,就认定规则更新也正常。

本文以 Mihomo 的 rule-providers 为例,适合远程规则更新报错、部分分流行为异常的情况。是否已经有可用的本地规则,需要查看实际加载状态,不能仅凭一次更新失败就判断全部规则失效。

作者:小六|资料核对日期:2026年10月6日

先找规则集名称,不要先删整个配置

规则集用于提供匹配内容,节点集合用于提供连接服务器的信息,两者名称可能相似,作用却不同。先从错误记录找到具体名称、时间和失败阶段。

Mihomo 的规则集合支持远程 HTTP、本地文件和内联内容等来源,字段说明见官方规则集合文档。本地文件来源没有同样的远程下载过程,应先确认类型。

记录当前是否还有规则被正常加载,以及哪些目标的行为发生了变化。不要为了消除一条更新提示,就直接删除所有本地缓存;还没确认问题前,先保留当前配置和必要的本地备份。

第一项:下载地址返回了什么?

对于远程规则,核对维护方给出的原始内容地址。仓库里展示文件的网页,与直接提供文件内容的地址,可能返回不同内容;能在浏览器里看到文件页面,不等于客户端拿到了规则原文。

失败线索 优先核对
连接超时或无法解析名称 获取规则时的路径与名称解析
服务端返回错误 地址是否变化,以及维护方的返回说明
下载完成后解析报错 是否拿到网页或不匹配的规则格式
无法保存或读取文件 本地路径、权限及文件状态

表格用于选择方向,不证明具体原因。若需要查看返回内容,只在本机判断它是规则、网页还是提示信息;求助时提供错误类型,不发送包含令牌的完整地址和请求头。

第二项:下载规则使用哪个出口?

规则集合的 proxy 字段指定下载、更新采用的代理。它描述的是获取规则的路径,不能只看客户端首页当前选中的节点来猜。字段含义见前面的官方文档。

例如,规则更新配置采用直连时,更换某个应用策略组的节点,不一定改变这次下载路径。反过来,若下载明确依赖某个策略,还要确认它在当前生效配置里存在且可用。

先按日志核对实际请求,再保持地址不变做一次受控对照。不要同时换 DNS、换规则来源和换节点,否则成功后仍不知道修复的是哪一环。

当问题涉及名称解析,可结合本站的系统、浏览器与客户端 DNS 区别继续查,不把任意公共 DNS 地址当成通用答案。

第三项:format 与 behavior 是否都匹配?

这两个字段回答不同问题:format 描述文件表示形式,behavior 描述其中的匹配内容。不能只改文件扩展名,也不能只看到 YAML 就认为所有规则内容都通用。

官方规则集合内容说明分别给出域名、IP 网段与经典规则的内容例子。域名集合和带规则类型的列表,不应未经核对就互换。

当前文档列出的文件格式有 YAML、文本与 MRS;MRS 对应的行为类型支持域名与 IP 网段,不应直接按经典规则来源处理。具体组合仍应与维护方文件说明及实际内核版本对应。

解析错误指向某一行时,先检查该来源的结构,不要删掉那一行后就认定整个规则集已经修好。删掉不认识的内容,可能改变原本需要的匹配范围。

第四项:本地路径是否适合当前客户端?

官方文档要求规则来源的路径不能重复,并对保存位置设有工作目录范围限制。换客户端、移动配置或复制别人模板后,应核对当前程序的实际数据目录,而不是沿用他人的绝对路径。

如果报错来自读取或写入,优先通过客户端支持的配置入口确认位置和文件权限。不要先放宽所有路径限制,也不要把工作目录里的未知文件全部清掉。

每次只处理已确认的规则来源,保留原值和错误记录。这样即使需要恢复,也能知道改动影响了哪一份内容。

更新成功后,还需要看规则是否被引用

规则文件下载成功,只能说明获取过程完成;还应检查它是否加载,以及路由规则是否引用了预期名称。策略与规则顺序不正确,也可能让实际连接没有采用这份规则。

Mihomo 的 API 文档区分规则集合信息、路由规则和活跃连接。图形面板显示哪些信息,以所用客户端为准;排查时应把加载情况与新请求的命中记录对应起来。

用一个确定应被匹配的目标建立新连接,核对命中与出口。不要只凭首页网页能打开,就判定所有分流正常,也不要凭一项更新提示就替整个机场下结论。

自动更新间隔,需要越短越好吗?

不需要。规则集合的 interval 是更新时间间隔,单位为秒;它不是节点延迟检测的超时时间。频繁点击刷新也不能修正地址、格式或权限错误。

优先查具体失败原因,再按来源说明设置合理更新频率。个人规则如何随订阅保留,可另看本站的自定义规则与扩展配置指南。

想交流规则集更新失败,可以提供内核版本、来源类型、失败阶段及脱敏后的错误记录:Telegram 联系我

搜索文章

正在加载搜索…