HyperADRules

下一代广告 / 恶意域名规则聚合
多上游合并 · 保守 DNS 语义 · 多客户端一键订阅

这是什么

HyperADRules 是广告与恶意域名规则聚合项目：

定时拉取多个 DNS 级上游，合并去重
保守语义：路径 / 端口 / 无法表达的 modifier 跳过，绝不静默扩大为整域误杀
一次构建，输出 AdGuard Home、mihomo、Clash、sing-box、Surge、dnsmasq、SmartDNS、Pi-hole 等格式
空 ipcidr 集合也会发布合法空资产，订阅 URL 不会 404

上游来源

上游	用途
AdGuard Home For Magisk Mod	ads / malware / allow 主过滤器
anti-AD	Clash payload 广告域 + 例外
dead-horse whitelist	并入 allow
Coolapk 1007 reward	补充 ads hosts
`sources/local_allow.txt`	仓库本地白名单，覆盖上游误杀业务域

快速开始

先按客户端选择格式，不需要下载整个 Release：

AdGuard Home：使用 *_adguard.txt，见下方 AdGuard Home
mihomo / Clash Meta：优先使用 .mrs，见下方 mihomo / Clash Meta
Clash（不支持 MRS）：使用 *_clash.yaml
sing-box：使用 *_singbox.srs
其他客户端见按客户端选择格式

规则按用途分为三组：

`{kind}`	用途	通常动作
`ads`	广告、跟踪域名	拦截
`malware`	恶意、钓鱼域名	拦截
`allow`	误杀例外	放行；必须优先于拦截规则

所有订阅都使用下面这种固定地址：

https://github.com/Lynricsy/HyperADRules/releases/latest/download/<文件名>

例如 AdGuard Home 广告规则：

https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_ads_adguard.txt

latest/download 会自动转到最新 Release。每天发布新版本后地址不变，客户端仍会下载到新内容。不要复制带 /download/snapshot-YYYYMMDD/ 的版本固定地址，也不需要每次手动更换。

按客户端选择格式

下表中的 {kind} 替换为 ads、malware 或 allow；订阅地址均为 https://github.com/Lynricsy/HyperADRules/releases/latest/download/<文件名>。

客户端 / 用途	文件名	怎么用
AdGuard Home	`hyper_adrules_{kind}_adguard.txt`	在 DNS 封锁清单中添加 `ads`、`malware` URL，在 DNS 允许清单中添加 `allow` URL
AdGuard / EasyList 兼容过滤器	`hyper_adrules_{kind}_easylist.txt`	作为远程过滤器订阅；内容使用 Adblock DNS 规则语法
mihomo / Clash Meta	`hyper_adrules_{kind}.mrs`	`rule-providers` 设置 `behavior: domain`、`format: mrs`
mihomo 的 IP 规则	`hyper_adrules_{kind}_ipcidr.mrs`	单独的 provider，设置 `behavior: ipcidr`、`format: mrs`
mihomo 文本格式	`hyper_adrules_{kind}.txt`	provider 设置 `behavior: domain`、`format: text`
mihomo 文本 IP 格式	`hyper_adrules_{kind}_ipcidr.txt`	provider 设置 `behavior: ipcidr`、`format: text`
Clash / YAML provider	`hyper_adrules_{kind}_clash.yaml`	provider 设置 `behavior: domain`、`format: yaml`
Clash / YAML IP provider	`hyper_adrules_{kind}_clash_ipcidr.yaml`	provider 设置 `behavior: ipcidr`、`format: yaml`
sing-box	`hyper_adrules_{kind}_singbox.srs`	远程 rule-set 设置 `format: binary`
sing-box 可读源文件	`hyper_adrules_{kind}_singbox.json`	远程 rule-set 设置 `format: source`；通常优先用 SRS
Surge Rule Set	`hyper_adrules_{kind}_surge.txt`	使用 `RULE-SET`，文件内含 `DOMAIN` / `DOMAIN-SUFFIX` / `IP-CIDR`
Surge Domain Set	`hyper_adrules_{kind}_surge2.txt`	使用 `DOMAIN-SET`；只含域名，不含 IP
dnsmasq	`hyper_adrules_{ads,malware}_dnsmasq.conf`	下载后通过 `conf-file=` 引入；只有拦截规则
SmartDNS	`hyper_adrules_{ads,malware}_smartdns.conf`	下载后通过 `conf-file` 引入；只有拦截规则
Pi-hole / 纯域名列表	`hyper_adrules_{kind}_domains.txt`	`ads`、`malware` 加入封锁列表；`allow` 加入允许列表
校验与统计	`SHA256SUMS` / `manifest.md` / `stats.json`	校验下载、查看产物统计；不能作为过滤规则导入

