用途:在远程主机的 SWAG(Secure Web Application Gateway)反向代理容器内管理 fail2ban 入侵防御,用于封禁恶意 IP、监控攻击与排查封禁失效问题。所有操作均在 SWAG 容器内部执行,不应在宿主机上直接运行 fail2ban 命令。
主要能力:查看 fail2ban 整体状态、列出与查看 jail;查询当前被封禁的 IP、手动封禁或解封 IP、按 IP 搜索日志;创建自定义 jail 与过滤器、测试过滤器正则;重载配置、查看 fail2ban 与 nginx 日志、查看 iptables 规则;备份与恢复配置。
常用配置变量:SWAG_HOST、SWAG_CONTAINER_NAME、SWAG_APPDATA_PATH。脚本需先赋予可执行权限:chmod +x scripts/fail2ban-swag.sh。常用命令如:./scripts/fail2ban-swag.sh status、list-jails、jail-status nginx-http-auth、banned-ips nginx-http-auth、ban 192.168.1.100 nginx-http-auth、unban、reload、test-filter、logs --follow、iptables、search-ip;加 --json 可输出机器可读结果。创建 jail 示例:./scripts/fail2ban-swag.sh create-jail custom-jail --filter custom-filter --logpath "/config/log/nginx/access.log" --maxretry 5 --findtime 600 --bantime 3600;创建过滤器示例:./scripts/fail2ban-swag.sh create-filter custom-filter --regex '^<HOST>."(GET|POST)." (403) .*$'。
适用场景:SWAG 容器内 nginx 的 HTTP Basic Auth 暴力破解、凭据喷洒、漏洞扫描、恶意爬虫与访问规则违规等防护,以及日常安全运维与故障排查。
限制:依赖 SWAG 容器具备 NET_ADMIN 能力并使用 DOCKER-USER 链;不防护应用层攻击(SQL 注入、XSS)、DDoS 与零日漏洞。具体收费标准与价格暂未提供。