Docker 容器健康检查怎么配合 --health-cmd 在运行时动态指定-Docker-PHP中文网

docker 20.10+ 支持运行时通过 --health-cmd 等参数覆盖健康检查，优先级高于 dockerfile 中的 healthcheck；需确保 daemon ≥20.10，命令在容器内可执行且带超时。

docker 容器的健康检查不能在 docker run 时用 --health-cmd 动态覆盖镜像中已定义的健康检查命令——这个参数只在构建镜像（dockerfile）时通过 healthcheck 指令声明，运行时无法直接用 --health-cmd 修改。

运行时真正可用的健康检查控制方式

Docker 不提供 --health-cmd 这样的运行时 flag。但你可以通过以下几种方式灵活实现“动态指定健康检查逻辑”：

在启动容器前重新构建镜像：用 docker build --build-arg HEALTH_CMD="..." -t myapp:custom .，配合 Dockerfile 中的 ARG 和动态 HEALTHCHECK，适合 CI/CD 场景。
使用环境变量 + 通用健康检查脚本：在镜像中预置一个轻量脚本（如 /health.sh），它读取 $HEALTH_CMD 或 $HEALTH_ENDPOINT 等环境变量，再执行对应检测（如 curl -f http://localhost:$PORT/health）。启动时只需：
docker run -e HEALTH_ENDPOINT=/readyz -e PORT=8080 myapp
覆盖默认 HEALTHCHECK（仅限 docker run 创建新容器时）：Docker 20.10+ 支持 --health-cmd、--health-interval 等运行时健康配置（⚠️注意：这不是 flag 名字叫 --health-cmd，而是 --health-cmd 确实存在且可用！）——这是关键纠正：Docker 20.10 起已支持运行时覆盖健康检查。

✅ Docker 20.10+ 正确的运行时覆盖写法

从 Docker v20.10 开始，docker run 确实支持以下健康检查相关参数（官方文档已明确列出）：

--health-cmd="CMD"：指定要执行的健康检查命令（如 --health-cmd="curl -f http://localhost:3000/health || exit 1"）
--health-interval=30s：检查间隔
--health-timeout=3s：单次检查超时
--health-retries=3：失败重试次数
--health-start-period=15s：启动后等待多久开始检查

示例：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

docker run -d \
  --name myweb \
  --health-cmd="wget --quiet --tries=1 --spider http://localhost:80/health || exit 1" \
  --health-interval=10s \
  --health-timeout=3s \
  --health-retries=2 \
  --health-start-period=30s \
  nginx:alpine

这样就完全绕过了镜像中定义的 HEALTHCHECK，以运行时参数为准。

验证与调试技巧

运行后用以下命令确认健康检查是否生效：

docker inspect myweb --format='{{.State.Health}}' 查看当前健康状态和历史
docker events --filter 'event=health_status' --filter 'container=myweb' 实时监听健康事件
若命令失败，Docker 会记录 stderr 输出（可通过 docker inspect 的 Health.Log 字段查看最近几次执行详情）