Clash rule-providers 自定义规则集:GitHub 上维护

为什么要把自定义规则拆成 rule-providers

规则只有几条时,把 DOMAIN-SUFFIX、IP-CIDR 直接写进 Clash 主配置最省事;可工作、开发、日常的策略慢慢分开以后,主配置就容易变成一份很难看懂的长文件。改某个服务的域名时,可能不小心改到订阅生成的内容;好几台设备共用规则时,复制粘贴后版本也常常对不上。rule-providers 的作用,就是把规则清单从主配置里拿出来,主配置只管引用,具体条目放在规则文件里维护。

这种分层特别适合要维护好几套策略的人:比如开发工具的域名单独一个文件,家里内网设备和自己搭的服务另放一个文件,两边各接到不同的策略组。规则集可以放在 GitHub 上,方便看改动历史、撤回错的提交,也能让好几份 Clash 配置共用同一个规则来源。要注意,规则集只负责“匹配”这一件事:它既不会生成策略组,也不带任何节点,用到的组名必须在你当前的配置里已经写好。

💡
先确认内核支持

rule-providers 支持哪些字段、什么格式,取决于内核。这里拿 Mihomo 常见的 YAML 写法举例;Clash Verge Rev、Mihomo 这些客户端的界面入口各不相同,最后都要交给实际在跑的内核来解析。如果客户端用的是老版本或者不是 Mihomo 内核,先确认它支持这些字段,别因为配置编辑器没报错就以为能用。

先写规则文件:按用途挑 behavior

规则提供器一般分两块:主配置里的 provider 定义,和放在远端的规则文件。拿域名规则来说,仓库里放的文件大致长下面这个样子。叫什么名字、放在哪个目录随你,要紧的是文件里的结构和 provider 声明的 behavior 对得上。

payload:
  - DOMAIN-SUFFIX,dev.example.com
  - DOMAIN,api.example.net
  - DOMAIN-KEYWORD,code-host

这里的 payload 就是规则列表。用 behavior: classical 时,一般把完整的 Clash 规则行放进列表,比如域名、进程名或别的支持的规则类型;用 behavior: domain 时,只放域名类条目;用 behavior: ipcidr 时,放 IP 网段。别把完整规则行塞进 domain 类型的文件,也别在 classical 文件里只写光秃秃的域名,不然可能解析失败,或者匹配结果跟你想的不一样。

写规则时,尽量用范围明确、说得清用途的条目。比如某个服务的主域名和子域名都要代理,就写成后缀匹配;只有一台固定的 API 主机要处理,就写精确匹配。别为了“保险”往共享规则集里塞范围过宽的 DOMAIN-KEYWORD 条目:按字串匹配可能撞上不相干的网站,影响比你想的大。也别往清单里堆没验证过的 IP 地址,CDN 地址会变,写死的网段很快就过时。

在主配置里声明 provider,接进规则链

文件传上去以后,回到 Mihomo 主配置,给它填好地址(url)、缓存放哪(path)、多久刷新(interval)和类型,然后在规则列表里用 RULE-SET 引用它。下面给出一份结构齐全的写法,仓库地址、组名和本地目录请改成你自己的:

rule-providers:
  dev-domains:
    type: http
    behavior: classical
    format: yaml
    url: "https://raw.githubusercontent.com/your-name/clash-rules/main/dev-domains.yaml"
    path: ./ruleset/dev-domains.yaml
    interval: 86400

rules:
  - RULE-SET,dev-domains,Proxy
  - GEOIP,CN,DIRECT
  - MATCH,Proxy

type: http 表示从 HTTP 或 HTTPS 地址下载规则文件;url 要指向文件本身,不是 GitHub 仓库首页或者文件的预览页。path 是客户端在本地存缓存的位置,每个 provider 各起一个文件名,别让两个规则集写进同一个缓存文件。写相对路径时,起点通常是配置文件所在的文件夹,或者客户端自己规定的那个目录;图形客户端可能会把配置复制到自己的数据目录,所以第一次配完要看看 provider 有没有成功生成或更新缓存。

interval: 86400 按秒算,也就是一天查一次有没有新版本。规则基本不动的话,间隔长一点能少发请求;团队规则改得勤,可以缩短,但没必要设成几分钟一回。“检查更新”不等于每次启动都重下一遍,客户端多半会看间隔和本地缓存的情况再决定。调试时可以去客户端的规则提供器页面手动点更新,然后看更新时间和状态有没有变。

