mlefkon/pinger

Pinger - 自动化服务器ping检测与故障邮件通知

镜像仓库：https://hub.docker.com/r/mlefkon/pinger%EF%BC%8C%E6%BA%90%E7%A0%81%E4%BB%93%E5%BA%93%EF%BC%9Ahttps://github.com/mlefkon/pinger

镜像概述

这是一个Docker容器，通过定时任务（cron）运行curl命令检测指定服务器/端点的可用性，当检测失败时通过SMTP中继发送邮件通知，并支持生成定期状态报告和持久化历史数据。

核心功能

1. 定期curl检测目标端点，验证响应内容是否符合预期
2. 检测失败时通过SMTP发送告警邮件
3. 生成定期状态报告（含uptime百分比、平均/中位数响应时间等）
4. 持久化存储检测历史数据（CSV格式）

使用场景

• 监控网站或API服务的可用性
• 跟踪服务响应时间变化
• 及时获取服务故障通知

配置说明（环境变量）

目标服务器

• ENDPOINT_NAME：默认"Pinger"，用于邮件主题和日志文件名，标识当前实例
• PING_URL：必填，需检测的URL（含协议如[] 或 url:[]
• ALLOW_INSECURE：默认0，是否允许无效证书（设1启用）
• IPv6：默认0，是否使用IPv6格式URL（设1启用）
• EXPECTED_RESPONSE：必填，期望从PING_URL返回的文本内容
• INTERVAL_MIN：默认5，检测间隔（分钟）
• RELIABLE_REFERENCE_PING_HOST：必填，故障时连通性测试的主机（仅域名，用ping而非curl）

邮件中继

• RELAY_HOST：必填，SMTP中继主机格式（含端口，如[relay.host.tld]:port）
• RELAY_USERNAME：必填，中继登录用户名
• RELAY_PASSWORD：必填，中继登录密码
• RELAY_SENDER_EMAIL_ADDRESS：必填，允许发送的发件***（通常与用户名相同）
• RELAY_SENDER_INFORMAL_NAME：默认"Pinger"，发件人显示名称

通知设置

• TO_EMAIL_ADDR：必填，告警邮件接收人***
• THRESHOLD_FAILS_FOR_EMAIL：默认1，连续失败多少次后发送告警
• STATUS_EMAIL_DAYS：默认30，定期状态报告间隔（天）

状态报告

每${STATUS_EMAIL_DAYS}天发送报告，包含：

• 起止日期
• 总downtime及故障时间点
• 服务可用百分比
• 响应时间中位数/平均值

历史数据

数据存储在/var/log/pinger/（可挂载卷持久化），CSV文件包括：

• 检测记录（.ping.curr.log）、历史汇总（.summary.history.log）、连续失败次数（.num.fails.log）

部署示例

bash
docker run --name mypinger -d \
-e ENDPOINT_NAME="我的Pinger" \
-e INTERVAL_MIN=3 \
-e THRESHOLD_FAILS_FOR_EMAIL=2 \
-e PING_URL=https://my.url.com/myscript \
-e ALLOW_INSECURE=0 \
-e IPv6=0 \
-e RELIABLE_REFERENCE_PING_HOST=google.com \
-e EXPECTED_RESPONSE="例如：Ping成功" \
-e RELAY_HOST=smtps://smtp.relay.com \
-e RELAY_USERNAME=user \
-e RELAY_PASSWORD=pass \
-e RELAY_SENDER_EMAIL_ADDRESS=useremail@relay.com \
-e RELAY_SENDER_INFORMAL_NAME="Pinger告警" \
-e TO_EMAIL_ADDR=recipient@email.com \
-e STATUS_EMAIL_DAYS=7 \
mlefkon/pinger

IPv6说明

若检测IPv6端点，建议用host网络（主机需支持IPv6）或启用IPv6的Docker bridge网络。curl访问IPv6地址需用方括号包裹，如https://[::1]