Clash rule-providers自定义规则集:托管优先级与缓存

先搞懂 rule-providers:让规则从主配置里独立出去

Clash 或 Mihomo 配置里,一条请求最后是直连、走代理还是拦掉,由规则说了算。规则不多的时候,直接写进主配置的 rules 字段没什么难的;可用的场景一多,去广告、流媒体、AI 服务、国内域名、局域网地址加起来,动辄几百上千条。全塞在一个 YAML 文件里,读起来费劲,更新和排错也麻烦。

rule-providers 干的事,是把一组规则存成单独的文件,主配置里按名字引用它。主配置只写清规则集放在哪、是什么格式、多久更新一次,具体的域名或 IP 列表在外部文件里维护。这样分工就清楚了:节点和策略组决定「流量去哪」,rule-providers 决定「哪些请求算哪一类」。规则集更新了,主配置也不用跟着频繁改。

要分清楚,rule-providers 既不是代理订阅,也不是提供节点的东西。里面一般只有 DOMAIN、DOMAIN-SUFFIX、DOMAIN-KEYWORD、IP-CIDR 这类规则,没有服务器地址、端口和加密参数。客户端能不能顺利打开目标网站,还是要看节点好坏、策略组怎么选、DNS 怎么设,以及当前内核认不认相关字段。

💡
推荐的拆分思路

按用途把规则分成几组相对固定的集合就好,比如 大陆站点直连、去广告、开发工具、视频平台、最后兜底。别一个域名建一个 provider,文件是多了,维护起来反而更累。

掌握 YAML 字段:name、type、behavior 与 url

Mihomo 配置里,rule-providers 一般写在最外层,跟 proxy-groups、rules 平级。一个远程规则集至少要写明规则类型、下载地址、本地缓存文件和更新间隔。下面这份示例入门够用,长期维护也合适:

rule-providers:
  ai-services:
    type: http
    behavior: classical
    url: "https://raw.githubusercontent.com/example/example-rules/main/ai.list"
    path: ./rule-providers/ai-services.yaml
    interval: 86400
    proxy: DIRECT
    health-check:
      enable: true
      url: https://www.gstatic.com/generate_204
      interval: 300

rules:
  - RULE-SET,ai-services,AI
  - MATCH,PROXY

ai-services 是这个 provider 的名字,后面 RULE-SET 引用时必须一字不差。名字可以用字母、数字和短横线,最好短一点、一看就知道是什么,别起 rules1、test 这种含糊的名字。type: http 表示客户端要从远程 HTTP 或 HTTPS 地址拉规则;规则文件跟配置放在一起的话,也可以用本地类型,具体怎么写以你所用 Mihomo 版本的文档为准。

behavior 告诉内核怎么读这个规则文件。常用的值有 classical、domain、ipcidr 三种。classical 适合每行都是完整 Clash 规则的文件,比如 DOMAIN-SUFFIX,example.com;domain 多用于只列域名的文件;ipcidr 用于 IP 网段。文件内容和 behavior 对不上时,客户端可能报解析失败,也可能显示加载成功、实际上一条都匹配不到。

path 是规则下载后存在本地的位置。可以都放进配置目录下的 rule-providers 文件夹,每个 provider 用一个不重名的文件。interval 以秒计,86400 就是一天检查一次。间隔别设得太短,不然远程请求变多,还可能被 GitHub 限流,更新老是失败。变化不大的规则集,一天或一周查一次更合适。

  • url:规则文件的远程地址,尽量用 HTTPS,并在浏览器里打开看一眼,内容应该是一行行规则。
  • path:本地缓存路径,几个 provider 别写成同一个文件。
  • proxy:下载规则时走哪个出口。规则地址直连不通的,可以指定一个代理策略组。
  • health-check:检查的是下载这条路通不通,不代表规则里那些业务域名一定能打开。

放在 GitHub Raw 上:地址写对,比点哪个复制按钮重要

很多人把自己写的规则存在 GitHub 仓库里,再让 Clash 定期去拉。要注意 GitHub 的网页地址和 Raw 文件地址是两回事。平时在仓库里点开文件,地址栏一般长这样:https://github.com/用户名/仓库/blob/main/path/rules.list,它给出的是一整个 HTML 页面,Clash 读不了。给 Clash 用的应该是对应的 Raw 地址:

https://raw.githubusercontent.com/用户名/仓库/main/path/rules.list

建规则仓库时,目录最好分得清楚,比如把 rules/ai.list、rules/media.list、rules/block.list 分开放。文件开头可以写一两行英文注释,但 Markdown 标题、项目徽章、网页 HTML 都不能混进规则文件。classical 类型的文件,内容可以照这样写:

DOMAIN-SUFFIX,ai.google.dev
DOMAIN,api.example.com

提交前确认文件谁都能读。把 Raw 地址贴进浏览器的无痕窗口,看显示的是不是纯文本、状态码是不是成功。浏览器跳到登录页、报 404,或者被重定向到仓库首页,Clash 都更新不了。分支改了名、文件挪了位置、仓库改成私有,原来好好的 provider 也会突然失效。

⚠️
来路不明的规则集别直接用

外部规则集能改变你流量的去向。导入前把提交记录和文件内容过一遍,看有没有范围很大的 MATCH、奇怪的 IP-CIDR 或可疑的域名。来源最好固定,仓库里留着改动说明,出问题时方便退回去。

动手配:从自己建文件到在客户端里看到命中

