home-dns-adblock

项目概述

home-dns-adblock 是一套面向家庭网络的 DNS 层广告拦截方案，用 dnsmasq 把红果免费短剧、番茄小说等 App 的广告域名一律解析到 0.0.0.0 黑洞。无需 root、不装证书、不改任何 App，家里设备把 DNS 指过来即可生效，出门通过 Tailscale 隧道照样拦截。

218 条精确域名、零误伤，一台常开主机守护全家去广告。

主要功能

• DNS 黑洞拦截：命中广告域一律回答 0.0.0.0，广告拉不到数据即被跳过
• 精确域名规则：218 条精确域名加白名单保护正片，不使用宽泛关键字
• 出门照样生效：接入 Tailscale 后 4G、异地 WiFi 走加密隧道回家解析
• 多格式订阅：dist/ 提供 AdGuard、hosts、Clash、Surge、Quantumult X 等现成规则
• 广告域发现工具：adblock-helper.sh 按时间戳回溯 DNS 日志，精准挑出新广告域
• 规则生成器：gen_rules.py 多源社区规则集交叉合并并保留手工补充
• 一键部署与自检：install.sh 快速部署，verify.sh 部署后验证
• 全量查询日志：实时观察每台设备在查什么、拦下了什么

适用人群

• 被红果、番茄广告困扰的用户
• 有一台常开 Linux 主机的自托管玩家
• 希望家人零配置一起免疫广告的家庭
• 已有 AdGuard/Clash 只想订阅规则的用户

快速上手

1. 准备一台常开的 Linux 主机并固定内网 IP
2. 安装 dnsmasq，把 config/ 下规则与配置模板拷入 /etc/dnsmasq-adblock/
3. 修改 listen-address 等三处配置后启动 dnsmasq
4. 设备或路由器 DHCP 把 DNS 指向主机内网 IP
5. 需要在外生效时安装 Tailscale 并在后台开启「Override local DNS」

核心优势

• 零侵入：不 root、不装描述文件与 CA 证书，改动不落任何设备
• 拦域名更稳：广告 IP 天天变但域名固定，拦住查号一步即可
• 极省资源：实测内存 2.5 MB、CPU 0.0%，树莓派也跑得动
• 两种玩法：可自建 DNS 服务，也可只订阅现成规则列表

系统要求

项目	要求
服务器	Ubuntu/Debian/OpenWrt/树莓派等常开 Linux 主机
依赖	dnsmasq；外出场景需 Tailscale 账号
开源许可	MIT

注意事项

• 直播流插播广告与正片共用 CDN 域名无法拦截，已缓存的广告也拦不住
• 客户端改用 DoH 或系统级 VPN 会绕过本机 DNS
• 新增规则先在单台设备验证正片正常，再全量放开
• iOS 设备只保留这一个 DNS，混入不通的公共 DNS 会导致断网