mort3m/adguard-home-raspi

AdGuardHome Docker镜像（树莓派版）

适用于树莓派（已测试3+、Zero W型号）的AdGuard Home Docker容器。
GitHub仓库：https://github.com/mort3m/adguard-home-docker-raspi

镜像概述

本镜像为树莓派设备提供AdGuard Home的容器化部署方案，支持广告拦截、DNS解析等功能，帮助用户构建家庭网络的广告过滤与隐私保护环境。

核心功能

• 广告与跟踪器拦截：过滤网页、移动应用中的广告及***跟踪请求
• 自定义DNS规则：支持配置个性化DNS解析策略，提升网络访问效率
• 轻量适配：针对树莓派硬件优化，运行稳定且资源占用低

使用场景

• 树莓派搭建家庭广告拦截DNS服务器，覆盖所有联网设备
• 个人网络环境中减少广告干扰，保护上网隐私

配置说明

快速试用

执行以下命令启动临时容器（配置不持久化）：

bash
docker run --rm -ti -p 53:53/udp -p 53:53/tcp -p 3000:3000 docker.xuanyuan.run/mort3m/adguard-home-raspi

访问 http://<你的IP>:1337，初始登录账号密码均为 admin。

正式运行

容器内 /data/ 目录存储配置文件，需先生成配置：

bash
docker run --rm -ti -v <你的数据目录>:/data docker.xuanyuan.run/mort3m/adguard-home-raspi

按 CTRL-C 退出后，<你的数据目录> 会生成以下配置文件：

AdGuardHome
AdGuardHome.yaml
Corefile
dnsfilter.txt

注意：AdGuardHome二进制曾需与配置耦合（参考https://github.com/AdguardTeam/AdGuardHome/issues/381%EF%BC%89%EF%BC%8C%E8%AF%A5%E9%97%AE%E9%A2%98%E5%B7%B2%E4%BF%AE%E5%A4%8D%EF%BC%8C%E9%95%9C%E5%83%8F%E5%B0%86%E5%90%8C%E6%AD%A5%E6%9B%B4%E6%96%B0%E6%96%B0%E7%89%88%E6%9C%AC%E3%80%82

后台运行容器（配置持久化）：

bash
docker run -d -p 53:53/udp -p 53:53/tcp -p 3000:3000 -v <你的数据目录>:/data docker.xuanyuan.run/mort3m/adguard-home-raspi

构建镜像

自行构建镜像：

bash
make build

致谢

感谢Ash McKenzie（https://gitlab.com/ashmckenzie/adguard-home-docker%EF%BC%89%E7%9A%84%E8%B4%A1%E7%8C%AE%E3%80%82