配置 2026年10月17日

Clash 规则集进阶配置:rule-providers 托管与自动更新

通过 Mihomo rule-providers 将自定义分流规则拆分为独立 YAML 文件,托管至 GitHub 并自动更新。本文覆盖关键字段、规则匹配优先级、版本管理和常见更新故障排查,帮助你构建更易维护的 Clash 配置。

Docker代理 GitHub加速 进阶配置 YAML

rule-providers 解决什么问题:把规则数据与主配置分开维护

当分流规则逐渐增加,直接把每条规则都写进主配置会让文件变得难读、难审查,也难以在不动代理节点和策略组的情况下更新规则。Mihomo 的 rule-providers 可以把一组规则作为独立资源加载:主配置负责声明规则集来源、匹配类型、本地缓存位置与更新间隔,具体规则则放在单独的 YAML 或文本文件中。再通过 RULE-SET 将规则集接入现有规则链,规则内容更新时通常无需手动复制整段配置。

这并不代表规则集会自动替你决定流量走向。规则集描述的是哪些请求属于这一组,主配置中的 RULE-SET 第三个参数才指定命中后的策略,例如 PROXY、DIRECT 或你自己定义的策略组。也就是说,托管文件、客户端拉取、规则匹配和策略选择是相关但不同的环节;配置其中一环有误,都可能出现「文件看起来更新了,流量却没按预期走」的情况。

开始前建议先确认客户端实际运行的内核是 Mihomo,且内核版本支持配置中使用的字段。Clash Verge、Clash Verge Rev 等图形客户端可能使用不同版本的 Mihomo,也可能通过订阅合并配置;仅凭界面显示「Clash」不能判断某个字段一定受支持。先备份当前配置,并在测试配置中验证语法与命中结果,再把规则集接入日常使用的配置。

先读懂关键字段:来源、行为、缓存与更新间隔

每个 provider 通常需要声明名称、下载类型、规则行为、文件格式、URL、本地路径和更新间隔。名称会在 RULE-SET 中引用,因此必须保持一致;URL 应指向可直接下载规则文件的地址,而不是 GitHub 仓库的网页地址。以 GitHub 为例,浏览器打开仓库时的 github.com 页面通常是文件预览页,Mihomo 需要能返回原始文件内容的 raw 地址。

rule-providers:
  personal-sites:
    type: http
    behavior: domain
    format: yaml
    url: https://raw.githubusercontent.com/your-name/clash-rules/main/personal-sites.yaml
    path: ./ruleset/personal-sites.yaml
    interval: 86400

rules:
  - RULE-SET,personal-sites,PROXY
  - MATCH,DIRECT

上面是结构示例,仓库名、分支名、策略组和路径都需要换成自己的值。type: http 表示通过 HTTP(S) 获取远程内容;path 是 Mihomo 保存本地副本的位置,通常相对于配置文件所在位置解析;interval 以秒为单位,示例中的 86400 表示按一天的周期检查更新。它不是「每天固定某一时刻更新」的保证,也不等于 GitHub 文件一变化,客户端就会立刻拉取。不同客户端的配置目录、更新入口及检查时机可能不同,首次加载时应确认本地路径可写、远程地址可访问。

behavior 决定 Mihomo 如何理解文件中的规则。常见类型包括 domain、ipcidr 和 classical:前两者分别用于域名类与 IP 网段规则,classical 用于包含完整规则类型和参数的传统规则条目。不要只看文件扩展名判断行为类型;文件格式与规则行为是两个不同字段。对于 YAML 格式,规则集一般使用 payload 作为规则列表容器,提交前要确认结构符合所声明的行为。

规则文件可以先从小规模开始。例如,域名类规则集可写成:

payload:
  - '+.example.com'
  - '+.example.net'

如果使用 classical,文件中的条目则应采用相应的完整规则表达式;不能把一份只包含域名后缀的列表不加检查地改成 classical,也不能把完整的 DOMAIN-SUFFIX 条目直接当作纯域名列表。规则类型与文件内容不匹配时,常见表现是内核启动报错、provider 加载失败,或规则集加载成功但实际匹配不到流量。

