如何将主机httpd.conf挂载到Apache httpd Docker容器？挂载异常排查

问题描述 #

使用以下命令启动httpd容器后，容器内/usr/local/apache2/conf/httpd.conf与主机挂载的/share/CACHEDEV1_DATA/Container/apache/config/httpd.conf内容不一致，但httpd-vhosts.conf挂载正常：

docker run -d \
    --add-host=host.docker.internal:host-gateway \
    --name=apache \
    --restart always \
    -e PUID=1000 \
    -e PGID=1000 \
    -e TZ=Europe/London \
    -p 80:80 \
    -v /share/CACHEDEV1_DATA/Container/apache/config/httpd.conf:/usr/local/apache2/conf/httpd.conf \
    -v /share/CACHEDEV1_DATA/Container/apache/config/httpd-vhosts.conf:/usr/local/apache2/conf/extra/httpd-vhosts.conf \
    httpd:latest

排查与解决步骤 #

1. 检查主机侧httpd.conf的权限与归属 #

容器以PUID=1000、PGID=1000的用户运行，如果主机文件的权限或归属不正确，容器进程无法读取挂载的文件，会自动使用镜像默认的httpd.conf。

• 查看主机文件权限：

  ls -l /share/CACHEDEV1_DATA/Container/apache/config/httpd.conf
  

• 调整权限匹配容器用户：

  chown 1000:1000 /share/CACHEDEV1_DATA/Container/apache/config/httpd.conf
  chmod 644 /share/CACHEDEV1_DATA/Container/apache/config/httpd.conf
  

• 操作后停止并重新创建容器：

  docker stop apache && docker rm apache
  # 重新执行原启动命令
  

2. 确认容器内httpd.conf的实际路径 #

部分httpd镜像的配置文件路径可能存在差异，比如部分发行版镜像将httpd.conf放在/etc/httpd/conf/httpd.conf而非/usr/local/apache2/conf/httpd.conf。

• 进入容器查找配置文件位置：

  docker exec -it apache bash
  find / -name httpd.conf
  

• 如果路径不符，修改启动命令中的挂载路径，匹配容器内实际的httpd.conf位置。

3. 排查镜像初始化脚本的覆盖问题 #

部分httpd镜像启动时会执行初始化脚本，若检测到httpd.conf不存在或异常，会自动生成默认配置。如果第一次启动时主机侧httpd.conf不存在，Docker会创建一个空文件，镜像脚本会写入默认内容到该文件，导致主机文件被污染。

• 恢复主机侧httpd.conf的正确内容，然后停止并删除容器，重新启动。

4. 解决NAS存储的缓存延迟 #

你使用的是NAS存储（/share/CACHEDEV1_DATA），NAS文件系统可能存在缓存机制，导致容器读取的是旧文件内容。

• 重启NAS上的Docker服务，或刷新NAS文件缓存后，重新启动容器。

验证方法 #

启动容器后，直接对比容器内与主机的文件内容：

# 查看容器内文件
docker exec apache cat /usr/local/apache2/conf/httpd.conf
# 查看主机文件
cat /share/CACHEDEV1_DATA/Container/apache/config/httpd.conf

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