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

Правило recidive в fail2ban: неделя блокировки для тех, кто возвращается

Бот попал под блокировку SSH, подождал 10 минут и вернулся — и так по кругу. Правило recidive замечает такие адреса по журналу самого fail2ban: пять блокировок за сутки — и адрес закрыт на неделю, сразу на всех портах. Здесь — как его включить, проверить и не попасть под него самому.

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

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

  1. Подключитесь к серверу по SSH (как подключиться). Если fail2ban ещё не установлен — установка fail2ban.
  2. Проверьте, что журнал fail2ban на месте:
    sudo tail -n 5 /var/log/fail2ban.log

    В ответе — строки со временем и словом fail2ban.

  3. Если вы заходите на сервер с неизменного адреса, сначала добавьте его в белый список: recidive закрывает адресу и SSH, и сайт.
  4. Откройте файл: sudo nano /etc/fail2ban/jail.local (как работать в nano) и допишите в конец:
    [recidive]
    enabled = true
    backend = auto
  5. Сохраните: Ctrl+O, Enter, Ctrl+X.
  6. Проверьте и примените:
    sudo fail2ban-client -t
    sudo fail2ban-client reload
  7. Проверьте, что правило работает и читает файл: sudo fail2ban-client status recidive. В строке File list должен быть /var/log/fail2ban.log.

Как работает recidive

Правило читает не журнал SSH, а журнал самого fail2ban — файл /var/log/fail2ban.log. Каждая строка о блокировке в другом правиле, например NOTICE [sshd] Ban 203.0.113.10, для recidive — одна попытка с этого адреса.

Настройки из раздела [recidive] в jail.conf:

НастройкаЗначениеЧто значит
maxretry5 — из [DEFAULT]адрес блокируется после пятой блокировки в других правилах
findtime1dблокировки считаются за последние сутки
bantime1wадрес закрыт на неделю
banactionnftables[type=allports]закрыты все порты, а не только порт правила

Пример: бот подбирает пароль к SSH. Правило sshd закрывает ему порт 22 на 10 минут, бот ждёт и начинает снова. Если он возвращается после каждой блокировки, пять блокировок он наберёт меньше чем за час — и recidive закроет ему сервер на неделю.

Что recidive не считает:

  • свои собственные блокировки: строки [recidive] Ban в образце фильтра исключены;
  • блокировки, которые fail2ban вернул после перезапуска, — строки Restore Ban. Поэтому перезапуск службы не добавляет адресам попыток.

Почему без backend = auto правило ничего не найдёт

В Ubuntu 24.04 в файле /etc/fail2ban/jail.d/defaults-debian.conf записано backend = systemd: все правила читают журнал systemd. Для recidive это значит — искать записи службы fail2ban.service в журнале systemd. Но fail2ban пишет свой журнал в файл /var/log/fail2ban.log — так задано строкой logtarget в /etc/fail2ban/fail2ban.conf, — и строк о блокировках в журнале systemd нет.

Если включить recidive без строки backend = auto, ошибки не будет: -t пройдёт, правило запустится, но в status будет Journal matches вместо File list, а Total failed останется 0.

Строка backend = auto говорит: читать файл из настройки logpath. Для recidive она уже записана в jail.conf: logpath = /var/log/fail2ban.log.

Почему блокирует все порты

Другие правила закрывают адресу только свои порты: sshd — порт SSH, правила для nginx — порты 80 и 443. recidive использует banaction_allports, а в Ubuntu 24.04 это nftables[type=allports]: адресу закрыты все TCP-порты сервера. Заблокированный не попадёт ни по SSH, ни на сайт, ни в другие программы на сервере.

Если под recidive попадёте вы, сервер не пустит вас ни по SSH, ни на сайт целую неделю. Попасть на сервер можно будет только через консоль в панели хостера. Пять своих блокировок за сутки — это, например, пять раз по пять неверных паролей. Чтобы такого не случилось, входите по ключу и добавьте неизменный адрес в ignoreip.

Как проверить, что правило работает

Посмотреть состояние правила:

sudo fail2ban-client status recidive
Строка ответаЧто значит
File list: /var/log/fail2ban.logправило читает журнал fail2ban — всё настроено
Total failedсколько блокировок в других правилах recidive насчитал
Currently bannedсколько адресов закрыто на неделю сейчас
Banned IP listсами эти адреса

Узнать заранее, кого бы правило заблокировало, — прогнать фильтр по журналу. Команда только читает файл и ничего не блокирует:

sudo fail2ban-regex /var/log/fail2ban.log recidive

В конце ответа — строка Lines: … matched: сколько строк о блокировках фильтр нашёл. Подробно — проверка фильтров fail2ban-regex. Какие адреса блокировались больше всех — журнал fail2ban.

Как увидеть блокировки recidive в nftables — fail2ban, nftables и ufw.

Как снять блокировку recidive

КомандаЧто делает
sudo fail2ban-client unban 203.0.113.10снимает блокировку во всех правилах сразу: и в recidive, и в sshd
sudo fail2ban-client set recidive unbanip 203.0.113.10снимает блокировку только в recidive

Если не уверены, каким правилом заблокирован адрес, используйте unban. Подробно — как разблокировать свой IP.

Как поменять срок и порог

Свои значения пишите в jail.local, в тот же раздел [recidive]. Пример — три блокировки за сутки и бан на три дня:

[recidive]
enabled = true
backend = auto
maxretry = 3
bantime = 3d

Затем sudo fail2ban-client -t и sudo fail2ban-client reload. Проверить: sudo fail2ban-client get recidive bantime — ответ 259200, это три дня в секундах. Как записывать время — настройки fail2ban.

Над разделом recidive в jail.conf два предупреждения:

ПредупреждениеЧто это значит для вас
не ставьте loglevel = DEBUG в fail2ban.conf или fail2ban.localпри DEBUG fail2ban пишет в свой журнал очень много строк, и recidive начинает читать собственные записи по кругу. После установки стоит loglevel = INFO — менять не нужно
увеличьте dbpurgeage, например до 648000 — это 7,5 сутокв fail2ban 1.0.2 недельная блокировка и без этого возвращается после перезапуска: запись о ней хранится сутки и ещё три её срока. Хотите следовать совету — как поменять dbpurgeage

Ошибки и как их исправить

Что видитеПричинаЧто делать
Total failed: 0 и строка Journal matches в statusнет backend = autoдопишите backend = auto в раздел [recidive]
Sorry but the jail 'recidive' does not existправило не включеноenabled = true в разделе [recidive], затем -t и reload
не пускает ни по SSH, ни на сайтваш адрес заблокировал recidiveвойдите через консоль хостера и выполните sudo fail2ban-client unban со своим адресом
Have not found any log file for recidive jailнет файла /var/log/fail2ban.logпроверьте строку logtarget в /etc/fail2ban/fail2ban.local: если она там есть, уберите её
боты возвращаются, а recidive никого не блокируетблокировок у одного адреса меньше пяти за суткиsudo fail2ban-regex /var/log/fail2ban.log recidive — сколько строк находит фильтр; при желании уменьшите maxretry до 3

Всё сверено с 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.

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