Skip to content

About

通过 GitHub Actions 自动合并、去重多个来源的 AdGuard Home 去广告规则。 支持自动检测并分离上游规则中的混合黑白名单。 黑白名单完全独立,同时存在的规则会单独列在冲突规则中。感谢分享规则的各位大佬。

Resources

Stars

1 star

Watchers

0 watching

Forks

 
 

Latest commit

 

History

1,819 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

激进的规则 · 自动更新的 AdGuard Home 规则

一句话说明:把 31 个开源广告拦截名单合并、去重、纠错,自动生成两个可以直接订阅的 AdGuard Home 规则文件(拦截 + 允许)。每 6 小时自动重建一次,本页面上的数字和名单同步刷新。

项目 当前状态
最后构建时间 2026-11-22 02:55:48 (UTC+8)
拦截规则 924,071 条 + 301 条「域名空间」(连全部子域一起拦)
允许规则 302 条 + 3 条「域名空间放行」
冲突规则(同时被拦又被放行) 137 条
上游来源 31 个黑名单源 + 1 个白名单源(明细见下方表格)
构建方式 GitHub Actions 自动构建,也可在 Actions 页面手动触发

一、这是给谁用的?

  • 你在手机、电脑或路由器上装了 AdGuard Home(或兼容 AdGuard 语法的 DNS 过滤器), 想让 App 开屏广告、信息流广告、统计埋点在 DNS 层就被拦掉;
  • 你不想自己维护十几份规则名单,也不清楚哪些名单质量好。

直接订阅下面两个链接就行。本项目只做「合并 + 清洗」,不生产规则, 规则来自下方「上游名单」表格里列出的开源项目。

⚠️ DNS 过滤的能力边界:它只能拦「域名」,拦不住同一个域名下混排的内容 (例如贴吧用自己的 API 下发广告位),也看不到 HTTPS 里的内容。 所以「某个 App 的广告没干净」不一定代表规则有错,详见第五节。


二、三分钟部署(新手向)

第 0 步:先有一个 AdGuard Home

