Docker中Nginx健康检查需验证HTTP响应而非仅进程存在，推荐用curl -f探测/health端点，配置interval=30s、timeout=3s、start_period=40s、retries=3，并结合restart策略或Prometheus实现自愈。
直接在 Docker 部署 Nginx 时加入健康检查探针，就能实时判断容器内服务是否真正可用，而不仅是进程在运行。关键不是只看 Nginx 进程是否存在，而是它能否响应 HTTP 请求——这才是业务层面的“存活”。
在 Dockerfile 中定义 HEALTHCHECK
构建自定义镜像时，用 HEALTHCHECK 指令嵌入探测逻辑。推荐使用 curl -f 检查根路径或专用健康端点：
-
--interval=30s：每 30 秒检查一次，太频繁会增加负载，太长则故障发现滞后 -
--timeout=3s：单次请求超过 3 秒无响应即判失败，避免卡住检查周期 -
--start-period=40s：Nginx 启动需加载配置、绑定端口，给足 40 秒缓冲期，防止刚启动就误标为 unhealthy -
--retries=3：连续 3 次失败才标记为不健康，容忍短暂抖动 -
CMD curl -f http://localhost/ || exit 1：用-f让 curl 在非 200 响应时自动返回非零退出码，符合 Docker 健康判定规则
使用 docker-compose.yml 统一管理（更推荐）
无需重新构建镜像，直接在编排文件中声明健康检查，适合快速验证和生产部署：
services:
nginx:
image: nginx:alpine
ports:
- "8080:80"
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost/"]
interval: 30s
timeout: 3s
start_period: 40s
retries: 3
启动后执行 docker compose ps，状态列会显示 healthy 或 unhealthy；也可用 docker inspect <container> | grep -A 5 Health 查看详细结果。
确保 Nginx 实际可响应（避免假阳性）
默认 Nginx 的 / 路径返回 200，但若你修改了 root 或加了访问控制，可能返回 403 或超时。建议：
- 保留默认欢迎页，或添加一个显式健康接口，比如在配置中加入 location：
location /health {
return 200 'OK';
add_header Content-Type text/plain;
}
然后把健康检查命令改为 curl -f http://localhost/health，语义更清晰，也避免页面内容变更导致误判。
配合 restart 策略实现基础自愈
Docker 本身不会因 health status 变为 unhealthy 而自动重启容器，但可以组合使用：
- 设置
restart: on-failure或unless-stopped，保证进程崩溃后重启 - 再配合外部脚本定期检查
docker inspect --format='{{.State.Health.Status}}'，若持续 unhealthy 就执行docker restart - 进阶方案：接入 Prometheus + Alertmanager，当
docker_container_health_status{status="unhealthy"} == 1持续 2 分钟，触发 webhook 自动恢复
