树莓派Docker Compose部署AdGuard Home后重建容器无法访问Web UI

问题现象 #

在树莓派上用Docker Compose部署AdGuard Home，首次初始化可通过HOST:3000访问Web UI；但重建容器后，Web UI无法访问，删除conf目录下的AdGuardHome.yaml并重新初始化后恢复正常。

原因分析 #

从容器日志可以看到，AdGuard Home启动后Web UI监听的是80端口，而非3000端口。这是因为首次初始化完成后，AdGuard Home会将Web UI切换到你设置的正式端口（默认是80），该配置会持久化到AdGuardHome.yaml中。重建容器时，容器加载了旧的配置文件，因此不再监听初始化专用的3000端口，导致访问HOST:3000失败。

解决方案 #

1. 直接访问正确的Web UI端口 #

根据日志中的提示，直接访问树莓派IP加80端口即可，例如：

http://192.168.178.37:80

2. 修改配置文件指定监听端口（可选） #

若希望继续通过3000端口访问，编辑挂载目录下的conf/AdGuardHome.yaml，找到web节点修改配置：

web:
  listen_addr: ":3000"
  # 保留其他原有配置项

保存后重启容器：

docker-compose restart adguard

注：此方式仅适合临时调试，建议使用初始化时设置的正式端口作为日常访问入口。

3. 避免重复初始化的正确姿势 #

重建容器时无需删除配置文件，只需查看容器日志确认Web UI的监听端口，直接访问对应端口即可，无需重复完成初始化流程。

内容的提问来源于stack exchange，提问作者FrankTheTank