equivalent/health_check_nginx

Health Check Nginx Docker镜像

镜像概述和主要用途

Health Check Nginx是一个运行Nginx的轻量级Docker镜像，专为提供简单可靠的健康检查端点设计。该镜像通过预配置的Nginx规则，对特定路径返回固定HTTP状态码，可直接用于验证容器或服务的运行状态。

核心功能和特性

• 路径响应规则：
  • 根路径(/)：返回404 Not Found
  • 健康检查路径：/health-check、/health-check.html、/healthcheck、/healthcheck.html均返回200 OK
• 轻量级：基于官方Nginx基础镜像，配置精简，镜像体积小
• 即开即用：无需额外配置，启动后立即提供健康检查服务

使用场景和适用范围

• 容器编排健康检查：在Kubernetes、Docker Compose等编排工具中，作为容器存活探针(liveness probe)或就绪探针(readiness probe)的端点
• 服务监控验证：供监控系统（如Prometheus、Zabbix）检测服务可用性
• 快速测试环境：在开发或测试环境中，模拟健康检查端点的响应行为

使用方法和配置说明

基本运行命令

通过以下命令启动容器，将容器80端口映射到主机80端口：

bash
docker run -d -p 80:80 equivalent/health-check-nginx

自定义端口映射

如需使用非80端口，可修改端口映射参数（例如映射到主机8080端口）：

bash
docker run -d -p 8080:80 equivalent/health-check-nginx

验证端点响应

容器启动后，可通过curl或浏览器验证各路径响应：

bash
# 验证根路径（404）
curl -I http://localhost/
# 预期响应：HTTP/1.1 404 Not Found

# 验证健康检查路径（200）
curl -I http://localhost/health-check
# 预期响应：HTTP/1.1 200 OK

curl -I http://localhost/healthcheck.html
# 预期响应：HTTP/1.1 200 OK

源代码与文档

完整源代码、配置细节及更新日志请访问GitHub仓库：
https://github.com/equivalent/health_check_nginx_docker