在 docker 中设置容器健康检查,需要在 dockerfile 中使用 healthcheck 指令或在 docker run 命令中添加 --health 参数。核心做法是定义一个用于检测服务状态的命令、检查间隔、重试次数以及超时时间,docker 守护进程会定期执行该命令并根据退出码判断容器是否健康。

HEALTHCHECK 指令的具体语法和参数含义是什么
HEALTHCHECK 指令允许开发者在镜像构建阶段直接嵌入健康检查逻辑,其基本语法为 HEALTHCHECK [OPTIONS] CMD command。主要参数包括 --interval(检查间隔)、--timeout(单次检查超时时间)、--retries(连续失败判定不健康的次数)和 --start-period(启动宽限期)。当命令返回退出码 0 时视为健康,非 0 视为不健康,而退出码 1 则保留供用户自定义错误状态。

FROM nginx:latest # 设置健康检查:每30秒检查一次,超时5秒,重试3次,启动宽限期10秒 HEALTHCHECK --interval=30s --timeout=5s --retries=3 --start-period=10s \ CMD curl -f http://localhost/ || exit 1
上述代码构建的镜像在运行时会自动启用健康检查。使用 curl -f 访问本地根路径,如果服务器无响应或返回错误页面,curl 会返回非零退出码,从而触发健康状态变更。这种配置方式将检查逻辑固化在镜像中,便于在不同环境中复用。
如何通过 docker inspect 查看容器的实时健康状态
容器运行后,可以通过 docker inspect 命令获取详细的健康状态信息,重点关注 State.Health 字段。该字段包含 Status(当前状态)、FailingStreak(连续失败次数)和 LastCheck(最近一次检查的时间戳)。这些数据结构帮助运维人员快速定位是服务暂时不可用还是持续故障。
「在我电脑上明明能跑」——因为少了Docker。帮你写Dockerfile、构建镜像、配置多环境、编排docker-compose,从本地开发到服务器部署一条龙。支持Node.js/Python/Go/Java/前端全栈,覆盖CI/CD集成、安全加固、监控告警,告别环境不一致的噩梦。 触发词:Docker部署、容...

# 查看名为 my-nginx 的容器健康状态
$ docker inspect --format='{{json .State.Health}}' my-nginx | jq
执行上述命令并配合 jq 解析,可以得到类似如下的 JSON 输出:{"Status":"healthy","FailingStreak":0,"Log":[...]}。如果状态变为 unhealthy,则说明连续多次检查失败。开发者可以结合 Log 数组中的详细信息,分析最后一次检查失败的原因,例如连接被拒绝或超时。
当容器健康检查失败时,如何自动重启或通知
虽然 Docker 本身不直接提供基于健康状态的自动重启策略,但可以通过编排工具或外部脚本实现。在单机环境下,可以使用 docker-compose.yml 中的 restart 策略配合健康检查,或者编写简单的 Shell 脚本监控 docker inspect 的输出并在状态变为 unhealthy 时执行 docker restart。此外,许多现代部署平台(如 Kubernetes)原生支持基于健康检查的自愈机制。










