CentOS Overlay配置会出错吗

简短回答：会，CentOS 下配置 Overlay（OverlayFS）是“容易出错的”，尤其是在不同版本、不同存储驱动、不同初始化方式下。下面按常见场景 + 易错点 + 排查建议说明。

一、常见出错场景

1️⃣ CentOS 版本与内核不兼容

OverlayFS 依赖内核支持：

❌ 常见问题：

• 老内核不支持 overlay2
• 启用 overlay2 却实际还在用 overlay

✅ 检查：

uname -r
lsmod | grep overlay

2️⃣ Docker / Podman Overlay 存储驱动配置错误（最常见）

❌ 错误示例

{
  "storage-driver": "overlay2"
}

但：

• /var/lib/docker 在 不支持 overlay 的文件系统
• 或之前用过 devicemapper，没有清理

✅ 建议配置：

{
  "storage-driver": "overlay2",
  "storage-opts": [
    "overlay2.override_kernel_check=true"
  ]
}

3️⃣ 文件系统不兼容（非常常见）

OverlayFS 不支持：

✅ 检查：

df -T /var/lib/docker

✅ 推荐：

• ext4
• xfs（必须开启 ftype=1）

检查 XFS：

xfs_info / | grep ftype

✅ 必须是：

ftype=1

4️⃣ SELinux 导致 Overlay 失败（CentOS 经典坑）

SELinux 会直接导致：

• Overlay 挂载失败
• 容器无法启动
• 权限报错

✅ 排查：

getenforce

✅ 临时验证：

setenforce 0
systemctl restart docker

✅ 永久解决（生产不推荐直接关）：

sed -i 's/^SELINUX=.*/SELINUX=permissive/' /etc/selinux/config

5️⃣ 手动 mount overlay 时参数错误

❌ 错误示例

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

常见错误：

• workdir 和 upperdir 在同一目录
• workdir 不存在
• lowerdir 顺序错误

✅ 正确示例：

mount -t overlay overlay \
  -o lowerdir=/lower,upperdir=/upper,workdir=/work \
  /merged

6️⃣ Docker 升级后 Overlay 异常

Docker 升级后常见问题：

• 旧 graphdriver 与新版本不兼容
• /var/lib/docker 残留

✅ 排查：

docker info | grep -i storage

⚠️ 不要直接删除 /var/lib/docker（会丢数据）

二、快速自检清单 ✅

# 1. 内核支持
uname -r

# 2. overlay 模块
lsmod | grep overlay

# 3. 文件系统
df -T /var/lib/docker

# 4. SELinux
getenforce

# 5. Docker 存储驱动
docker info | grep -i storage

三、推荐配置（CentOS 最佳实践）

✅ CentOS 7/8/Stream

• 文件系统：xfs (ftype=1) 或 ext4
• Docker 存储：overlay2
• SELinux：permissive 或规则放行
• 不直接在 NFS 上使用 overlay

四、你具体是哪种情况？

你可以直接告诉我：

1. CentOS 具体版本
2. 是 Docker / Podman / 手动 overlay
3. 报错日志（docker info / journalctl -u docker）

我可以精确帮你定位是哪一步出错，而不是泛泛而谈。