Docker Autoheal：智能容器健康监控与自动修复解决方案

Docker Autoheal：智能容器健康监控与自动修复解决方案

【免费下载链接】docker-autoheal Monitor and restart unhealthy docker containers. 项目地址: https://gitcode.com/gh_mirrors/do/docker-autoheal

在 Docker 容器化环境中，保持服务的健康和稳定是至关重要的。Docker Autoheal 是一个开源项目，专门监控并重启不健康的 Docker 容器，确保您的应用程序始终在线，即使在遇到问题时也能快速恢复。

项目介绍

Docker Autoheal 是一个轻量级解决方案，旨在填补 Docker 自身功能的一个空白——至今尚未实现的 --exit-on-unhealthy 标志。通过监控容器的健康状态，并在它们变得不健康时自动重启，Docker Autoheal 提供了对容器健康状况的实时管理。

快速上手指南

基础环境搭建

通过 Docker CLI 快速启动 Autoheal 服务：

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

多种连接方式

UNIX 套接字连接（推荐）：

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

TCP 连接：

docker run -d \
    --name autoheal \
    --restart=always \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -e DOCKER_SOCK=tcp://$HOST:$PORT \
    willfarrell/autoheal

容器标签配置

有三种方式启用容器监控：

• 为容器添加标签 autoheal=true
• 设置环境变量 AUTOHEAL_CONTAINER_LABEL=all 监控所有运行容器
• 设置环境变量 AUTOHEAL_CONTAINER_LABEL 为现有标签名，其值为 true

核心配置参数

环境变量	默认值	描述
AUTOHEAL_CONTAINER_LABEL	autoheal	设置现有标签名，其值为 true
AUTOHEAL_INTERVAL	5	检查间隔（秒）
AUTOHEAL_START_PERIOD	0	首次健康检查前等待时间（秒）
AUTOHEAL_DEFAULT_STOP_TIMEOUT	10	容器停止超时时间（秒）
AUTOHEAL_ONLY_MONITOR_RUNNING	false	是否仅监控运行中的容器
DOCKER_SOCK	/var/run/docker.sock	Docker API 的 Unix 套接字路径
CURL_TIMEOUT	30	curl 请求到 Docker API 的最大超时时间
WEBHOOK_URL	""	容器重启（或重启失败）时发送消息的 webhook URL

应用场景

生产环境保障

在关键业务系统中，任何容器故障都可能导致服务中断。Autoheal 能够即时检测并自动恢复，确保业务连续性。

持续部署防护

自动化部署流程中，新版本可能引入未知问题。Autoheal 作为安全网，在问题出现时快速回滚到稳定状态。

开发测试加速

开发环境中频繁重启不稳定容器，大大提升调试效率，让开发者专注于核心逻辑。

技术特点

智能监控机制

基于 Docker 原生 HEALTHCHECK 功能，Autoheal 实时评估容器健康状况，一旦发现异常立即触发修复流程。

安全连接选项

支持 UNIX 套接字和 TCP 两种连接方式，并可配置 mTLS 加密通信，确保与 Docker 守护进程的安全交互。

灵活标签控制

通过自定义标签精确控制监控范围，只对指定容器启用自动修复功能。

本地测试和构建

docker buildx build -t autoheal .

docker run -d \
    -e AUTOHEAL_CONTAINER_LABEL=all \
    -v /var/run/docker.sock:/var/run/docker.sock \
    autoheal

最佳实践建议

1. 合理设置检查间隔：根据应用特性调整监控频率
2. 配置优雅停止：确保应用有足够时间完成清理工作
3. 选择性监控：只为关键服务启用自动修复
4. 时区配置：如需匹配本地时区，可映射 /etc/localtime

docker run ... -v /etc/localtime:/etc/localtime:ro

Docker Autoheal 是一款强大的工具，能够帮助您构建更加可靠、自动化的 Docker 环境。无论是生产环境还是开发环境，它都能成为您可靠的守护者，确保服务的稳定性。

【免费下载链接】docker-autoheal Monitor and restart unhealthy docker containers. 项目地址: https://gitcode.com/gh_mirrors/do/docker-autoheal