Docker Compose部署AdGuard Home：映射目录无文件、配置丢失求助

安全阿岳

2026-8-3

解决AdGuard Home Docker Compose配置丢失问题

核心问题诊断

你的AdGuard Home容器每次重启都丢失配置、映射目录无文件生成，直接原因是卷映射语法错误：在volumes段的两行末尾多了反斜杠\，导致Docker Compose无法正确解析挂载规则，容器无法将配置写入宿主机指定目录，重启后自然回到初始设置状态。

修复步骤

修正卷映射语法
移除volumes中两行末尾的反斜杠，确保每个卷映射为独立行。
修复宿主机目录权限
宿主机的AdGuard目录需要容器进程有读写权限，执行以下命令：
```
sudo mkdir -p /home/pi/homematicDocker/adguard/{work,conf}
sudo chown -R 1000:1000 /home/pi/homematicDocker/adguard
```
（AdGuard容器默认以UID/GID 1000的用户运行）

重建容器
删除旧容器并重新部署：

docker-compose stop adguard
docker-compose rm adguard
docker-compose up -d adguard

修正后的AdGuard Compose配置段

adguard:
    image: adguard/adguardhome
    container_name: adguard
    restart: unless-stopped
    ports:
      - 53:53/tcp 
      - 53:53/udp
      - 67:67/udp 
      - 68:68/udp  # 原配置69:68错误，DHCP客户端端口为68，此处修正
      - 80:80/tcp 
      - 443:443/tcp 
      - 443:443/udp 
      - 3000:3000/tcp
      - 853:853/tcp
      - 784:784/udp 
      - 853:853/udp 
      - 8853:8853/udp
      - 5443:5443/tcp 
      - 5443:5443/udp
    environment:
      - TZ=Europe/Berlin
    volumes:
      - /home/pi/homematicDocker/adguard/work:/opt/adguardhome/work
      - /home/pi/homematicDocker/adguard/conf:/opt/adguardhome/conf
    networks:
      - homematic  # 加入现有homematic网络，保证与其他服务互通