配置 2026年11月9日

Clash rule-providers进阶配置:自定义规则集托管与版本管理

从 rule-providers 字段和规则匹配机制入手,学习编写 Clash 自定义规则集,并用 GitHub 托管、更新和追踪变更。文章提供 YAML 示例、规则优先级说明与排障思路,帮助你把个人分流配置升级为可复用、易维护的工程化方案。

Docker代理 GitHub加速 进阶配置 YAML

先把概念说清:rule-providers 管规则数据,不替你决定策略

当个人分流规则只有几条时,直接把条目写进主配置的 rules: 很方便;但当域名清单持续增长、需要跨设备复用,或希望和主配置分开维护时,长长的规则列表就会变成负担。rule-providers 的作用,是把一组规则作为独立数据源加载,再由主配置中的 RULE-SET 引用。这样可以分别管理「规则内容」和「命中后采用什么策略」,更新清单时也不必反复编辑整份主配置。

这项能力属于内核配置,不是所有名为 Clash 的客户端都必然支持。当前常见用法主要面向 Mihomo 及兼容相应配置格式的内核;Clash Verge、Clash Verge Rev 等图形客户端通常由所选内核解析配置。若配置保存失败、提示字段未知,先确认客户端实际使用的内核及版本,再核对规则提供者格式。客户端界面负责管理配置、更新和日志,最终能否解析,仍取决于内核能力。

理解时可以把整个过程拆成三层:rule-provider 描述规则从哪里来、采用什么类型;提供者文件保存匹配条目;主配置里的 RULE-SET 决定命中后交给哪个策略组。规则集本身不是策略组,也不会自动让对应流量走代理。比如,一个域名规则集可以命名为 personal-sites,而命中它的连接仍可按需要交给 PROXY、DIRECT 或你自己的策略组。

阅读提示:以下配置用于说明结构,策略组名称、GitHub 用户名、仓库名和规则内容都需要替换成你实际使用的值。不同 Mihomo 版本及客户端对配置编辑、验证入口的呈现可能不同。

从 YAML 开始:定义规则提供者并接入主规则链

适合初学者的方式,是先把一组自定义域名规则存为 YAML 文件,再通过 HTTPS 地址加载。下面示例把提供者命名为 personal-sites,文件放在 GitHub 仓库的 rules 目录中。path 是内核在本地保存该规则集的位置;相对路径通常以配置运行环境中的工作目录为基准,使用前应确认客户端实际写入位置和目录权限。

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

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

对应文件可以采用如下结构。对于 behavior: domain,条目表达的是域名匹配范围;例如 +.example.com 用于匹配该域及其子域,具体写法请以所用 Mihomo 版本支持的格式为准。不要把包含策略名的主配置规则直接当作 domain 列表上传,否则提供者类型与文件内容不匹配,可能导致加载失败或条目无法按预期解释。

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

若要在提供者文件里写完整的规则类型、匹配条件与参数,例如 DOMAIN-SUFFIX、PROCESS-NAME 或 IP-CIDR,通常应选择适合完整规则行的 behavior: classical,并按该格式提供条目。相对地,behavior: domain 与 behavior: ipcidr 分别面向域名类和 IP 网段类数据。三者不是标签装饰:选错类型,即使 YAML 缩进完全正确,也可能出现解析错误或规则未命中的情况。

写完后要检查两处引用是否一致:RULE-SET 后的提供者名称必须与 rule-providers 下的键名完全相同;最后一个参数必须是主配置中已存在的策略组或合法策略目标。规则提供者负责判断是否命中,策略参数负责选择出口,两者职责不同。若规则命中但策略组名称拼错,问题不在 GitHub 文件,而在主配置引用。

匹配优先级:规则集的位置决定谁先接住连接

加载成功不等于规则一定生效。Mihomo 的主规则链按顺序匹配,通常是从上到下,命中后即停止继续检查。因此,同一域名若先命中较宽泛的规则,就不会再走到后面更具体的 RULE-SET。例如,若在规则集之前已经有一条覆盖范围很大的域名或地理位置规则,后置的个人清单便可能看起来「完全没作用」。排查时先看规则顺序,而不是立刻复制更多重复条目。

一个易读的排列方式,是把业务范围明确、需要优先处理的自定义规则集放在较前位置,再放通用规则,最后用 MATCH 兜底。下面只是说明顺序,不代表所有用户都应采用同一套策略;尤其是局域网、国内站点、开发服务和特定应用规则,应结合自己的实际需求安排。

