如何让 Docker 容器在挂载卷时正确初始化配置文件-php教程-PHP中文网

如何让 Docker 容器在挂载卷时正确初始化配置文件

Docker 容器挂载宿主机目录作为卷时，会直接覆盖镜像中对应路径的原始内容（包括启动时自动生成的配置文件），导致文件“消失”；正确做法是先运行无卷容器提取初始文件，再挂载已填充的目录。

如何让 docker 容器在挂载卷时正确初始化配置文件？docker 容器挂载宿主机目录作为卷时，会直接覆盖镜像中对应路径的原始内容（包括启动时自动生成的配置文件），导致文件“消失”；正确做法是先运行无卷容器提取初始文件，再挂载已填充的目录。

这是 Docker 卷（volume/bind mount）机制的核心行为特性，而非配置错误：当使用 volumes 挂载宿主机路径（如 /mnt/data/apps/apache:/etc/apache2）时，Docker 会完全用宿主机目录内容替换容器内目标路径的全部内容——无论该路径在镜像中原本是否存在文件、或是否由 ENTRYPOINT/CMD 在启动时动态生成。

以 php:5.6-apache 镜像为例，其启动逻辑依赖 /etc/apache2/ 下的默认配置（如 apache2.conf、sites-enabled/000-default.conf 等），这些文件通常由镜像构建阶段预置，或在容器首次启动时由初始化脚本生成。但一旦你挂载一个空的或不完整的宿主机目录（如 /mnt/data/apps/apache），容器内 /etc/apache2/ 就变成空目录，Apache 因缺少必要配置而无法正常启动，甚至可能静默失败。

✅ 正确解决流程（推荐标准化操作）：

启动临时容器（无卷），获取镜像原生配置结构：

docker run --rm -d --name tmp-apache php:5.6-apache
sleep 3  # 确保 Apache 初始化完成

复制容器内初始化后的完整配置到宿主机：

Docker Compose Linter

检查 docker-compose.yml 文件的安全问题、最佳实践和端口冲突

下载

mkdir -p /mnt/data/apps/{html,ssl,apache}
docker cp tmp-apache:/var/www/html/. /mnt/data/apps/html/
docker cp tmp-apache:/etc/ssl/. /mnt/data/apps/ssl/
docker cp tmp-apache:/etc/apache2/. /mnt/data/apps/apache/

清理临时容器：
```
docker rm -f tmp-apache
```

使用已填充的目录重新部署（你的 docker-compose.yml 可保持不变）：

services:
  apache:
    image: 'php:5.6-apache'
    container_name: apache
    restart: always
    ports:
      - '80:80'
      - '443:443'
    volumes:
      - /mnt/data/apps/html:/var/www/html
      - /mnt/data/apps/ssl:/etc/ssl
      - /mnt/data/apps/apache:/etc/apache2  # ✅ 此时目录已含完整配置

⚠️ 注意事项：