centos overlay为何配置失败

CentOS 上 overlay（OverlayFS）配置失败通常不是单一原因，而是和 内核版本、存储驱动、文件系统、Docker/容器运行时配置或 SELinux 有关。下面按常见原因 → 排查方法 → 解决办法说明。

一、最常见原因汇总

1️⃣ 内核版本过低（最常见）

OverlayFS 需要：

• CentOS 7：内核 ≥ 3.10.0-514
• CentOS 8/Stream：一般原生支持

❌ 老内核会直接失败：

overlay: filesystem not supported

✅ 检查：

uname -r

✅ 解决：

yum update kernel -y
reboot

2️⃣ 底层文件系统不支持 overlay

OverlayFS 不支持：

• 某些 NFS
• 某些 tmpfs 组合
• 非 UTF-8 / 老 ext3

支持较好：

• ext4
• xfs（CentOS 默认）

✅ 检查：

df -T /var/lib/docker

✅ 解决：

• 使用 ext4 / xfs
• 不要放在 NFS 上

3️⃣ Docker 存储驱动配置错误（非常常见）

Docker 默认应使用：

storage-driver = overlay2

❌ 错误配置示例：

{
  "storage-driver": "overlay"
}

✅ 正确（CentOS 推荐）：

{
  "storage-driver": "overlay2"
}

文件位置：

/etc/docker/daemon.json

重启：

systemctl restart docker

4️⃣ /var/lib/docker 目录有问题

• 权限错误
• 之前用 devicemapper 残留
• 磁盘满

✅ 检查：

ls -ld /var/lib/docker
df -h

✅ 清理（⚠️会删容器）：

systemctl stop docker
rm -rf /var/lib/docker
systemctl start docker

5️⃣ SELinux 导致挂载失败

CentOS 默认开启 SELinux。

表现：

permission denied
overlay mount failed

✅ 临时测试：

setenforce 0

✅ 永久（不推荐关闭）：

vi /etc/selinux/config
SELINUX=permissive

✅ 正确方式： 确保 Docker 支持 SELinux：

rpm -qa | grep docker-selinux

6️⃣ 手动 mount overlay 失败（非 Docker）

示例：

mount -t overlay overlay -o lowerdir=/a,upperdir=/b,workdir=/c /mnt

失败常见原因：

• workdir 不存在
• upperdir 和 workdir 同盘但不空
• 权限不足

✅ 正确结构：

mkdir -p /a /b /c /mnt
mount -t overlay overlay \
  -o lowerdir=/a,upperdir=/b,workdir=/c /mnt

二、快速排查清单（照着做）

uname -r
cat /etc/os-release
docker info | grep -i storage
ls -l /var/lib/docker
df -T /var/lib/docker
getenforce

三、如果你能贴出错误信息

请把以下任意一项贴出来，我可以精准定位：

• docker info 输出
• journalctl -u docker
• 手动 mount 报错
• 具体 CentOS 版本（7 / 8 / Stream）

我可以一步步帮你修 ✅