linux overlay常见问题有哪些

Linux 的 OverlayFS（overlay） 常用于容器（Docker、Kubernetes）、Live CD、只读根文件系统等场景。下面按使用场景 + 问题分类总结常见问题和原因。

一、基础概念相关问题

1. overlay 与 overlay2 的区别

• overlay：旧版本，只支持两层（upper + lower）
• overlay2：推荐，支持多层 lowerdir，Docker 默认使用
• 问题表现：旧内核或旧 Docker 使用 overlay 可能不稳定

✅ 建议：内核 ≥ 4.x，Docker 使用 overlay2

二、挂载相关常见问题

2. 挂载失败：mount: wrong fs type

常见原因：

• 内核未开启 CONFIG_OVERLAY_FS
• 目录不存在或权限不足
• upperdir / workdir 不在同一文件系统（某些旧内核要求）

检查：

cat /proc/filesystems | grep overlay
lsmod | grep overlay

3. workdir 必须存在且为空

错误示例：

overlayfs: workdir is in-use by another mount

规则：

• workdir 不能和 upperdir 相同
• workdir 必须为空目录

4. lowerdir 多个目录顺序错误

mount -t overlay overlay \
  -o lowerdir=/a:/b,upperdir=/u,workdir=/w /mnt

注意：

• lowerdir 从左到右优先级递减
• /a 覆盖 /b

三、容器场景（Docker / K8s）常见问题

5. Docker 无法启动：storage-driver=overlay 不支持

错误：

overlay: the backing xfs filesystem is formatted without d_type support

原因：

• XFS 未开启 ftype=1

检查：

xfs_info /var/lib/docker | grep ftype

解决：

• 重新格式化并加：

mkfs.xfs -n ftype=1 /dev/sdX

6. 容器磁盘爆满（overlay 占用高）

原因：

• 容器写层（upperdir）不断写入
• 未清理停止的容器

排查：

docker system df
du -sh /var/lib/docker/overlay2/*

清理：

docker system prune -a

7. 删除文件但空间不释放

原因：

• 文件在 lowerdir 中被 upperdir 用 whiteout 屏蔽
• 实际 inode 仍存在

表现：

df -h 看满了
du 看不到大文件

解决：

• 清理容器或重建 overlay 层

四、权限与安全问题

8. 权限异常（root 也无权）

原因：

• lowerdir 只读
• SELinux / ACL 限制

排查：

ls -lZ /lower
getenforce

9. 用户 namespace + overlay 不兼容

• overlay 在某些内核版本不支持 userns
• 容器开启 --userns-remap 可能失败

五、性能与稳定性问题

10. 大量小文件性能差

原因：

• overlay 多层查找
• inode 开销大

优化：

• 减少镜像层数
• 使用 ext4 / xfs + 合适挂载选项

11. 内核 BUG / 死锁

• 旧内核（< 4.10）常见
• 表现：mount 卡死、rm 卡死

解决：

• 升级内核
• 避免嵌套 overlay

六、典型错误汇总（速查）

如果你有具体场景（Docker / K8s / 嵌入式 / Live OS / 自己 mount），可以告诉我，我可以给你更针对性的排查清单。