remogloor/autoheal

Docker Autoheal镜像说明

镜像概述

Docker Autoheal镜像用于监控并自动重启标记为不健康的Docker容器。此功能曾计划随HEALTHCHECK特性加入Docker原生支持，但未被采纳，因此该镜像可作为替代方案，直到原生支持--exit-on-unhealthy功能（相关PR：https://github.com/docker/docker/pull/22719%EF%BC%89%E3%80%82

核心功能

1. 监控容器健康状态，自动重启不健康的容器
2. 支持通过UNIX socket或TCP socket（含mTLS）连接Docker API
3. 可通过环境变量或容器标签配置监控范围（指定标签容器或所有容器）
4. 支持自定义检查间隔、启动等待时间、容器停止超时等参数
5. 可映射本地时区文件以同步容器时区

使用场景

• 生产环境中保障服务容器的持续运行，自动恢复故障容器
• 测试环境中快速验证容器健康检查机制的有效性
• 需要自动维护容器可用性的各类Docker部署场景

配置说明

环境变量默认值

AUTOHEAL_CONTAINER_LABEL=autoheal  # 默认监控带autoheal=true标签的容器
AUTOHEAL_INTERVAL=5                # 每5秒检查一次容器健康状态
AUTOHEAL_START_PERIOD=0            # 启动后立即开始首次健康检查
AUTOHEAL_DEFAULT_STOP_TIMEOUT=10   # 容器重启时默认等待10秒停止（可通过标签覆盖）
DOCKER_SOCK=/var/run/docker.sock   # 默认使用UNIX socket连接Docker API
CURL_TIMEOUT=30                    # Docker API请求的超时时间为30秒

可选容器标签

• autoheal.stop.timeout=20：为特定容器设置重启时的停止超时时间（替代默认值）

部署示例

UNIX Socket方式部署

bash
docker run -d \
    --name autoheal \
    --restart=always \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -v /var/run/docker.sock:/var/run/docker.sock \
    docker.xuanyuan.run/remogloor/autoheal

TCP Socket方式部署（需配置mTLS）

bash
docker run -d \
    --name autoheal \
    --restart=always \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -e DOCKER_SOCK=tcp://HOST:PORT \
    -v /path/to/certs/:/certs/:ro \
    docker.xuanyuan.run/remogloor/autoheal

（注：证书文件需命名为ca.pem、client-cert.pem、client-key.pem并放置在指定目录）

同步本地时区

bash
docker run -d \
    --name autoheal \
    --restart=always \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -v /var/run/docker.sock:/var/run/docker.sock \
    -v /etc/localtime:/etc/localtime:ro \
    remogloor/autoheal