环境

我部署在极空间 Z4S NAS 上,使用内置 Docker,采用 host network。

使用 AdGuardHome 官方 Docker 镜像,版本 v0.107.56,地址是:adguard/adguardhome

部署

1. 关闭 NAS 53 端口

极空间 Z4S 支持虚拟机,而且自身采用的是 Ubuntu 系统改造,需要关闭两处配置,SSH 登录到 Z4S NAS 系统里,切换到 root 用户分别执行下面命令 :

  1. 关闭 systemd-resolved 服务(必须)
systemctl stop systemd-resolved.service
systemctl disable systemd-resolved.service
  1. 关闭 libvirtd 虚拟化服务中的 dnsmasq(删除 virbr0 网卡以达到目的)
virsh net-autostart --disable default  
virsh net-destroy default

我不需要虚拟化服务,所以把 libvirtd 服务也关闭了,实际中如果使用的话,可跳过此步骤,后续监听 53 端口时,固定用 bond、eth 网卡接口,而非全部网卡接口。

PS 上述操作需要开启 SSH 远程访问,不然我也不知道如何关闭。

2. 启动 AdGuardHome 容器

在 极空间 Z4S Docker 控制台,下载镜像,adguard/adguardhome:v0.107.56

添加容器,部署参数如下,其他保持默认参数即可:

image-20250207212236472

持久化保存数据、配置:

image-20250207212449163

网络选择 host 即可:

image-20250207212550871

然后就可以点击应用,创建容器,但请注意,AdGuardHome默认使用 3000/TCP 端口初始化服务,所以不能被占用,其他端口都可在初始化后配置决定启用与否。

创建成功后,日志输出如下:

image-20250207212824693

SSH 登录到 Z4S 控制台也能看到监听:

image-20250207212938603

3. 初始化向导

打开浏览器,输入你 Z4S IP:3000 进入配置向导:

image-20250207213334600

按照向导下一步,配置后台管理端口和 DNS 监听端口,前者随便定义,但是 DNS 端口 53 不要改:

image-20250207213459798

下一步设置管理员账号密码,继续,结束,会自动跳到后台管理端口,比如我设置的是13000。

image-20250207213740569

使用

后续配置和使用不介绍了,网上有很多教程。