必须显式启用 metacopy=on 和 redirect_dir=on，且 d_type=true 是硬性前提；否则 copy_up 和目录重命名退化为全量拷贝，I/O 延迟翻倍。需通过 findmnt 或文件系统工具确认 dtype 启用，并在 daemon.json 中配置 overlay2.mountopt=nodev,metacopy=on,redirect_dir=on 等关键参数。
overlay2 默认配置在高密度小文件场景下会迅速暴露元数据瓶颈，必须显式启用 metacopy=on 和 redirect_dir=on，否则 copy_up 和目录重命名将退化为全量拷贝，I/O 延迟翻倍是常态。
确认 d_type 是否启用 —— overlay2 性能的硬性门槛
overlay2 在 ext4/xfs 上必须启用 d_type=true，否则无法使用 metacopy 和 redirect_dir，底层会 fallback 到低效的 redirect-on-write 模式。
- 检查命令：
findmnt -t overlay输出中必须含dtype；或运行xfs_info /var/lib/docker | grep ftype（xfs）或tune2fs -l /dev/sda1 | grep "Filesystem features" | grep filetype（ext4） - ext4 未启用时，需在
/etc/fstab对应挂载项加dtype，再执行sudo mount -o remount,dtype /var/lib/docker - xfs 未启用时，需格式化时指定
-m reflink=1,finobt=1,ftype=1；线上环境不可直接重格式化，只能重建节点
配置 daemon.json 启用核心优化参数
仅声明 storage-driver: "overlay2" 远远不够，关键行为由 storage-opts 控制，缺一不可：
-
overlay2.override_kernel_check=true：跳过内核版本强校验（仅限 kernel ≥ 4.0 且已加载overlay模块的环境） -
overlay2.mountopt=nodev,metacopy=on,redirect_dir=on：三者必须共存——nodev防止设备文件误创建，metacopy=on加速只读层文件首次写入（跳过数据块复制），redirect_dir=on将mv dir/转为原子重定向（避免递归 copy） - 注意：
redirect_dir=on要求内核 ≥ 5.11；metacopy=on要求内核 ≥ 4.19 且d_type=true
规避深层镜像叠加与 upperdir 膨胀陷阱
即使参数全开，不当使用仍会抵消优化效果：
- 构建阶段避免超过 10 层镜像：每层增加 open() 路径查找开销，小文件 stat 频次激增直接打满 dentry 缓存
- 禁止在容器内高频 touch/cp 小文件到挂载点外路径（如
/tmp未设 tmpfs），这些文件会落入upperdir，持续消耗 inode - 对 CI/CD 构建容器，强制加
--storage-opt overlay2.size=10G限制单容器upperdir容量，防止单个构建耗尽宿主机 inode - 监控命令：
df -i /var/lib/docker看 inode 使用率，du -sh /var/lib/docker/overlay2/*/diff | sort -hr | head -5快速定位膨胀的 upperdir
真正卡住性能的从来不是磁盘带宽，而是 inode 分配锁、dentry 查找和 copy_up 的串行阻塞。所有参数都只是杠杆，支点永远是 d_type 是否真实生效 —— 没有它，metacopy 和 redirect_dir 根本不会加载，docker info 里也看不到对应 mountopt。
