树莓派上 AdGuard Home 安装与优化完整指南

最后更新: 9月2026
  • AdGuard Home 充当 DNS 服务器,在恶意请求和广告请求到达设备之前对其进行过滤。
  • 安装可以通过直接脚本或 Docker 容器完成,以实现更灵活、更清晰的管理。
  • 它的路由器级配置允许您保护整个家庭网络,包括智能电视和手机,而无需安装单独的应用程序。

树莓派上的 AdGuard Home

说实话,如今上网就像走在雷区里。无论你是想找个简单的食谱还是浏览新闻,总会有烦人的广告或追踪器试图偷偷溜进你的屏幕。虽然很多人都会使用浏览器扩展程序,但这个问题在手机应用和智能电视上依然存在,因为在这些平台上安装广告拦截器根本不可能。

这时,AdGuard Home 就派上了用场。这款强大的工具能将你的树莓派变成覆盖全屋的数字防护罩。与传统的拦截器不同,该系统在网络层面运行,这意味着连接到你 Wi-Fi 的任何设备,从智能冰箱到孩子的手机,都能享受干净私密的浏览体验,而无需对每个设备进行单独配置。

使用 Pi-hole 拦截广告
相关文章:
Pi-hole 广告拦截完整指南

AdGuard Home究竟是什么?它是如何工作的?

树莓派上的 AdGuard Home

简单来说,你可以把DNS想象成互联网的地址簿。当你输入网址时,你的设备会查询这个地址簿,找到应该连接的IP地址。我们通常使用互联网服务提供商提供的地址簿,这不仅速度慢,还会记录我们上网的每一步操作,并将这些数据出售给广告商。因此,你可以选择使用谷歌的DNS或Digi的DNS来提升速度和安全性。

  DHCP 协议完整指南:操作、优势和安全性

AdGuard Home 位于此过程的中间位置。当设备请求广告服务器地址时,AdGuard 会检查其黑名单,如果检测到广告,则直接不返回该地址。这样一来,广告甚至不会被下载,从而加快页面加载速度,并显著节省移动数据和带宽。

AdGuard Home 和 Pi-hole:该选哪个?

树莓派上的 AdGuard Home

人们经常将它与该领域的资深产品 Pi-hole 进行比较。虽然它们的功能相同,但 AdGuard Home 给人的感觉更加现代化。它使用 Go 语言开发,通常能提供更流畅、更高效的性能。此外,它的界面对普通用户来说也更加直观、美观。

加固家庭实验室 VLAN
相关文章:
利用 VLAN 加固家庭实验室:完整的家庭安全指南

AdGuard 的一个关键优势在于它内置了许多其他系统需要插件或复杂手动配置才能实现的功能,例如对加密 DNS(DoH 和 DoT)的原生支持以及集成的 DHCP 服务器。这大大简化了网络管理,无需在终端中费力地处理晦涩难懂的配置文件。

硬件要求和准备

树莓派上的 AdGuard Home

要搭建这套系统,你需要一台全天候运行的服务器。最佳选择是树莓派,8GB 4B 版本性能强劲,不过像 Zero 2W 这样配置较低的型号也能胜任。如果你手头没有合适的硬件,可以使用一台装有 Docker 的旧电脑,甚至可以使用云端的免费 VPS 服务器,例如 Oracle Cloud 提供的服务器。

如果您选择树莓派,最好安装 Raspberry Pi OS Lite,以免浪费资源安装您不会使用的图形界面。务必为设备分配静态 IP 地址;否则,如果路由器重启树莓派并使用不同的 IP 地址,您家里的所有设备都将无法访问互联网,因为设备将无法找到 DNS 服务器。

高级自托管 VPN
相关文章:
高级自托管 VPN:完整指南和实用选项

详细安装过程

树莓派上的 AdGuard Home

安装 AdGuard Home 主要有两种方法。第一种方法最快:使用 curl 命令从终端运行自动安装脚本。此方法会下载官方二进制文件,并将服务配置为随系统自动启动。

  如何使用 Nextcloud 创建自己的私有云

第二种方法是使用 Docker,这种方法非常适合那些喜欢井然有序并希望避免依赖冲突的用户。这可以通过一个文件来实现。 docker-compose.yml我们可以定义必要的端口(DNS 使用 53 端口,初始配置使用 3000 端口,控制面板使用 80 或 8181 端口)。Ubuntu 系统的一个关键细节是: 自由港 53自该服务以来 systemd-resolved 它通常会占用该空间,阻止 AdGuard 启动。

面板配置和优化

安装完成后,您可以通过输入服务器的 IP 地址以及端口号 3000 来访问 Web 界面。向导非常简单:您只需创建一个管理员用户,并选择系统监听的端口即可。进入控制面板后,最重要的是前往DNS 过滤器部分,添加更严格的黑名单,例如 HaGeZi 的黑名单,这些黑名单以其高效性而闻名。

要实现完全过滤,您需要访问路由器设置,并将 DHCP DNS 服务器更改为树莓派的 IP 地址。这样,任何连接到 Wi-Fi 的设备都会自动应用广告拦截功能。如果您使用的是安卓设备,请谨慎使用“私有 DNS”选项,因为如果设置为自动,手机可能会绕过 AdGuard 并使用谷歌的 DNS 服务器。

DNS 封锁的局限性和现实情况

重要的是要认清现实:DNS 拦截器并非万能。它无法屏蔽 YouTube 或 Instagram、Facebook 等应用中的广告,因为它们投放广告的域名与实际内容的域名相同。如果您屏蔽了广告域名,就会屏蔽整个视频或帖子。

  户外 Wi-Fi 7 接入点:充分利用网络功能的完整指南

为了解决这个问题,理想的方案是将 AdGuard Home 与浏览器中的 uBlock Origin 等工具结合使用。AdGuard 可以清理网络并保护“非智能”设备(例如 Roku 或智能电视),而 uBlock Origin 扩展程序则负责对电脑进行精细的清理。这样,您就能最大限度地保护隐私,并获得流畅的用户体验。

客户管理和家长控制

AdGuard 的优势之一在于其能够单独管理客户端。您可以为每个家庭成员设置不同的规则;例如,仅在您孩子的设备上启用安全搜索过滤器和成人内容拦截功能,而您自己的设备则保持不受限制的访问权限。

对于在VPS上使用该系统的用户来说,配置防火墙和允许的客户端至关重要。向所有人开放53端口非常危险,因为它可能会加剧DNS攻击。正确的做法是仅允许您自己的公网IP地址访问,以维护服务器安全。