阅读提示:配置字段与支持的文件格式会随 Mihomo 版本变化。遇到字段校验错误时,先查看客户端实际使用的内核版本和对应版本文档,再检查 YAML 缩进、字段拼写与规则列表格式;不要仅凭其他客户端的界面选项推断内核能力。

托管到 GitHub:让更新可追踪、可验证、可回滚

创建一个专门存放规则的公开仓库,按用途拆分文件,例如把个人域名、广告拦截和局域网例外分开。分文件管理能让每次变更更容易审查,也能避免一个很大的规则文件同时承载不同匹配逻辑。目录名和文件名尽量稳定;若需要重命名,记得同步修改主配置中的 URL,并确保老版本客户端不会继续请求已删除的地址。

完成首次提交后,打开 GitHub 上的文件页面,使用 raw 文件地址填入 url。建议将分支名显式写入 URL,例如 main,避免依赖默认分支名称;同时确认仓库无需登录即可读取。把 URL 粘贴到浏览器中检查时,重点看返回的是规则文件原文,而不是 HTML 页面、登录页面或 404 提示。若仓库用于长期使用,不要把访问令牌写进公开配置或公开仓库,也不要把订阅链接、节点密码等敏感信息提交到规则仓库。

规则集内容最好采用小步提交:每次只添加一类经过验证的条目,并在提交说明中写清用途和变更原因。若规则来自第三方列表,应记录来源、许可或维护说明,并关注上游是否更改了文件格式。公共仓库虽然方便访问,但不代表永远稳定;上游可能删文件、改分支、重命名目录,或者临时限制请求。对关键规则集,保留一个本地备份或已知可用的提交版本,能在远程源故障时缩短恢复时间。

如果希望限制变更带来的风险,可以固定到经过验证的分支或版本路径,而不是不加评估地跟随快速变化的内容。代价是你需要主动检查上游更新;好处是每次变更都有机会先在测试配置中观察。无论采用哪种策略,都应让规则文件尽量保持纯粹:只放规则数据,不混入完整的代理配置、账号信息或客户端专属字段。

规则匹配优先级:provider 命中后仍受主规则顺序控制

Mihomo 的规则通常按配置中的顺序逐条匹配,命中后采用对应的策略。因此,RULE-SET 写在什么位置非常重要。假设某个域名先被一条较宽泛的规则匹配并送往 DIRECT,那么后面针对它的 provider 规则就没有机会生效。把规则拆到远程文件,并不会改变规则链的匹配顺序,也不会让 provider 自动拥有更高优先级。

实际配置时,先明确规则集的职责,再安排顺序。需要明确代理的个人域名规则集,可以放在通用直连规则之前;广告拦截规则集可以根据你的策略放在相应的拒绝规则位置;局域网、保留地址或最终兜底规则则应结合整个配置的逻辑安排。以下仅展示规则链引用方式,策略名称必须与配置中的策略组一致:

rules:
  - RULE-SET,personal-sites,PROXY
  - RULE-SET,local-domains,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

不要机械复制示例顺序。比如,若个人规则集里包含国内站点,却把它放在更早的宽泛规则之后,最终策略可能与预期不同;若最后一条是 MATCH,DIRECT,没有被前面规则捕获的请求就会直连。修改顺序后应使用 Clash Verge 或 Clash Verge Rev 的连接记录、内核日志或可用的规则测试功能,观察真实请求命中了哪条规则、进入了哪个策略组。仅查看 YAML 文本无法确认某条规则在运行时是否被提前匹配。

建议在规则来源或仓库说明中注明规则集的用途和匹配类型,并用少量容易验证的域名进行测试。若一条规则覆盖范围过大,先缩小规则集或拆分出更精确的集合,而不是依靠不断追加例外来补救。规则越容易解释,出现误分流时就越容易定位到底是规则内容错误、优先级不合适,还是策略组本身不可用。

