怎样调试linux overlay

在 Linux 下调试 OverlayFS（overlay） 通常涉及内核参数、挂载选项、工具排查以及常见故障定位。下面按「原理 → 调试方法 → 常见坑 → 工具」系统讲一下。

一、OverlayFS 基本结构回顾

Overlay 挂载通常包含：

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

示例：

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

二、启用调试信息（最重要）

1. 动态开启 OverlayFS 调试

OverlayFS 使用内核 dynamic debug：

# 查看是否支持
cat /sys/kernel/debug/dynamic_debug/control | grep overlay

# 开启 overlay 所有调试
echo "file fs/overlayfs/* +p" > /sys/kernel/debug/dynamic_debug/control

查看日志：

dmesg -T | tail
journalctl -k -f

关闭：

echo "file fs/overlayfs/* -p" > /sys/kernel/debug/dynamic_debug/control

2. 挂载时增加 verbose（部分版本）

某些内核支持：

mount -t overlay overlay -o lowerdir=...,upperdir=...,workdir=...,verbose /mnt

三、常见调试手段

1. 检查挂载参数

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

确认：

• upper/work 是否同文件系统
• lowerdir 是否存在
• 权限是否正确

2. 文件“消失 / 不更新”问题

Overlay 行为：

• upper 有文件 → 用 upper
• upper 有 whiteout（字符设备 0,0）→ 文件被删除
• lower 修改不会反映到 merged（除非没 copy-up）

调试：

ls -l /upper
# 查看 whiteout
find /upper -type c

3. Copy-up 问题

第一次写文件会触发 copy-up：

strace -e trace=file touch /merged/test

常见问题：

• upper 磁盘满
• upper 不支持某些属性（ACL、xattr）

4. xattr / SELinux 问题

Overlay 依赖 xattr：

getfattr -d /upper/file

关闭 xattr（不推荐）：

-o userxattr

SELinux：

dmesg | grep avc
setenforce 0  # 临时验证

5. Docker / Kubernetes 场景

Docker 使用 overlay2：

docker info | grep Storage

调试容器层：

ls /var/lib/docker/overlay2
cat /var/lib/docker/overlay2/*/lower

容器层未更新：

• 宿主机改 lower 无效（设计如此）
• 需重建容器

四、实用工具

1. overlayfs-tools（社区工具）

可分析 overlay 层关系：

git clone https://github.com/iawia002/overlayfs-tools

2. findmnt

findmnt -t overlay

3. strace

strace -f -e trace=file mount -t overlay ...

五、常见错误速查表

六、内核配置检查

zcat /proc/config.gz | grep OVERLAY

需要：

CONFIG_OVERLAY_FS=y
CONFIG_OVERLAY_FS_REDIRECT_DIR=y

如果你有具体场景（Docker、容器、自建 rootfs、嵌入式、initramfs），我可以给你更针对性的调试步骤。