如何在不搭建复杂 CI/CD 流水线的情况下自动化 Docker 容器更新

如果你在家用服务器、NAS 或者小型 VPS 上运行一些个人项目，你可能已经习惯了这种更新流程：某个服务发布了新版本，你就得再次打开终端，执行一系列操作——拉取镜像、停止旧容器、回忆各种端口映射、卷挂载和环境变量，然后再重新启动所有服务。

当你有十几个容器时，手动更新会耗费大量时间。Watchtower 项目可以帮你一劳永逸地解决这个问题。

Watchtower 的工作原理

Watchtower 是一个小型容器，用于监控宿主机上其他正在运行的服务。它会定期检查 Docker Hub 或你的私有镜像仓库，查找新的标签并自动更新应用程序。

其工作原理非常简单：

1. Watchtower 检测到镜像仓库中发布了新版本的镜像。
2. 它将新镜像下载到服务器。
3. 它会优雅地停止当前容器。
4. 它使用与旧容器完全相同的参数和配置启动新容器。

所有设置，包括挂载的目录、网络和环境变量，都会自动转移到新实例中。

快速上手

启动该工具只需要一条终端命令：

$ docker run --detach \
    --name watchtower \
    --volume /var/run/docker.sock:/var/run/docker.sock \
    nickfedor/watchtower

关键在于传递 Docker socket /var/run/docker.sock。这是该工具与本机 Docker daemon 通信并管理其他容器的方式。

适用场景与应避免的场景

项目开发者在文档中明确警告：Watchtower 不适用于商业公司的生产环境。

在生产服务器上直接从镜像仓库自动重启容器存在风险。在生产环境中，最好设置完整的 CI/CD 流水线，包含测试和金丝雀发布，或者使用 Kubernetes 配合 FluxCD 等 GitOps 工具。

不过，Watchtower 在以下场景中非常理想：

• 家庭实验室和媒体服务器。
• 本地开发环境。
• 小型项目的预发布或测试环境。

技术细节与架构

该项目使用 Go 语言编写。该工具支持大多数主流 CPU 架构：amd64、i386、armhf、arm64v8，甚至 riscv64。这意味着你可以在普通服务器和 Raspberry Pi 上运行它。

为了与宿主机交互，Watchtower 使用 Docker API 1.43 版或更高版本。默认情况下，该工具会自动与 daemon 协商所需的 API 版本，但如有必要，你也可以通过 DOCKER_API_VERSION 环境变量手动设置版本。

Watchtower 免去了在笔记和脚本中收集手动命令的麻烦。如果你厌倦了手动更新家庭服务或本地开发容器，部署该工具不到一分钟就能完成，每次发布新版本时都能节省时间。