如何扩展Ubuntu Overlay的存储容量

Ubuntu 中 Overlay 存储扩容的正确思路

OverlayFS 本身是一个联合文件系统，容量由它的upperdir（可写层）和所有lowerdir（只读层）所在的底层文件系统决定；因此“扩容”的本质是给这些底层存储扩容，然后让 Overlay 识别新增空间。若你使用的是 Docker 的 overlay2，其数据默认位于 /var/lib/docker，通常应优先扩容该目录所在的分区/卷，而不是尝试直接“扩展 Overlay 本身”。

常见场景与对应做法

• 虚拟机或云盘底层扩容（VMware、VirtualBox、公有云）

  • 先在虚拟化平台或云控制台把虚拟磁盘/云盘容量调大，然后在 Ubuntu 内扩容分区与文件系统。
  • 典型步骤（以 Ubuntu 云盘为例）：安装工具（Ubuntu 14/16/18/Debian 9 可用 apt 安装 cloud-guest-utils 与 xfsprogs）→ 用 growpart 扩展分区（如 growpart /dev/vda 1）→ 扩展文件系统（ext4 用 resize2fs，XFS 用 xfs_growfs）→ 验证 df -h。Docker 场景看到 overlay/overlay2 挂载点容量随之变大。
  • VMware 场景：关机→扩展虚拟磁盘→开机后在系统内用 fdisk 删除并重建分区（保持起始扇区不变）→重启→resize2fs 扩展文件系统→df -h 验证。
  • LVM 场景：在新增空间上创建新分区并设类型为 **Linux LVM（8e）**→ pvcreate → vgextend 把新 PV 加入卷组 → lvextend 扩容逻辑卷 → 再用 resize2fs/xfs_growfs 扩展文件系统。

• Docker 使用 overlay2 时的扩容

  • 优先方案是将 /var/lib/docker 放到更大的磁盘/分区/LV 上，然后重启 Docker。
  • 临时过渡：清理无用镜像/容器/构建缓存（如 docker system prune -af），或把 /var/lib/docker 迁移到新盘后 bind mount 回去（停机迁移，注意权限与 SELinux/AppArmor）。
  • 不建议把单个容器的 upperdir 单独挂到小盘，容易再次受限；更稳妥的是扩容底层存储后让所有容器共享新增空间。

• 手动挂载的 OverlayFS（非 Docker）

  • 确认 upperdir、lowerdir、workdir 所在分区是否有空余空间；先扩容这些底层分区/卷（LVM、云盘、虚拟机磁盘等）。
  • 文件系统扩容后，OverlayFS 会自动看到新空间，通常无需卸载/重新挂载；若确有异常，可 umount 后按 mount -t overlay overlay -o lowerdir=…,upperdir=…,workdir=… 重新挂载。

快速排查与常用命令

• 查看空间与挂载：df -h、lsblk、fdisk -l；定位大目录：du -h --max-depth=1 /var/lib/docker
• 分区与文件系统扩容：growpart /dev/vda 1；resize2fs /dev/vda1（ext4）；xfs_growfs /mount/point（XFS）
• LVM 扩容：pvcreate /dev/sdX；vgextend /dev/sdX；lvextend -L +G ；resize2fs/xfs_growfs
• Docker 清理：docker system prune -af（谨慎，会删除未使用数据）
• 风险提示：任何分区/卷操作前先做快照/备份，并确保有可用空间再执行扩容，避免数据丢失。