前言：为什么要使用 rule-providers？
在 Clash Verge Rev 中，rule-providers 用来管理远程规则集。它可以把大量域名、IP 地址或网络地址规则放在独立文件中，由 Clash 按照设定的周期自动更新，而不必把几千甚至几万条规则全部写进主配置文件。对于需要长期维护分流策略的用户来说，这种方式更清晰，也更容易替换和排查。
需要注意的是，rule-providers 只负责“提供规则”，并不会自动让这些规则生效。你还必须在 rules 部分使用 RULE-SET 引用对应的 provider，并指定流量应该交给哪个策略组。例如，规则集名称是 streaming，策略组名称是 Proxy，对应的规则通常写成 RULE-SET,streaming,Proxy。
先理解两个名称
rule-providers 下的键名是规则集名称，rules 中 RULE-SET 后面的名称必须与它完全一致。名称大小写、连字符和下划线都建议保持统一，否则 Clash 无法找到对应规则集。
1配置前需要确认的内容
开始设置之前，建议先准备好一份可正常使用的 Clash Verge Rev 配置，并确认当前使用的是 Mihomo 内核。Clash Verge Rev 的不同版本界面名称可能略有差异，但配置文件中的 YAML 结构基本一致。你还需要确认以下信息：
- 规则集地址：必须是可以通过网络访问的 URL，常见格式包括 YAML、纯文本或经过压缩的规则文件。
- 匹配类型：根据规则内容选择
domain、classical或ipcidr，类型错误会导致规则无法解析。 - 更新周期：通过
interval设置自动更新间隔，单位为秒。常用值是86400，也就是每天更新一次。 - 目标策略组：规则匹配后要交给哪个策略组，例如
Proxy、DIRECT或自定义的流媒体策略组。 - 配置来源：确认当前配置是本地文件、订阅文件，还是由 Merge 合并生成。直接改订阅文件可能会在下次更新时被覆盖。
不要直接相信文件后缀
URL 以 .yaml 结尾并不代表一定使用 yaml 格式。判断 behavior 时，应查看文件实际内容以及规则集提供方的说明，而不是只看链接名称。
2rule-providers 参数逐项说明
一个基础的远程规则集配置通常放在主配置文件的顶层，与 proxy-groups、rules 等字段处于同一层级。下面的示例使用一个名为 streaming 的规则集：
type、url 与 path
type: http 表示从远程 HTTP 或 HTTPS 地址获取规则文件，url 是规则集的在线地址。建议优先使用 HTTPS，并确认地址不需要登录、验证码或临时 Cookie，否则客户端可能无法定时更新。
path 是规则下载到本地后的保存位置。使用相对路径时，通常以 Clash 配置文件所在目录为基准。不同版本的客户端可能会自动创建目录；如果没有自动创建，可以手动建立 ruleset 文件夹。文件名最好固定且具有辨识度，避免多个规则集使用同一个路径而互相覆盖。
behavior 与 format
behavior 描述规则内容的匹配方式，常见选择如下：
| 类型 | 适用内容 | 常见特征 |
|---|---|---|
domain |
域名规则 | 通常是一行一个域名或域名后缀 |
classical |
完整 Clash 规则 | 可能包含 DOMAIN、DOMAIN-SUFFIX、IP-CIDR 等规则类型 |
ipcidr |
IP 网段规则 | 主要包含 IPv4 或 IPv6 CIDR 地址段 |
format 用于说明文件格式。结构化 YAML 规则集通常写 format: yaml，纯文本规则集则可能使用 format: text。如果规则集提供方明确要求特定格式，应以对方文档为准。不要为了“看起来完整”随意添加不确定的参数。
3在 Clash Verge Rev 中实际添加规则集
下面以桌面版 Clash Verge Rev 为例，演示从配置入口到验证生效的完整流程。不同发行版的按钮位置可能不同，但核心思路都是先修改配置，再重新加载内核。
- 打开 Clash Verge Rev，进入「配置」页面，找到当前正在使用的配置文件。先复制一份备份，建议将原文件另存为带有日期的 YAML 文件。
- 用内置编辑器或文本编辑器打开配置，在顶层添加
rule-providers:。不要把它缩进到proxy-groups、dns或某个策略组内部。 - 在
rule-providers下创建唯一名称，例如streaming，然后填写type、behavior、url、path和interval。 - 回到配置文件的
rules:列表，加入RULE-SET,streaming,Proxy。其中Proxy必须是已经存在的策略组名称。 - 保存文件后，在 Clash Verge Rev 中点击「重新加载」或切换到其他配置再切回来，让 Mihomo 重新读取 YAML。
- 进入规则或规则集管理界面，检查
streaming是否显示为已下载、更新时间是否正常，再访问一个目标网站进行测试。
如果你的订阅配置每次更新都会覆盖本地修改，更推荐使用 Clash Verge Rev 的「Merge」或「覆写」功能。将自定义内容放在独立的合并配置中，可以避免订阅更新后规则集消失。一个简单的 Merge 示例可以这样写：
是否使用 prepend-rules 取决于你的合并配置方式。如果你希望自定义规则优先于订阅中的通用规则，可以放在前面；如果规则集仅作为补充，则可以使用普通的追加规则。最重要的是确认最终生成的配置中确实同时存在 provider 定义和对应的 RULE-SET 引用。
4规则顺序与多个规则集的组织方式
Clash 会按照 rules 从上到下的顺序匹配，第一条命中的规则会决定后续处理方式。因此，rule-providers 定义得再准确，如果引用位置被更宽泛的规则挡住，也可能看不到预期效果。
上面的顺序体现了一个常见思路：先处理明确的本地或私有地址，再处理专门的应用规则集，最后使用地区规则和兜底规则。不要把 MATCH,DIRECT 放在自定义规则集前面，否则所有流量都会先被直连匹配，后面的 provider 永远没有机会执行。
当规则集数量增加时，可以按照用途命名，例如 ads、private、streaming、ai。规则集名称尽量使用简单的英文小写单词，避免空格和特殊符号。不同 provider 的 path 也要分别保存，以免下载任务相互覆盖。
推荐的维护习惯
每添加一个规则集，就同步记录它的来源、匹配类型、目标策略组和更新时间。这样在规则失效或链接停止维护时，可以快速定位问题，而不用重新检查整份配置。
5不生效时的检查与错误排查
规则集配置最常见的问题不是语法本身，而是层级、名称、格式或加载流程出现偏差。可以按照下面的顺序逐项排查。
配置保存后提示 YAML 错误
YAML 对缩进非常敏感，只能使用空格，不能混用 Tab。streaming: 应该比 rule-providers: 多缩进两格，type、url 等字段则应比规则集名称多缩进两格。URL 中包含特殊字符时，使用英文双引号包裹，避免冒号、井号等字符被误解析。
规则集显示下载失败
先在浏览器中打开 url，确认地址没有失效，并检查返回内容是否真的为规则文件。如果浏览器需要登录、跳转到网页或返回 JSON 错误信息，Mihomo 也无法把它识别为有效规则。随后检查网络连接、系统时间和本地保存目录权限。桌面系统中的安全软件也可能阻止客户端写入规则目录。
规则集已加载但流量没有命中
重点检查三处：第一，RULE-SET 后的名称是否与 provider 键名完全一致；第二，behavior 是否与文件实际类型匹配；第三，规则前面是否已经存在 MATCH、GEOIP 或其他宽泛规则。还要确认目标策略组名称拼写正确，并在 Clash Verge Rev 的连接日志或规则命中记录中查看最终走向。
不要盲目提高更新频率
将 interval 设置得过短会增加规则源压力，也可能触发服务端限制。规则并非每分钟都在变化，普通订阅使用每天一次或每三天一次通常已经足够。
完成后的验证清单
配置完成后，不要只看客户端是否显示“运行中”，还应进行一次完整验证。首先确认当前配置确实已经重新加载；其次在规则集页面查看远程文件是否成功下载；然后检查配置文件中是否同时存在 rule-providers 与 RULE-SET。最后访问规则集覆盖的域名，通过连接日志确认它命中了预期规则和策略组。
- provider 名称与
RULE-SET引用名称一致。 - 规则集 URL 能够正常访问，返回内容没有登录页或错误页。
behavior、format与实际文件格式相符。- 本地
path不重复，且 Clash 有权限写入目录。 - 自定义规则位于兜底规则之前，策略组名称真实存在。
- 订阅更新后，Merge 或覆写内容仍然被正确应用。
掌握这些检查方法后，你就可以把广告过滤、流媒体、AI 服务、办公软件等规则分别维护，而不必频繁修改庞大的主配置。对于刚开始使用 Clash Verge Rev 的用户，建议先添加一个规则集进行验证，确认流程稳定后再逐步扩展，配置会更容易管理。