如何调试Debian Overlay

在 Debian 系统中调试 OverlayFS（Overlay） 通常涉及排查挂载失败、文件层不生效、写入异常等问题。下面按常见场景 + 调试方法系统说明。

一、确认内核与模块支持

1. 检查内核是否支持 OverlayFS

uname -r
ls /proc/filesystems | grep overlay

或：

modprobe overlay
lsmod | grep overlay

✅ 正常情况应能看到 overlay

二、手动挂载 Overlay 进行调试（最常用）

1. 准备目录结构

mkdir -p /tmp/overlay/{lower,upper,work,merged}

• lower：只读层
• upper：可写层
• work：工作目录（必须为空）
• merged：最终挂载点

2. 手动挂载

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

3. 验证

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

三、常见错误与调试方法

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

✅ 常见原因：

• workdir 不存在或不为空
• upperdir / workdir 在同一文件系统（某些旧内核要求不同）
• SELinux / AppArmor 限制

✅ 调试：

dmesg | tail -20

2. 修改文件但没生效

检查：

mount | grep overlay
ls -l /tmp/overlay/upper

✅ OverlayFS 只在 upperdir 中记录变更

3. 删除文件后又出现

原因：

• 在 lowerdir 中删除文件，会创建 whiteout 文件

检查：

ls -l /tmp/overlay/upper

whiteout 文件示例：

c--------- 1 root root 0, 0 file

四、调试 Docker / systemd-nspawn 使用的 Overlay

1. Docker

docker info | grep -i overlay

查看存储位置：

ls /var/lib/docker/overlay2

调试容器层：

docker inspect <container-id> | grep UpperDir

2. systemd-nspawn

systemd-nspawn --overlay=+/path/to/upper:/path/to/lower:/merged

调试：

machinectl status

五、查看 OverlayFS 内部结构

1. 查看 xattr（重要）

OverlayFS 使用扩展属性记录来源：

getfattr -d -m ".*" /tmp/overlay/merged/somefile

常见属性：

• trusted.overlay.opaque
• trusted.overlay.origin

2. 查看文件真实来源

stat /tmp/overlay/merged/file
ls -l /tmp/overlay/upper/file
ls -l /tmp/overlay/lower/file

六、调试 initramfs / Live 系统 Overlay

常见于 Debian Live / Raspberry Pi OS

1. 查看启动参数

cat /proc/cmdline

关注：

boot=live union=overlay

2. 查看挂载情况

mount | grep overlay
cat /proc/mounts

七、日志与调试工具

1. 内核日志（最重要）

dmesg -T | grep -i overlay
journalctl -k | grep overlay

2. 使用 strace 跟踪 mount

strace mount -t overlay overlay -o ... /mnt

八、典型调试清单（快速）

✅ 检查项：

• [ ] 内核支持 overlay
• [ ] lower / upper / work 目录存在
• [ ] workdir 为空
• [ ] upper 和 work 在同一文件系统
• [ ] 没有 SELinux / AppArmor 拦截
• [ ] dmesg 无报错
• [ ] 文件修改出现在 upperdir

九、常见使用场景总结

如果你愿意，可以告诉我：

• ✅ 是 Docker / Live / 手动挂载 / systemd 哪种？
• ✅ 报错信息或 dmesg 输出
• ✅ Debian 版本（cat /etc/debian_version）

我可以给你针对性的调试步骤。