Debian Overlay故障排查

Debian OverlayFS 故障排查清单

一 快速定位流程

• 查看内核与挂载：确认内核支持并识别挂载点
  命令：uname -r；mount | grep overlay；必要时用 lsmod | grep overlay 检查模块。
• 核对挂载参数：确保 lowerdir、upperdir、workdir 路径正确且可访问；workdir 必须是空目录。
• 检查文件系统健康：对底层分区执行 fsck（卸载后执行），排除底层错误引发的异常。
• 资源与权限：用 df -h 检查可用空间；用 ls -ld 检查关键目录权限与属主。
• 日志与内核消息：用 journalctl -xe、tail -f /var/log/syslog 查找与 overlay 相关的报错线索。
• 变更后验证：修正参数或资源问题后执行 mount -o remount 或重启相关服务，确认问题是否消除。

二 常见症状与修复要点

三 手动挂载与最小复现

• 准备目录：
  命令：mkdir -p /mnt/lower /mnt/upper /mnt/work /mnt/overlay
• 只读下挂载示例：
  命令：mount -t overlay overlay -o lowerdir=/mnt/lower /mnt/overlay
• 读写挂载示例：
  命令：mount -t overlay overlay -o lowerdir=/mnt/lower,upperdir=/mnt/upper,workdir=/mnt/work /mnt/overlay
• 验证：
  命令：mount | grep overlay；df -h /mnt/overlay；在挂载点创建/删除文件测试。

四 持久化与自动化检查

• 在 /etc/fstab 中持久化（示例为只读层）：
  示例：/mnt/lower /mnt/overlay overlay lowerdir=/mnt/lower 0 0
  提示：读写场景需同时提供 upperdir 与 workdir；变更后用 mount -o remount 验证。
• 开机自检清单：
  1）内核与模块：uname -r、lsmod | grep overlay；
  2）挂载状态：mount | grep overlay；
  3）资源：df -h、目录权限；
  4）日志：journalctl -xe | grep -i overlay、tail -n50 /var/log/syslog。

五 数据安全与恢复建议

• 变更前先备份关键数据与配置；对疑似异常的分区先做只读检查再修复。
• 执行 fsck 前务必卸载分区，避免数据损坏扩大。
• 若 workdir 或 upperdir 所在磁盘空间紧张，优先清理无用文件或扩容后再恢复服务。
• 复杂问题（如文件系统级损坏、启动失败）建议记录完整日志与错误信息，再寻求专业支持。