为何overlay挂载失败

“Overlay 挂载失败”在生产/容器中很常见，但原因取决于你用的是哪种 overlay：

• overlayfs（Linux 文件系统，如 Docker、Kubernetes、容器根fs）
• Overlay 网络（如 Docker overlay network、Kubernetes Flannel/Calico）
• 软件部署中的 overlay 目录挂载（如 livecd、固件、大屏系统）

下面按**最常见场景（overlayfs）**给你原因 + 排查方法。

一、Linux overlayfs 挂载失败常见原因

1️⃣ 内核不支持 overlay

cat /proc/filesystems | grep overlay

如果没有输出：

• 老内核（< 3.18）不支持
• 某些云厂商定制内核被裁剪

✅ 解决：升级内核或换支持 overlay 的镜像

2️⃣ lowerdir / upperdir / workdir 不存在或权限不对

overlay 必须：

• lowerdir 存在
• upperdir 存在且可写
• workdir 存在且为空

典型错误：

mount: mounting overlay on ... failed: No such file or directory

✅ 检查：

ls -ld lower upper work

3️⃣ workdir 和 upperdir 在同一文件系统但配置错误

错误示例：

overlayfs: workdir and upperdir must be same fs

✅ 解决：

mount -t overlay overlay \
  -o lowerdir=/a,upperdir=/b/upper,workdir=/b/work \
  /mnt

4️⃣ upperdir 或 workdir 被只读挂载

常见于：

• 根分区只读
• 容器以 ro 挂载

✅ 检查：

mount | grep 'on / '

5️⃣ SELinux / 安全模块限制

报错可能像：

permission denied

✅ 临时验证：

setenforce 0

6️⃣ Docker / Kubernetes 场景

常见原因：

• /var/lib/docker 在不支持 overlay 的文件系统（如 some NFS）
• storage-driver 配置错误

✅ 检查：

docker info | grep -i storage

二、如果你是在用容器 overlay 网络失败

常见原因：

• 没有正确初始化 swarm / CNI
• 防火墙阻断 VXLAN（4789 UDP）
• 节点时间不一致

三、请补充信息我可以精准定位

你可以贴出：

1. 完整报错信息
2. 使用场景（Docker？K8s？裸机？）
3. 挂载命令或配置文件
4. 内核版本（uname -a）

我可以直接帮你判断是哪一类问题。