debian overlay配置要注意啥

在 Debian（以及大多数 Linux 发行版）上使用 overlay（OverlayFS）时，通常出现在 Docker 存储驱动、Live CD/USB、initramfs、或 容器/沙箱定制 场景。下面从通用配置注意点和常见使用场景两个层面说明。

一、OverlayFS 基本原理（先理清）

OverlayFS 至少包含两个目录：

• lowerdir：只读层（可以多个，用 : 分隔）
• upperdir：可读写层
• workdir：工作目录（必须和 upperdir 同文件系统）
• merged：最终挂载点

示例：

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

二、Debian 上配置 overlay 的通用注意事项

1. 内核支持

Debian 默认内核已支持 overlay（≥ 3.18）：

lsmod | grep overlay
modprobe overlay

如失败，需确认内核是否裁剪过。

2. workdir 的硬性要求（最容易踩坑）

• workdir 必须为空
• workdir 和 upperdir 必须在同一文件系统
• 不能是 tmpfs 与 ext4 混用（除非同类型）

❌ 错误示例：

upperdir=/mnt/ext4/upper
workdir=/tmp/work   # 不同文件系统

✅ 正确：

upperdir=/mnt/overlay/upper
workdir=/mnt/overlay/work

3. lowerdir 可以是多个

lowerdir=/lower1:/lower2:/lower3

优先级从左到右，左边覆盖右边

4. 权限与 SELinux/ACL

Debian 默认不用 SELinux（用 AppArmor）：

• 注意 文件 owner / mode
• upperdir 中新建文件继承挂载时权限
• 若用于容器，建议 root 或明确 uid/gid

5. 不要直接在 upperdir/lowerdir 里操作文件

• 所有访问走 merged 挂载点
• 直接改 upper/lower 可能导致不一致

6. 卸载顺序

umount /merged

未 umount 就删 upper/work 会出问题。

7. fstab 配置示例

overlay /merged overlay \
  noauto,x-systemd.requires=/upper,lowerdir=/lower,upperdir=/upper,workdir=/work 0 0

注意：

• noauto 防止启动失败
• 确保底层目录已挂载

三、Docker 场景（Debian 最常见）

查看当前驱动

docker info | grep Storage

推荐配置（overlay2）

/etc/docker/daemon.json：

{
  "storage-driver": "overlay2"
}

重启：

systemctl restart docker

⚠ 注意：

• 不要用 overlay（旧版，已弃用）
• 文件系统推荐 ext4 或 xfs
• 禁止在 btrfs 上再套 overlay（性能差）

四、Live / 持久化场景（Debian Live）

常见于：

overlayfs:/upperdir=/persist/upper:/lowerdir=/filesystem.squashfs

注意：

• squashfs 必须只读
• persist 分区需可写
• 启动参数写错会直接进 emergency shell

五、排错常用命令

dmesg | tail
mount | grep overlay
ls -ld /upper /work

六、一句话总结

Debian 配 overlay，最关键的是：workdir 同文件系统且为空、所有操作走 merged、Docker 用 overlay2、fstab 谨慎写。

如果你能说下你是 Docker / Live USB / 自研容器 / 启动挂载 哪种场景，我可以给你更精确的配置示例。