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

fail2ban не запускается: как найти ошибку и снова включить защиту

После правки jail.local fail2ban перестал работать, а команды fail2ban-client отвечают ошибкой? Пока служба стоит, подбор паролей к SSH никто не блокирует. Здесь — как найти строку с причиной, что значит каждая ошибка запуска и как не остаться без защиты при следующей правке.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте службу:
    sudo systemctl status fail2ban

    Найдите строку Active:. active (running) — служба работает, failed — не запустилась. Если внизу экрана нет приглашения для новой команды, нажмите Q.

  3. Найдите причину:
    sudo fail2ban-client -t

    Если в конце ответа ERROR: test configuration failed, причина — в строках выше: ищите Failed during configuration: или Errors in jail.

  4. Исправьте ошибку по таблице ниже и повторяйте sudo fail2ban-client -t, пока ответ не станет OK: configuration test is successful.
  5. Запустите службу и проверьте:
    sudo systemctl start fail2ban
    sudo fail2ban-client status

    В ответе — Number of jail: и список правил в строке Jail list:.

Как понять, что fail2ban не работает

Что видитеЧто значит
Active: active (running)служба работает
Active: failedслужба не запустилась или завершилась с ошибкой
Active: inactive (dead)служба остановлена, например командой sudo systemctl stop fail2ban
status=255/EXCEPTIONfail2ban завершился с ошибкой — причину покажут команды ниже
Failed to access socket path: /var/run/fail2ban/fail2ban.sock. Is fail2ban running? в ответ на команду fail2ban-clientслужба не работает, команде не с кем связаться

После ошибки в настройках служба сама не перезапустится: в её файле записано не перезапускать fail2ban, если он вышел с кодом 255. Она будет стоять, пока вы не исправите ошибку и не запустите её командой start.

Пока fail2ban стоит, никто не блокирует подбор паролей к SSH и другие атаки, от которых защищают ваши правила. Если на сервер можно войти по паролю, исправьте ошибку сразу или включите вход только по ключу.

Где fail2ban пишет причину

Быстрее всего причину покажет проверка sudo fail2ban-client -t: она читает те же файлы, что и служба при запуске, и печатает ошибки на экран.

В свой файл /var/log/fail2ban.log fail2ban пишет только после того, как прочитал настройки. Если прочитать их не удалось, ошибки запуска остаются в журнале systemd. Последние 30 строк журнала службы:

sudo journalctl -u fail2ban -n 30 --no-pager

Ошибки — строки со словом ERROR. Если запуск сорвался из-за настроек, в журнале будет строка Async configuration of server failed, а выше — строки с причиной.

Ошибка в одном правиле и ошибка во всём файле

Где ошибкаЧто при запуске службыЧто ответит -t
в одном правиле: неверное имя фильтра или действияправило пропущено, остальные работаютERROR: test configuration failed
во всех включённых правилахfail2ban не запускаетсяERROR: test configuration failed
во всём файле: раздел записан дважды, строка без =fail2ban не запускаетсяERROR: test configuration failed
нет файла журнала у правила с backend = autofail2ban не запускается, даже если остальные правила в порядкеERROR: test configuration failed

Поэтому active (running) ещё не значит, что работают все правила: сверьте список в строке Jail list: ответа sudo fail2ban-client status. Пропущенное правило отмечено в журнале fail2ban строкой Jail 'ИМЯ' skipped, because of wrong configuration: с причиной. Найти такие строки:

sudo grep 'skipped' /var/log/fail2ban.log

Когда служба работает, а правила нет

-t отвечает OK, служба работает, а sudo fail2ban-client status recidive отвечает Sorry but the jail 'recidive' does not exist? Правило не включилось, и ошибки об этом нет. Проверьте строку enabled в его разделе:

Как записаноЧто прочитает fail2ban
enabled = trueправило включено. Включают его и значения yes, on, 1
enabled = true # включитьзначение true # включить — правило выключено: знак # в конце строки не считается комментарием
enabled = tureопечатка — правило выключено
строка enabled = true начинается с пробела, а над ней другая настройкастрока стала продолжением настройки над ней — правило выключено

Комментарии пишите отдельной строкой, начиная её с #. Строки настроек начинайте без пробелов. Затем sudo fail2ban-client -t и sudo fail2ban-client reload.

Как не остаться без защиты при следующей правке

  1. Перед правкой сохраните копию файла:
    sudo cp /etc/fail2ban/jail.local /etc/fail2ban/jail.local.bak

    Файл с окончанием .bak fail2ban не читает.

  2. После правки проверьте настройки: sudo fail2ban-client -t.
  3. Применяйте настройки командой sudo fail2ban-client reload, а не restart.
КомандаЕсли ошибка такая, что fail2ban не запустился бы
sudo fail2ban-client reloadответит ошибкой, fail2ban продолжит работать со старыми настройками
sudo systemctl restart fail2banостановит службу, и она не запустится

Вернуть копию, если не получается найти ошибку:

sudo cp /etc/fail2ban/jail.local.bak /etc/fail2ban/jail.local
sudo fail2ban-client -t
sudo systemctl start fail2ban

Если ошибку найти не удаётся, а копии нет

Временно отключите свой файл — fail2ban запустится с настройками Ubuntu, в которых включено правило sshd:

sudo mv /etc/fail2ban/jail.local /etc/fail2ban/jail.local.off
sudo fail2ban-client -t
sudo systemctl start fail2ban

SSH снова под защитой. Затем исправьте файл jail.local.off по таблице ниже и верните ему имя:

sudo mv /etc/fail2ban/jail.local.off /etc/fail2ban/jail.local
sudo fail2ban-client -t
sudo fail2ban-client reload

Если свои настройки вы писали в файл из папки /etc/fail2ban/jail.d/, переименуйте так же его: в этой папке fail2ban читает только файлы с окончанием .conf и .local. Файл defaults-debian.conf не трогайте — в нём настройки Ubuntu.

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

Что видитеПричинаЧто делать
Have not found any log file for nginx-botsearch jailу правила backend = auto, а файла журнала из logpath нет: nginx не установлен или журнал лежит в другом местеsudo ls -l /var/log/nginx/ — есть ли файлы. Нет nginx — поставьте в разделе правила enabled = false. Журнал в другом месте — исправьте logpath
Unable to read the filter 'wordpres-login', затем Errors in jail 'wordpress-login'опечатка в строке filter или нет файла фильтраls /etc/fail2ban/filter.d/ — сверьте имя. В строке filter имя пишется без .conf
Unable to read action 'nftable'опечатка в строке banaction или actionls /etc/fail2ban/action.d/ — сверьте имя
section 'sshd' already existsраздел [sshd] записан в одном файле дважды. В начале текста ошибки — путь к файлу и номер строки, например [line 12]оставьте один раздел [sshd] и перенесите в него все строки второго
option 'enabled' in section 'sshd' already existsв одном разделе одна настройка записана дваждыудалите лишнюю строку — её номер есть в тексте ошибки
Source contains parsing errorsстрока без знака =, например имя правила без квадратных скобокномер строки — после [line, рядом сама строка. Разделы пишутся в скобках: [sshd], настройки — имя = значение
File contains no section headersфайл начинается с настройки, а не с разделапервой строкой файла поставьте раздел, например [DEFAULT]
Server already runningfail2ban уже работаетничего делать не нужно — проверьте sudo fail2ban-client status
Active: failed, а -t отвечает OKошибка не в настройкахsudo journalctl -u fail2ban -n 30 --no-pager — смотрите строки со словом ERROR

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

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