AdGuardHome树莓派安装：低功耗广告拦截方案

你是否厌倦了在家庭网络中的每台设备上单独安装广告拦截器？智能电视、手机、平板上的广告是否让你不胜其烦？本文将带你通过树莓派（Raspberry Pi）搭建一套低功耗、全网络覆盖的广告拦截方案，只需一次配置，即可保护家中所有设备。

读完本文后，你将能够：

• 在树莓派上成功部署AdGuardHome
• 理解AdGuardHome的网络广告拦截原理
• 配置家庭设备使用AdGuardHome作为DNS服务器
• 查看广告拦截效果和网络统计数据

方案概述

AdGuardHome是一款网络级广告和跟踪器拦截DNS服务器，它通过将广告域名重定向到"黑洞"来阻止设备连接到这些服务器。与传统广告拦截器不同，AdGuardHome只需在网络中的一台设备（如树莓派）上安装，即可保护整个网络中的所有设备，无需在每个设备上单独配置。

AdGuardHome的工作原理如图所示：

树莓派作为低功耗设备，非常适合作为24小时运行的家庭广告拦截服务器，全年耗电量仅相当于几瓦灯泡，既环保又经济。

准备工作

硬件需求

• 树莓派（任何型号均可，推荐Raspberry Pi 3或更高版本以获得更好性能）
• MicroSD卡（至少4GB，推荐8GB及以上）
• 电源适配器
• 网线（推荐，用于稳定连接）或Wi-Fi连接

软件需求

• Raspbian或其他基于Debian的树莓派操作系统
• 网络连接（用于下载安装文件）
• 基本的Linux命令行操作知识

安装步骤

1. 系统更新

首先，确保你的树莓派系统是最新的：

sudo apt update && sudo apt upgrade -y

2. 下载并运行安装脚本

AdGuardHome提供了便捷的一键安装脚本，适用于Linux系统。在树莓派终端中输入以下命令：

curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

或者如果你没有安装curl，可以使用wget：

wget --no-verbose -O - https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

安装脚本会自动检测系统环境并完成安装，安装过程可能需要几分钟时间。安装脚本的详细代码可以查看scripts/install.sh文件。

3. 安装完成验证

安装成功后，脚本会显示类似以下的消息：

AdGuard Home is now installed and running
you can control the service status with the following commands:
sudo /opt/AdGuardHome/AdGuardHome -s start|stop|restart|status|install|uninstall

初始配置

1. 访问管理界面

安装完成后，AdGuardHome会自动启动。打开浏览器，访问树莓派的IP地址，端口为3000，例如：http://192.168.1.100:3000

2. 设置管理员账户

首次访问时，系统会引导你完成初始设置：

• 创建管理员用户名和密码
• 设置Web管理界面端口（默认80）
• 设置DNS服务器端口（默认53）

3. 配置上游DNS服务器

AdGuardHome需要使用上游DNS服务器来解析非拦截域名。你可以选择：

• 默认DNS（AdGuard DNS）
• 自定义DNS（如Cloudflare、Google DNS等）
• 加密DNS（DNS-over-HTTPS、DNS-over-TLS等）

配置界面如图所示（示意图）：

客户端配置

AdGuardHome作为DNS服务器工作，因此需要将你的设备DNS设置指向树莓派的IP地址。有两种方法可以实现：

方法1：在路由器中设置（推荐）

在路由器的DHCP设置中，将DNS服务器地址修改为树莓派的IP地址。这样，所有连接到路由器的设备都会自动使用AdGuardHome作为DNS服务器，无需在每个设备上单独配置。

方法2：在单个设备上设置

如果无法修改路由器设置，可以在每个设备的网络设置中手动将DNS服务器设置为树莓派的IP地址。

高级配置

1. 配置过滤规则

AdGuardHome默认包含一些基本的广告拦截规则，你可以根据需要添加更多规则列表。在管理界面中，导航到"过滤器"选项卡，点击"添加过滤器"，输入规则列表URL。

官方推荐的过滤器列表可以在internal/filtering/目录中找到相关实现代码。

2. 配置客户端设置

在"客户端"选项卡中，你可以为不同的设备设置个性化的过滤规则。例如，为儿童设备添加额外的安全过滤，或者为某些设备禁用广告拦截。

客户端管理的实现代码可以查看internal/aghuser/目录中的用户和会话管理相关文件。

3. 启用DHCP服务器

AdGuardHome内置了DHCP服务器功能，可以替代路由器的DHCP服务，方便统一管理IP分配和DNS设置。在"设置" -> "DHCP"中启用并配置DHCP服务器。

DHCP服务的实现代码位于internal/dhcpsvc/目录。

维护与更新

1. 查看服务状态

sudo /opt/AdGuardHome/AdGuardHome -s status

2. 更新AdGuardHome

AdGuardHome提供了内置的更新功能，在管理界面的"设置" -> "更新"中可以检查并安装最新版本。

或者通过命令行更新：

cd /opt/AdGuardHome
sudo ./AdGuardHome -s stop
sudo curl -L -S -o AdGuardHome_new https://static.adtidy.org/adguardhome/release/AdGuardHome_linux_armv7.tar.gz
sudo tar xzf AdGuardHome_new
sudo ./AdGuardHome -s start

更新功能的实现代码可以在internal/updater/目录中找到。

3. 查看日志

AdGuardHome的日志文件通常位于/opt/AdGuardHome/data/AdGuardHome.log，可以通过以下命令查看：

tail -f /opt/AdGuardHome/data/AdGuardHome.log

性能优化

1. 调整缓存大小

在"设置" -> "DNS设置"中，可以调整DNS缓存大小，增加缓存可以提高解析速度并减少重复查询。

2. 启用DNSSEC

DNSSEC可以提高DNS查询的安全性，在"设置" -> "DNS设置"中启用"使用DNSSEC"选项。

DNSSEC相关实现代码位于internal/dnsforward/目录。

3. 配置上游DNS

选择合适的上游DNS服务器可以提高解析速度和可靠性。推荐使用支持DNS-over-HTTPS或DNS-over-TLS的加密DNS服务。

常见问题解决

1. 安装后无法访问互联网

检查AdGuardHome服务是否正常运行，以及DNS设置是否正确。尝试重启服务：

sudo /opt/AdGuardHome/AdGuardHome -s restart

2. 某些网站无法访问

可能是由于过滤规则误拦截，你可以在"查询日志"中找到被拦截的域名，然后在"允许列表"中添加该域名。

查询日志功能的实现代码位于internal/querylog/目录。

3. 树莓派重启后AdGuardHome不自动启动

检查服务是否正确安装：

sudo /opt/AdGuardHome/AdGuardHome -s install

服务管理的实现代码可以在internal/aghos/service.go中找到。

结论

通过树莓派安装AdGuardHome，你已经拥有了一个功能强大、低功耗的家庭广告拦截解决方案。它不仅可以拦截广告和跟踪器，还能提高网络隐私和安全性，同时减少带宽使用。

AdGuardHome的源代码托管在GitHub上，如果你有编程经验，可以查看main.go了解程序入口，或通过CONTRIBUTING.md了解如何为项目贡献代码。

希望本指南能帮助你成功搭建家庭广告拦截系统，享受更清洁、更安全的网络体验！