CentOS Overlay常见问题及解决方案

一、内核版本过低不支持Overlay

• 问题描述：CentOS 7默认内核版本（如3.10.0-327以下）不支持Overlay2存储驱动，导致Docker启动时报错“unsupported graphdriver: overlay2”。
• 解决方法：
  1. 升级内核至3.10.0-514及以上版本（CentOS 7可通过yum --enablerepo=extras install kernel-latest安装最新内核）；
  2. 修改/etc/docker/daemon.json，添加"storage-driver": "overlay2"和"storage-opts": ["overlay2.override_kernel_check=true"]；
  3. 重启系统并启动Docker服务（systemctl daemon-reload && systemctl start docker）。

二、SELinux阻止Overlay操作

• 问题描述：SELinux策略限制可能导致Overlay挂载失败（如“Permission denied”）或Docker容器无法访问Overlay文件系统（如“no such file or directory”）。
• 解决方法：
  1. 临时禁用SELinux测试（setenforce 0），若问题解决则调整策略；
  2. 使用semanage fcontext添加SELinux上下文（如semanage fcontext -a -t httpd_sys_rw_content_t "/var/lib/docker(/.*)?"），并通过restorecon -Rv /var/lib/docker恢复上下文；
  3. 若无需SELinux保护，可修改/etc/selinux/config将SELINUX=enforcing改为SELINUX=permissive（需重启系统）。

三、内核模块未加载

• 问题描述：系统未加载overlay内核模块，导致挂载Overlay文件系统时报错“mount: unknown filesystem type ‘overlay’”或“missing module overlay”。
• 解决方法：
  1. 创建模块加载配置文件：echo "overlay" | sudo tee /etc/modules-load.d/overlay.conf；
  2. 重启系统使模块自动加载（或手动执行modprobe overlay）。

四、Docker存储驱动配置错误

• 问题描述：/etc/docker/daemon.json配置错误（如缺少storage-driver字段、拼写错误），导致Docker无法使用Overlay2驱动（如“Cannot start service: error initializing graphdriver”）。
• 解决方法：
  1. 编辑/etc/docker/daemon.json，确保内容为：{"storage-driver": "overlay2", "storage-opts": ["overlay2.override_kernel_check=true"]}（若已有其他配置，需合并）；
  2. 重启Docker服务（systemctl daemon-reload && systemctl restart docker）。

五、文件系统不支持或参数错误

• 问题描述：
  • 使用XFS文件系统但未启用ftype=1（Overlay2要求XFS的ftype=1）；
  • 文件系统类型不支持Overlay（如旧版ext3）。
• 解决方法：
  1. 检查文件系统类型（df -Th），若为XFS且ftype=0，需重新格式化（mkfs.xfs -n ftype=1 /dev/sdXY，注意：格式化会清除数据）；
  2. 若使用ext4，确保内核支持（ext4默认支持Overlay）；
  3. 挂载时添加必要参数（如rw,noatime,data=writeback），可通过/etc/fstab永久生效。

六、挂载参数或路径错误

• 问题描述：
  • 指定lowerdir、upperdir、workdir路径不存在或非绝对路径；
  • 挂载时参数顺序错误（如overlay写成overaly）。
• 解决方法：
  1. 确认路径存在（ls -ld /path/to/lower /path/to/upper /path/to/work），并使用绝对路径；
  2. 正确执行挂载命令：mount -t overlay overlay -o lowerdir=/lower,upperdir=/upper,workdir=/work /mnt/overlay；
  3. 检查/etc/fstab中的挂载配置（若有），确保参数正确。

七、磁盘空间不足

• 问题描述：/var/lib/docker/overlay2目录占满（如容器镜像过多），导致无法创建新容器（报错“no space left on device”）。
• 解决方法：
  1. 使用df -h检查磁盘空间，du -sh /var/lib/docker/overlay2/*定位大目录；
  2. 清理无用镜像（docker rmi $(docker images -q -f "dangling=true")）、停止的容器（docker rm $(docker ps -aq)）；
  3. 将/var/lib/docker挂载到单独的大容量磁盘（如/dev/sdb1），修改/etc/fstab实现永久挂载。

八、OverlayFS层数过多导致性能下降

• 问题描述：容器层数过多（如超过128层），导致启动慢、读写性能下降（如docker build时逐层复制耗时久）。
• 解决方法：
  1. 合并Dockerfile中的相邻RUN命令（如将RUN apt-get update && apt-get install -y curl合并为一条）；
  2. 使用多阶段构建（FROM多个阶段，仅复制必要文件到最终镜像）；
  3. 调整内核参数限制层数（echo 128 > /proc/sys/fs/overlayfs/max_layers，临时生效；需写入/etc/sysctl.conf永久生效）。