最新

NAS 怎么用 Docker 部署 AdGuard Home 过滤广告

在 NAS 上用 Docker 跑 AdGuard Home,把全屋 DNS 指向它,就能在解析层拦掉广告。本文给挂载、端口配置和断网回退。

入口在哪

AdGuard Home 是一个跑在局域网里的 DNS 服务,靠拦截域名解析来挡广告。它不装在要保护的设备上,而是装在 NAS 里,让全屋设备都把 DNS 指向它。

入口在 NAS 的容器套件里。群晖较新版本叫 Container Manager,旧版叫 Docker;威联通叫 Container Station;其它品牌多半直接叫 Docker。名称不同,操作逻辑一样:拉镜像、配端口、挂目录、起容器。

动手之前先想清楚一件事:全屋 DNS 一旦指到 NAS,NAS 关机或容器挂掉,家里所有设备都会上不了网。所以下面每一步都要留好回退路径。

具体步骤

  1. 在 NAS 上建两个目录,一个放工作数据,一个放配置。本文以 /volume1/docker/adguard/work 和 /volume1/docker/adguard/conf 为例,实际路径按你的存储空间名改。
  2. 拉取镜像 adguard/adguardhome,标签选 latest。
  3. 端口映射要留三个:3000 用于首次配置向导,53 的 TCP 和 UDP 用于 DNS 解析,80 可选,用于管理页面。53 是最容易冲突的一个,装之前先确认没被占用。
  4. 把上面两个目录分别挂到容器内的 /opt/adguardhome/work 和 /opt/adguardhome/conf。不挂目录,容器重建后配置全丢。
  5. 启动容器,浏览器打开 NAS 的 IP 加 3000 端口,按向导设置管理端口和 DNS 端口。管理端口建议改成 3001 之类,避免和 NAS 自带网页端口打架。
  6. 向导走完后,先把路由器 DHCP 下发的 DNS 改成 NAS 的 IP;拿不准就先只改一台设备做小范围测试。

习惯命令行的话,一条命令能写全:

docker run -d --name adguardhome --restart unless-stopped --network host -v /volume1/docker/adguard/work:/opt/adguardhome/work -v /volume1/docker/adguard/conf:/opt/adguardhome/conf adguard/adguardhome:latest

用 host 网络时不必再写端口映射,容器直接占用 NAS 的端口,代价是端口冲突没有隔离。

几个坑

  • 53 端口被占用。NAS 自带的 DNS 服务、别的容器、甚至系统解析器都可能占着 53。先查一遍再装,冲突时容器起得来但解析不生效。
  • 改 DNS 前没测通。一定先用一台设备单独指过去,确认能正常解析再动路由器,否则全家断网时要一台台改回来。
  • 上游 DNS 写成域名。容器用桥接网络时上游要先写 IP,不然它自己都解析不了。
  • 过滤器订阅一上来加太多。几十条订阅同时拉取会拖慢启动,先加一两条常用的,确认能用再逐步加。
  • 忘了留回退。动路由器之前记下原来的设置。真出问题时,在路由器里把 DNS 改回自动获取,一分钟就能恢复。
  • 把管理页面暴露到公网。管理端口只在局域网用,不要顺手做端口映射。

怎么验证

第一步看解析是否生效:在电脑上把 DNS 临时指向 NAS 的 IP,查询一个已知的广告域名,返回 0.0.0.0 或者空结果,就说明拦住了。

第二步看日志:打开 AdGuard Home 的查询日志,刚才那条查询应该出现在列表里,处理方式标为已拦截。日志里没有记录,说明请求根本没到它这里。

第三步看全屋:手机连上 Wi-Fi,打开一个广告较多的网页,对比改 DNS 前后的加载情况。顺手在 NAS 上重启一次容器,看解析能不能在一分钟内恢复,这一步验证的是回退能力。

常见问题

会不会拖慢网速

DNS 查询只在打开网页时发生,解析结果会被缓存,正常情况感觉不到差异。真正影响速度的是上游 DNS 的响应,换一个延迟低的上游比换设备更有用。

NAS 关机后家里断网怎么办

这是这套方案固有的代价。缓解办法有两个:一是路由器 DHCP 里填两个 DNS,主用 NAS,备用写公共 DNS;二是接受断网,需要时把路由器 DNS 改回自动获取。前者省事,但备用 DNS 会让一部分广告漏过。

能不能只对某台设备生效

可以。不动路由器,只在那台设备的网络设置里把 DNS 改成 NAS 的 IP。适合先试用,也适合不想影响家人的场景。

一句话总结:AdGuard Home 靠改 DNS 拦广告,装的时候盯住 53 端口,动路由器之前一定要留好改回去的路。