fail2ban 举报工具

监控 fail2ban 封禁记录，并自动向 AbuseIPDB 举报攻击者。

安装设置

1. 在此处获取免费的 AbuseIPDB API 密钥：https://www.abuseipdb.com/account/api
2. 存储密钥：pass insert abuseipdb/api-key
3. 安装监控脚本：bash {baseDir}/scripts/install.sh

手动使用

举报所有当前被封禁的 IP

bash {baseDir}/scripts/report-banned.sh

检查特定 IP

bash {baseDir}/scripts/check-ip.sh <ip>

显示封禁统计信息

bash {baseDir}/scripts/stats.sh

自动举报

安装脚本会设置一个 fail2ban 动作，自动举报新的封禁。

bash {baseDir}/scripts/install.sh    # install auto-reporting
bash {baseDir}/scripts/uninstall.sh  # remove auto-reporting

心跳集成

添加到 HEARTBEAT.md 以定期检查新封禁：

- [ ] Check fail2ban stats and report any unreported IPs to AbuseIPDB

工作流程

1. fail2ban 封禁一个 IP → 触发动作report-single.sh
2. 脚本使用 SSH 暴力破解类别向 AbuseIPDB 举报
3. 发送Telegram通知（如果已配置）
4. 将报告记录至/var/log/abuseipdb-reports.log

API参考

完整API文档请参见references/abuseipdb-api.mdfor full API docs.