Docker Compose首次启动时如何将本地Media目录内容填充至对应Docker卷

我来帮你搞定这个问题！你现在需要的是首次启动Docker Compose时，自动把本地media目录的内容同步到media卷里，而且之后卷里有内容了就不要再覆盖——完全理解这个需求，结合你现有的配置，我给你两个实用的方案：

方案一：修改Entrypoint脚本（推荐，和现有配置整合度高） #

这个方案不需要新增服务，只需要给你的backend服务加个临时挂载，再在启动脚本里加几行判断逻辑就行：

1. 更新docker-compose.yaml的backend配置 #

给backend的volumes新增一行，把本地media目录临时挂载到容器的一个临时路径（比如/tmp/local_media）：

backend:
  build: ./
  depends_on:
    - db
  restart: always
  volumes:
    - static:/app/static/
    - media:/app/media/
    - ./media:/tmp/local_media/  # 新增：临时挂载本地media到容器临时目录
  env_file:
    - .env

2. 修改entrypoint.sh添加同步逻辑 #

在python manage.py migrate --no-input之后、启动gunicorn之前，加入判断：如果容器内的/app/media（也就是media卷）是空的，就把临时挂载的本地media内容复制过去：

#!/bin/sh
echo "Waiting for MySQL..."
while ! nc -z $MYSQL_HOST $MYSQL_PORT; do
  sleep 0.1
done
echo "MySQL started"

python manage.py migrate --no-input

# 新增：首次启动同步本地media到卷
if [ -z "$(ls -A /app/media)" ]; then
    echo "Media volume is empty, copying local media files..."
    # 复制本地media内容到卷，忽略空目录报错
    cp -r /tmp/local_media/* /app/media/ 2>/dev/null || true
    echo "Local media files copied successfully!"
fi

gunicorn app.asgi:application \
    --bind 0.0.0.0:8000 \
    --workers 8 \
    --worker-class uvicorn.workers.UvicornWorker
exec "$@"

为什么这么做？

• 你把media加到.dockerignore是对的，避免把大量静态文件打包进镜像，这个临时挂载只是为了首次同步用
• 只有当media卷为空时才会执行复制，之后卷里有内容了就不会再触发，完全不会影响后续启动

方案二：新增一次性初始化服务（更解耦） #

如果你不想改动现有backend的配置和启动脚本，可以单独加一个只运行一次的初始化服务，专门负责同步media内容：

1. 在docker-compose.yaml里新增init_media服务 #

把这个服务加在所有服务的最前面或者最后面都行：

services:
  # 保留你原来的db、backend、nginx服务...
  
  init_media:
    image: alpine:latest  # 用轻量的alpine镜像
    volumes:
      - ./media:/local_media  # 挂载本地media目录
      - media:/container_media  # 挂载目标media卷
    command: >
      sh -c 'if [ -z "$(ls -A /container_media)" ]; then 
              echo "Copying local media to volume..."; 
              cp -r /local_media/* /container_media/ 2>/dev/null || true;
            fi'
    restart: "no"  # 只运行一次，完成后自动退出

2. 让backend依赖这个初始化服务（可选） #

如果想确保backend在media同步完成后再启动，给backend的depends_on加一行：

backend:
  build: ./
  depends_on:
    - db
    - init_media  # 等media初始化完成再启动
  # 其他配置不变

这个方案的好处：完全独立于现有服务逻辑，不需要改任何现有代码或脚本，适合不想动现有配置的场景

注意事项 #

• 如果你本地media目录的权限比较特殊，复制到容器后可能需要调整权限（比如Django应用用非root用户运行），可以在复制命令后加chown -R <user>:<group> /app/media（比如chown -R www-data:www-data /app/media）
• 之后如果本地media有更新，想要同步到卷里，可以手动运行docker-compose run --rm init_media（方案二），或者手动进入backend容器执行复制命令

备注：内容来源于stack exchange，提问作者Snorki