本目录主要存放由本项目维护的 OpenClash 远程覆写模块。这些模块用于在 OpenClash 加载配置时,按需修改规则、DNS、Rule Provider 或插件数据源。
本项目覆写功能的维护范围仅包括通过 OpenClash 插件覆写模块机制实现的功能。
Important
覆写模块只能调整其声明的配置项,不能替代 OpenClash LuCI 页面中的插件设置。
建议先按照项目 Wiki 的 OpenClash 设置方案,结合自身网络环境完成插件设置,再选择需要的覆写模块。
| 位置 | 用途 |
|---|---|
本目录直接存放的 .conf |
本项目维护的单功能远程覆写模块,本文重点介绍 |
yaml/ |
存放用于远程调用本项目 YAML 配置文件的覆写模块;文件区别、变量和订阅地址请查看 yaml/ |
OpenClash_Overwrite/ |
第三方完整覆写方案,具体用法以上游 README 为准 |
archived/ |
已停止维护的旧版文件,仅供历史参考 |
Note
yaml/ 目录中的模块用于下载、填写并切换本项目的 YAML 配置,与本目录直接存放的单功能增强模块用途不同。此处不再展开介绍。
| 模块 | 主要作用 | 影响范围 | 是否需要参数 |
|---|---|---|---|
Prevent_DNS_Leak.conf |
综合降低 DNS 泄漏风险 | DNS、规则、最终策略及专用策略组 | 否 |
Block_Encrypted_DNS.conf |
阻断常见 DoH、DoT、DoQ 绕过 | Rule Provider 与前置阻断规则 | 否 |
Add_No_Resolve.conf |
为目标 IP 类规则补充 no-resolve |
rules 与 sub-rules |
否 |
Add_Custom_Direct_Rules.conf |
为其他规则方案附加本项目的域名与 IP 直连规则 | Rule Provider 与前置直连规则 | 否 |
Rule_Provider_Format_Fix.conf |
根据文件扩展名补全或修正 Rule Provider 的 format |
rule-providers.*.format |
否 |
Direct_Game_Download.conf |
让 Steam CDN 和游戏平台下载流量直连 | Rule Provider 与前置直连规则 | 否 |
Set_GeoIP_Database_URL.conf |
替换 GeoIP MMDB、DAT 与 GeoASN 数据源 | OpenClash GEO 数据库地址 | 否 |
Set_China_IP_Route_URL.conf |
替换大陆 IPv4、IPv6 白名单数据源 | OpenClash Chnroute 数据源 | 否 |
Set_IP_Data_Source_URL.conf |
统一替换 GeoIP、GeoASN 与大陆 IPv4、IPv6 白名单数据源 | OpenClash GEO 数据库与 Chnroute 数据源 | 否 |
- 想系统降低 DNS 泄漏风险:使用
Prevent_DNS_Leak.conf。 - 只想阻止终端使用常见加密 DNS 绕过本地 DNS:使用
Block_Encrypted_DNS.conf。 - 只需要给 IP 类规则补充
no-resolve:使用Add_No_Resolve.conf。 - 正在使用其他规则方案,只想附加本项目的域名与 IP 直连规则:使用
Add_Custom_Direct_Rules.conf。 - Rule Provider 因缺少或写错
format导致加载失败:使用Rule_Provider_Format_Fix.conf。 - 希望游戏下载和更新尽量走直连:使用
Direct_Game_Download.conf。 - 只想替换 OpenClash 使用的数据源:选择对应的
Set_*.conf模块。 - 希望用一个模块统一替换 GeoIP、GeoASN 与大陆 IP 白名单数据源:使用
Set_IP_Data_Source_URL.conf。
- 进入「服务」→「OpenClash」运行状态页。
- 点击页面顶部的「覆写模块」按钮,打开覆写编辑器。
- 点击模块卡片栏中的「+」,选择通过订阅链接添加,并从本文复制 jsDelivr CDN 或 GitHub Raw 地址。
- 进入模块信息填写步骤,确认自动回填的名称和描述;旧版本按页面提供的字段手动填写。
- 将匹配配置文件设置为
all或当前配置文件。不要留空,否则模块不会生效。 - 仅在模块说明要求时填写
EN_KEY参数。 - 添加并启用模块,然后保存设置。
- 重启 OpenClash,使插件重新生成运行配置。
- 检查 OpenClash 日志及最终运行配置,确认模块已经生效。
不同 OpenClash 版本的菜单名称可能略有差异。
模块文件头部的 #!NAME、#!DESC、#!CONFIG 和 #!CRON 分别声明名称、描述、匹配配置和模块订阅更新计划。新模块默认匹配 all,并以 off 关闭模块订阅的定时更新;启用前可按需修改。yaml/ 中的远程 YAML 模块还通过 #!ENV 声明环境变量,具体参数见其使用说明。
元信息只在新增模块时回填表单。刷新已有模块的订阅不会自动修改其名称、描述、匹配配置、更新计划或参数。#!CRON 控制模块文件本身的订阅更新,Rule Provider 和模块内部 DOWNLOAD_FILE 的更新行为仍由各自设置决定。
Tip
jsDelivr CDN 与 GitHub Raw 指向同一个仓库文件,只需要选择其中一个。jsDelivr CDN 通常更适合 GitHub Raw 访问质量不佳的网络环境。
Warning
新增、停用或更换模块后,必须重新应用配置。仅显示「模块订阅成功」不代表最终 YAML 校验和 Mihomo 内核启动一定成功。
Prevent_DNS_Leak.conf 是本项目自行维护且影响范围最大的模块,用于通过 DNS 劫持、DNS 上游规则跟随、no-resolve 以及将最终规则指向代理目标等方式降低 DNS 泄漏风险。
主要操作:
- 强制使用
rule模式; - 启用路由器自身代理和 OpenClash DNS 劫持;
- 启用
dns.respect-rules; - 禁止自动追加 WAN DNS 和自动补充
default-nameserver; - 清除 DNS 列表中的
system,关闭 DNS HTTP/3 偏好; - 为目标 IP 类规则补充
no-resolve; - 将最终
MATCH或FINAL指向COCR-DNS-Leak-Guard; - 创建
COCR-DNS-Leak-Guard策略组,并自动引入可用代理。
模块不再接收 EN_KEY1 或 EN_KEY2。缺少 proxy-server-nameserver 时,模块只尝试复用有效的 default-nameserver;最终规则固定使用 COCR-DNS-Leak-Guard,避免远程模块参数进入动态 Ruby 表达式。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Prevent_DNS_Leak.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Prevent_DNS_Leak.conf
验收重点:
dns.respect-rules: true;- 存在有效的
proxy-server-nameserver; - DNS 列表中没有
system; - 目标 IP 类规则带有
no-resolve; - 最终规则指向预期代理目标;
- 日志中没有 Ruby 覆写或配置校验错误。
Caution
本模块会强制修改 DNS、规则和最终代理策略。启用前应备份当前可用配置,并确认不会与其他 DNS 或最终规则覆写重复。
Block_Encrypted_DNS.conf 用于阻止局域网终端通过常见 DoH、DoT 或 DoQ 绕过路由器配置的 DNS 服务。
主要操作:
- 阻断 TCP/UDP 目标端口
853; - 添加加密 DNS 域名 MRS Rule Provider;
- 添加加密 DNS IP MRS Rule Provider;
- 将三条阻断规则插入现有规则列表顶部;
- 保留原有
rules和rule-providers。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Block_Encrypted_DNS.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Block_Encrypted_DNS.conf
验收重点:
- DST-PORT,853,REJECT
- RULE-SET,COCR-Encrypted-DNS-Domain,REJECT
- RULE-SET,COCR-Encrypted-DNS-IP,REJECT,no-resolve限制:
- 无法识别所有非标准端口或尚未收录的加密 DNS;
- 无法可靠区分共享 CDN 上的全部 DoH 流量;
- 不负责 DNS 劫持、IPv6 DNS 管理或 OpenWrt 防火墙设置;
- 可能影响确实需要使用加密 DNS 的企业、校园或自建服务。
Add_No_Resolve.conf 用于为以下目标 IP 类规则添加 no-resolve:
IP-CIDR;IP-CIDR6;GEOIP;- 引用
behavior: ipcidrRule Provider 的RULE-SET; - 顶层
rules和sub-rules中的直接规则。
模块会保留原有规则顺序、策略和其他附加参数,并跳过已经含有 no-resolve 或 src 的规则。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Add_No_Resolve.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Add_No_Resolve.conf
限制:
- 不修改 Rule Provider 文件内部的规则;
- 不处理
behavior: domain或behavior: classical的 Provider; - 不解析
AND、OR、NOT内部嵌套规则; - 不处理
IP-ASN、IP-SUFFIX、SRC-IP-CIDR或SRC-GEOIP。
Note
Prevent_DNS_Leak.conf 已经包含本模块的核心功能。启用前者时,不需要再启用本模块。
Add_Custom_Direct_Rules.conf 面向正在使用其他规则方案的用户。模块仅附加本项目维护的域名与 IP 直连规则,不要求改用本项目的完整配置、订阅转换模板或 YAML。
主要操作:
- 添加
Custom_Direct_Domain.mrs域名 Rule Provider; - 添加
Custom_Direct_IP.mrsIP Rule Provider; - 将两条
DIRECT规则插入现有规则列表顶部; - 为 IP Rule Provider 的引用规则添加
no-resolve; - 保留原有
rules和rule-providers。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Add_Custom_Direct_Rules.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Add_Custom_Direct_Rules.conf
验收重点:
rule-providers:
COCR-Custom-Direct-Domain:
behavior: domain
format: mrs
COCR-Custom-Direct-IP:
behavior: ipcidr
format: mrs
rules:
- RULE-SET,COCR-Custom-Direct-Domain,DIRECT
- RULE-SET,COCR-Custom-Direct-IP,DIRECT,no-resolve限制:
- 不附加本项目的端口规则、代理规则或其他配置;
- 两条规则位于原有规则之前,命中目标会优先使用
DIRECT; - 如果其他覆写模块随后改写整个
rules或同名 Provider,本模块的结果可能被覆盖; no-resolve只阻止当前 IP 规则为匹配目标主动触发 DNS 解析。更早的规则已经完成解析时,仍可使用解析结果匹配。
Rule_Provider_Format_Fix.conf 用于根据 Rule Provider 的实际文件扩展名补全或修正 format 字段,以解决传统 subconverter 转换出的配置文件缺少 format: 字段的问题。
判断规则:
| 文件扩展名 | 写入的 format |
|---|---|
.mrs |
mrs |
.yaml、.yml |
yaml |
处理逻辑:
- 普通远程 Provider 优先检查
url,再检查path; type: file优先检查path,再检查url;- 自动忽略 URL 查询参数和
#fragment; - 扩展名匹配不区分大小写;
- 识别到受支持扩展名时,会修正已有的错误
format; - 未识别到
.mrs、.yaml或.yml时保持原配置不变。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Rule_Provider_Format_Fix.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Rule_Provider_Format_Fix.conf
验收示例:
rule-providers:
Example-MRS:
url: https://example.com/rules/example.mrs
format: mrs
Example-YAML:
url: https://example.com/rules/example.yaml?token=example
format: yaml限制:
- 只处理顶层
rule-providers; - 只识别
.mrs、.yaml和.yml; - 不修改
type、behavior、url或path; - 不下载并验证文件实际内容;
- 如果文件扩展名本身与内容不一致,模块仍会按扩展名设置
format。
Direct_Game_Download.conf 用于将游戏下载与更新流量优先设为直连。
主要操作:
- 添加本项目维护的 Steam CDN 域名 Rule Provider;
- 添加 Steam CDN IP Rule Provider;
- 将对应域名和 IP 规则设为直连;
- 添加
GEOSITE,category-game-platforms-download,DIRECT; - 将相关规则插入现有规则列表顶部。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Direct_Game_Download.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Direct_Game_Download.conf
限制:
- 只处理游戏下载和更新流量;
- 不会将登录、商店、社区、云存档或游戏联机全部改为直连;
- 依赖 Mihomo GeoSite 数据包含
category-game-platforms-download; - 直连速度仍取决于运营商、DNS 和 CDN 调度结果。
Set_GeoIP_Database_URL.conf 用于替换 OpenClash 使用的:
- GeoIP MMDB:
Country.mmdb; - GeoIP DAT:
geoip.dat; - GeoASN:
Country-asn.mmdb。
以上数据库地址均使用 cdn.jsdelivr.net。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Set_GeoIP_Database_URL.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Set_GeoIP_Database_URL.conf
模块会同时影响 OpenClash 启动时生成的 geox-url 和插件自身的数据库更新流程。
限制:
- 不会自动启用 GeoIP DAT 模式;
- 不会自动开启数据库定时更新;
- 不修改 GeoSite、规则或策略组;
- 会覆盖 OpenClash 页面中已有的 GeoIP MMDB、DAT 与 GeoASN 自定义地址。
Set_China_IP_Route_URL.conf 用于替换 OpenClash 大陆白名单使用的 IPv4 和 IPv6 Chnroute 数据源。两个数据源地址均使用 cdn.jsdelivr.net。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Set_China_IP_Route_URL.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Set_China_IP_Route_URL.conf
限制:
- 不会自动开启「绕过中国大陆 IP」或「回国」模式;
- 不会自动开启大陆白名单定时更新;
- 不修改配置文件中的 GeoIP、GeoSite、Rule Provider 或
geox-url; - 只有相关大陆 IP 白名单功能已经启用时,新数据源才会被实际使用。
Set_IP_Data_Source_URL.conf 集合前述两个数据源模块的功能,一次替换以下 5 个来源:
| 数据源 | 文件 |
|---|---|
| GeoIP MMDB | Country.mmdb |
| GeoIP DAT | geoip.dat |
| GeoASN | Country-asn.mmdb |
| 大陆 IPv4 白名单 | text/cn-ipv4.txt |
| 大陆 IPv6 白名单 | text/cn-ipv6.txt |
所有地址均使用 cdn.jsdelivr.net/gh/Aethersailor/geoip@release/。
jsDelivr CDN:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Set_IP_Data_Source_URL.conf
GitHub Raw:
https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Set_IP_Data_Source_URL.conf
只需启用本模块,无需同时启用 Set_GeoIP_Database_URL.conf 和 Set_China_IP_Route_URL.conf。
限制:
- 不会自动启用 GeoIP DAT 模式、「绕过中国大陆 IP」或「回国」模式;
- 不会自动开启数据库或大陆白名单定时更新;
- 不修改 GeoSite、规则、策略组或 Rule Provider 数据源;
- 只有相关大陆 IP 白名单功能已经启用时,白名单数据源才会被实际使用;
- 会覆盖 OpenClash 页面或原配置中已有的对应数据源地址。
| 组合 | 建议 |
|---|---|
Prevent_DNS_Leak.conf 与 Block_Encrypted_DNS.conf |
✅ 可组合,分别处理 OpenClash 内部 DNS 路由和终端常见加密 DNS |
Prevent_DNS_Leak.conf 与 Add_No_Resolve.conf |
❌ 不需要组合,前者已包含 no-resolve 处理 |
Add_Custom_Direct_Rules.conf 与 Add_No_Resolve.conf |
✅ 可以组合;本模块的 IP 规则已带 no-resolve,后者可继续处理其他 IP 类规则 |
Rule_Provider_Format_Fix.conf 与其他单功能模块 |
✅ 通常可以组合,但需确认没有故意使用与扩展名不一致的 format |
Direct_Game_Download.conf 与数据源替换模块 |
✅ 通常可以组合,两者修改范围不同 |
Set_IP_Data_Source_URL.conf 与另外两个数据源替换模块 |
|
yaml/ 中的远程 YAML 模块与根目录单功能模块 |
|
| 第三方完整覆写方案与本目录模块 | |
| 多个完整覆写方案 | ❌ 不建议同时启用 |
当两个模块修改同一字段、同一规则数组或同一策略组时,后执行的模块可能覆盖先执行的结果。不要依赖执行顺序长期维持冲突配置。
应用模块后,至少检查:
- 远程模块下载成功;
- OpenClash 配置校验通过;
- Mihomo 内核启动成功;
- Rule Provider 下载和解析成功;
- 最终运行配置中出现模块预期写入的字段或规则;
- DNS、IPv4、IPv6 和流量接管仍符合预期;
- 常用服务的规则命中符合预期;
- 日志中没有 Ruby、YAML、Provider 或内核错误。
模块没有生效时,依次检查:
- 模块是否已经启用;
- jsDelivr CDN 或 GitHub Raw 地址是否能够正常下载;
- 远程模块内容是否已经显式刷新;仅保存设置或重启 OpenClash 不会重新下载已保存的模块文件;
- 模块要求的
EN_KEY参数格式是否正确; - 当前 OpenClash 是否接受模块使用的
[General]、[YAML]、[Overwrite]和 Ruby helper; - 是否有其他模块修改同一配置项;
- 最终运行配置中是否出现预期结果;
- OpenClash 日志是否存在下载、解析、Ruby、配置校验或内核启动错误。
如果 Add_No_Resolve.conf 的警告中仍出现 begin; add_no_resolve,OpenClash 读取的是修复前保存在路由器上的旧模块文件,不是仓库当前版本。
-
将订阅地址替换为以下任一当前地址:
https://cdn.jsdelivr.net/gh/Aethersailor/Custom_OpenClash_Rules@main/overwrite/Add_No_Resolve.conf https://raw.githubusercontent.com/Aethersailor/Custom_OpenClash_Rules/main/overwrite/Add_No_Resolve.conf -
在覆写模块编辑器中执行「刷新订阅」。如果当前版本没有刷新按钮,删除旧模块后使用新地址重新添加。
-
检查模块编辑器中的正文,或在路由器上执行:
grep -F "drop('3'.to_i)" /etc/openclash/overwrite/Add_No_Resolve.conf输出包含
drop('3'.to_i)时,表示已加载兼容 Ruby 4 的模块。仅包含transform_values!不能证明已加载本次修复。正文仍包含begin; add_no_resolve时,先解决模块下载或缓存问题。 -
重新应用配置,并确认日志中不再出现「跳过不支持的覆写命令」。
旧版文档曾使用 testingcf.jsdelivr.net/...@main/... 地址。该入口的可变分支缓存可能滞后,不再作为覆写模块订阅地址使用。
曾在 OpenClash dev 0.47.169、Ruby 4.0.2 环境复现:旧版 Add_No_Resolve.conf、Rule_Provider_Format_Fix.conf 和 Prevent_DNS_Leak.conf 会被覆写命令校验跳过。Ruby 4 对整数和正则字面量使用新的语法节点,当时的 OpenClash 白名单未接受这些节点。
OpenClash 已在 2026 年 10 月 15 日的修复中补齐相关 AST 节点白名单。以下模块仍保留字符串转整数和字符串分割写法,以兼容尚未包含该修复的版本。
当前模块已改用字符串转整数和字符串分割,保留原有规则改写、Provider 格式识别和 DNS 配置行为。如果日志仍显示「跳过不支持的覆写命令」,先刷新这三个模块的订阅,再重新应用配置。仅更新 OpenClash、保存设置或重启服务不会刷新已下载的模块。
刷新后,检查最终运行配置:
Add_No_Resolve.conf:目标 IP 规则和ipcidrRule Provider 引用已添加no-resolve,包括sub-rules。Rule_Provider_Format_Fix.conf:.mrs对应format: mrs,.yaml和.yml对应format: yaml。Prevent_DNS_Leak.conf:检查dns.respect-rules、proxy-server-nameserver、no-resolve和MATCH,COCR-DNS-Leak-Guard。
排查冲突时,建议暂时停用其他覆写模块,只保留目标模块重新测试。
模块功能和兼容性可能随 OpenClash 与 Mihomo 更新而调整,请以仓库 main 分支中的最新文件为准。