Pi-hole

Pi-hole 是一款开源的网络级广告与追踪拦截软件,作为局域网的 DNS 黑洞(DNS sinkhole)工作:它接管网络的 DNS 解析,把已知的广告、追踪与恶意域名解析到空地址,从而在整个网络层面拦截广告,无需在每台设备上安装插件。因其最初设计在树莓派(Raspberry Pi)上运行而得名,但实际上可运行于任意 Linux 主机或容器中,是 homelab 中最受欢迎的网络服务之一。

发展背景

Pi-hole 项目针对传统浏览器广告拦截插件「只保护单设备、对智能电视/手机 App 无能为力」的痛点而生。通过把拦截放在 DNS 层,它可以保护连接到该网络的所有设备——电脑、手机、智能电视、IoT 设备。项目以易于在树莓派上一键安装、配套美观的统计面板而迅速流行,成为家庭网络隐私与去广告的标志性工具。

核心功能

• 网络级广告拦截:基于可订阅的黑名单(blocklist)拦截广告与追踪域名,覆盖全网设备。
• DNS 服务器:内置 DNS 解析与缓存,可加速重复查询。
• 本地 DHCP(可选):可替代路由器的 DHCP,以便精确识别每台客户端。
• 统计面板:Web 仪表盘展示查询总量、拦截比例、各客户端与域名排行。
• 白/黑名单管理:可手动放行被误拦的域名或额外屏蔽特定域名。
• 上游与加密 DNS:可配置上游解析器,并通过 cloudflared 等实现 DNS-over-HTTPS 加密查询。

工作原理

Pi-hole 的核心是改造过的 dnsmasq(项目内称 FTLDNS / pihole-FTL)。当客户端发起 DNS 查询时,Pi-hole 先比对查询域名是否在黑名单中:命中则返回一个无效/空地址(如 0.0.0.0),浏览器或 App 因无法解析广告服务器而不显示广告;未命中则正常转发到上游 DNS 并缓存结果。要让全网生效,需把路由器或各设备的 DNS 服务器指向 Pi-hole。FTL 引擎同时负责高效记录查询日志并通过 API 提供给 Web 面板。

部署与硬件要求

• 极低资源:树莓派、低端单板机或一个小容器即可流畅运行,内存与 CPU 需求都很低。
• 安装方式:官方一键安装脚本、Docker 镜像,或在现有 Linux 上手动安装。
• 网络配置:把路由器 DHCP 下发的 DNS 改为 Pi-hole 地址(最彻底),或让 Pi-hole 接管 DHCP。
• 稳定性建议:作为全网 DNS,建议给主机固定 IP 并保证常开;可部署两台做冗余避免单点故障。

典型使用场景

• 家庭全网去广告:一处部署,保护手机、电视、IoT 等所有设备。
• 隐私保护:拦截追踪与遥测域名,减少数据外泄。
• 恶意域名拦截:订阅威胁情报黑名单阻断钓鱼与恶意站点。
• 家庭上网管理:配合分组与定时,对特定设备做内容限制。

与同类对比

相较 AdGuard Home,Pi-hole 历史更久、社区与黑名单生态成熟,但加密 DNS、按客户端策略等功能需额外组件,界面较传统;AdGuard Home 单二进制内置 DoH/DoT/DoQ 与更细的客户端规则、界面更现代。相较浏览器插件(如 uBlock Origin),Pi-hole 在 DNS 层保护全网设备,但无法做页面元素级精细过滤,二者常配合使用。相较路由器自带的简单过滤,Pi-hole 黑名单更新更勤、可视化更强。

优缺点与注意事项

• 优点:全网保护、资源占用极低、统计直观、黑名单生态丰富、开源免费。
• 缺点:作为 DNS 单点需考虑冗余、过度激进的黑名单易误杀、原生加密 DNS 需额外配置。
• 注意:DNS 层无法拦截使用自有 DNS 或 DoH 的应用(如部分浏览器/智能电视);误拦时及时加白名单;建议双机或备用 DNS 防解析中断。