1. 拉取最新镜像#

首先，你需要从镜像仓库（如 Docker Hub）获取最新版本的镜像。这一步不会影响当前正在运行的服务。

1
docker compose --env-file .env pull

2. 重新启动服务#

运行 up -d 命令。Docker Compose 会自动检测镜像是否发生变化：

• 如果镜像有更新，它会停止旧容器并启动新容器。
• 如果镜像没有变化，它会保持现状。

1
docker compose --env-file .env up -d

3. 清理旧镜像（可选）#

升级完成后，旧的镜像会变成“悬空”状态（无标签），占用磁盘空间。你可以通过以下命令清理：

1
docker image prune -f

💡 核心注意事项#

• 数据持久化：

  确保你的数据存储在 volumes 中，而不是容器内部。只要挂载了宿主机目录或命名卷，升级容器不会导致数据丢失。

• 版本标签 (Tags)：

  • 如果你在 yaml 文件中使用的是 :latest 标签，直接执行上述步骤即可。
  • 如果你使用的是固定版本号（如 :1.2.1），你需要先修改 docker-compose.yml 或 .env 文件中的版本号，再执行 up -d。

• 配置生效：

  由于你指定了 --env-file .env，如果你在升级前修改了 .env 文件中的环境变量，执行 up -d 时 Docker Compose 也会检测到配置变更并自动重启受影响的容器。