Clash Verge Rev 配置模板:YAML 导入、订阅替换与排错
简答:可以直接使用下面的 Mihomo YAML 模板,但它适合“本地完整配置”,不是扩展配置。先替换订阅地址和文件路径,再通过 Clash Verge Rev 的本地配置入口导入;如果只是给已有订阅加规则,应使用客户端的规则编辑功能,避免覆盖原订阅。
定义:Clash Verge Rev 配置模板,是一份符合 Mihomo 配置结构的 YAML 文件,用来定义代理订阅、策略组、DNS、端口和分流规则。
先复制这份模板:只替换标注位置
下面是一份用于本地导入的完整示例。它包含端口、运行模式、DNS、代理提供者、策略组和规则。模板中的订阅地址、文件名和策略组名称都是示例值,必须替换为你自己有权使用的订阅信息,并以客户端设置页显示的实际端口为准。
重要:这不是扩展配置模板。不要把下面整段内容直接粘贴到“扩展配置”中,也不要在扩展配置里随意写顶层 rules:,因为 Clash Verge Rev 的扩展配置对列表和普通值通常采用整体替换逻辑。官方说明还指出,部分端口、运行模式和控制器字段由应用设置接管,扩展中写入的值可能被设置页回写或丢弃,具体可查看Clash Verge Rev 扩展配置与脚本文档。
mixed-port: 7890
allow-lan: false
mode: rule
log-level: info
ipv6: false
external-controller: 127.0.0.1:9090
secret: "change-this-secret"
dns:
enable: true
enhanced-mode: fake-ip
nameserver:
- https://1.1.1.1/dns-query
- https://8.8.8.8/dns-query
proxy-providers:
my-subscription:
type: http
url: "https://example.com/replace-with-your-subscription"
interval: 86400
path: ./providers/my-subscription.yaml
health-check:
enable: true
url: https://www.gstatic.com/generate_204
interval: 300
proxy-groups:
- name: PROXY
type: select
use:
- my-subscription
- name: FINAL
type: select
proxies:
- PROXY
- DIRECT
rules:
- IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,10.0.0.0/8,DIRECT,no-resolve
- IP-CIDR,172.16.0.0/12,DIRECT,no-resolve
- IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
- MATCH,FINAL
需要替换的位置:
url:替换为你有权使用的订阅链接。不要把示例地址原样保存。my-subscription:这是代理提供者名称。proxy-groups中的use必须写完全相同的名称。PROXY和FINAL:这是模板自己创建的策略组,不代表你的订阅一定存在同名分组。mixed-port与external-controller:只是示例值,不代表你的设备默认使用这些端口;如果端口冲突,应以设置页和日志为准。secret:控制器暴露到本机接口时不要长期使用示例字符串,建议改成你自己的随机值。
代理提供者用于加载远程代理集合,策略组通过 use 引用它;字段结构可对照Mihomo 代理集合配置和Mihomo 代理组配置。如果你的订阅返回的不是该客户端能够识别的代理集合格式,模板本身不会自动修复返回内容。
DNS、规则和端口分别解决什么问题
DNS:模板中的 dns 块负责域名解析相关设置。enable 控制 DNS 功能,enhanced-mode 指定增强模式,nameserver 列出解析服务器。不同版本和客户端设置可能对 DNS 覆写有额外控制,Mihomo 字段说明可查看Mihomo DNS 配置文档。如果你在 Clash Verge Rev 的设置页已经启用了 DNS 覆写,扩展或本地配置中的 DNS 可能受到应用设置影响,遇到解析异常时应先确认设置页状态。
代理提供者:proxy-providers 负责从订阅地址读取代理集合;它不等于策略组。策略组只是让你选择代理或直连方式,因此模板中需要同时保留这两部分,并确保名称完全一致。
规则:规则从上到下匹配,命中第一条符合条件的规则后停止。模板先让本机私有网段直连,最后用 MATCH,FINAL 兜底。规则顺序、策略名称和插入位置可参考Clash Verge Rev 自定义规则说明。如果你把 FINAL 改名为其他策略组,最后一条规则也要同步修改。
端口:mixed-port 是 HTTP 与 SOCKS 混合入站端口的示例写法;是否使用系统代理、TUN 或手动代理,还要看客户端当前设置。端口可以被其他程序占用,因此不要把模板中的数字当成固定默认值。
运行模式:rule 表示按照 rules 分流;全局模式和直连模式通常由客户端界面切换。若你通过设置页切换模式,应用可能回写配置,所以不要把“模板写了 mode”理解为永远锁定该模式。
在 Clash Verge Rev 中导入本地 YAML
- 使用文本编辑器新建文件,把模板粘贴进去,并保存为以
.yaml或.yml结尾的文件。保存时选择 UTF-8 编码,避免把缩进转换成制表符。 - 替换
url,检查proxy-providers中的名称与策略组use完全一致,再确认最后的MATCH引用的是实际存在的策略组。 - 打开 Clash Verge Rev,进入配置文件管理,选择新建本地配置或导入本地文件。官方文档说明,本地配置支持新建配置文件导入和拖拽配置文件导入;拖拽方式需要至少为
v1.6.2,具体以客户端当前版本为准,可查看Clash Verge Rev 订阅导入文档。 - 导入后先观察配置是否成功解析,再选择该配置。确认策略组中出现
PROXY和FINAL,并检查代理提供者是否能加载节点。 - 在客户端中选择一个可用策略,按需开启系统代理或 TUN。若只开启了配置但没有开启对应的代理入口,浏览器或其他应用可能仍然走本地直连。
- 用一个普通网页和一个需要代理的目标分别测试。若浏览器没有流量经过客户端,先检查系统代理、TUN、应用代理设置和策略组选择,不要马上修改规则。
如果你已经有远程订阅,只是想添加一两条自定义规则,不建议把远程配置复制成完整本地模板再长期维护。Clash Verge Rev 的自定义规则页面支持将规则放在前置或后置位置,且官方说明规则会按从上到下的顺序匹配;这种场景优先使用客户端的规则编辑入口。
导入失败时按这一张表排查
| 现象 | 优先检查 | 处理方式 |
|---|---|---|
| 文件无法解析 | YAML 缩进、冒号、引号、重复键 | 统一使用空格缩进,不要混用制表符;逐段删除最近新增的字段后重新导入。 |
| 策略组为空 | proxy-providers 名称与 use 名称 | 逐字核对名称,大小写、连字符和下划线都不能随意更改。 |
| 订阅加载失败 | URL 是否有效、是否需要登录、返回内容格式 | 先在浏览器或下载工具中确认返回的是订阅内容,而不是登录页、错误页或 HTML 页面;不要把示例地址保留在模板中。 |
| 规则报错或流量走错 | 规则引用的策略组是否存在 | 检查每条规则末尾的策略名称,尤其是 MATCH,FINAL;不要盲目改成未定义的名称。 |
| DNS 异常 | DNS 覆写、增强模式和网络环境 | 先暂时关闭额外 DNS 覆写或恢复为客户端可用设置,再逐项启用;DNS 字段以 Mihomo 文档和当前客户端界面为准。 |
| 提示连接错误 | 导入方式、证书、订阅服务可达性 | Clash Verge Rev 文档对远程订阅导入失败提供了更换导入方式的建议;不要把“允许无效证书”当作默认方案,仅在理解风险并确认来源时处理。 |
排错时建议一次只改一个字段,并保留能正常导入的备份。尤其不要在已有订阅的扩展配置中直接覆盖完整 rules、dns 或策略组;扩展配置和本地完整配置的用途不同。对于规则语法,可以继续对照Mihomo 路由规则文档。
本地完整配置与扩展配置怎么选
| 需求 | 适合方式 | 注意事项 |
|---|---|---|
| 自己维护端口、DNS、代理提供者、策略组和规则 | 本地完整 YAML | 需要自行维护订阅地址、字段和规则,适合愿意管理配置的用户。 |
| 已有订阅,只想增加少量规则 | 客户端规则编辑 | 优先使用前置或后置规则入口,不要用顶层列表覆盖整份订阅。 |
| 多个订阅统一调整少量字段 | 扩展配置 | 先确认字段的合并方式;列表和普通值可能整体替换,DNS 下部分字段也有特殊规则。 |
| 只想导入并使用订阅 | 远程订阅导入 | 不必先写 YAML,直接使用客户端的订阅导入功能,出现连接错误再按官方导入说明排查。 |
核对日期:2026年10月25日。Clash Verge Rev 的功能名称和配置行为可能随版本变化,遇到界面与本文不同的情况,应优先以当前客户端设置页和项目文档为准。
相关操作指南
如果你还没有完成订阅导入,可以先看便宜机场订阅链接怎么导入?Clash、v2rayN、安卓客户端步骤;如果配置已经导入但无法连接,可继续看便宜机场连接不上怎么办?按顺序排查订阅、节点与客户端设置。想先了解完整流程,可参考机场怎么用?订阅导入、客户端连接与失败排查步骤。
本站是第三方使用指南站,不代表任何订阅服务或客户端项目官方。请只使用你有权使用的订阅链接,不要下载来源不明的配置文件。
常见问题
Clash Verge Rev 配置模板应该保存成什么格式?
保存为 UTF-8 编码的 .yaml 或 .yml 文件,并使用空格缩进。文件扩展名正确不代表内容一定兼容,仍要检查字段、缩进、重复键和策略组名称。
为什么把配置模板粘贴到扩展配置后,原来的规则不见了?
扩展配置中的列表和普通值可能采用整体替换逻辑,rules 不是简单追加。已有订阅只需要增加规则时,应使用 Clash Verge Rev 的规则编辑入口,或严格按照当前版本支持的前置、后置规则方式操作。
模板里的 PROXY 是不是所有订阅都必须有的策略组?
不是。本文模板自己创建了名为 PROXY 的策略组,并让它通过 use 引用 my-subscription。若你使用的是已有订阅配置,应改用订阅中真实存在的策略组名称,不能机械照抄。
DNS 配置要不要保留?
可以先保留最小 DNS 配置,但如果客户端设置页已经接管 DNS,实际效果可能受 DNS 覆写开关影响。遇到解析失败时,先确认客户端 DNS 设置,再逐项调整 enable、enhanced-mode 和 nameserver。
导入成功但浏览器仍然无法连接,下一步做什么?
先确认配置已被选中,再检查策略组是否选择了可用代理,并确认系统代理或 TUN 已开启。随后查看客户端日志和代理提供者加载状态,不要先大范围修改 rules。
相关阅读
参考资料
- Clash Verge Rev Docs:订阅导入与本地配置导入方式(clashverge.dev)
- Clash Verge Rev Docs:扩展配置合并规则与应用设置优先级(clashverge.dev)
- Clash Verge Rev Docs:自定义规则、匹配顺序与前置后置规则(clashverge.dev)
