Поиск
Справочник

fail2ban-regex: как проверить, что фильтр ловит строки журнала

Включили правило fail2ban, а оно никого не блокирует? Или наоборот, хотите заранее знать, кого оно заблокирует? Команда fail2ban-regex прогоняет фильтр по журналу и показывает, сколько строк он нашёл. Она только читает журнал и ничего не блокирует, поэтому её можно запускать на рабочем сервере.

≈ 6 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте фильтр SSH по журналу systemd:
    sudo fail2ban-regex systemd-journal sshd
  3. Дождитесь конца ответа: команда читает весь журнал с начала, на сервере с большим журналом это займёт время.
  4. Найдите в конце строку Lines:, например Lines: 4210 lines, 0 ignored, 37 matched, 4173 missed. 37 matched — фильтр нашёл 37 неудачных попыток входа.

Как устроена команда

sudo fail2ban-regex ЖУРНАЛ ФИЛЬТР
Что подставить вместо ЖУРНАЛПример
файл журнала/var/log/nginx/error.log
журнал systemdsystemd-journal
одну строку в кавычках'2026-11-06 10:00:00 Failed login from 203.0.113.10'
Что подставить вместо ФИЛЬТРПример
имя фильтра из /etc/fail2ban/filter.dsshd, nginx-botsearch, recidive
имя фильтра с режимом, в кавычках'sshd[mode=extra]'
путь к своему файлу фильтра/etc/fail2ban/filter.d/wordpress-login.conf
образец строки в кавычках'Failed login from <HOST>'

<HOST> в образце — место, где в строке записан адрес. Так fail2ban узнаёт, какой адрес блокировать.

Примеры для готовых правил

Что проверитьКоманда
правило SSHsudo fail2ban-regex systemd-journal sshd
правило SSH в режиме extrasudo fail2ban-regex systemd-journal 'sshd[mode=extra]'
боты, которые ищут админкиsudo fail2ban-regex /var/log/nginx/error.log nginx-botsearch
подбор пароля к разделу с auth_basicsudo 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-systemdsudo 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.

Источники

Сверено 6 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше