centos overlay配置失败咋解决

CentOS 上 overlay（通常是 Docker 的 overlay2 存储驱动，或 Kubernetes/容器用的 overlay 文件系统）配置失败，原因比较集中，可以按下面思路一步步排查和解决。

一、先确认你用的是哪种 overlay

常见场景：

1. Docker 启动失败，报 overlay/overlay2 错误
2. mount -t overlay 手动挂载失败
3. Kubernetes / Podman 使用 overlay 报错

下面以 Docker overlay2 为主说明（最常见）。

二、最常见原因 & 解决办法

1️⃣ 文件系统不支持 overlay

overlay 需要：ext4 / xfs（带 ftype=1）

检查：

df -T /var/lib/docker

如果是 xfs：

xfs_info /var/lib/docker | grep ftype

• ftype=1 ✅ 正常
• ftype=0 ❌ 不支持 overlay2

✅ 解决：

• 重新格式化磁盘（xfs + -n ftype=1）
• 或改用 devicemapper / aufs（不推荐）
• 或换 ext4

2️⃣ 内核版本太低

CentOS 7 老内核容易出问题

查看：

uname -r

建议：

• CentOS 7：≥ 3.10.0-693
• CentOS 8 / Stream：没问题

✅ 解决：

yum update kernel
reboot

3️⃣ SELinux 导致 overlay 挂载失败

错误示例：

permission denied
overlay: failed to mount

✅ 临时关闭测试：

setenforce 0

✅ 永久解决（二选一）：

• 禁用 SELinux
• 或配置：

vim /etc/sysconfig/docker
# 添加
OPTIONS="--selinux-enabled=false"

4️⃣ Docker 存储驱动配置错误

查看当前驱动：

docker info | grep Storage

如果报错或不是 overlay2：

编辑：

vim /etc/docker/daemon.json

内容：

{
  "storage-driver": "overlay2"
}

然后：

systemctl restart docker

5️⃣ /var/lib/docker 损坏

常见于异常断电、磁盘满

✅ 解决（会清空镜像）：

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

⚠️ 生产环境慎用

6️⃣ 磁盘空间 / inode 耗尽

df -h
df -i

如果 100%：

• 清理日志
• 清理 docker：

docker system prune -a

三、快速排查命令汇总

# 查看 docker 错误
journalctl -u docker -xe

# 查看内核支持
lsmod | grep overlay

# 手动测试 overlay
mkdir -p /tmp/ov/{lower,upper,work,merged}
mount -t overlay overlay -o lowerdir=/tmp/ov/lower,upperdir=/tmp/ov/upper,workdir=/tmp/ov/work /tmp/ov/merged

四、如果你愿意，我可以更精准帮你

你可以贴出：

1. 完整报错信息
2. CentOS 版本（cat /etc/redhat-release）
3. Docker 版本（docker version）
4. 是 Docker / K8s / 手动 mount 哪一种

我可以直接告诉你具体哪一步错了、怎么改。