RULE-SET,dev-domains,Proxy 里那个名字,要跟 rule-providers 下面的键 dev-domains 一字不差;最后的 Proxy 得是你配置里真有的策略组。实际的组名可能叫 🚀 节点选择、PROXY 或者别的,别照抄例子。规则从上往下逐条比,所以这一行要放在那些可能把它盖住的大范围规则上面;放到 MATCH 下面,它就永远轮不到。

⚠️
别直接改订阅生成出来的那份配置

有的客户端一更新订阅就把主配置重写一遍,你手动加的 provider 可能跟着没了。先弄清楚你的客户端是怎么合并、覆写或者加自定义规则的,并留一份能还原的备份。规则文件单独放在外面,不代表主配置可以乱改;provider 的定义和规则里引用它的那一行,都得能长期保存下来。

放到 GitHub 上,管好规则的版本

自己一个人用的话,一个公开仓库加上 Raw 文件地址基本就够了。规则文件提交上去后,点开文件的 Raw 视图,确认浏览器里显示的是纯文本,再把这个地址填进 url。要是打开后是网页、登录页或者仓库首页,Mihomo 拿到的就不是它要的 YAML,更新当然失败。仓库公开以后谁都能看到里面的内容,所以规则文件里别放订阅链接、令牌、公司内部的域名列表这类敏感东西。

规则放在 GitHub 后,你怎么管版本会直接影响稳不稳。直接用 main 分支的 Raw 地址最省事,一提交,provider 下次刷新就拿到了;可分支随时会变,哪次提交写错了,所有引用它的配置立刻跟着出问题。更稳的做法是先在另一个分支上试,没问题再合进去;要求能复现的环境,可以在发布时锁定到某个明确的版本或提交,打算升级时再换地址。不管哪种,提交说明里都写清楚这次加了、删了哪些规则,为什么。

几个人一起维护时,按用途拆成几个文件,比把所有条目塞进一张大表好。比如自己开发用的、家里设备用的、测试环境用的各管各的,再让不同的配置挑着引用。拆也要有分寸:每个文件管什么要说得清楚,别让同一个域名在好几个 provider 里指向不同的策略。条目一多,先用 Git 看清改了什么,再在测试配置里确认命中结果,最后才动正式配置,这样比在正在用的配置里一条条往上加更容易退回去。

加载失败怎么查,平时怎么维护

provider 显示失败时,先分清是“没下载下来”还是“下载了但解析不了”。下不下来,多半跟地址、网络通不通、TLS 证书、GitHub 的访问限制或服务器返回的状态码有关;解析不了,更可能是 YAML 缩进、字段拼错、文件编码,或者 behavior 跟里面条目的类型对不上。打开客户端日志,找到这个 provider 的名字和更新时间,再直接用浏览器打开那个 Raw 地址看看,比反复去改主配置管用。

  • 报 404 或者打不开:仓库名、分支名、目录、文件名的大小写要完全一样;确认 Raw 地址指的是文件本身,不是 GitHub 的网页。
  • 下载成功但规则不起作用:看 YAML 缩进是不是统一用空格、每个列表项是不是用短横线开头,并确认文件里有该有的 payload 结构。
  • provider 加载了却一条都没命中:看 RULE-SET 里的名字对不对得上、策略组存不存在,以及这一行是不是排在了更宽泛的规则后面。
  • 一更新表现就变了:去看 GitHub 上这次提交改了什么、客户端缓存是什么时候刷新的,必要时把规则文件退回去,再手动更新 provider,看是否恢复。
  • 重启以后配置没了:看看是不是被订阅刷新覆盖掉了,并确认客户端是否要求把自定义内容写进覆写配置或者单独的配置文件。

平时最好留一份很短的自查清单:挑几个肯定该命中的域名,访问时到 Clash 连接记录里看匹配到的规则和最后用的策略组;再挑一个不该命中的,确认没被范围过宽的规则误伤。规则集每改一次,先在备用配置里看加载状态和命中顺序,没问题再推到平时用的那份。provider 用的是公开的远程地址时也别忘了,客户端要联网才拿得到更新;第一次下载失败时旧缓存还能不能用,要看客户端怎么实现,别把缓存当成唯一的备份。

比起把规则零零散散抄进好几份配置,rule-providers 更好审、也更好退回,不过你仍然要选靠谱的内核、把策略组理清楚,并时不时确认规则源还能访问。想把规则维护和平时的连接管理放在一起做,可以去下载页拿个客户端,再按自己的习惯慢慢迁过去。