_ipcidr 文件只包含 IP/CIDR 规则，不能当域名列表使用。dnsmasq 和 SmartDNS 没有标准的远程白名单动作，所以只生成 ads、malware 文件；allow 应使用客户端自己的白名单功能。

客户端配置

AdGuard Home

进入 过滤器 → DNS 封锁清单 → 添加封锁清单 → 添加自定义列表，分别添加：

https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_ads_adguard.txt
https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_malware_adguard.txt

再进入 过滤器 → DNS 允许清单 → 添加允许清单 → 添加自定义列表，添加：

https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_allow_adguard.txt

名称可以自行填写，例如 HyperADRules Ads、HyperADRules Malware、HyperADRules Allow。保存后点击 “检查更新”即可立即拉取；之后 AdGuard Home 会按自身过滤器刷新周期继续请求同一个固定 URL。

mihomo / Clash Meta

MRS 体积更小、加载更快，推荐使用。下面是完整的域名规则配置；如需 IP/CIDR，再按格式表添加对应 *_ipcidr.mrs provider，并使用 no-resolve。

rule-providers:
  hyper_allow:
    type: http
    behavior: domain
    format: mrs
    path: ./ruleset/hyper_adrules_allow.mrs
    url: https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_allow.mrs
    interval: 86400
  hyper_ads:
    type: http
    behavior: domain
    format: mrs
    path: ./ruleset/hyper_adrules_ads.mrs
    url: https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_ads.mrs
    interval: 86400
  hyper_malware:
    type: http
    behavior: domain
    format: mrs
    path: ./ruleset/hyper_adrules_malware.mrs
    url: https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_malware.mrs
    interval: 86400

rules:
  - SUB-RULE,(NETWORK,tcp),hyper_filter
  - SUB-RULE,(NETWORK,udp),hyper_filter
  # 这里继续你的代理 / 直连 / 地区分流
  - MATCH,DIRECT

sub-rules:
  hyper_filter:
    - RULE-SET,hyper_allow,PASS
    - RULE-SET,hyper_ads,REJECT
    - RULE-SET,hyper_malware,REJECT
    - MATCH,PASS

白名单必须在拦截规则之前。不要把 allow 写成 DIRECT，否则例外域名无法继续匹配后面的代理规则；也不要把 PASS 白名单和 REJECT 平铺在同一层 rules 中。旧版 Clash 不支持 MRS 时，把文件换为 *_clash.yaml，并把 format 改为 yaml。

sing-box

SRS 是已编译的二进制 rule-set。下面用逻辑规则表达“命中 ads 或 malware，并且没有命中 allow”；这样白名单只退出本项目的拦截，不会强制改变后续代理路由：

{
  "route": {
    "rules": [
      {
        "type": "logical",
        "mode": "and",
        "rules": [
          { "rule_set": ["hyper-ads", "hyper-malware"] },
          { "rule_set": "hyper-allow", "invert": true }
        ],
        "action": "reject"
      }
    ],
    "rule_set": [
      {
        "tag": "hyper-allow",
        "type": "remote",
        "format": "binary",
        "url": "https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_allow_singbox.srs"
      },
      {
        "tag": "hyper-ads",
        "type": "remote",
        "format": "binary",
        "url": "https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_ads_singbox.srs"
      },
      {
        "tag": "hyper-malware",
        "type": "remote",
        "format": "binary",
        "url": "https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_malware_singbox.srs"
      }
    ]
  }
}

如果下载 Release 需要经过代理，可给每个远程规则集增加 "download_detour": "<出站标签>"。使用 *_singbox.json 时把 format 改为 source。

Surge

在 [Rule] 中使用远程 Rule Set：

RULE-SET,https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_ads_surge.txt,REJECT
RULE-SET,https://github.com/Lynricsy/HyperADRules/releases/latest/download/hyper_adrules_malware_surge.txt,REJECT

Surge 没有与 mihomo PASS 等价的“只跳过当前过滤器”动作。若接受白名单域名固定直连，可把 hyper_adrules_allow_surge.txt 作为 DIRECT Rule Set 放在上述规则之前；否则不要整表导入 allow，而应把实际误杀域名加入你现有的优先规则。只需要域名集合时，可把 RULE-SET 和 _surge.txt 分别换成 DOMAIN-SET 和 _surge2.txt。

dnsmasq / SmartDNS

这两种格式需要先下载到本地，再由服务配置文件引入；可用 cron 或 systemd timer 定期覆盖本地文件。

# dnsmasq
conf-file=/etc/dnsmasq.d/hyper_adrules_ads_dnsmasq.conf
conf-file=/etc/dnsmasq.d/hyper_adrules_malware_dnsmasq.conf

# SmartDNS
conf-file /etc/smartdns/hyper_adrules_ads_smartdns.conf
conf-file /etc/smartdns/hyper_adrules_malware_smartdns.conf

