tarampampam/microcheck

Docker容器轻量级健康检查工具

这是一套极简、静态链接的工具，专为Docker容器健康检查设计，基于musl编译以实现最小体积和零依赖。适用于在无内置健康检查机制的容器运行时（如原生Docker）中监控应用状态，尤其适合scratch或distroless等极简镜像环境（传统工具如curl/wget无法在此类环境运行）。

核心功能

• 静态链接：可在极简容器（如scratch、distroless）中运行
• 极速高效：纯C编写，musl编译
• 多架构支持：支持x86_64、ARM等多种架构
• 极小体积：优化镜像大小，工具体积仅几十KB
• TLS支持：httpscheck工具通过mbedTLS实现HTTPS检查（支持自签名证书）
• 协议自动检测：httpscheck自动尝试HTTPS，失败则回退到HTTP
• 灵活配置：支持命令行参数和环境变量
• Docker友好：优雅处理SIGTERM/SIGINT信号

工具列表

工具使用说明

httpcheck & httpscheck

用于HTTP/HTTPS端点检查，httpscheck支持协议自动检测（无协议前缀时先尝试HTTPS）。
示例：

shell
# 检查HTTP端点
httpcheck http://localhost:8080/health

# 自动检测协议（优先HTTPS）
httpscheck localhost:8080/health

portcheck

检查TCP/UDP端口是否开放。
示例：

shell
# 检查本地TCP端口8080
portcheck --port 8080

# 检查远程UDP端口53
portcheck --udp --port 53 --host example.com

parallel

并行执行多个检查命令，全部成功则返回0。
示例：

shell
parallel "httpcheck http://localhost:8080" "portcheck --port 8080"

pidcheck

检查PID文件对应的进程是否运行。
示例：

shell
pidcheck --file /var/run/myapp.pid

Docker镜像使用示例

HTTP服务健康检查

Dockerfile
FROM docker.xuanyuan.run/scratch
COPY --from=containous/whoami:v1.5.0 /whoami /whoami
COPY --from=ghcr.io/tarampampam/microcheck:1 /bin/httpcheck /bin/httpcheck

HEALTHCHECK --interval=5s --retries=2 CMD ["httpcheck", "http://127.0.0.1:8080/health"]
ENTRYPOINT ["/whoami", "-port", "8080"]

多条件并行检查

Dockerfile
FROM docker.xuanyuan.run/scratch
COPY --from=containous/whoami:v1.5.0 /whoami /whoami
COPY --from=ghcr.io/tarampampam/microcheck:1 /bin/httpcheck /bin/portcheck /bin/parallel /bin/

HEALTHCHECK --interval=5s --retries=2 CMD ["parallel", \
    "httpcheck http://127.0.0.1:8080", \
    "portcheck --port 8080" \
]
ENTRYPOINT ["/whoami", "-port", "8080"]

可用镜像源

• GitHub Container Registry: ghcr.io/tarampampam/microcheck
• Red Hat Container Registry: quay.io/tarampampam/microcheck
• Docker Hub: tarampampam/microcheck

建议使用指定版本标签（如1.0.0）而非latest，避免兼容性问题。