自动更新故障排查:从下载、解析到实际命中逐层确认

更新失败时,先判断故障发生在哪一层,不要第一时间同时改 URL、规则格式和策略组。首先在客户端检查 provider 状态、更新时间和报错信息;如果日志显示无法连接远程地址,再确认设备能否访问 raw 文件地址、仓库是否公开、分支与文件路径是否正确,以及当前 DNS、代理或 TUN 设置是否影响了这次下载。桌面客户端能打开 GitHub 页面,不一定代表 Mihomo 内核进程也能访问 raw 地址。

若日志提示 YAML 解析或字段错误,优先检查缩进是否使用空格、冒号后的值是否正确、payload 是否存在,以及规则格式是否与 behavior 对应。可以先将规则集缩减到一两条已知有效规则,再逐步恢复完整内容。远程文件编辑后,还要确认 raw 地址返回的确实是最新版本;浏览器缓存、选错分支或文件尚未提交,都可能让你误以为更新已经发布。

若 provider 显示加载成功,但流量没有按预期分流,接着检查三件事:主配置引用的 provider 名称是否与声明完全一致;RULE-SET 的策略名称是否存在;这条规则是否被前面的规则截获。还要确认当前配置确实包含你编辑的 rule-providers 段——有些客户端会通过订阅合并或覆写生成最终配置,本地修改的文件未必是内核实际加载的那份。

更新间隔较长时,刚发布的新规则可能不会立即进入本地缓存。可以通过客户端提供的规则集更新操作触发检查,或在确认版本支持后使用相应的控制接口;操作后查看更新时间和内核日志,确认拉取、解析和加载均已完成。不要在没有确认路径含义的情况下删除整个配置目录:本地 provider 缓存与主配置可能放在相邻目录,误删会造成额外恢复工作。稳妥流程是先导出备份,再针对单个规则集处理。

常见问题

设置 interval 后,规则会在提交到 GitHub 时立刻更新吗?

不会。interval 表示更新检查的周期,不是 GitHub 提交事件的实时通知。具体检查时机还可能受到内核启动时间、客户端更新机制和网络状态影响。若需要立即验证,请使用客户端提供的 provider 更新操作,并检查日志中的实际更新时间和加载结果。

domain、ipcidr 与 classical 应该怎么选?

按规则内容选择:主要是域名匹配时考虑 domain,主要是 IP 网段时考虑 ipcidr;需要在同一规则集中使用不同类型的完整规则表达式时,通常使用 classical。最终以当前 Mihomo 版本的字段和格式说明为准,避免只改声明而不调整文件内容。

为什么 GitHub 页面能打开,provider 却下载失败?

仓库网页地址与 raw 文件地址返回的内容不同;provider 需要原始规则文件。请检查 URL 是否指向正确分支和文件路径、仓库是否公开,以及内核日志中的连接错误。若 URL 返回 HTML 或 404,Mihomo 就无法把它当作有效规则文件解析。

规则文件更新后一定要重启客户端吗?

不一定。更新是否能在运行中加载,取决于内核能力、客户端实现和触发方式。先通过客户端的 provider 状态或日志确认是否已重新加载;若状态仍旧或配置报错,再按客户端提供的流程重新加载配置。重启不是验证更新成功的替代方法。

与把规则直接堆进主配置相比,第三方列表往往更省事,但来源、更新节奏和内容变更未必适合你的分流习惯;手工维护单一大文件则容易在更新时漏项,也不便于回滚。通过 Mihomo 的 rule-providers 拆分规则、托管在可追踪的 GitHub 仓库,并在主配置中明确匹配顺序,你可以同时获得独立更新、变更审查和故障定位能力。如果希望在支持的平台上管理 Clash/Mihomo 客户端,可以前往下载页选择合适版本。

前往下载 →

准备好开始了吗?

选择适合的平台客户端,导入配置并逐步验证规则集更新。