在 Ubuntu 上,overlay(OverlayFS)常用于容器(Docker)、Live CD、initramfs、或者手动挂载联合文件系统。排查 overlay 配置错误,可以按下面思路和步骤来。
OverlayFS 需要内核支持:
uname -r
cat /proc/filesystems | grep overlay
如果没有 overlay,说明内核没开 CONFIG_OVERLAY_FS。
Ubuntu 一般默认支持,但老版本或定制内核可能不支持。
基本命令:
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 对目录有严格要求:
ls -ld /upper /work
ls -A /work # 必须为空
: 分隔dmesg | tail
journalctl -xe
Overlay 报错通常会写内核日志,例如:
overlayfs: upper fs does not support tmpfile
overlayfs: workdir is not empty
Docker 默认使用 overlay2:
docker info | grep Storage
如果是 overlay2:
ls -l /var/lib/docker/overlay2
常见问题:
/var/lib/docker 在 NFS / FAT / tmpfsd_type检查 d_type:
docker info | grep -i warning
或:
df -T /var/lib/docker
XFS 需要格式化时加:
mkfs.xfs -n ftype=1
示例:
overlay /mnt/merged overlay defaults,lowerdir=/a,upperdir=/b/upper,workdir=/b/work 0 0
排查:
mount -a 测试mount | grep overlaystrace mount -t overlay overlay -o ... /merged
mount --bind /lower /mnt/lower
mount --bind /upper /mnt/upper
stat -f /upper
不支持 overlay 的:
Docker 起不来
storage-driver overlay2 not supported
→ 文件系统不支持 d_type
容器写文件失败 → upperdir 所在分区只读
重启后 overlay 丢失 → 没写 fstab 或挂载顺序问题
如果你能贴出:
我可以直接帮你定位具体原因。