一句话说明:把 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 的广告没干净」不一定代表规则有错,详见第五节。
还没装的话,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 指向它。
- 进入 AdGuard Home 后台 → 左侧菜单 过滤器 → DNS 拦截清单
- 点 添加拦截清单
- 名称随便填(例如
AdGuard-Rules-Black),URL 填:
https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black.txt
- 点 保存
同一个页面切换到 DNS 允许清单 标签 → 添加:
https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/White.txt
为什么必须两个都加:任何公共拦截名单都难免少量误杀(上游名单常把某些 App 的 网关、风控、CDN 域名一起拦掉,表现就是「App 显示无网络」)。允许清单负责把这些放行。 只订阅拦截清单,遇到「无网络」的概率会高很多。
- 立即生效:过滤器页面点一次 「更新」(默认 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 # 系统联网检测:应能正常解析本项目只负责「公共部分」。你要单独拦/放某个域名时,有两个选择:
- 临时/少量:AdGuard Home 里的 过滤器 → 自定义规则,直接写
||example.com^(拦)或@@||example.com^(放); - 长期/较多:放到你自己的名单仓库里再让本项目合并(当前已接入
本地规则源,见下方表格)。自己的黑名单 优先级高于上游任何私人白名单。
GitHub 直连慢的话,在地址前面套一层公共加速前缀即可,例如:
https://gh-proxy.org/https://github.com/Logic769/AdguardHome-Rules/releases/latest/download/Black.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 的网络规则不会剥离#,带了注释整条就失效。
| 来源 | 本次贡献条数 | 仓库 / 地址 |
|---|---|---|
| 本地规则(白名单) | 165 | https://raw.githubusercontent.com/Logic769/Adguardhome-local-rules/main/whitelist.txt |
统计的是「本次构建从该源解析出的条数」,同一域名被多个源收录时会去重, 所以各源之和会大于最终条数。
统计生成: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 | — | — |
- 带上下文修饰符的规则(
$domain=、$third-party、$script、$path=等): 这类条件在 DNS 层无法表达,硬留着会把「只在某站点生效」的规则变成全局拦截, 是历史上最主要的误杀来源(曾把gw.tmall.com的$path=/union/规则放大成 「天猫校园整个网关被拦 → App 显示无网络」)。 $badfilter(取消规则):它是否定语义,不能当拦截执行。- 死规则:裸 IP、含下划线的域名、首尾点、公共后缀(
com.cn之类)、 以及 TLD 不是「≥2 字符且首尾为字母」的域名——这些在 AdGuard Home 里 通不过域名校验,会被退化成 URL 子串规则并连注释一起解析,永远不可能命中。
部分名单自带很长的私人白名单(有的近 3000 条 @@)。照单全收会把公认广告域放行
(实测 als.baidu.com 被 17 个源共同拦截、nsclick.baidu.com 被 16 个源拦截,
却因一句 @@ 被放行,直接导致贴吧广告回流)。
因此:被 3 个以上独立名单共同拦截的域名,不采纳任何单个名单的例外。
- 核心服务保护名单(系统更新、联网检测、推送通道、支付、加密 DNS、NTP 等) —— 永不拦截,防止「App 显示无网络」;
- 你自己的本地名单 —— 你的黑名单优先于上游一切私人白名单;
- 上游拦截规则。
- 上游
||*.X^的原意是「拦 X 的全部子域」,纯域名格式却会把它降级成 「只拦 X 本身」,子域全漏。本项目把它还原成域名空间规则||X^(覆盖全部子域), 本次 301 条; - 但平台内容 CDN(拼多多图床
pddpic.com、B 站hdslb.com、 快手yximgs.com、字节pstatp.com等)以及「有子域被上游放行」的父域 不会被自动升级,避免把「没图没视频」这种故障引入; - 你自己白名单里「只含一个
*」的放行(如@@||storage*360buyimg.com^)会还原成@@||360buyimg.com^,否则它们在 DNS 层等于没写。
- 每个源失败会重试 3 次(退避 3s/6s),仍失败则构建失败、不发布新版—— 宁可停更一次,也不发布「悄悄少了一个源」的残缺名单;
- 同一份名单被配成两个源时按源文件去重,避免「多源共识」判定被重复计数放大;
- 中文域名(IDN)按 IDNA 转成 punycode 再输出;
- 行内注释会被剥离:
||example.com^$important # 说明只取规则本身。不剥离的话 注释会混进修饰符,整条规则被当成「未知修饰符」静默丢弃——实测有 8 条白名单 因此失效,而构建日志完全看不出问题。
保留 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() 在每次构建时自动生成,
请勿手工修改(会被下一次构建覆盖)。