AdGuard Home 常见问题

收集 AdGuard Home 使用中常见的问题和排查方法，配置不生效先看这里。

1 改了 DNS 不生效 ❓

检查优先级

1. 设备是否真的把 DNS 指向了 AdGuard Home：查看客户端查询日志，有没有该设备的记录
2. 上游 DNS 是否配置正确：设置 > DNS 设置 里测试上游，确认能通过
3. 是否走了加密 DNS：DoH/DoT 需要域名证书，自签名或 IP 直连可能导致部分客户端拒绝
4. 规则是否误拦：在 查询日志 里搜索目标域名，看是否被过滤规则拦截

常见原因

• 浏览器缓存了旧结果：清除浏览器缓存或等待 TTL 过期
• 系统缓存未刷新：Windows 执行 ipconfig /flushdns
• 路由器 DNS 转发未生效：OpenWRT 里确认 网络 > DHCP/DNS > 转发 指向 AdGuard Home 地址
• 客户端配置了固定 DNS：部分 APP 或设备自带 DNS 设置，会绕过系统 DNS

2 53 端口被占用 🔌

OpenWRT 上 53 端口默认被 dnsmasq 占用，AdGuard Home 装好后无法监听 53 端口：

• 方案一：把 AdGuard Home 的 DNS 端口改成 953，再在 dnsmasq 的 转发 里指向 127.0.0.1#953
• 方案二：禁用 dnsmasq（会失去 DHCP 等功能），AdGuard Home 直接使用 53 端口
• 旁路由用户优先用方案二，主路由用户建议方案一

3 网页打不开 / 部分网站异常 ⚠️

• 确认是 AdGuard Home 的锅：临时把设备 DNS 改回自动获取，看是否恢复
• 规则误拦：在查询日志找到被拦截域名，加入白名单
• 上游 DNS 解析异常：换一组上游 DNS 测试（如 223.5.5.5、119.29.29.29）
• DoH 上游不稳定：DoH 走 443 端口，可能被网络环境干扰，尝试换 DoT 或非加密上游

4 内存 / CPU 占用高 📈

• 查询量大的环境（多设备、高并发）属于正常现象，AdGuard Home 本身较省资源
• 开启 乐观缓存（设置 > DNS 设置）可减少上游请求次数
• 过滤规则过多会拖慢查询，清理不常用的规则列表
• 使用 docker stats 查看容器资源占用，确认没有内存泄漏式增长

5 更新与备份 💾

备份配置

AdGuard Home 的配置在安装目录下，备份 conf 和 data 两个文件夹即可完整迁移。

容器升级

cd /mnt/docker/apps/adguardhome
docker compose pull
docker compose up -d

TIP

升级前先备份 conf/data。AdGuard Home 跨大版本升级偶尔会改配置格式，备份可以随时回滚。

6 其他小问题 🔧

• Web 管理界面打不开：确认访问端口，默认 3000（OpenWRT 常改为 33000/880）；检查防火墙是否放行
• 忘记管理员密码：删除 conf/AdGuardHome.yaml 后重启，重新初始化（会丢失原配置，慎用）
• 时间不同步：AdGuard Home 依赖系统时间判断过滤规则更新，确保系统时间准确