whefter/watchtower

whefter/watchtower

弃用通知

上游仓库containrrr/watchtower已实现本分支原有的标签（在 upstream 中称为“scopes”）功能，建议切换到上游版本使用。

 https://goreportcard.com/badge/github.com/whefter/watchtower](https://goreportcard.com/report/github.com/whefter/watchtower)

镜像概述

Watchtower是一款监控Docker容器的工具，当容器的基础镜像更新时，会自动重启容器以使用新镜像。本分支在v2tec/watchtower基础上，支持仅监控带有指定标签的容器，允许多个Watchtower实例以不同间隔运行，管理不同容器组，方便集成到docker-compose文件中管理特定服务。

核心功能

1. 按标签监控：仅监控带有de.whefter.watchtower.tag标签的容器，支持多实例管理不同容器组。
2. 自动更新重启：检测到镜像更新后，自动拉取新镜像、停止旧容器并重启（保留原运行参数）。
3. 清理旧镜像：支持清理更新后的旧镜像，避免磁盘占用。
4. 通知功能：支持通过邮件、Slack、MSTeams发送更新通知。
5. 远程主机监控：可监控远程Docker主机的容器。
6. 链接容器管理：自动处理链接容器的启停顺序，确保依赖关系正确。

使用场景

1. 微服务管理：在微服务架构中，用不同Watchtower实例监控不同服务组，按需求更新。
2. 私有镜像监控：监控私有 registry 中的镜像更新，自动部署新版本。
3. docker-compose集成：将Watchtower实例加入docker-compose文件，管理该文件内的服务。

配置说明

基础运行命令

需挂载Docker socket以访问本地Docker守护进程，指定监控标签：

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1

注意：监控的容器和Watchtower实例本身都需添加de.whefter.watchtower.tag标签。

私有镜像配置

通过环境变量或挂载docker config文件认证私有registry：

bash
docker run -d \
  --name watchtower \
  -v /home/<user>/.docker/config.json:/config.json \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1 --debug

docker-compose示例

监控私有镜像并设置30秒更新间隔：

yaml
version: "3"
services:
  cavo:
    image: index.docker.io/<org>/<image>:<tag>
    labels:
      - "de.whefter.watchtower.tag=cavo"
    ports:
      - "443:3443"
      - "80:3080"
  watchtower:
    image: whefter/watchtower
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /root/.docker/config.json:/config.json
    labels:
      - "de.whefter.watchtower.tag=cavo"
    command: --tag cavo --interval 30

关键参数

• --tag/WATCHTOWER_TAG：指定监控的标签值。
• --interval, -i：轮询间隔（秒），默认300秒。
• --schedule, -s：Cron表达式（6字段），替代interval设置更新时间。
• --cleanup：更新后清理旧镜像。
• --debug：启用调试日志。
• --notifications：指定通知方式（email/slack/msteams）。

通知配置

邮件通知

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=email \
  -e WATCHTOWER_NOTIFICATION_EMAIL_FROM=from@example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_TO=to@example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER=smtp.example.com \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_USER=user \
  -e WATCHTOWER_NOTIFICATION_EMAIL_SERVER_PASSWORD=pass \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1

Slack通知

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=slack \
  -e WATCHTOWER_NOTIFICATION_SLACK_HOOK_URL="https://hooks.slack.com/services/xxx/yyyy" \
  -e WATCHTOWER_NOTIFICATION_SLACK_IDENTIFIER=watchtower-server \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1

MSTeams通知

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e WATCHTOWER_NOTIFICATIONS=msteams \
  -e WATCHTOWER_NOTIFICATION_MSTEAMS_HOOK_URL="https://outlook.office.com/webhook/xxx" \
  -e WATCHTOWER_NOTIFICATION_MSTEAMS_USE_LOG_DATA=true \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1

远程主机监控

指定远程Docker主机地址：

bash
docker run -d \
  --name watchtower \
  -e DOCKER_HOST="tcp://10.0.1.2:2375" \
  --label=de.whefter.watchtower.tag=wordpress1 \
  whefter/watchtower --tag wordpress1

自动更新自身

若Watchtower实例挂载了本地Docker socket且带有监控标签，则可自动更新自身。

bash
docker run -d \
  --name watchtower \
  -v /var/run/docker.sock:/var/run/docker.sock \
  --label=de.whefter.watchtower.tag=watchtower \
  whefter/watchtower --tag watchtower