Docker运行正常但无法连接：Pi-hole加额外卷后Web界面无法访问

阿华AIGC实验室

2026-5-22

解决Pi-hole Docker容器运行但Web界面无法访问的问题

我之前也碰到过类似的情况，加了自定义卷后容器明明显示运行，但Web界面死活连不上，结合你的启动命令，大概率是这几个原因，一步步排查就能解决：

1. 「--net=host」与端口映射的冲突问题

你同时用了--net=host和-p参数来映射端口，这其实是多余且可能引发冲突的：

当使用--net=host时，容器会直接共享宿主机的网络命名空间，不需要再手动映射端口，容器里的服务会直接使用宿主机的对应端口。
重复的端口映射可能导致端口被占用，或者Pi-hole的Web服务启动失败。

解决步骤：

先停止并删除现有容器：

sudo docker stop pihole && sudo docker rm pihole

然后去掉所有-p参数，重新启动容器：

sudo docker run -d \
  --name pihole \
  --net=host \
  --volume=/dcfg/pihole:/etc/pihole \
  --volume=/dcfg/dnsmasq.d:/etc/dnsmasq.d \
  -e TZ="America/Toronto" \
  -e WEBPASSWORD="PASSWORD" \
  -e ServerIP="SERVERIP" \
  pihole/pihole:latest

之后检查宿主机的80端口是否被其他服务占用（比如Nginx、Apache）：

sudo lsof -i :80

如果有冲突，要么停止占用端口的服务，要么给Pi-hole指定其他Web端口，比如添加-e WEBPORT="8080"环境变量，之后用http://SERVERIP:8080访问界面。

2. 自定义卷的权限问题

你挂载的/dcfg/pihole和/dcfg/dnsmasq.d目录，可能存在权限不匹配的问题：
Pi-hole容器内的服务通常以UID/GID为1000的用户运行，而宿主机的目录可能是root权限，导致容器无法读写配置文件，进而Web服务启动失败。

解决步骤：

调整宿主机目录的权限，让容器用户能正常访问：

sudo chown -R 1000:1000 /dcfg/pihole /dcfg/dnsmasq.d

之后重新启动容器即可。

3. 自定义卷的配置文件损坏

如果是第一次挂载这些卷，容器会自动复制默认配置到宿主机目录，但如果之前挂载过旧的配置，或者目录里有错误的配置文件，可能导致Pi-hole服务异常。

解决步骤：

先备份现有配置，然后让容器重新生成默认配置：

# 备份旧配置
sudo mv /dcfg/pihole /dcfg/pihole.bak
sudo mv /dcfg/dnsmasq.d /dcfg/dnsmasq.d.bak

# 创建新的空目录并设置权限
mkdir -p /dcfg/pihole /dcfg/dnsmasq.d
sudo chown -R 1000:1000 /dcfg/pihole /dcfg/dnsmasq.d

然后重新启动容器，访问Web界面试试。