Clash rule-provider 的 mrs、yaml、text 格式区别
mihomo 的 rule-providers 用 format 字段指定规则集文件格式,默认 yaml。这篇讲清三种格式的文件长什么样、mrs 只支持 domain 和 ipcidr 这条限制、怎么用 convert-ruleset 转换,以及 behavior 填错的表现。
本文目录(6 节 · 约 2 分钟) +
- 01 先分清 format 和 behavior
- 02 三种格式长什么样
- 03 什么时候用哪种
- 04 规则集的三种来源:http、file、inline
- 05 写配置时容易错的几处
- 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 补上。
相关文章
Clash redir-host 与 fake-ip 区别:enhanced-mode 怎么选
Clash 配置里 dns 段的 enhanced-mode 有 fake-ip 和 redir-host 两个值。这篇讲清 fake-ip 返回假地址再按域名分流的过程、redir-host 在 mihomo 里的定位,哪些应用需要用 fake-ip-filter 排除,以及改模式后先查哪几项。
Clash 策略组 select、url-test、fallback、load-balance 区别
Clash 配置里的 proxy-groups 决定流量走哪个节点。这篇讲清 select 手动选、url-test 自动挑延迟低的、fallback 按顺序备用、load-balance 分摊请求这四类各自怎么工作,常用字段 url、interval、tolerance、lazy 的含义。
Clash 订阅导入完整教程:Verge、Meta 与规则分流配置
从拿到订阅链接到节点能用,一共四步。本文给 Clash Verge Rev 与 Mihomo 的完整导入流程,以及导入失败最常见的四个原因。