下载后重载对应 DNS 服务。此格式只导出明确的域名后缀阻断规则，避免把精确匹配扩大为整个域。

Pi-hole / 其他纯域名客户端

使用 *_domains.txt。它每行一个域名，适合只接受纯域名的客户端；为了不扩大匹配语义，无法安全表达的 “仅子域”和通配符规则不会写入该格式。将 ads、malware URL 加入封锁列表，将 allow URL 加入允许列表。

手动下载

只需替换文件名即可下载任何格式：

base=https://github.com/Lynricsy/HyperADRules/releases/latest/download
curl -fLO "$base/hyper_adrules_ads_adguard.txt"
curl -fLO "$base/SHA256SUMS"

产物一览

GitHub Actions 每天 UTC 20:23 构建并发布。文件名中 {kind} = ads / allow / malware。完整文件清单、适用客户端和用法见按客户端选择格式；Release 内的 manifest.md 提供当次构建统计。

Release tag

新 tag：snapshot-YYYYMMDD（UTC 日期）
notes 含 CONTENT_ID（SHA256SUMS 指纹前 16 位）
同日重跑：完整且 checksum 一致则跳过；残缺则删重建

转换策略

只保留 DNS / domain 层能完整表达的规则：

输入	结果
`\|\|example.com^`	`+.example.com`
`@@\|\|example.com^`	allow 集合
`\|\|1.2.3.4^` / CIDR	ipcidr
hosts `0.0.0.0 ads.example.com`	exact domain
`\|\|example.com/path`、`:8443`、query/fragment	跳过（不整域扩大）
无法表达的 `$script` 等 modifier	跳过
安全 wildcard	保留为 Clash/mihomo 可编译形式

跳过原因会进入 unsupported_path / unsupported_port / unsupported_modifier 统计。

本地构建

git clone --depth=1 https://github.com/liuzq2002/Adguard-Home-For-Magisk-Mod upstream-adguard
git clone --depth=1 https://github.com/privacy-protection-tools/anti-AD upstream-anti-ad
curl -fsSL https://raw.githubusercontent.com/privacy-protection-tools/dead-horse/master/anti-ad-white-for-clash.yaml \
  -o upstream-anti-ad/anti-ad-white-for-clash.yaml
curl -fsSL https://raw.githubusercontent.com/lingeringsound/10007/main/reward \
  -o upstream-coolapk-1007-reward.txt

uv run python -m scripts.build_rulesets \
  --adguard-source upstream-adguard \
  --anti-ad-source upstream-anti-ad \
  --coolapk-1007-reward-source upstream-coolapk-1007-reward.txt \
  --local-allow-source sources/local_allow.txt \
  --output dist \
  --adguard-commit "$(git -C upstream-adguard rev-parse HEAD)" \
  --anti-ad-commit "$(git -C upstream-anti-ad rev-parse HEAD)" \
  --dead-horse-commit "$(sha256sum upstream-anti-ad/anti-ad-white-for-clash.yaml | cut -d ' ' -f 1)" \
  --coolapk-1007-reward-commit "$(sha256sum upstream-coolapk-1007-reward.txt | cut -d ' ' -f 1)"

生成二进制：

mihomo convert-ruleset domain text dist/hyper_adrules_ads.txt dist/hyper_adrules_ads.mrs
# 空 ipcidr 由流水线写入合法空 MRS；有规则时同样 convert-ruleset ipcidr

sing-box rule-set compile --output dist/hyper_adrules_ads_singbox.srs dist/hyper_adrules_ads_singbox.json

反馈

误杀 / 漏拦欢迎开 Issue。规则会定期从上游重建；本仓库只做保守、可追溯的格式转换与发布。

Name		Name	Last commit message	Last commit date
Latest commit History 1,858 Commits
.github/workflows		.github/workflows
pics		pics
scripts		scripts
sources		sources
tests		tests
.gitignore		.gitignore
README.md		README.md
pyproject.toml		pyproject.toml
uv.lock		uv.lock

Navigation Menu

Repository files navigation

HyperADRules

这是什么

上游来源

快速开始

按客户端选择格式

客户端配置

AdGuard Home

mihomo / Clash Meta

sing-box

Surge

dnsmasq / SmartDNS

Pi-hole / 其他纯域名客户端

手动下载

产物一览

Release tag

转换策略

本地构建

反馈

About

Releases

Packages

Used by

Contributors

Languages

Folders and files

Latest commit

History

Repository files navigation

HyperADRules

这是什么

上游来源

快速开始

按客户端选择格式

客户端配置

AdGuard Home

mihomo / Clash Meta

sing-box

Surge

dnsmasq / SmartDNS

Pi-hole / 其他纯域名客户端

手动下载

产物一览

Release tag

转换策略

本地构建

反馈

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages