bohemtucsok/blacklist_monitor

镜像概述和主要用途

本Docker镜像用于通过cron任务定期监控IP地址和邮件域名是否被列入黑名单，并通过集成的通知服务（基于Apprise）发送提醒。主要用途是帮助用户及时发现IP或域名的黑名单状态，避免因被列入黑名单影响服务可用性（如邮件投递、服务器访问等）。

核心功能和特性

• 定时监控：通过cron任务定期执行黑名单检查，支持自定义检查时间（配置于scheduler.txt）
• 多目标监控：同时监控IP地址和邮件域名的黑名单状态
• 灵活通知：集成Apprise支持多种通知渠道（如邮件、短信、即时通讯工具等），用户可按需配置
• 日志记录：任务执行日志自动保存至log文件，便于查看历史检查结果
• 简单配置：所有配置文件集中于挂载目录，支持用户自定义修改

使用场景和适用范围

• 服务器管理员：监控服务器公网IP是否被列入黑名单，确保服务可访问
• 邮件服务运维人员：监控邮件服务器域名/IP是否被反垃圾邮件黑名单收录，保障邮件投递成功率
• 个人站长/企业IT人员：实时掌握网站域名或服务器IP的黑名单状态，及时处理异常

使用方法和配置说明

基本部署命令

bash
docker run --name Blacklist -v /your_patch/:/opt -e TZ=Europe/Budapest docker.xuanyuan.run/bohemtucsok/blacklist_monitor

参数说明：

• --name Blacklist：指定容器名称为Blacklist
• -v /your_patch/:/opt：将本地目录/your_patch挂载至容器内/opt目录，用于存放配置文件、脚本和日志
• -e TZ=Europe/Budapest：设置容器时区（示例为布达佩斯时区，用户需根据实际情况修改，如Asia/Shanghai）
• bohemtucsok/blacklist_monitor：镜像名称

配置文件说明

容器挂载的/your_patch目录（即容器内/opt目录）包含以下关键文件/目录：

• cron：目录，存放cron任务脚本
  • cron.sh：核心执行脚本，需在此配置通知方式（详见“通知配置”部分）
• log：文件，记录cron任务执行日志，包含检查结果和通知状态
• scheduler.txt：文件，定义cron任务执行时间，格式遵循标准cron时间规则（如0 */6 * * *表示每6小时执行一次）

通知配置

1. 访问Apprise支持的通知渠道列表：https://github.com/caronc/apprise/wiki
2. 选择所需通知方式（如邮件、***、Slack等），获取对应的配置格式（如邮件为mailto://user:pass@domain）
3. 编辑/your_patch/cron/cron.sh文件，将获取的通知配置插入脚本中，实现通知功能

致谢

本镜像基于以下项目/工具开发，特此致谢：

• blacklist-check-unix-linux-utility：https://github.com/adionditsak/blacklist-check-unix-linux-utility（黑名单检查工具）
• Gotify：[***]（开源通知服务器）
• Apprise：https://github.com/caronc/apprise（多渠道通知库）

支持信息

如需技术支持，请联系：***

请我喝杯咖啡