跳到主内容
机场YYDS
✦ 专栏深度解析 上手教程 文 / jichangyyds

Clash rule-provider 的 mrs、yaml、text 格式区别

mihomo 的 rule-providers 用 format 字段指定规则集文件格式,默认 yaml。这篇讲清三种格式的文件长什么样、mrs 只支持 domain 和 ipcidr 这条限制、怎么用 convert-ruleset 转换,以及 behavior 填错的表现。

发布:2026 年 11 月 11 日 ⏱ 约 2 分钟读完
本文目录(6 节 · 约 2 分钟) +
  1. 01 先分清 format 和 behavior
  2. 02 三种格式长什么样
  3. 03 什么时候用哪种
  4. 04 规则集的三种来源:http、file、inline
  5. 05 写配置时容易错的几处
  6. 06 常见问题

mihomo 的规则集(rule-providers)有三种文件格式:yaml 把规则写在 payload: 下面的列表里,text 每行一条,mrs 是由前两种转换出来的文件。默认是 yaml。选格式时最要紧的一条限制是:mrs 只支持 domain 和 ipcidr 两种 behavior,带规则类型前缀的 classical 规则集不能用 mrs。

先分清 format 和 behavior

规则集里有两个字段经常被混在一起:

  • format:文件本身用什么格式存,可选 yaml、text、mrs。
  • behavior:文件里装的是哪一类规则,可选 domain、ipcidr、classical。

mihomo 文档的原话是,behavior 要按文件的实际格式填写。也就是说,这两项都得和文件内容对上:下载了一个纯域名列表,behavior 就填 domain;文件是带 DOMAIN-SUFFIX, 这类前缀的混合规则,就填 classical。

三种格式长什么样

yaml

在 payload: 下面逐条列出。以纯域名规则集为例:

payload:
  - '.blogger.com'
  - '*.*.microsoft.com'
  - 'books.itunes.apple.com'

classical 类型的 yaml,每一条前面要带规则类型:

payload:
  - DOMAIN-SUFFIX,google.com
  - DOMAIN-KEYWORD,google
  - IP-CIDR,127.0.0.0/8
  - GEOIP,CN

text

不要 payload:,每行一条,可以用 # 写注释:

# comment
.blogger.com
*.*.microsoft.com
books.itunes.apple.com

以上写法示例来自 Clash 知识库对规则集的说明。

mrs

mrs 文件不是手写的,而是用 mihomo 自带的命令从 yaml 或 text 转出来。文档给的命令格式是:

mihomo convert-ruleset domain/ipcidr yaml/text XXX.yaml XXX.mrs

第一个参数是 behavior,只能是 domain 或 ipcidr;第二个参数是源文件格式;后面依次是源文件和输出文件。官方没有说明 mrs 在体积和加载速度上和另外两种差多少,这里不做比较。

什么时候用哪种

你的规则集可选格式
纯域名列表yaml、text、mrs 都行
纯 IP 段列表yaml、text、mrs 都行
混有规则类型前缀的 classical只能 yaml 或 text
想自己手改、看得懂yaml 或 text

MetaCubeX 维护的规则数据仓库就提供了 mrs 版本的 geosite 文件,它的示例配置是:type: http、behavior: domain、format: mrs,再用 RULE-SET,cn,DIRECT 引用。

规则集的三种来源:http、file、inline

格式之外,type 决定规则集从哪来,三种来源对格式的要求也不同。

  • http:从网上下载,必须填 url。下载下来的文件按 format 读取,这是订阅配置里最常见的写法。
  • file:读本地文件,适合自己维护的规则。文件同样要和 format、behavior 对上。
  • inline:规则直接写在配置文件里,用 payload 字段列出,不需要单独的文件。payload 只在这种类型下生效。

写好规则集之后,还要在 rules 里用 RULE-SET,规则集名,策略 引用它,规则集才会参与分流。只定义不引用,它不会用来判断流量。另外,文档要求规则集的名字必须唯一,起名时带上用途,比如 cn、ads,方便日后排查。

写配置时容易错的几处

  • behavior 和文件对不上。 classical 的文件填了 domain,或者把 classical 写成 mrs,规则集加载不出来。
  • 改了 format 没换文件。 format 只告诉内核怎么读,不会帮你转换。把 format 改成 mrs,url 指向的也必须是 mrs 文件。
  • path 放到了别处。 path 要在内核的 HomeDir 里,放在外面需要额外设置 SAFE_PATHS 环境变量。不填 path 时,文件名用 URL 的 MD5。
  • 下载失败没有走代理。 规则集地址在境外又下载不下来时,可以用 proxy 字段指定下载和更新走哪个代理。

interval 是更新间隔,单位秒;size-limit 限制下载文件大小,默认 0 表示不限。规则集下载失败、订阅里的规则跟着失效时,整体排查可以参考订阅导入后节点或规则异常。想先了解策略组怎么接住这些规则,可以看Clash 机场与客户端配置专题。

常见问题

classical 规则集能转成 mrs 吗

不能。mihomo 文档写明,mrs 目前只支持 domain 和 ipcidr 两种 behavior。classical 规则集只能保持 yaml 或 text。

text 格式能写注释吗

可以。text 格式每行一条规则,以 # 开头的行是注释,不会被当成规则。

不写 format 会怎样

不写就按默认的 yaml 读取。如果你的文件其实是 text 或 mrs,会读取失败,需要把 format 补上。

相关文章

📣 你也在运营网站、频道或自媒体?

我们开放内容创作者长期合作,提供专属推广链接、独立业绩统计与推广素材支持。

还没想好买哪家?先看排行榜再看避坑名单

先用榜单把候选缩到 2–3 家,再去避坑名单确认没踩雷,最后用优惠码下单月付试一个晚高峰。这个顺序能帮你省掉大部分冤枉钱。