ubuntu overlay为何找不到

在 Ubuntu 里“overlay 找不到”通常分几种情况，下面按最常见原因逐一说明，你可以对照看看是哪一种。

一、你指的是 overlay 文件系统（overlayfs）

1️⃣ 内核没开启 overlay 支持

Ubuntu 桌面/服务器版一般都支持，但：

• 某些 定制内核 / 云厂商内核
• 某些 容器专用内核
• 很老的内核（< 3.18）

检查：

cat /proc/filesystems | grep overlay

或

lsmod | grep overlay

如果没有：

modprobe overlay

失败说明内核未编译 CONFIG_OVERLAY_FS。

2️⃣ mount 时提示 unknown filesystem type 'overlay'

典型错误：

mount: unknown filesystem type 'overlay'

原因：

• overlay 模块未加载
• 在 chroot / 容器 / WSL1 环境

解决：

modprobe overlay

仍不行 → 内核不支持

二、你指的是 Docker 的 overlay / overlay2 存储驱动

1️⃣ Docker 说不支持 overlay2

storage-driver overlay2 not supported

检查：

docker info | grep Storage

常见原因：

• 在 WSL1（不支持）
• 文件系统不是 ext4 / xfs
• 内核太老

解决：

• 用 ext4
• 升级内核
• WSL1 → 改用 WSL2

三、你指的是 overlayroot（Ubuntu 只读根文件系统）

Ubuntu 有 overlayroot 包，但 默认不安装。

检查：

dpkg -l | grep overlayroot

安装：

sudo apt install overlayroot

配置：

sudo nano /etc/overlayroot.conf

四、你指的是 overlay 网络（Docker / Kubernetes）

如果是：

overlay network not found

常见原因：

• Docker 未启用 bridge + overlay
• 在非 swarm 模式
• 防火墙阻断 VXLAN（4789）

检查：

docker network ls

五、你是在 WSL 里用 Ubuntu

⚠️ WSL1 不支持 overlay ✅ WSL2 支持

确认：

uname -a

看到 WSL1 → 升级到 WSL2

快速自检清单 ✅

cat /proc/filesystems | grep overlay
modprobe overlay
uname -a
docker info 2>/dev/null | grep Storage

如果你能贴出具体报错信息（命令 + 报错），我可以精准告诉你缺哪一步。