Docker Compose启动后app/media目录文件丢失问题求助

问题根源 #

你遇到的情况是Docker绑定挂载（bind mount）的特性导致的：当宿主机的./media目录为空时，挂载到容器内的/usr/src/app/media后，会直接覆盖容器内该目录的原有内容。而Git仓库大概率因为media目录包含大量大文件，被加入了.gitignore，所以拉取代码后宿主机的./media是空的，启动容器后就把镜像里的media文件覆盖掉了。

紧急恢复文件 #

方法1：从Git历史恢复 #

如果这些文件之前已经提交到Git仓库（只是后来被忽略），可以用Git命令把历史中的media文件恢复到本地：

# 从最新提交中恢复media目录
git checkout HEAD -- app/media/
# 或者指定某个提交版本恢复
git checkout <commit-hash> -- app/media/

恢复后把文件移动到宿主机的./media目录下，再重启容器即可。

方法2：从Docker镜像中拷贝 #

如果Git历史里没有这些文件，直接从镜像中提取：

# 启动一个临时容器，不挂载media目录
docker run --rm -v $(pwd)/temp_media:/tmp/media xxxx/myimage:latest bash -c "cp -r /usr/src/app/media/* /tmp/media/"
# 把临时目录的文件移动到宿主机的media目录
mv temp_media/* ./media/
rm -rf temp_media

修正挂载配置避免再次丢失 #

方案1：使用命名卷替代绑定挂载（推荐） #

命名卷会保留容器内的初始内容，适合需要持久化且希望保留镜像中初始文件的场景：

services:
  web:
    # ... 其他配置不变
    volumes:
      - ./static:/usr/src/app/static
      - media_volume:/usr/src/app/media  # 替换原有的./media绑定挂载
  nginx:
    # ... 其他配置不变
    volumes:
      # ... 其他挂载不变
      - media_volume:/home/app/web/media  # 同样替换为命名卷

# 在compose文件末尾添加命名卷定义
volumes:
  media_volume:

启动容器时，Docker会自动将镜像中/usr/src/app/media的内容复制到命名卷中，之后的修改会持久化在卷里，不会被空目录覆盖。

方案2：挂载前确保宿主机media目录存在且有内容 #

在启动容器前，先检查并初始化宿主机的media目录：

# 创建media目录（如果不存在）
mkdir -p ./media
# 如果镜像中有初始media文件，先拷贝到宿主机
docker run --rm xxxx/myimage:latest bash -c "tar -c -f - -C /usr/src/app media" | tar -x -f - -C ./

之后再启动docker-compose up，此时宿主机media目录有内容，挂载后不会覆盖容器内的文件。

长期优化方案 #

1. 不要将大媒体文件存入Git仓库：Git不适合存储大量大文件，会导致仓库体积膨胀，拉取推送变慢。建议将media文件迁移到对象存储服务（如MinIO、阿里云OSS、AWS S3等），应用直接从对象存储读取和写入文件。
2. 使用Git LFS（可选）：如果必须用Git管理少量大文件，可以启用Git LFS跟踪docx、xlsx文件，但大量文件仍不推荐。

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