守护进程升级不直接破坏镜像或数据卷，但跨大版本（如20.x→26.x）可能因存储驱动兼容性、元数据格式变更等导致启动失败或数据不可见；平滑迁移需升级前锁定状态、升级中保持数据目录不变、升级后验证一致性。
守护进程升级本身不直接破坏镜像或数据卷，但若版本跨度过大（如从 20.x 升级到 26.x），可能因存储驱动兼容性、元数据格式变更或默认配置调整引发启动失败或数据不可见。平滑迁移的关键是：**升级前锁定状态、升级中保持数据目录不变、升级后验证一致性**。
确认升级是否影响存储结构
新版 Docker 守护进程通常向后兼容旧版 /var/lib/docker 目录结构，但需提前验证：
- 查阅官方发布说明（如 Docker Engine Release Notes），重点关注 “Storage driver compatibility” 和 “Breaking changes in dockerd” 条目
- 运行
docker info | grep -E "(Storage Driver|Docker Root Dir)"，确认当前使用overlay2（主流且兼容性好），且Docker Root Dir路径未被手动修改 - 避免跨大版本跳跃（例如跳过 24.x 直接升 26.x），建议按主版本逐级升级（23 → 24 → 25 → 26）
升级前必须做的三件事
不备份、不检查、不停服务就升级，风险极高：
-
停止所有容器：执行
docker stop $(docker ps -q)，防止升级过程中文件句柄异常或写入中断 -
完整备份数据目录：用
rsync -aHAX /var/lib/docker/ /backup/docker-$(date +%F)/备份（保留硬链接、ACL、扩展属性） -
记录关键信息：保存
docker images -a --format "{{.Repository}}:{{.Tag}} {{.ID}}"和docker volume ls输出，便于升级后比对是否丢失
升级后验证与修复要点
升级完成启动守护进程后，不是看到 active (running) 就算成功：
- 检查镜像是否全部可见：
docker images输出行数应与升级前一致；若缺失，可能是元数据损坏，可尝试docker system prune -a --volumes前先运行docker builder prune清理构建缓存干扰项 - 验证命名卷可挂载：
docker run --rm -v mydata:/test alpine ls /test，能列出内容即正常；若报volume not found，说明卷注册表未加载，需重启 dockerd 或检查/var/lib/docker/volumes/下对应目录是否存在 - 测试容器启动逻辑：
docker run --rm hello-world成功仅表示基础功能正常，还需用原业务镜像启动一个临时容器，验证端口映射、环境变量、挂载路径是否生效
特殊情况处理：升级后镜像/卷“消失”了
这通常不是数据丢失，而是守护进程未识别旧元数据：
- 先确认
/var/lib/docker内容完好（ls -l /var/lib/docker/{images,volumes,overlay2}非空） - 尝试重启守护进程两次：
systemctl restart docker && sleep 3 && systemctl restart docker，部分版本首次启动会延迟加载卷索引 - 仍无效时，可临时降级回旧版 dockerd，用
docker save导出关键镜像，再在新版本中docker load导入（数据卷仍需单独导出）
