tgbyte/autoheal

镜像概述

该镜像为willfarrell/docker-autoheal的分支版本，继承了原镜像自动监控并恢复容器健康状态的核心能力，同时新增对已停止的不健康容器的修复功能。通过定期检查容器健康状态，可自动重启运行中不健康容器及恢复因健康问题停止的容器，有效提升容器化应用的可用性。

主要用途

• 自动监控Docker容器健康状态
• 重启运行中健康检查失败的容器
• 恢复因健康问题停止运行的容器
• 适用于无人值守的容器化环境维护

核心功能与特性

基础功能

• 原生健康检查集成：基于Docker原生健康检查机制（HEALTHCHECK）工作
• 定期状态检测：可配置检查间隔，默认每30秒扫描一次容器状态
• 智能重启策略：仅针对健康状态为"unhealthy"的容器执行重启操作
• 标签化管理：支持通过容器标签（如autoheal=true）精确控制监控范围

新增特性

• 已停止容器恢复：能够识别并重启之前因健康检查失败而停止的容器，弥补原镜像仅处理运行中容器的局限
• 配置兼容性：与原docker-autoheal配置完全兼容，无需修改现有部署流程即可启用新增功能
• 低资源占用：保持轻量级设计，内存占用<10MB，CPU使用率可忽略

使用场景与适用范围

适用场景

• 生产环境服务：需要高可用性的Web服务、API节点、数据库从库等
• CI/CD持续集成：长期运行的测试环境容器，减少人工干预
• 边缘计算节点：远程部署的无人值守容器设备
• 依赖外部服务的容器：易因网络波动、依赖服务不可用导致健康检查失败的应用（如缓存客户端、消息队列消费者）

限制条件

• 目标容器必须配置有效的HEALTHCHECK（通过Dockerfile或运行参数定义）
• Docker引擎版本需≥1.12（支持健康检查功能）
• 不建议用于对重启敏感的有状态服务（需结合业务特性评估）

使用方法与配置说明

前置要求

• 宿主机Docker服务正常运行
• 挂载Docker守护进程socket（/var/run/docker.sock）到容器内部
• 目标容器已配置健康检查参数（--health-cmd/--health-interval等）

基础部署（Docker Run）

bash
docker run -d \
  --name autoheal \
  --restart always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -e AUTOHEAL_INTERVAL=30 \          # 健康检查间隔（秒），默认30
  -e AUTOHEAL_START_PERIOD=0 \       # 容器启动后延迟检查时间（秒），默认0
  -e AUTOHEAL_LABEL=autoheal \       # 监控标签（容器需添加对应标签），默认"autoheal"
  -e AUTOHEAL_RESTORE_STOPPED=true \ # 启用已停止不健康容器修复，默认true
  your-registry/autoheal-fork:latest  # 替换为实际镜像地址

Docker Compose配置示例

yaml
version: '3.8'
services:
  autoheal:
    image: your-registry/autoheal-fork:latest
    container_name: autoheal
    restart: always
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro  # 建议使用只读模式增强安全性
    environment:
      - AUTOHEAL_INTERVAL=60          # 每60秒检查一次
      - AUTOHEAL_START_PERIOD=30      # 容器启动30秒后开始检查
      - AUTOHEAL_LABEL=false          # 设为false监控所有带健康检查的容器
      - AUTOHEAL_RESTORE_STOPPED=true # 启用停止容器恢复功能
    labels:
      - "autoheal=false"              # 排除自身被监控

配置参数详解

环境变量配置

容器标签控制

通过在目标容器添加标签精确控制监控行为：

• autoheal=true: 强制纳入监控（优先级高于环境变量配置）
• autoheal=false: 强制排除监控（即使全局配置为监控所有容器）

示例：启动一个带健康检查和监控标签的应用容器

bash
docker run -d \
  --name api-service \
  --health-cmd "wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1" \
  --health-interval 15s \
  --health-timeout 5s \
  --health-retries 3 \
  --label autoheal=true \  # 标记为需要监控
  api-service:latest