Docker挂载绑定后容器目录为空的问题求助

问题原因 #

Docker的**绑定挂载（bind mount）**会直接将主机目录挂载到容器内的目标路径，完全覆盖容器内该路径的原有内容。你本地的./container目录是空的，所以挂载后容器内的/var/www就被清空了。

而MySQL官方镜像之所以没问题，是因为它的entrypoint脚本会检测挂载的/var/lib/mysql目录：如果目录为空，会自动执行数据库初始化逻辑生成必要文件，并非挂载没有覆盖目录。

解决方案 #

1. 先同步容器内容到本地目录（快速解决） #

如果已经构建好镜像，先把容器内的/var/www内容复制到本地挂载目录，再启动服务：

# 启动临时容器（不挂载目录）
docker run --rm -d --name temp-server private/image
# 复制容器内/var/www的内容到本地./container
docker cp temp-server:/var/www ./container
# 停止临时容器
docker stop temp-server

之后执行docker-compose up，此时本地./container已有内容，挂载后容器内的/var/www会显示本地目录的内容，不会为空。

2. 给自定义镜像添加初始化逻辑（类似MySQL的自动填充） #

修改Dockerfile和entrypoint脚本，实现挂载空目录时自动填充初始内容：

修改Dockerfile

在复制项目文件后，把内容备份到模板目录：

FROM php:8.1-fpm as stage-php

# ... 原有安装依赖、扩展的代码 ...

# 复制项目文件到容器，并备份为模板
COPY --chown=www-data:www-data . /var/www
RUN cp -r /var/www /var/www-template

# ... 原有复制配置文件、设置entrypoint的代码 ...

修改entrypoint.sh

添加检测逻辑，若挂载目录为空则从模板复制内容：

#!/bin/bash

# 检测挂载的/var/www是否为空，为空则从模板复制初始化内容
if [ ! -f "/var/www/vendor/autoload.php" ] && [ -d "/var/www-template" ]; then
    cp -r /var/www-template/* /var/www/
fi

# 原有composer安装逻辑
if [ ! -f "vendor/autoload.php" ]; then
    composer install --no-progress --no-interaction
fi

php-fpm -D
nginx -g "daemon off;"

这样每次启动容器时，若本地挂载目录为空，会自动填充镜像内的初始项目内容，避免容器目录为空导致服务异常。

3. 使用命名卷替代绑定挂载（适合无需本地编辑代码的场景） #

Docker的命名卷会在第一次使用时，自动将容器内目标目录的内容复制到卷中，后续挂载不会覆盖：
修改docker-compose.yml的volumes配置：

services:
    server:
        # ... 原有配置 ...
        volumes:
            - server-data:/var/www
        # ... 原有配置 ...

# 定义命名卷
volumes:
    server-data:

第一次启动时，Docker会把容器内/var/www的内容复制到server-data卷中，之后启动服务都会使用卷内的内容，不会出现目录清空的问题。

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