容器升级前，先做好回滚计划

升级不是只执行 pull

新镜像可能修改配置项、数据库结构或权限要求。对持续运行的家庭服务而言，升级成功的标准不是容器能启动，而是原有数据完整、主要功能正常、出现问题能够回到上一个可用状态。

升级前的四项记录

先记下当前镜像标签或摘要、Compose 文件、环境变量来源以及数据所在的目录和卷。查看项目发布说明，特别关注破坏性变更和数据库迁移。备份完成后，最好在另一个目录或测试环境验证能恢复。

docker compose config
docker compose ps
docker compose images
docker compose pull
docker compose up -d

这些命令只是常见的更新流程，并不会自动备份数据，也不会为你处理不可逆的数据库迁移。

如何回滚

保留旧版配置和明确的旧镜像标签。新版本出问题时，先停止业务写入，再评估数据格式是否兼容旧版本；如果已经发生数据库迁移，可能需要把备份与旧版程序一起恢复。不要直接把旧镜像盖回去就假设数据结构也随之回退。

建议的节奏

对不影响安全的普通功能更新，可以安排固定的维护窗口；对安全修复应提高优先级，但仍需备份和验证。把每次升级写成简短变更记录，下次故障时能少走很多弯路。