下面拿 Clash Verge Rev 或其他 Mihomo 客户端举例,配一个自定义 provider。各家界面叫法会有点出入,配置思路差不多。动手前先备份当前配置,免得缩进写错整份配置都加载不了。

  1. 在 GitHub 仓库里新建一个规则文件,比如 rules/ai.list,写上要走代理的域名,确认不登录也能打开它的 Raw 地址。
  2. 打开正在用的 Mihomo 配置,在最外层加上 rule-providers,写好 provider 名字、behavior、url、path 和 interval。
  3. 在最外层的 rules 列表里加一行 RULE-SET,ai-services,AI,ai-services 要和 provider 名字完全一样,AI 得是配置里已经有的策略组。
  4. 保存后重新加载配置,去客户端里列出规则集或 Providers 的地方找到它,状态应当是已经加载好;要是写着下载出错或者解析出错,就回头查前面几步。
  5. 开着连接日志去访问规则文件里的域名,看命中的规则是不是显示 RULE-SET,最后的出口是不是进了你想要的策略组。
  6. 验证期间先锁定一个稳定节点。确认规则能命中之后,再把策略组改回自动选择或故障转移,免得节点切换和规则问题搅在一起。

客户端有图形化的规则集管理的话,可以先在界面上看 provider 有没有下好,再回到 YAML 看最终生成的内容。别只看网页能不能打开,浏览器可能用的是缓存,也可能只有主站走了代理,API 和静态资源还在直连。靠谱的做法是把主域、子域和实际的业务请求都看一遍,在连接日志里确认它们是不是按你的设计进了同一个策略组。

规则顺序特别关键。Clash 基本是按 rules 从上往下匹配,第一条命中的规则说了算。所以针对性强的 provider 要放在宽泛规则上面。比如某个 AI 服务的规则集,要排在通用的境外代理规则之前;去广告规则要是写在 MATCH 后面,就永远轮不到它。MATCH 应该放在最后兜底,不要排到自定义规则集前面去。

优先级、定时更新和长期维护

rule-providers 在工程上的好处,不止是「少写几行规则」,更在于配置能查、能退、能复用。变动频繁的规则和基本不变的规则最好分开管。广告域名可能天天变,更新间隔可以短一点;公司内网、局域网、固定服务这类规则很少变,手动更新或者设个长间隔就行。

几个 provider 可能匹配到同一个域名时,要先想好谁优先。比如某个域名同时出现在去广告集合和 AI 服务集合里,排序不同,结果就完全两样。别光追求规则集多,先把思路写下来:哪类域名一定要走代理、哪类一定不走、哪类直接拦掉、其余的交给谁处理。拿不准的域名,可以先单独放进一个测试集合,跑几天没问题再并进正式的 provider。

  • 固定版本:要紧的场景可以用 Git 标签或某次提交保存一份稳定快照,免得上游一改规则,访问路径突然就变了。
  • 留好改动记录:每次成批加减域名,在提交说明里写清原因,出故障时好查。
  • 别互相覆盖:几个 provider 内容差不多时,先合并,或者定好谁优先,不然很难查出到底是哪个命中的。
  • 更新别太勤:别把所有 provider 都设成每分钟更新,远程服务的限制和本地磁盘读写都会受影响。
  • 定期清理:已经不用的 provider、缓存文件和失效的策略组删掉,别让旧规则还在影响流量。

规则集更新后出了状况,第一反应不该是换节点,而是看最近一次提交改了什么、provider 是什么时候下载的。可以先把上一版文件恢复回来,或者把对应的 RULE-SET 注释掉,确认问题到底是不是规则引起的。多人一起维护的仓库,大范围的规则改动要走 Pull Request 审一下,别一不小心把顶级域名写成范围过大的关键字规则。

常见故障:下载成功了,规则不一定生效

最常遇到的是「provider 显示已下载,访问结果却没变」。多半是这三种原因之一:规则文件格式和 behavior 对不上、RULE-SET 名字拼错,或者规则命中了却指向错的策略组。先把日志面板打开,看这次请求访问的是哪个主机、被哪条规则接住、最后从哪个出口出去,再一层层往下查,别光凭浏览器的报错去猜。

显示下载失败的话,先把 Raw 地址贴到浏览器里试,再看客户端访问 GitHub 时走的是哪个出口。有些配置让规则更新请求走 DIRECT,而本机直连又打不开 GitHub;这时可以给 provider 指定一个合适的 proxy 策略组。返回 404,就核对仓库名、分支名和文件路径;返回 403,可能是仓库权限、请求太频繁或托管平台的限制。

提示 YAML 解析出错的,重点看缩进、冒号、引号和列表前的短横线。YAML 对空格非常挑剔,rule-providers、provider 名字和各字段的层级必须对。规则文件本身也不能混进全角逗号、看不见的字符或错乱的换行。可以先拿一个只有两三条规则的小文件试,通了再慢慢往里加。

还有一种容易漏掉的情况:客户端兼容性。各家 Clash 客户端对 Mihomo 扩展字段、规则集格式、自动更新选项的认可程度参差不齐。Clash for Windows 已经停止维护,内核老旧,不少新字段它认不出来,建议换成 Clash Verge Rev、Mihomo Party 或新版 Android 客户端,这些对 Meta 语法支持得更好。同样的配置放到两台机器上结果不同,先对一下内核版本和报错日志,别急着把所有规则都改一遍。

ℹ️
一套顺手的排查顺序

先确认 Raw 地址打得开,再确认 provider 已经下载,然后看 behavior 和文件格式对不对,接着核对 RULE-SET 名字和规则顺序,最后才去查节点、DNS 和策略组。照这个顺序来,语法问题就不会被当成线路问题。

想换一款仍在维护的客户端,可以去下载页按平台挑选,安装包取自各客户端的官方 GitHub 发布页,页面上附了 SHA256。