Fail2ban识别Nginx自定义路径暴力请求需三步:一是在Nginx中为敏感路径(如/auth/signin)配置可匹配的日志格式,确保记录$request_uri和$status;二是手写filter.d规则,用failregex精准匹配POST/GET目标路径及400/401/403/429状态码,并锚定行首行尾;三是通过fail2ban-regex验证正则有效性,再在jail.local中启用对应jail,设置合理maxretry、findtime、ignoreip与logpath,反向代理场景必须透传并记录X-Real-IP。

Fail2ban怎么识别Nginx自定义路径的暴力请求
Fail2ban本身不直接“知道”你把登录接口放在 /admin/login 或 /api/v1/auth,它只认日志里出现的固定模式。关键在于让Nginx把这类请求明确记进独立日志,或在通用访问日志中留下可匹配的特征(比如特定URL、HTTP状态码、User-Agent异常)。否则默认的nginx-http-auth过滤器只会盯401,对绕过基础认证、直击业务接口的爆破完全无效。
实操建议:
- 在Nginx配置中为敏感路径显式记录日志,例如:
location /admin/ { access_log /var/log/nginx/admin_access.log main; # 其他配置... } - 或者统一用
log_format在常规access日志中加入$request_uri和$status,确保爆破请求(如大量POST /login返回400/403)能被正则捕获 - 避免依赖
$remote_user——多数API爆破根本不走HTTP Basic Auth,这个字段为空,过滤器会直接跳过
写一个能匹配自定义路径爆破的fail2ban过滤器
系统自带的nginx-botsearch或nginx-badbots基本没用:它们匹配的是爬虫UA或高频/wp-login.php这类固定路径,没法适配你的/auth/signin。必须手写filter.d规则,核心是failregex精准命中目标。
示例(保存为/etc/fail2ban/filter.d/nginx-custom-login.conf):
[Definition] failregex = ^<host> -.*"(POST|GET) /auth/signin HTTP/1\.1" (400|401|403|429) .+$ ignoreregex =</host>
注意点:
-
必须出现在行首或紧接IP位置,Nginx日志格式要和正则对齐(比如用了log_format含$remote_addr,就不能假设自动识别) - 状态码选
400/429比只盯401更实用——现代登录接口常用400 Bad Request响应错误凭证,而非标准401 - 加
^和$锚定行首行尾,防止误匹配日志中的URL片段(比如某次正常请求里带/auth/signin参数)
如何验证过滤器是否真能抓到攻击IP
写完正则别急着重启fail2ban,先用fail2ban-regex本地测试,否则上线后发现没效果,攻击已经打穿了。
命令和要点:
- 执行
fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/nginx-custom-login.conf - 如果输出
Lines: 12345 - Matched: 0 - Failed: 12345,说明正则完全没命中——检查Nginx日志实际格式(空格数、引号位置、协议版本),用head -n 5 /var/log/nginx/access.log看真实样例 - 若匹配数正确但
Ignore match过多,可能是ignoreregex写太宽(比如误加了health忽略,结果把/auth/health也放过了) - 测试时加
--print-all-matched参数,直接看到哪些行被成功提取出IP,比数总数更可靠
启用jail并防止误封自己
过滤器通过后,得在jail.local里启用它,并设置合理阈值。暴力破解不是秒级洪水,而是每分钟几十次试探,maxretry = 5配findtime = 600(10分钟)比findtime = 60更稳——避免网络抖动或重试逻辑导致的误封。
关键配置项:
- 指定日志路径:
logpath = /var/log/nginx/access.log(如果用了独立日志,这里要对应改) - 务必加
ignoreip = 127.0.0.1/32 192.168.1.0/24,把内网和运维IP段排除,否则改配置时自己把自己锁在外面 -
bantime设成1h起步,别用-1永久封——临时误操作比真实攻击更常见 - 动作推荐
action = %(action_mwl)s,封IP同时发邮件告警,比静默封禁更容易发现问题
真正麻烦的是Nginx反向代理场景:日志里$remote_addr全是负载均衡IP,永远抓不到真实攻击者。这时候必须让上游透传X-Real-IP,并在fail2ban的logpath里用nginx-proxy类过滤器,或者直接改Nginx日志格式记录$http_x_real_ip——这点漏掉,整个防护就形同虚设。











