AdGuard Home 部署与配置指南

前言

AdGuard Home 是一款全网级的广告拦截和隐私保护 DNS 服务。把它部署在家里后，所有连上 WiFi 的设备（手机、电脑、智能电视、IoT 设备）都能自动享受去广告效果，无需逐个安装浏览器插件或 App。

本文介绍如何用 Docker 快速部署 AdGuard Home，并配置适合国内环境的 DNS 上游和过滤规则。

部署

创建目录

1

mkdir -p /Volumes/ssd/docker/adguard/{config,data}

Docker Compose

创建 docker-compose.yml：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

services:
  adguard:
    image: adguard/adguardhome:latest
    container_name: adguard
    restart: unless-stopped
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "3000:3000/tcp"   # 初始设置向导
      - "8080:80/tcp"     # 管理后台
    volumes:
      - ./config:/opt/adguardhome/conf
      - ./data:/opt/adguardhome/work

端口说明：53 是 DNS 端口，3000 仅首次设置时使用，8080 是日常管理后台。

启动

1
2

cd /Volumes/ssd/docker/adguard
docker compose up -d

初始设置

1. 浏览器访问 http://你的IP:3000
2. 设置管理后台监听端口（默认 80，对应 compose 里的 8080 映射）
3. 设置 DNS 监听端口（默认 53）
4. 创建管理员账号密码

设置完成后，管理后台地址变为 http://你的IP:8080。

DNS 上游配置

进入 设置 → DNS 设置，配置上游 DNS 服务器。推荐使用 DoH（DNS over HTTPS）加密查询，防止运营商劫持：

上游 DNS（并行查询，自动选最快）：

Bootstrap DNS（用于解析 DoH 域名）：

1
2
3
4
5
6

223.5.5.5
223.6.6.6
119.29.29.29
114.114.114.114
8.8.8.8
1.1.1.1

查询模式选择 并行请求，AdGuard 会同时向所有上游发起查询，使用最先返回的结果。

过滤规则

进入 过滤器 → DNS 黑名单，添加以下适合国内环境的过滤规则：

规则会自动更新（默认每 24 小时），无需手动维护。

客户端配置

AdGuard 部署好后，需要将设备的 DNS 指向 AdGuard 所在的 IP。

方式一：路由器设置（推荐）

在路由器 DHCP 设置中将主 DNS 改为 AdGuard 所在 IP，这样所有连 WiFi 的设备自动生效。

方式二：单设备手动设置

日常维护

查看查询日志

管理后台 → 查询日志，可以实时查看所有 DNS 请求，支持按域名、客户端、状态筛选。

手动屏蔽域名

在 过滤器 → 自定义过滤规则 中添加：

1

||example.com^

重置密码

如果忘记密码，可以修改配置文件中的密码哈希：

1
2
3
4
5
6
7
8

# 生成新密码的 bcrypt 哈希
htpasswd -nbBC 12 '' '你的新密码'

# 编辑配置文件，替换 password 字段
vim /path/to/adguard/config/AdGuardHome.yaml

# 重启生效
docker restart adguard

备份配置

AdGuard 的所有配置都在 config/AdGuardHome.yaml 一个文件里，定期备份即可：

1

cp config/AdGuardHome.yaml config/AdGuardHome.yaml.bak

常见问题

Q: 53 端口被占用？

macOS 自带的 DNS 服务可能占用了 53 端口。检查并关闭：

1
2

sudo lsof -i :53
sudo killall named  # 如果有

Q: 部分网站访问变慢？

可能是某些上游 DNS 响应慢。在 DNS 设置中把查询模式改为 并行请求，或减少上游数量只保留延迟最低的几个。

Q: 想临时关闭广告拦截？

管理后台首页有一个 保护 开关，一键切换。也可以针对单个客户端在 设置 → 客户端设置 中排除。

总结

AdGuard Home 是家庭网络去广告的最佳方案之一——一次部署，全家设备受益。配合国内优化的 DNS 上游和过滤规则，既能加速 DNS 解析，又能有效拦截广告和追踪器。