如何让自定义Dockerfile等效替代Docker Hub官方Nginx镜像？

原有Docker Compose中webserver服务配置如下：

...
 webserver:
    image: nginx:latest
    container_name: webserver
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - web-root:/var/www/html
      - ./nginx-conf:/etc/nginx/conf.d
      - certbot-etc:/etc/letsencrypt
      - certbot-var:/var/lib/letsencrypt
      - dhparam:/etc/ssl/certs
    depends_on:
      - nodejs
    networks:
      - app-network
...

为了自定义Nginx镜像，修改Compose文件为：

...
 webserver:
    build: 
      context: ./nginx
      dockerfile: Dockerfile
    container_name: webserver
...

在./nginx目录下创建Dockerfile，尝试过以下几种写法，但容器启动后无法正常提供网站服务：

1. 极简版：

FROM nginx:latest

2. 复制配置版：

FROM nginx:latest
COPY ./nginx-conf:/etc/nginx/conf.d

3. 添加卷声明版：

FROM nginx:latest
COPY ./nginx-conf:/etc/nginx/conf.d
VOLUME /etc/letsencrypt
VOLUME /var/lib/letsencrypt
VOLUME /etc/ssl/certs

需要实现自定义镜像与原有image: nginx:latest配置完全一致的功能。

1. 简化Dockerfile，保留核心自定义逻辑 #

自定义镜像只需基于官方nginx:latest，仅添加你需要自定义的文件（比如脚本、额外静态资源等），无需复制配置文件或声明VOLUME——因为Compose中的卷挂载会直接覆盖容器内对应路径，且这种方式更灵活（修改配置无需重新构建镜像）。

示例Dockerfile（仅添加自定义脚本）：

FROM nginx:latest
# 仅复制你需要自定义的文件，比如初始化脚本
COPY myscript.sh /usr/local/bin/
# 若需要执行脚本，可添加执行权限
RUN chmod +x /usr/local/bin/myscript.sh

2. 完整保留Compose中的原有配置 #

确保修改后的webserver服务保留所有原有配置项（ports、volumes、depends_on、networks等），仅替换image为build配置：

webserver:
    build: 
      context: ./nginx
      dockerfile: Dockerfile
    container_name: webserver
    restart: unless-stopped
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - web-root:/var/www/html
      - ./nginx-conf:/etc/nginx/conf.d
      - certbot-etc:/etc/letsencrypt
      - certbot-var:/var/lib/letsencrypt
      - dhparam:/etc/ssl/certs
    depends_on:
      - nodejs
    networks:
      - app-network

3. 重新构建并启动容器 #

执行以下命令重新构建镜像并启动服务：

# 构建webserver镜像
docker-compose build webserver
# 后台启动服务
docker-compose up -d

4. 排查问题的关键步骤 #

如果仍有问题，通过以下方式定位：

• 查看Nginx容器日志，确认启动报错：

  docker logs webserver
  

• 检查容器卷挂载是否正确：

  docker inspect webserver
  

  在输出的Mounts部分，确认所有卷都正确挂载到对应路径。
• 进入容器验证文件结构：

  docker exec -it webserver bash
  

  检查/etc/nginx/conf.d、/var/www/html等目录是否存在正确的文件。

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