pyouroboros/ouroboros

!logo

![]([] ![BuyUsCoffee]([]
![Travis]([] ![Pypi Downloads]([] ![Python Version]([] ![Layers]([***]

自动更新运行中的Docker容器至最新可用镜像，是https://github.com/v2tec/watchtower%E7%9A%84Python%E6%9B%BF%E4%BB%A3%E6%96%B9%E6%A1%88%E3%80%82

概述

Ouroboros会监控（所有或指定的）运行中Docker容器，并将其更新至远程 registry 中的最新或指定标签镜像。更新后的容器保留原容器创建时的参数，如卷/绑定挂载、Docker网络连接、环境变量、重启策略、入口点、命令等。

核心功能

• 推送镜像至registry后，按设定间隔自动检测新镜像并重新部署容器
• 支持邮件或平台定制化Webhook通知（当前支持***/Slack/Pushover/HealthChecks/通用Webhook）
• 提供监控指标（当前支持Prometheus/InfluxDB）
• 减少服务器SSH访问需求

使用场景

• 日常容器维护：自动更新应用容器至最新版本，无需手动执行pull和run命令
• 多主机管理：监控远程Docker主机上的容器更新
• 生产环境自动化：结合通知功能及时了解容器更新状态

配置说明

更多详细用法和配置可参考https://github.com/pyouroboros/ouroboros/wiki%E3%80%82

Docker部署

基础部署

bash
docker run -d --name ouroboros \
  -v /var/run/docker.sock:/var/run/docker.sock \
  pyouroboros/ouroboros

该镜像兼容amd64、arm32和arm64 CPU架构

Docker Compose部署

https://github.com/pyouroboros/ouroboros/blob/master/docker-compose.yml

Pip安装

Ouroboros也可通过pip安装：

bash
pip install ouroboros-cli

安装后可通过ouroboros命令调用：

bash
ouroboros --interval 300 --loglevel debug

此方式适用于创建systemd服务等非容器化的守护进程

示例

监控最新标签更新

若希望Ouroboros将所有容器更新至latest标签（而非原镜像标签），可设置LATEST=true：

bash
docker run -d --name ouroboros \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e LATEST=true \
  pyouroboros/ouroboros

默认值为false

监控远程主机容器

Ouroboros可监控远程Docker主机，通过DOCKER_SOCKETS环境变量指定远程Docker API地址：

bash
docker run -d --name ouroboros \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e DOCKER_SOCKETS=tcp://my-remote-docker-server:2376 \
  pyouroboros/ouroboros

默认值为unix://var/run/docker.sock

更多示例请参考Wiki的https://github.com/pyouroboros/ouroboros/wiki/Usage

贡献

欢迎所有形式的贡献