Docker部署Nginx报错：nginx.conf挂载路径问题排查与解决

报错信息 #

unable to start container process: error during container init: error mounting "/data/compose/158/docker/nginx/nginx.conf" to rootfs at "/etc/nginx/nginx.conf": mount /data/compose/158/docker/nginx/nginx.conf:/etc/nginx/nginx.conf (via /proc/self/fd/6), flags: 0x5001: not a directory: unknown: Are you trying to mount a directory onto a file (or vice-versa)? Check if the specified host path exists and is the expected type.

配置与目录结构 #

docker-compose.yml #

services:
  nginx:
    image: nginx:latest
    container_name: superset_nginx
    restart: unless-stopped
    ports:
      - "81:81"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    volumes:
      - ./docker/nginx/nginx.conf:/etc/nginx/nginx.conf:ro

项目目录结构 #

project
-docker
--nginx
---nginx.conf
-docker-compose.yml

问题原因 #

核心问题是容器内的/etc/nginx/nginx.conf是目录而非文件，你尝试将主机上的文件挂载到容器内的目录路径，触发了文件类型不匹配的挂载错误。

可能的诱因：

• 部分非官方Nginx镜像会修改默认结构，将/etc/nginx/nginx.conf设为目录
• 之前运行容器时因异常退出、错误挂载等操作，导致容器关联卷内的/etc/nginx/nginx.conf变成了目录

修复方案 #

1. 清理残留容器与卷 #

先停止并删除现有容器，避免残留结构影响：

docker stop superset_nginx
docker rm superset_nginx

检查并删除关联的匿名卷（如果有）：

docker volume ls | grep superset_nginx
docker volume rm <对应卷名>

2. 验证镜像内文件类型 #

临时启动容器，确认/etc/nginx/nginx.conf的类型：

docker run --rm -it nginx:latest ls -ld /etc/nginx/nginx.conf

• 输出以-rw-r--r--开头：是文件，符合正常挂载要求
• 输出以drwxr-xr-x开头：是目录，建议更换官方标准nginx:latest镜像

3. 调整挂载路径（可选） #

如果必须使用当前镜像（容器内/etc/nginx/nginx.conf是目录），修改挂载路径为目录下的文件：

volumes:
  - ./docker/nginx/nginx.conf:/etc/nginx/nginx.conf/nginx.conf:ro

同时需要确保Nginx配置加载路径指向该文件。

问题解答 #

确实存在主机路径与容器内路径类型不匹配的问题：主机侧是文件，容器侧是目录，这是导致挂载失败的直接原因。

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