怎样调试debian overlay

在 Debian 上，“overlay”通常指 OverlayFS（叠加文件系统），常用于 Live CD、容器（Docker）、或自定义根文件系统。下面按常见使用场景说明如何调试。

一、确认 OverlayFS 是否正常工作

1. 查看内核支持

cat /proc/filesystems | grep overlay
# 或
lsmod | grep overlay

若无输出：

modprobe overlay

Debian 默认内核通常已支持。

2. 手动挂载测试（最基础调试）

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

失败常见原因：

workdir 与 upperdir 必须同一文件系统
lowerdir 可多个，用 : 分隔
权限不足（root 执行）

二、常见调试手段

1. 查看挂载信息

mount | grep overlay
cat /proc/mounts | grep overlay

2. 打开内核调试信息

dmesg -T | tail -50

OverlayFS 错误通常会打印在 dmesg 中。

3. 查看文件来源（调试写时复制）

ls -l /tmp/ovl/merged

文件在 upper 中出现 → 已修改（Copy-on-Write）
文件只在 lower → 只读

可用：

stat /tmp/ovl/merged/somefile

三、Docker / 容器中的 Overlay 调试

1. 查看存储驱动

docker info | grep -i storage

2. 查看 overlay 挂载点

findmnt -t overlay

3. 常见问题

磁盘满：upperdir 爆满
inode 耗尽

df -i

四、Debian Live / initramfs 中的 Overlay

常见于：

overlay / ro

调试方法：

cat /proc/cmdline

关键参数：

boot=live union=overlay

可加：

debug

查看 initramfs 日志。

五、典型错误与解决

错误	原因	解决
`mount: wrong fs type`	内核无 overlay	`modprobe overlay`
`workdir and upperdir must be same fs`	不同分区	放同一磁盘
文件改了但看不到	lower 覆盖	检查层级顺序
写不进去	upper 只读	检查权限/磁盘

六、调试建议总结

先用手动 mount验证
用 dmesg 看内核错误
分清 lower / upper / work
Docker 场景看 docker info

如果你能说明具体场景（Docker / Live / 自定义 rootfs / 启动失败），我可以给你更针对性的调试步骤。