Docker Compose中Nginx覆盖挂载卷静态文件的解决咨询

Docker Compose 配置 #

services:
  nginx:
    image: nginx:latest
    restart: unless-stopped
    volumes:
      - ./data/nginx:/etc/nginx/conf.d
      - ./data/certbot/conf:/etc/letsencrypt
      - ./data/certbot/www:/var/www/certbot
      - admin-dist:/apps/static/admin:ro
    ports:
      - "80:80"
      - "443:443"
    depends_on:
      - admin
    command: "/bin/sh -c 'while :; do sleep 6h & wait $${!}; nginx -s reload; done & nginx -g \"daemon off;\"'"

  admin:
    build:
      dockerfile: ./apps/Blogue/admin/Dockerfile
      context: ../../
    volumes:
      - admin-dist:/app/dist

volumes:
  admin-dist:
    external: true

Nginx 配置 #

server {
    listen 443 ssl;
    server_name mydomain.com;
    server_tokens off;

    ssl_certificate /etc/letsencrypt/live/mydomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/mydomain.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    location / {
      root /apps/static/admin;
      index index.html;
      try_files $uri $uri/ /index.html;
    }
}

已在 Docker Compose 中配置 Nginx 依赖 admin 服务（admin 优先构建），但 Nginx 启动后仍会用默认的50x.html和index.html占位文件覆盖admin-dist卷中的静态文件。因存在其他依赖，调整构建顺序的方案稳定性不足，寻求可行解决办法。

1. 让 Nginx 等待静态文件生成后启动 #

修改 Nginx 服务的 command，加入文件检查逻辑，确保admin-dist卷中的核心静态文件生成后再启动 Nginx，避免空卷被镜像内默认文件填充：

command: "/bin/sh -c 'until [ -f /apps/static/admin/index.html ]; do sleep 2; done; while :; do sleep 6h & wait $${!}; nginx -s reload; done & nginx -g \"daemon off;\"'"

该逻辑会每隔2秒检查一次目标文件，直到文件存在后再启动 Nginx 主进程及证书重载任务。

2. 改用镜像复制静态文件替代卷挂载 #

放弃卷挂载方式，通过多阶段构建让 Nginx 直接从 admin 镜像复制静态文件，彻底规避卷覆盖问题：

步骤1：创建自定义 Nginx Dockerfile #

在项目中新建nginx/Dockerfile，内容如下：

FROM nginx:latest
# 从构建完成的admin镜像中复制静态文件到Nginx目标目录
COPY --from=admin /app/dist /apps/static/admin

步骤2：更新 Docker Compose 配置 #

将 Nginx 服务的image替换为build，并移除admin-dist卷挂载项：

nginx:
    build: ./nginx  # 指向自定义Dockerfile所在目录
    restart: unless-stopped
    volumes:
      - ./data/nginx:/etc/nginx/conf.d
      - ./data/certbot/conf:/etc/letsencrypt
      - ./data/certbot/www:/var/www/certbot
    ports:
      - "80:80"
      - "443:443"
    depends_on:
      - admin
    command: "/bin/sh -c 'while :; do sleep 6h & wait $${!}; nginx -s reload; done & nginx -g \"daemon off;\"'"

构建 Nginx 镜像时会直接复制 admin 镜像中的静态文件，运行时无需挂载卷，不会出现覆盖问题。

3. 标记 admin 服务初始化完成 #

在 admin 服务的启动命令中添加初始化完成标记，让 Nginx 仅在标记存在后启动，确保所有静态文件完全写入卷：

步骤1：修改 admin 服务的启动命令 #

假设 admin 镜像中静态文件构建在/build/dist目录，更新 Dockerfile 的CMD：

CMD ["sh", "-c", "cp -r /build/dist/* /app/dist && touch /app/dist/.init_complete && tail -f /dev/null"]

步骤2：修改 Nginx 服务的 command #

command: "/bin/sh -c 'until [ -f /apps/static/admin/.init_complete ]; do sleep 2; done; while :; do sleep 6h & wait $${!}; nginx -s reload; done & nginx -g \"daemon off;\"'"

这种方式比直接检查单个文件更可靠，能确保所有静态文件复制完成。

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