rules:
  - RULE-SET,personal-sites,PROXY
  - RULE-SET,work-direct,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,PROXY

这段示例中,personal-sites 放在 GEOIP,CN,DIRECT 前面,因此该提供者先得到匹配机会;如果把它移到 GEOIP 之后,落入前面规则范围的流量就不会再检查个人规则集。还要留意提供者内部的规则顺序:当 behavior: classical 包含不同范围的条目时,较宽的匹配条件可能遮住后续更具体的条件。遇到「只有一部分域名生效」,应同时检查主规则链和提供者文件内部,而不是只看其中一处。

规则越宽,维护成本越高。比如把一个大型平台的整个根域名后缀都送入代理,可能连不需要代理的服务也一起改变出口;反过来只写一个精确主机名,又可能遗漏实际访问的 API 子域。较稳妥的做法是从日志中确认真实请求域名,再选择 DOMAIN、DOMAIN-SUFFIX 或对应的 provider 类型,并以最小可用范围开始。每添加一条规则,都应能说明它解决什么问题、预期命中哪些流量。

用 GitHub 托管与版本管理:更新可追踪,回滚有依据

将规则文件放入 GitHub 仓库,最大的价值不只是获得一个 Raw 文件地址,而是让规则修改拥有可阅读的提交历史。建议使用结构简单的目录,例如 rules/ 存放规则集,README 记录用途、匹配范围、最后审核日期和维护者。提交说明尽量写清「新增哪些域名、依据是什么、影响哪些服务」,避免只写「更新规则」。当分流出现回归时,提交差异能帮助你判断变更是否相关,也更容易恢复到之前可用的版本。

示例中的 main 分支地址指向持续变化的内容,适合希望规则按 interval 自动检查更新的场景;代价是仓库有新提交后,客户端下一次更新可能立即采用新规则。若更看重可复现性,可以使用经过审核的发布版本或固定提交地址,并在确认变更后再调整引用。两种方式没有绝对优劣:前者维护省事但变更更快,后者上线更可控但需要主动更新地址。无论选择哪种,都应保留 Git 历史,别把唯一副本只放在客户端缓存目录里。

公开仓库不适合放入包含个人隐私、内部域名、访问令牌或敏感网络结构的规则。GitHub Raw 地址可以被他人访问;即使仓库暂时私有,也不要把令牌直接拼进 URL 或提交到 YAML。还需考虑远程托管服务的可用性:客户端更新时若无法连到源站,可能继续使用本地缓存,也可能报告更新失败,具体表现取决于内核和客户端。更新频率不必设得过短,规则很少变化时按日或按周检查通常更易于控制,也能减少不必要的请求。

排障时按层定位,比反复切换节点更有效。先在 Clash Verge 或 Clash Verge Rev 中查看当前配置是否成功加载、rule-provider 状态是否更新;再确认 YAML 缩进、键名、URL、网络连通性和本地 path 权限;随后检查规则集名称、behavior 与文件格式是否对应;最后打开内核日志,核对目标域名实际命中的规则和策略组。若提供者更新失败但旧规则仍在工作,先区分「更新源不可达」与「规则匹配错误」;若更新成功却未改变流量路径,则优先检查主规则顺序和策略组选择。

如果你依赖远程订阅合并,先确认自定义 rule-providers 与 rules 是否确实进入最终下发给内核的配置。有些配置管理方式会覆盖局部字段,或要求通过特定的合并入口加入内容;只编辑了一个未被客户端使用的 YAML 文件,内核当然不会读取。建议每次只改一个变量:先用少量测试域名验证提供者能加载,再观察日志确认命中,最后扩大规则集。这样遇到错误时,能够迅速判断是远程下载、解析、合并还是匹配环节出了问题。

与把所有规则塞进单一配置文件相比,部分规则订阅服务虽然省去托管步骤,却不一定提供适合个人维护的提交记录、命名约定或精细回滚;而完全手写主配置则容易在多设备之间产生版本差异。rule-providers 配合 GitHub 的优势,是规则内容与策略分离、改动可审阅、版本可回退,但前提是你愿意维护清晰的文件结构并验证变更。若希望从小规模规则开始逐步建立这套流程,可以先下载适用于自己平台的 Clash 兼容客户端,再用一两个测试条目确认加载和命中行为。

前往下载 Clash 客户端 →

准备好开始了吗?

选择兼容 Mihomo 的客户端,逐步搭建可复用、可追踪的自定义规则集。