jakowenko/watchtower

Watchtower

Watchtower是一款用于监控Docker容器镜像更新的工具，可自动检测Docker Hub上的镜像更新，并根据配置自动更新现有容器，帮助用户降低容器化应用的维护成本。

核心功能

• 实时监控Docker容器对应的镜像在Docker Hub的更新状态
• 支持自动拉取最新镜像并重建容器（保留原有配置）
• 提供HTTP、邮件等多种通知方式，及时推送更新信息
• 通过环境变量和容器标签灵活配置监控规则
• 可选自动清理未使用的镜像和卷，释放系统存储空间

使用场景

• 容器化应用的自动更新维护，减少手动操作
• 多容器环境下的批量镜像更新监控
• 需要及时获取镜像更新通知的场景

配置说明

安装方式

Node.js
npm install @jakowenko/watchtower

Docker
docker pull jakowenko/watchtower

Docker部署示例

Docker Run命令

shell
docker run -d \
  --name=watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  jakowenko/watchtower

Docker Compose配置

yaml
version: '3.7'
services:
  watchtower:
    container_name: watchtower
    image: jakowenko/watchtower
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

环境变量选项

容器标签配置

通过标签对单个容器设置监控规则：

• 启用监控：watchtower.enable=true
• 禁用监控：watchtower.enable=false
• 启动时更新：watchtower.update-on-start=true

示例：

yaml
version: '3.7'
services:
  app:
    image: example/app
    labels:
      - 'watchtower.enable=true'
      - 'watchtower.update-on-start=true'