debian overlay怎样排错

在 Debian 中使用 overlay（overlayfs，常用于 Live CD、容器、initramfs、systemd 等场景）时，排错可以从内核支持、挂载参数、上层/下层目录、权限、fstab/systemd 配置几个方面入手。下面按常见场景给你一套排错思路。

一、先确认 overlay 是否可用

1. 内核是否支持 overlay

cat /proc/filesystems | grep overlay

或

lsmod | grep overlay

如果没有：

• Debian 默认内核一般支持
• 如果是自定义内核，需开启：

  CONFIG_OVERLAY_FS=y
  

2. 手动挂载测试（最推荐）

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

如果失败，错误信息是最直接的线索。

二、常见错误与原因

1. mount: wrong fs type, bad option, bad superblock

可能原因：

• workdir 缺失或不在同一文件系统
• upperdir 和 workdir 必须：
  • 在同一文件系统
  • 不能是 overlay 本身
• lowerdir 不存在

✅ 正确示例：

lowerdir=/a
upperdir=/b/upper
workdir=/b/work

❌ 错误示例：

upperdir=/a/upper
workdir=/c/work   # 不同文件系统

2. workdir and upperdir must be on same filesystem

df -i /upper /work
df /upper /work

确保：

mount | grep upper

3. 只读 lowerdir 被修改

• lowerdir 必须是只读
• 修改只发生在 upperdir

如果你看到：

cannot create directory : Read-only file system

说明：

• 实际写到了 lower
• 或 upper 没正确挂载

4. 权限问题（非常常见）

• upperdir / workdir 必须是 root 可写
• 在容器中常见：

chmod 700 /upper /work
chown root:root /upper /work

5. overlay 作为 rootfs（Live / initramfs）

常见于：

/dev/sda1 → lower
tmpfs → upper

排错：

dmesg | grep overlay
journalctl -b | grep overlay

三、系统层面排错（fstab / systemd）

1. /etc/fstab 示例

overlay /mnt/merged overlay \
lowerdir=/mnt/lower,upperdir=/mnt/upper,workdir=/mnt/work 0 0

⚠ 注意：

• nofail 可避免启动失败

overlay /mnt/merged overlay nofail 0 0

2. systemd mount 单元

如果失败：

systemctl status mnt-merged.mount
journalctl -u mnt-merged.mount

四、调试技巧

1. 打开内核日志

dmesg -T | grep overlay

2. 使用 strace

strace -f mount -t overlay overlay -o ... /merged

3. 检查是否被其他 overlay 嵌套

overlay 不能嵌套 overlay（除非内核支持并配置）

五、容器 / Docker 场景补充

如果是 Docker：

docker info | grep Storage

• overlay2 推荐
• 老 overlay 已弃用

六、最小排错清单 ✅

1. 内核支持 overlay
2. lower / upper / work 都存在
3. upper 和 work 同文件系统
4. 权限正确
5. 手动 mount 测试
6. 看 dmesg / journalctl

如果你能贴出：

• 具体报错
• 使用场景（Live / 容器 / fstab）
• Debian 版本 & 内核版本

我可以帮你精确到某一条命令来修。