fail2ban не запускается: как найти ошибку и снова включить защиту
После правки jail.local fail2ban перестал работать, а команды fail2ban-client отвечают ошибкой? Пока служба стоит, подбор паролей к SSH никто не блокирует. Здесь — как найти строку с причиной, что значит каждая ошибка запуска и как не остаться без защиты при следующей правке.
Содержание 10
- Что сделать прямо сейчас
- Как понять, что fail2ban не работает
- Где fail2ban пишет причину
- Ошибка в одном правиле и ошибка во всём файле
- Когда служба работает, а правила нет
- Как не остаться без защиты при следующей правке
- Если ошибку найти не удаётся, а копии нет
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте службу:
sudo systemctl status fail2banНайдите строку
Active:.active (running)— служба работает,failed— не запустилась. Если внизу экрана нет приглашения для новой команды, нажмите Q. - Найдите причину:
sudo fail2ban-client -tЕсли в конце ответа
ERROR: test configuration failed, причина — в строках выше: ищитеFailed during configuration:илиErrors in jail. - Исправьте ошибку по таблице ниже и повторяйте
sudo fail2ban-client -t, пока ответ не станетOK: configuration test is successful. - Запустите службу и проверьте:
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/EXCEPTION | fail2ban завершился с ошибкой — причину покажут команды ниже |
Failed to access socket path: /var/run/fail2ban/fail2ban.sock. Is fail2ban running? в ответ на команду fail2ban-client | служба не работает, команде не с кем связаться |
После ошибки в настройках служба сама не перезапустится: в её файле записано не перезапускать fail2ban, если он вышел с кодом 255. Она будет стоять, пока вы не исправите ошибку и не запустите её командой start.
Где 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 = auto | fail2ban не запускается, даже если остальные правила в порядке | 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.
Как не остаться без защиты при следующей правке
- Перед правкой сохраните копию файла:
sudo cp /etc/fail2ban/jail.local /etc/fail2ban/jail.local.bakФайл с окончанием .bak fail2ban не читает.
- После правки проверьте настройки:
sudo fail2ban-client -t. - Применяйте настройки командой
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 fail2banSSH снова под защитой. Затем исправьте файл 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 или action | ls /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 running | fail2ban уже работает | ничего делать не нужно — проверьте 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.
Источники
- Файл службы fail2ban в Ubuntu 24.04 — запуск fail2ban-server -xf start, Restart=on-failure, RestartPreventExitStatus=0 255.
- Исходный код fail2ban 1.0.2: fail2bancmdline.py — Failed during configuration, ERROR: test configuration failed, OK: configuration test is successful, вывод ошибок на экран до чтения настроек.
- Исходный код fail2ban 1.0.2: fail2banclient.py — Async configuration of server failed, Server already running, Failed to access socket path; reload не применяет настройки с ошибкой.
- Исходный код fail2ban 1.0.2: jailsreader.py — Errors in jail, запуск без правила с ошибкой.
- Исходный код fail2ban 1.0.2: jailreader.py — Unable to read the filter, Unable to read action, Have not found any log file, Jail skipped, because of wrong configuration.
- Исходный код fail2ban 1.0.2: configreader.py — какие файлы читаются: jail.conf, jail.d/.conf, jail.local, jail.d/.local.
- Исходный код fail2ban 1.0.2: configparserinc.py — комментарий в конце строки — только после точки с запятой.
- Исходный код fail2ban 1.0.2: helpers.py — значения true, yes, on, 1 для enabled.
- Модуль configparser языка Python 3.12 — на английском: тексты ошибок разбора файла, продолжение настройки на строке с отступом.
- Файл defaults-debian.conf в Ubuntu 24.04 — правило sshd включено в настройках Ubuntu.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Журнал fail2banчто пишет служба, когда работает.
- Настройки fail2banкакие файлы есть и куда писать свои.
- Установка fail2banесли fail2ban ещё не установлен.