检查 Ubuntu Overlay 配置是否正确的实用步骤
一 明确检查对象
- OverlayFS 文件系统：联合挂载，将多个目录层叠为统一视图，常用于容器镜像层与可写层。
- 根文件系统覆盖 overlayroot：以只读根 + 可写覆盖层的方式保护系统盘，配置集中在 /etc/overlayroot.conf。
- 容器网络 Overlay：跨主机容器通信的 Docker Overlay 网络，依赖 Swarm/KV 等控制面。
二 快速检查清单
- 查看内核是否支持 OverlayFS：grep CONFIG_OVERLAY_FS /boot/config-$(uname -r)，期望输出为 CONFIG_OVERLAY_FS=y。若使用容器，还需确认内核启用 cgroups 与 namespaces（如 CONFIG_CGROUPS、CONFIG_NAMESPACES 为 y）。
- 检查模块与挂载：lsmod | grep overlay；mount | grep overlay；findmnt -o TARGET,SOURCE,FSTYPE,OPTIONS -T /your/mount。关注挂载选项是否包含 lowerdir、upperdir、workdir，且为 rw 状态。
- 核对 fstab 与手工命令：grep overlay /etc/fstab；必要时用 mount -t overlay overlay -o lowerdir=…,upperdir=…,workdir=… /merged 测试挂载是否成功。
- 权限与目录：确认 upperdir/workdir 存在且可写（权限、属主、父目录可访问），避免因权限导致写入失败。
- 资源与日志：df -h 检查空间；dmesg | tail、journalctl -xe 或 tail /var/log/syslog 查看挂载/访问报错线索。
三 场景化验证步骤
- 场景A OverlayFS 手动或 fstab 挂载
- 核对目录与权限：ls -ld /lower /upper /work /merged；确保 upperdir/workdir 可写。
- 挂载并校验：mount -t overlay overlay -o lowerdir=/lower,upperdir=/upper,workdir=/work /merged；mount | grep overlay；findmnt -T /merged。
- 功能验证：在 /merged 中创建文件、修改文件，确认写入落在 upperdir，底层 lowerdir 保持不变；必要时 umount /merged 清理。
- 场景B 根文件系统覆盖 overlayroot
- 查看配置：grep -E ‘^overlayroot=’ /etc/overlayroot.conf；常见值为 tmpfs 或设备路径（如 overlayroot=“/dev/sda2”）。
- 检查挂载：mount | grep ’ / '；若启用 overlayroot，根应显示为 overlay 类型，包含 lowerdir（只读根）与 upperdir（可写层，常见在 /media/root-rw 或 tmpfs）。
- 临时回写：若需维护，可在 GRUB 启动项添加 overlayroot=disabled 临时以可写根启动，完成后再恢复。
- 场景C Docker Overlay 网络（Swarm）
- 环境准备：docker swarm init；docker network create -d overlay my_overlay。
- 运行验证：docker run -d --name c1 --network my_overlay busybox sleep 3600；docker exec c1 ping -c 4 c2 或查看 docker network inspect my_overlay 的 Containers 字段。
四 常见错误与修复要点
- 挂载失败或只读：检查 lowerdir/upperdir/workdir 路径、权限与存在性；确认 workdir 必须是空目录；查看 dmesg/journal 报错定位参数或 I/O 问题。
- 空间不足：df -h 发现 upperdir 所在分区满会导致写入失败，清理不必要文件或扩容。
- 内核不支持：/boot/config-$(uname -r) 中 CONFIG_OVERLAY_FS 为 n 时需升级内核或启用相应配置后重启。
- 容器网络异常：确认 Swarm 已初始化、节点间网络互通、必要的 KV/集群存储 配置正确（如 Consul/etcd 地址），再创建/连接 overlay 网络。