fail2ban自动上报

技能简介

fail2ban-reporter 连接 fail2ban 与 AbuseIPDB，在检测到恶意 IP 被封禁时自动完成上报，并支持 Telegram 即时通知。

能做什么

• 监听 fail2ban 新封禁事件，实时上报 AbuseIPDB
• 批量上报当前所有已封禁 IP
• 查询指定 IP 的封禁状态与历史记录
• 生成封禁统计报表
• 发送 Telegram 告警通知

使用说明

前置准备

1. 注册 AbuseIPDB 账号并获取免费 API Key：https://www.abuseipdb.com/account/api
2. 存储 API Key：pass insert abuseipdb/api-key

安装自动上报

bash {baseDir}/scripts/install.sh

该脚本会配置 fail2ban action，实现新封禁自动触发上报。

手动操作

• 上报全部已封禁 IP：bash {baseDir}/scripts/report-banned.sh
• 查询指定 IP：bash {baseDir}/scripts/check-ip.sh <ip>
• 查看统计：bash {baseDir}/scripts/stats.sh

卸载

bash {baseDir}/scripts/uninstall.sh

输入与输出

见下方输入与输出表格。

风险提示

• 需妥善保管 AbuseIPDB API Key，避免泄露导致配额被盗用
• 自动上报前建议先手动测试，确认分类标签正确
• Telegram 通知需额外配置 bot token 与 chat ID
• 频繁上报可能触及 AbuseIPDB 速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jestersimpps/fail2ban-reporter/SKILL.md
来源类型：GitHub 仓库