如何快速解决Overlay配置中的常见问题，避免配置难题困扰？

Overlay 配置常见痛点汇总，方便你定位并解决部署中的难题。

一、内核版本不兼容

症状：在启动 Docker 或 Kubernetes 时出现 “unknown filesystem type ‘overlay’” 或 “cannot mount overlay” 的报错；/var/lib/docker/overlay2 目录无法创建。老实说，

原因：OverlayFS 需要 Linux 内核 ≥4.0。部分老旧发行版不满足要求。

方法：

• 至于检查内核版本。uname -r
• 若低于 4.0，升级内核。
• 后 再看确认。uname -r
• 如使用自定义 initramfs，需包含 overlay 模块。

二、Overlay 模块未加载或被禁用

症状："unknown filesystem type ‘overlay’"，Docker 启动报错。

原因：OverlayFS 模块未被加载或已被禁用。

• lsmod | grep overlay 检查模块是否已加载。若无，请手动加载：sudo modprobe overlayfs.
• Create 自动加载配置：在 /etc/modules-load.d/overlay.conf 写入 `overlay` 并重启。