温馨提示×

ubuntu overlay配置如何排查错

小樊
80
2026-10-18 11:27:09
栏目: 智能运维

在 Ubuntu 上,overlay(OverlayFS)常用于容器(Docker)、Live CD、initramfs、或者手动挂载联合文件系统。排查 overlay 配置错误,可以按下面思路和步骤来。


一、确认内核和工具支持

OverlayFS 需要内核支持:

uname -r
cat /proc/filesystems | grep overlay

如果没有 overlay,说明内核没开 CONFIG_OVERLAY_FS。

Ubuntu 一般默认支持,但老版本或定制内核可能不支持。


二、手动挂载 overlay 测试(最有用)

基本命令:

mount -t overlay overlay \
  -o lowerdir=/lower,upperdir=/upper,workdir=/work \
  /merged

常见错误和含义

错误 原因
mount: wrong fs type 内核不支持 overlay
upperdir is in-use upperdir 已被其他 overlay 使用
workdir and upperdir must be on same fs upper 和 work 不在同一文件系统
lowerdir missing lowerdir 路径不存在
permission denied SELinux / 权限 / 只读文件系统

三、检查目录要求(非常重要)

overlay 对目录有严格要求:

  1. upperdir 和 workdir
    • 必须在同一个文件系统
    • workdir 必须是空目录
    • upperdir 可以是空目录
ls -ld /upper /work
ls -A /work   # 必须为空
  1. lowerdir
    • 可以多个,用 : 分隔
    • 必须是只读或不会被写的地方

四、查看系统日志

dmesg | tail
journalctl -xe

Overlay 报错通常会写内核日志,例如:

overlayfs: upper fs does not support tmpfile
overlayfs: workdir is not empty

五、Docker 场景排查

Docker 默认使用 overlay2:

docker info | grep Storage

如果是 overlay2:

ls -l /var/lib/docker/overlay2

常见问题:

  • /var/lib/docker 在 NFS / FAT / tmpfs
  • 文件系统不支持 d_type

检查 d_type:

docker info | grep -i warning

或:

df -T /var/lib/docker

XFS 需要格式化时加:

mkfs.xfs -n ftype=1

六、fstab 中的 overlay 配置

示例:

overlay /mnt/merged overlay defaults,lowerdir=/a,upperdir=/b/upper,workdir=/b/work 0 0

排查:

  • 用 mount -a 测试
  • 看 mount | grep overlay
  • 确保路径在挂载时已存在

七、调试技巧

1. 用 strace

strace mount -t overlay overlay -o ... /merged

2. 单步测试

mount --bind /lower /mnt/lower
mount --bind /upper /mnt/upper

3. 检查文件系统类型

stat -f /upper

不支持 overlay 的:

  • NFS
  • vfat
  • some tmpfs

八、典型案例速查

Docker 起不来

storage-driver overlay2 not supported

→ 文件系统不支持 d_type

容器写文件失败 → upperdir 所在分区只读

重启后 overlay 丢失 → 没写 fstab 或挂载顺序问题


如果你能贴出:

  • Ubuntu 版本
  • 使用场景(Docker / 手动 / Live)
  • 报错原文

我可以直接帮你定位具体原因。

0 踩