Docker Compose运行报错：fuse-overlayfs存储驱动注册symlink操作不被允许

核心原因 #

failed to register layer: symlink ... operation not permitted
该报错源于vfat文件系统原生不支持Linux符号链接、POSIX权限位及特殊文件属性，即使使用fuse-overlayfs作为存储驱动，也无法突破底层文件系统的功能限制，镜像层解压创建软链接时直接触发权限拒绝。

可选解决方案 #

• 方案一：格式化外接盘为Linux原生文件系统（最推荐）

  1. 备份外接盘内全部现有数据
  2. 执行lsblk查询外接盘对应的分区路径（例：/dev/sda1）
  3. 格式化为ext4文件系统：mkfs.ext4 /dev/你的分区路径
  4. 修改/etc/fstab配置分区开机自动挂载，重新挂载后重启Docker服务即可，无需继续使用fuse-overlayfs，默认overlay2驱动即可正常运行。

• 方案二：切换存储驱动为vfs（适配不可格式化的vfat盘）
  若必须保留vfat格式，可切换到不依赖symlink支持的vfs存储驱动，缺点是存储利用率低、读写性能差。
  修改/etc/docker/daemon.json配置：

  {
    "data-root": "/mnt/usb1/docker",
    "storage-driver": "vfs"
  }
  

  执行systemctl daemon-reload && systemctl restart docker重启Docker后重新启动容器即可。

• 方案三：拆分存储路径（折中方案）
  将Docker镜像、容器运行时的核心存储放在本地内置磁盘（使用默认overlay2驱动），仅把业务数据通过卷挂载到vfat外接盘，兼顾存储效率和数据外置需求。修改后的docker-compose配置参考：

  prometheus:
    image: ajeetraina/prometheus-armv7
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml
      # 监控数据存储到外接盘
      - /mnt/usb1/prometheus/data:/prometheus
    command:
      - "-config.file=/etc/prometheus/prometheus.yml"
    ports:
      - "9090:9090"
  
  grafana:
    image: fg2it/grafana-armhf:v3.1.1
    volumes:
      # 仪表盘配置、数据存储到外接盘
      - /mnt/usb1/grafana/data:/var/lib/grafana
    ports:
      - "3000:3000"
  

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