fail2ban-regex: как проверить, что фильтр ловит строки журнала
Включили правило fail2ban, а оно никого не блокирует? Или наоборот, хотите заранее знать, кого оно заблокирует? Команда fail2ban-regex прогоняет фильтр по журналу и показывает, сколько строк он нашёл. Она только читает журнал и ничего не блокирует, поэтому её можно запускать на рабочем сервере.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте фильтр SSH по журналу systemd:
sudo fail2ban-regex systemd-journal sshd - Дождитесь конца ответа: команда читает весь журнал с начала, на сервере с большим журналом это займёт время.
- Найдите в конце строку
Lines:, напримерLines: 4210 lines, 0 ignored, 37 matched, 4173 missed. 37 matched — фильтр нашёл 37 неудачных попыток входа.
Как устроена команда
sudo fail2ban-regex ЖУРНАЛ ФИЛЬТР| Что подставить вместо ЖУРНАЛ | Пример |
|---|---|
| файл журнала | /var/log/nginx/error.log |
| журнал systemd | systemd-journal |
| одну строку в кавычках | '2026-11-06 10:00:00 Failed login from 203.0.113.10' |
| Что подставить вместо ФИЛЬТР | Пример |
|---|---|
| имя фильтра из /etc/fail2ban/filter.d | sshd, nginx-botsearch, recidive |
| имя фильтра с режимом, в кавычках | 'sshd[mode=extra]' |
| путь к своему файлу фильтра | /etc/fail2ban/filter.d/wordpress-login.conf |
| образец строки в кавычках | 'Failed login from <HOST>' |
<HOST> в образце — место, где в строке записан адрес. Так fail2ban узнаёт, какой адрес блокировать.
Примеры для готовых правил
| Что проверить | Команда |
|---|---|
| правило SSH | sudo fail2ban-regex systemd-journal sshd |
| правило SSH в режиме extra | sudo fail2ban-regex systemd-journal 'sshd[mode=extra]' |
| боты, которые ищут админки | sudo fail2ban-regex /var/log/nginx/error.log nginx-botsearch |
| подбор пароля к разделу с auth_basic | sudo fail2ban-regex /var/log/nginx/error.log nginx-http-auth |
| повторные нарушители | sudo fail2ban-regex /var/log/fail2ban.log recidive |
Для журнала systemd команда сама берёт из фильтра, какие записи читать: у sshd — записи программы sshd. Чем отличаются режимы sshd — правило sshd.
Проверить образец на одной строке, без журнала:
sudo fail2ban-regex '2026-11-06 10:00:00 Failed login from 203.0.113.10' 'Failed login from <HOST>'В строке Lines: должно быть 1 matched. Так удобно проверять свой образец, прежде чем записать его в файл фильтра.
Как читать ответ
Ответ идёт сверху вниз: что команда прочитала, затем раздел Results с итогами.
| Строка ответа | Что значит |
|---|---|
Use log file : /var/log/nginx/error.log | какой файл прочитан |
Use systemd journal | прочитан журнал systemd |
Use journal match : … | какие записи журнала systemd выбраны |
Failregex: 37 total | сколько строк подошло под образцы фильтра. Ниже — по каждому образцу: номер, в квадратных скобках число совпадений и сам образец |
Ignoreregex: 0 total | сколько строк фильтр исключил нарочно |
Date template hits: | при проверке по файлу: в каком формате найдено время в строках. Если под этой строкой пусто, fail2ban не нашёл время в строках файла |
Lines: … matched, … missed | всего строк, сколько исключено, сколько найдено, сколько не подошло |
missed — строки, которые не подошли под фильтр. В журнале их больше всего: успешные входы, служебные записи. Это нормально.
Если пропущенных строк меньше 20, команда покажет их под заголовком Missed line(s):. Если больше — строку Missed line(s): too many to print. Use --print-all-missed to print all … lines.
Как увидеть сами строки и адреса
| Что хотите увидеть | Что добавить к команде |
|---|---|
| все найденные строки | --print-all-matched |
| все пропущенные строки | --print-all-missed |
| ничего не печатать о пропущенных | --print-no-missed |
| адрес и время под каждым образцом | -v |
| только адреса, по одному на совпадение | -o ip |
Какие адреса нашлись больше всего раз:
sudo fail2ban-regex -o ip /var/log/nginx/error.log nginx-botsearch | sort | uniq -c | sort -rn | headСлева — число совпадений, справа — адрес.
Найдено — ещё не значит заблокировано
fail2ban-regex считает все подходящие строки в журнале — за всё время, по всем адресам. Правило блокирует адрес, только если с него пришло maxretry попыток за findtime: по умолчанию 5 за 10 минут. Адреса из белого списка ignoreip правило не блокирует, а fail2ban-regex их считает.
Поэтому 37 matched может означать и 37 попыток одного бота за минуту, и 37 разных адресов по одной попытке. Как это выяснить — команда с -o ip выше. Подробно о порогах — bantime, findtime и maxretry.
Если matched 0, а попытки в журнале есть
| Что проверить | Как |
|---|---|
| тот ли журнал | правила для nginx и recidive читают файлы, sshd — журнал systemd. Для nginx: /var/log/nginx/error.log, а не systemd-journal |
| есть ли нужные строки | sudo grep -c 'wp-login' /var/log/nginx/access.log — посчитать строки со словом напрямую |
| нашлось ли время | при проверке по файлу под строкой Date template hits: есть хотя бы одна строка |
| тот ли режим | строки режимов ddos и extra фильтр sshd находит, только если указать режим: 'sshd[mode=extra]', 'sshd[mode=ddos]' или 'sshd[mode=aggressive]' |
| тот ли формат журнала | если вы меняли формат access.log в nginx, готовые фильтры могут его не понимать |
Если фильтр в fail2ban-regex находит строки, а правило — нет, проверьте, что правило читает тот же журнал: sudo fail2ban-client status ИМЯ_ПРАВИЛА, строка File list или Journal matches. Почему правило для nginx не видит журнал — fail2ban для nginx.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
ERROR: failed to load filter | нет фильтра с таким именем | ls /etc/fail2ban/filter.d/ — проверьте имя |
ERROR: Wrong filter name or options | ошибка в записи режима | пишите в кавычках: 'sshd[mode=extra]' |
Error: systemd library not found. Exiting... | нет модуля python3-systemd | sudo apt install python3-systemd — в Ubuntu 24.04 он ставится вместе с fail2ban |
| команда долго не отвечает | большой журнал systemd | дождитесь ответа или проверяйте по файлу |
| ошибка при чтении файла журнала | команда без sudo, а файл доступен только администратору | добавьте sudo в начало |
Всё сверено с fail2ban 1.0.2 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится fail2ban 1.1.0.
Источники
- Справка fail2ban-regex для Ubuntu 24.04 — на английском: журнал, фильтр, ключи --print-all-matched, --print-all-missed, -v, -o.
- Исходный код fail2ban 1.0.2: fail2banregex.py — строки ответа Results, Failregex, Date template hits, Lines; чтение журнала systemd с начала.
- Фильтр sshd в Ubuntu 24.04 — режимы и journalmatch.
- Файл jail.conf в Ubuntu 24.04 — maxretry 5, findtime 10m.
Сверено 6 ноября 2026 года.
Что почитать дальше
- fail2ban для WordPressсвой фильтр, который проверяют этой командой.
- Правило sshdрежимы проверки SSH.
- Настройки fail2banкакие файлы есть и куда писать свои.