AdguardTeam/AdGuardHome
运维与部署自建 DNS 服务,为网络中所有设备拦截广告与跟踪域名,无需在每台设备上安装客户端。
AdGuard Home 是一个可自行运行的免费开源 DNS 服务器,在自有网络上为所有接入设备统一拦截广告与跟踪域名。它适合能控制路由器或家用服务器、又不想在每台设备上装拦截软件的人。它并非客户端广告拦截器:由于工作在 DNS 层,与内容共用同一域名的广告(例如 YouTube、Twitch 上的广告)无法被它拦截。
功能与原理
安装完成后,把设备的 DNS 指向它,AdGuard Home 就会对跟踪和广告域名返回“黑洞”响应,设备因此不会连接到这些服务器。它自带 HTTPS 管理网页、内置 DHCP 服务器,并支持加密上游(DNS-over-HTTPS、DNS-over-TLS、DNSCrypt),自身也能作为 DoH/DoT 服务器运行,还提供按客户端配置、访问控制、家长控制和强制安全搜索;它也可以在不使用 root 权限的情况下运行。README 在与 Pi-hole 对比时宣称这些功能开箱即用、无需额外软件,但这张对比表是项目方的自述。
运行方式
- 面向 Linux、Unix、macOS、FreeBSD 和 OpenBSD 的自动安装脚本。
- 官方 Docker 镜像,以及 Linux 上的 Snap 包。
- 手动安装,步骤见项目 wiki。
- 从源码构建需要 Go 1.25+、Node.js 24.10.0+ 和 npm 10.8+;构建不支持非标准的并行
make -j参数设置。 - 可通过 REST API(附 OpenAPI 定义)集成,另有 Python 客户端和 Home Assistant 集成。
限制与隐私
文档列出的已知限制源于 DNS 过滤本身,并不是缺陷:与内容共用域名的 YouTube、Twitch 广告以及赞助帖无法拦截;项目方表示 DNS 永远不足以处理这类情况。AdGuard Home 不收集使用统计,也不会在你主动配置之前使用任何网络服务。项目采用 GPL-3.0 许可证,因此再分发或修改后部署需承担相应的 copyleft 义务。2024 年 Hacker News 讨论中的诊断性评论肯定了这一方案,同时也对厂商的公司所在地提出疑虑;这属于对来源的看法,并非已被证实的缺陷,代码本身是公开可审查的。
HotRepo 点评
唯一可比较的日榜记录是 2026-10-30 的 37,933 stars(当日 +107),样本太少,不足以说明趋势。该项目持续的相关性更适合参考其第三方集成数量和自 2016 年以来的存续时间,而不是某一天的数字。
本文由 AI 根据项目 README 生成,更新于 2026年10月30日,以项目官方文档为准。