还没装的话,Docker 一条命令即可(其它方式见 https://adguard.com/zh_cn/adguard-home/getting-started.html):

docker run -d --name adguardhome \
  -v /opt/adguardhome/work:/opt/adguardhome/work \
  -v /opt/adguardhome/conf:/opt/adguardhome/conf \
  -p 53:53/tcp -p 53:53/udp -p 3000:3000/tcp \
  --restart unless-stopped adguard/adguardhome

装好后浏览器打开 http://设备IP:3000,跟着向导设置管理账号,并把设备/路由器的 DNS 指向它。

第 1 步:添加「拦截清单」

  1. 进入 AdGuard Home 后台 → 左侧菜单 过滤器 → DNS 拦截清单
  2. 点 添加拦截清单
  3. 名称随便填(例如 AdGuard-Rules-Black),URL 填:
https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black.txt
  1. 点 保存

第 2 步:添加「允许清单」(强烈建议,别跳过)

同一个页面切换到 DNS 允许清单 标签 → 添加:

https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/White.txt

为什么必须两个都加:任何公共拦截名单都难免少量误杀(上游名单常把某些 App 的 网关、风控、CDN 域名一起拦掉,表现就是「App 显示无网络」)。允许清单负责把这些放行。 只订阅拦截清单,遇到「无网络」的概率会高很多。

第 3 步:更新并验证

  • 立即生效:过滤器页面点一次 「更新」(默认 12 小时自动更新一次, 可在 设置 → 常规 → 过滤器更新间隔 调整)
  • 验证是否生效(把 127.0.0.1 换成你的 AdGuard Home 地址):
nslookup doubleclick.net 127.0.0.1    # 广告域:应返回 0.0.0.0 或解析失败
nslookup gw.tmall.com 127.0.0.1       # 天猫校园网关:应能正常解析(保护名单在管)
nslookup dns.msftncsi.com 127.0.0.1   # 系统联网检测:应能正常解析

第 4 步:你自己的规则放哪

本项目只负责「公共部分」。你要单独拦/放某个域名时,有两个选择:

  1. 临时/少量:AdGuard Home 里的 过滤器 → 自定义规则,直接写 ||example.com^(拦)或 @@||example.com^(放);
  2. 长期/较多:放到你自己的名单仓库里再让本项目合并(当前已接入 本地规则 源,见下方表格)。自己的黑名单 优先级高于上游任何私人白名单。

国内下载慢?

GitHub 直连慢的话,在地址前面套一层公共加速前缀即可,例如:

https://gh-proxy.org/https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black.txt

三、订阅文件分别是干什么的

文件 作用 条数 订阅地址(推荐)
Black.txt 拦截:广告、追踪、统计、恶意域名 924,372 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black.txt
White.txt 允许:保护名单 + 你自己的白名单,用来纠正误杀 305 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/White.txt
Conflict.txt 冲突:同时出现在黑名单和白名单里的域名(仅供排查,一般不用订阅) 137 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Conflict.txt
Black-adblock.txt adblock 版:与 Black.txt 同源,统一 ABP 语法、无行尾注释,uBlock Origin / AdGuard / mihomo 可直接导入 789,514 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black-adblock.txt
Black-with-sources.txt 带上游来源的拦截版:每条规则附 # From: 源A; 源B(多个上游用分号分隔),用于追溯规则来自哪些上游;体积更大,不建议日常设备直接订阅 924,372 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black-with-sources.txt
Black-domains-cn-final.txt 中文源纯域名子集:给内存受限的路由器(mosdns adblock_set) 116,958 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black-domains-cn-final.txt
Black-domains-dedup.txt 全量去冗余版:父域吸收后的纯域名全集,语义等价、体积更小,给内存紧张的路由器 789,212 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black-domains-dedup.txt
Black-domains-small.txt 热门域小型版:从 1 万热门域命中项中筛出,体积小、误杀低,给内存极小的路由器(mosdns adblock_set) 127,671 https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black-domains-small.txt

推荐地址指向最新 Release(每次构建更新同名文件,永久有效)。

各文件详细说明

1. Black.txt(拦截 · 全量 · AdGuard 一键导入)

项目的主产物。混合两种语法:绝大多数行是纯域名(hosts 规则,精确匹配,不携带 # From: 行尾注释), 文件开头还有一段 ||域名^ 形式的域名空间规则(连全部子域一起拦,对付随机子域广告)。 适合所有 AdGuard Home 用户直接订阅。

父域吸收:不做。Black.txt 走 AdGuard Home 的 hosts 精确匹配(example.com 只匹配它自己、不含子域), 所以删掉子域会直接丢失拦截;文件里只有约 300 条 ABP 段能吸收,收益太小不值得复杂化。

2. Black-adblock.txt(拦截 · 全量 · 通用 ABP)

与 Black.txt 同源,但把所有规则统一成 ||域名^ 的 ABP 语法、并去掉行尾注释。 用于 uBlock Origin、AdGuard 浏览器扩展、mihomo 等通用 adblock 引擎(它们不认识 hosts 写法的行尾注释)。

父域吸收:已做。ABP 的 ||d^ 匹配 d 及其全部子域,祖先已在拦截集合里时子域规则冗余, 本次吸收掉约 11.2 万条(80.6 万 → 69.5 万)。放行段(@@||)不做吸收——放行父域会放大放行范围。

3. Black-domains-dedup.txt(拦截 · 纯域名 · 去冗余全量)

纯域名列表,做了「父域吸收」:如果 a.b.example.com 的父域 example.com 也在名单里, 则子域被删除(mosdns 等引擎是后缀匹配,父域已覆盖)。语义等价、体积从约 14.8 MB 降到 13.1 MB, 条数从 80 万降到约 69 万。适合内存充足(>256 MB)的路由器。

父域吸收:已做,且是这份文件的生成方式本身(吸收掉约 11.2 万条)。

4. Black-domains-small.txt(拦截 · 纯域名 · 热门域小型)

从 top-domains.txt(1 万个热门域名)的命中项里筛出来的小型版,约 11 万条。 体积小、误杀低,专门给内存很小的路由器(mosdns adblock_set),常驻内存约 25 MB。

父域吸收:已做(从 dedup 版筛选,天然继承吸收结果,复查 0 条可再删)。

5. Black-domains-cn-final.txt(拦截 · 纯域名 · 中文源)

只保留中文规则源的纯域名子集(anti-AD、海哥、秋风等 10 个源),约 2.5 万条。 误杀相对更少,适合只想拦中文广告、或内存极小的设备。

父域吸收:已做,约 3,200 条子域被父域覆盖(2.54 万 → 2.22 万条),常驻内存约 5 MB。

6. White.txt(允许)

保护名单 + 自定义白名单,用来纠正误杀。AdGuard Home 的「允许列表」格式。

父域吸收:不做。白名单吸收会放大放行范围(父域放行 = 放行其全部子域),有误伤风险。

7. Conflict.txt(冲突 · 排查用,不订阅)

同时出现在黑名单和白名单里的域名。只用于排查「为什么某个域名没被拦」, 不要订阅,订阅它反而会放行这些域名。

父域吸收:不适用(排查用,不参与订阅)。

8. Black-with-sources.txt(拦截 · 带来源标注 · 审计用)

与 Black.txt 同源,但每条规则行尾附带 # From: 源A; 源B(同一规则被多个上游收录时列出全部来源),用于追溯规则来自哪些上游。 文件体积更大、行尾注释也会增加解析与内存开销,不建议日常设备直接订阅; 如你的引擎支持行尾 # 注释,也可作为“带来源”的审查订阅。

父域吸收:不做(与 Black.txt 一致)。

文件格式说明:

  • 绝大多数行是纯域名,例如 example.com, AdGuard Home 按 hosts 规则处理,精确匹配该主机名;不携带 # From: 行尾注释,可减少内存占用;
  • 文件开头有一段以 ||域名^ 写法的域名空间规则(数量见上表), 这类规则会连全部子域一起拦,用来对付「广告域用随机子域轮换」的情况; 它们不带行尾注释——AdGuard 的网络规则不会剥离 #,带了注释整条就失效。

四、上游名单(每次构建自动统计)

黑名单源(拦截规则来源)

来源 本次贡献条数 仓库 / 地址
关圣去广告DNS 613,775(另含 293 条例外) https://raw.githubusercontent.com/guandasheng/adguardhome/main/rule/dns.txt
hagezi Pro 244,918 https://raw.githubusercontent.com/hagezi/dns-blocklists/main/adblock/pro.txt
AdBlock DNS Filters 241,631(另含 197 条例外) https://raw.githubusercontent.com/217heidai/adblockfilters/main/rules/adblockdns.txt
Mullvad 226,786 https://raw.githubusercontent.com/mullvad/dns-blocklists/main/output/doh/doh_adblock.txt
oisd/big 224,119 https://big.oisd.nl/
neodavhost 220,545 https://raw.githubusercontent.com/neodevpro/neodevhost/master/adblocker
AdRules 211,152 https://raw.githubusercontent.com/Cats-Team/AdRules/main/dns.txt
natsuki 206,225 https://raw.githubusercontent.com/Natsuki-Kaede/Natsuki-List/refs/heads/main/adguardhome.txt
adsethost 203,807 https://raw.githubusercontent.com/rentianyu/Ad-set-hosts/master/adguard
AdGuard DNS filter 191,257(另含 11 条例外) https://adguardteam.github.io/HostlistsRegistry/assets/filter_1.txt
Phishing Army 146,414 https://phishing.army/download/phishing_army_blocklist_extended.txt
ShadowWhisperer Tracking 133,659 https://raw.githubusercontent.com/ShadowWhisperer/BlockLists/master/Lists/Tracking
xndeye adblock_list 127,031(另含 28 条例外) https://raw.githubusercontent.com/xndeye/adblock_list/refs/heads/release/dns.txt
GOODBYEADS 121,639 https://raw.githubusercontent.com/8680/GOODBYEADS/master/data/rules/dns.txt
1hosts 102,239 https://raw.githubusercontent.com/badmojr/1Hosts/master/Lite/adblock.txt
anti-AD 96,391(另含 107 条例外) https://raw.githubusercontent.com/privacy-protection-tools/anti-AD/master/anti-ad-easylist.txt
ABP 57,488(另含 26 条例外) https://raw.githubusercontent.com/damengzhu/abpmerge/refs/heads/main/abpmerge.txt
ShadowWhisperer Malware 29,428 https://raw.githubusercontent.com/ShadowWhisperer/BlockLists/master/Lists/Malware
10007 12,422(另含 9 条例外) https://raw.githubusercontent.com/lingeringsound/10007_auto/master/adb.txt
海哥 12,061(另含 1 条例外) https://raw.githubusercontent.com/2771936993/HG/main/hg1.txt
smad 4,938 https://raw.githubusercontent.com/2Gardon/SM-Ad-FuckU-hosts/refs/heads/master/SMAdHosts
大萌主 4,517(另含 4 条例外) https://raw.githubusercontent.com/damengzhu/banad/main/jiekouAD.txt
HaGeZi Encrypted DNS 3,059 https://raw.githubusercontent.com/hagezi/dns-blocklists/main/adblock/doh.txt
Malicious URL Blocklist 2,119 https://adguardteam.github.io/HostlistsRegistry/assets/filter_11.txt
home-dns-adblock 1,011 https://raw.githubusercontent.com/abclq/home-dns-adblock/main/dist/adguard-dns-full.txt
本地规则(你自己的名单) 1,010 https://raw.githubusercontent.com/Logic769/Adguardhome-local-rules/main/blacklist.txt
秋风的规则 978 https://raw.githubusercontent.com/TG-Twilight/AWAvenue-Ads-Rule/main/AWAvenue-Ads-Rule.txt
茯苓的广告规则 664 https://raw.githubusercontent.com/Kuroba-Sayuki/FuLing-AdRules/main/FuLingRules/FuLingBlockList.txt
逆向涉猎 547 https://raw.githubusercontent.com/rssvcn/qy-Ads-Rule/main/black.txt
DD自用 464(另含 159 条例外) https://raw.githubusercontent.com/afwfv/DD-AD/main/rule/DD-AD.txt
困了想睡觉 47 https://raw.githubusercontent.com/Kuner-mw/DNS-Kuner/main/FilterRules/blacklist.txt

白名单源(放行规则来源)

来源 本次贡献条数 仓库 / 地址
本地规则(白名单) 165 https://raw.githubusercontent.com/Logic769/Adguardhome-local-rules/main/whitelist.txt

统计的是「本次构建从该源解析出的条数」,同一域名被多个源收录时会去重, 所以各源之和会大于最终条数。

实际拦截贡献(AdGuard Home 查询日志)

统计生成:2026-11-22 02:45:04 (UTC+8);统计窗口:2026-11-22 00:25:46 (UTC+8) ~ 2026-11-22 01:38:42 (UTC+8)(约 1.2 小时);共 2,000 次查询,841 次被拦截(42.05%)。 数据来自我的 AdGuard Home 查询日志,只统计聚合命中来源,不包含具体查询内容;服务器每 15 分钟更新,本页随每次构建刷新。 注:同一域名被多个上游同时收录时,实际拦截事件按来源数平均分摊(1/N);「域名空间」规则以 ||父域^ 形式覆盖全部子域,无法对应单一上游源,单独统计。

上游源 实际拦截事件 事件占比 命中唯一域名 规则条数 规则占比
ShadowWhisperer Tracking 142.45 16.94% 30 46,728 3.29%
海哥 53.06 6.31% 7 5,975 0.42%
本地规则 46.07 5.48% 2 440 0.03%
xndeye adblock_list 30.42 3.62% 40 57,400 4.04%
关圣去广告DNS 18.06 2.15% 38 261,013 18.39%
AdBlock DNS Filters 17.53 2.08% 36 94,752 6.68%
1hosts 16.90 2.01% 33 42,595 3.00%
Mullvad 15.86 1.89% 31 90,223 6.36%
hagezi Pro 15.76 1.87% 35 110,517 7.79%
AdGuard DNS filter 15.42 1.83% 28 71,436 5.03%
其他 23 个源 131.46 15.64% — 638,135 44.95%
未映射(可能是自定义规则/新规则) 338 40.19% 33 — —

五、规则为什么这么写?(进阶:合并与纠错规则)

1. 会丢弃的东西

  • 带上下文修饰符的规则($domain=、$third-party、$script、$path= 等): 这类条件在 DNS 层无法表达,硬留着会把「只在某站点生效」的规则变成全局拦截, 是历史上最主要的误杀来源(曾把 gw.tmall.com 的 $path=/union/ 规则放大成 「天猫校园整个网关被拦 → App 显示无网络」)。
  • $badfilter(取消规则):它是否定语义,不能当拦截执行。
  • 死规则:裸 IP、含下划线的域名、首尾点、公共后缀(com.cn 之类)、 以及 TLD 不是「≥2 字符且首尾为字母」的域名——这些在 AdGuard Home 里 通不过域名校验,会被退化成 URL 子串规则并连注释一起解析,永远不可能命中。

2. 上游 @@ 例外(白名单)只采纳「有争议」的

部分名单自带很长的私人白名单(有的近 3000 条 @@)。照单全收会把公认广告域放行 (实测 als.baidu.com 被 17 个源共同拦截、nsclick.baidu.com 被 16 个源拦截, 却因一句 @@ 被放行,直接导致贴吧广告回流)。 因此:被 3 个以上独立名单共同拦截的域名,不采纳任何单个名单的例外。

3. 优先级

  1. 核心服务保护名单(系统更新、联网检测、推送通道、支付、加密 DNS、NTP 等) —— 永不拦截,防止「App 显示无网络」;
  2. 你自己的本地名单 —— 你的黑名单优先于上游一切私人白名单;
  3. 上游拦截规则。

4. 通配规则的处理

  • 上游 ||*.X^ 的原意是「拦 X 的全部子域」,纯域名格式却会把它降级成 「只拦 X 本身」,子域全漏。本项目把它还原成域名空间规则 ||X^(覆盖全部子域), 本次 301 条;
  • 但平台内容 CDN(拼多多图床 pddpic.com、B 站 hdslb.com、 快手 yximgs.com、字节 pstatp.com 等)以及「有子域被上游放行」的父域 不会被自动升级,避免把「没图没视频」这种故障引入;
  • 你自己白名单里「只含一个 *」的放行(如 @@||storage*360buyimg.com^)会还原成 @@||360buyimg.com^,否则它们在 DNS 层等于没写。

5. 抓取与构建的可靠性

  • 每个源失败会重试 3 次(退避 3s/6s),仍失败则构建失败、不发布新版—— 宁可停更一次,也不发布「悄悄少了一个源」的残缺名单;
  • 同一份名单被配成两个源时按源文件去重,避免「多源共识」判定被重复计数放大;
  • 中文域名(IDN)按 IDNA 转成 punycode 再输出;
  • 行内注释会被剥离:||example.com^$important # 说明 只取规则本身。不剥离的话 注释会混进修饰符,整条规则被当成「未知修饰符」静默丢弃——实测有 8 条白名单 因此失效,而构建日志完全看不出问题。

6. 本次构建统计

保留 3,616,601 条(其中带上下文修饰符但目标本身是广告域的 157 条), 丢弃上下文规则 6,246 条,丢弃 badfilter 16 条, 采纳全局例外 1,144 条,忽略不可信的上游例外 174 条, 剔除无效域名 19,162 条。


六、自动构建做了什么

拉取上游名单(31 个黑名单源 + 本地黑白名单)
   ↓  解析 adblock / hosts 两种语法,剔除上下文修饰符、$badfilter、死规则
   ↓  分离上游的 @@ 例外,只采纳「有争议」的
   ↓  新源套用知名站点护栏(top-domains.txt:命中就不收,避免拦死真实站点)
   ↓  合并去重 + 冲突消解(保护名单 > 你的本地名单 > 上游)
   ↓  还原 ||*.X^ 为域名空间规则(含平台 CDN 安全过滤)
   ↓  输出 Black.txt / White.txt / Conflict.txt
   ↓  重建本 README(数量、上游贡献、构建时间)并提交
   ↓  创建 Release(供 releases/latest/download 永久订阅地址使用)

七、常见问题

Q:更新后广告还在? 先确认点过过滤器页面的「更新」,再检查该广告是不是由 App 自己的 API 下发 (DNS 层拦不到);可用 AdGuard Home 的「查询日志」看该请求是否被拦。

Q:某个 App 打不开 / 显示无网络? 回到 过滤器 → 查询日志,看它的请求是不是被拦了;确认后把域名加进 允许清单(自定义规则写 @@||域名^),或提交到你自己的本地名单仓库。

Q:为什么同一域名有时拦有时不拦? AdGuard Home 的查询日志里 Result.Rules 会给出命中的规则来源, 据此能判断是保护名单、你自己的规则,还是某个上游源。

Q:能用多久 / 会被删吗? 订阅地址用 releases/latest/download,每次构建都会更新同名文件,地址永久有效。


构建时间:2026-11-22 02:55:48 (UTC+8) · 项目作者:logic769 · 本 README 由 documents/process_rules.py 的 update_readme() 在每次构建时自动生成, 请勿手工修改(会被下一次构建覆盖)。

About

通过 GitHub Actions 自动合并、去重多个来源的 AdGuard Home 去广告规则。 支持自动检测并分离上游规则中的混合黑白名单。 黑白名单完全独立,同时存在的规则会单独列在冲突规则中。感谢分享规则的各位大佬。

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages