Docker Compose无法创建新卷：OpsWeb容器与主机目录映射失败

先明确挂载类型差异 #

你提到的“卷”如果是绑定挂载（直接映射主机目录到容器），它不会出现在Portainer的“卷”列表里——Portainer的卷列表仅展示Docker命名卷，这可能是你找不到它的核心原因。

分步排查与修复 #

1. 检查容器启动日志 #

先查看opsweb-opsweb-backend-1的启动日志，定位挂载失败的具体原因：

docker logs opsweb-opsweb-backend-1

如果日志出现permission denied或no such file or directory错误，对应处理：

• 主机目录不存在：手动创建并配置权限

  mkdir -p /home/ubuntu/opsweb/exchange
  # 获取容器内运行用户的UID，替换下方占位符
  CONTAINER_UID=$(docker exec opsweb-opsweb-backend-1 id -u)
  chown -R $CONTAINER_UID:$CONTAINER_UID /home/ubuntu/opsweb/exchange
  

2. 核对挂载配置语法 #

若用绑定挂载（直接映射主机目录）

docker-compose配置示例：

services:
  opsweb-backend:
    # 其他容器配置...
    volumes:
      # 格式：主机绝对路径:容器内目标路径
      - /home/ubuntu/opsweb/exchange:/容器内需要映射的目录路径

这种配置本身不会生成命名卷，自然不会出现在Portainer的卷列表中。

若用命名卷（会出现在Portainer卷列表）

需先定义卷，再关联容器：

volumes:
  exchange:
    driver: local
    driver_opts:
      type: none
      o: bind
      device: /home/ubuntu/opsweb/exchange

services:
  opsweb-backend:
    # 其他容器配置...
    volumes:
      - exchange:/容器内需要映射的目录路径

你说和已定义卷语法一致，要确认已定义的是绑定挂载还是命名卷——如果是前者，本身就不会出现在Portainer卷列表。

3. 验证容器内挂载状态 #

容器启动后，进入容器检查挂载是否生效：

docker exec -it opsweb-opsweb-backend-1 bash
# 查看挂载点信息
mount | grep /容器内需要映射的目录路径

如果无输出，说明挂载未成功，修改配置后必须重启容器：

docker restart opsweb-opsweb-backend-1

4. Portainer可视化配置注意事项 #

如果在Portainer里操作：

• 绑定挂载：在容器创建/编辑的Volumes选项卡，选择Bind类型，填写主机绝对路径和容器路径
• 命名卷：先在Portainer的Volumes菜单创建对应卷，再在容器配置里选Volume类型关联

额外检查点 #

• 确保主机目录路径无拼写错误，是绝对路径
• 主机目录不能是Docker守护进程无权访问的受限路径
• 容器内的目标路径需是容器进程有权读写的目录

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