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

Настройки fail2ban: какие файлы есть и куда писать свои

У fail2ban несколько файлов настроек, и правит из них нужно только один — jail.local. Остальные ставятся вместе с пакетом, и обновление может их заменить. Здесь — какой файл за что отвечает, в каком порядке они читаются, как записать свою настройку, проверить её и применить так, чтобы защита SSH не выключилась из-за опечатки.

≈ 7 мин чтения
Содержание 11

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

  1. Подключитесь к серверу по SSH (как подключиться). Если fail2ban ещё не установлен — установка fail2ban.
  2. Посмотрите, есть ли у вас свой файл настроек:
    ls /etc/fail2ban/jail.local
  3. Если в ответе путь к файлу — свои настройки уже есть, их можно посмотреть: sudo cat /etc/fail2ban/jail.local. Если система ответила, что такого файла нет, — fail2ban работает с настройками Ubuntu, а свои вы запишете по шагам из раздела как написать jail.local.
  4. Проверьте, что настройки читаются без ошибок:
    sudo fail2ban-client -t

    Ответ OK: configuration test is successful — ошибок нет.

Какой файл за что отвечает

Все настройки лежат в папке /etc/fail2ban. Правило в fail2ban называется jail: например, правило sshd следит за входами по SSH.

ФайлЧто в нёмПравить ли
jail.confвсе правила и значения по умолчаниюнет: обновление пакета может заменить файл
jail.d/defaults-debian.confчто включила Ubuntu: правило sshd, журнал systemd, блокировка через nftablesнет: нужное перепишите в jail.local
jail.localваши настройкида, это ваш файл
fail2ban.confнастройки самой службы: куда писать журнал, где базанет: свои — в fail2ban.local
filter.d/фильтры: какие строки журнала считать неудачной попыткойсвой фильтр — новым файлом, пример для WordPress
action.d/действия: как блокировать адресне нужно, выбор действия — строкой banaction

Справка fail2ban советует не менять файлы .conf, а свои значения писать в файлы .local: в .local указывают только то, что меняют, остальное fail2ban берёт из .conf.

В каком порядке читаются файлы

  1. jail.conf
  2. файлы .conf из папки jail.d, по алфавиту
  3. jail.local
  4. файлы .local из папки jail.d, по алфавиту

Если одна и та же настройка встречается в нескольких файлах, работает та, что прочитана позже. Пример: в jail.conf bantime = 10m, в jail.local bantime = 1h — блокировка будет на час.

Значение из раздела правила главнее значения из [DEFAULT], даже если [DEFAULT] прочитан позже. В jail.conf у правила sshd записано port = ssh, поэтому port = 2222 в разделе [DEFAULT] вашего jail.local на sshd не подействует. Порт SSH пишут в раздел [sshd] — пример.

Вместо одного jail.local можно положить несколько файлов в папку jail.d, например jail.d/sshd.local и jail.d/nginx.local. Работает так же — главное, чтобы файлы заканчивались на .local или .conf.

Что уже настроено в Ubuntu

Посмотреть: cat /etc/fail2ban/jail.d/defaults-debian.conf. В Ubuntu 24.04 там два раздела:

[DEFAULT]
banaction = nftables
banaction_allports = nftables[type=allports]
backend = systemd

[sshd]
enabled = true
СтрокаЧто значит
banaction = nftablesадреса блокируются через nftables — как посмотреть блокировки
banaction_allports = nftables[type=allports]так блокируют правила, которые закрывают адресу все порты, например recidive
backend = systemdfail2ban читает журнал systemd, а не файлы журналов
enabled = true в [sshd]включено одно правило — защита SSH

Строка backend = systemd записана в [DEFAULT], то есть касается всех правил. Для SSH это правильно, а nginx пишет журнал в файлы. Поэтому у правил для nginx в jail.local пишут backend = auto — подробно.

Как написать jail.local

  1. Откройте файл: sudo nano /etc/fail2ban/jail.local. Если файла нет, nano создаст его. Как работать в nano.
  2. Напишите только то, что хотите изменить. Пример:
    [DEFAULT]
    bantime = 1h
    findtime = 10m
    maxretry = 5
    
    [sshd]
    mode = extra

    Строки под [DEFAULT] касаются всех правил, под [sshd] — только защиты SSH. Что значат bantime, findtime и maxretry — на отдельной странице, что значит mode — в настройке правила sshd.

  3. Сохраните: Ctrl+O, Enter, Ctrl+X.
  4. Проверьте: sudo fail2ban-client -t. Ответ OK: configuration test is successful — можно применять.
  5. Примените: sudo fail2ban-client reload.
  6. Проверьте, что настройка дошла: sudo fail2ban-client get sshd bantime. Ответ — число секунд: для 1h это 3600.

Как записывать время

bantime, findtime и другие сроки пишут числом секунд или числом с буквой:

ЗаписьСколько
600600 секунд, то есть 10 минут
10m10 минут
1h1 час
1h30mполтора часа
1dсутки
1wнеделя
1moмесяц

m — это минуты, а не месяцы. Месяц пишут mo или mon.

Комментарии в файле

Строка, которая начинается с #, — комментарий, fail2ban её пропускает. Комментарий в конце строки пишут после точки с запятой с пробелом:

# защита SSH
bantime = 1h ; блокировка на час

Знак # в конце строки комментарием не считается: в строке bantime = 1h # час fail2ban сочтёт # час частью значения. Пробел перед точкой с запятой тоже нужен: справка fail2ban прямо пишет, что он важен.

Как применить изменения

КомандаЧто делает
sudo fail2ban-client -tпроверяет все файлы, ничего не меняет
sudo fail2ban-client reloadперечитывает настройки, служба не останавливается, блокировки остаются
sudo systemctl reload fail2banто же самое: служба выполняет fail2ban-client reload
sudo fail2ban-client reload sshdперечитывает только правило sshd
sudo systemctl restart fail2banостанавливает и запускает службу заново; блокировки возвращаются из базы

Для изменений в jail.local хватает reload. Если клиент не смог прочитать настройки, он пишет Failed during configuration и ничего не передаёт службе: она продолжает работать со старыми настройками. А restart сначала останавливает службу, и если в новых настройках ошибка, fail2ban не запустится — вместе с защитой SSH.

Перед reload и restart запускайте sudo fail2ban-client -t. Проверка строже запуска: если в одном правиле ошибка, проверка не пройдёт, а при запуске fail2ban пропустит это правило, напишет Errors in jail 'X'. Skipping... и запустит остальные.

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

Что видитеПричинаЧто делать
ERROR: test configuration failedошибка в настройкахпричина — в строке выше, после Failed during configuration:; исправьте и повторите -t
изменили jail.local, а get показывает старое значениене применили измененияsudo fail2ban-client reload
после reload значение всё равно староенастройка в [DEFAULT], а у правила своянапишите её в раздел правила, например [sshd]
Sorry but the jail 'nginx-http-auth' does not existправило не включено или имя с опечаткойsudo fail2ban-client status покажет включённые правила
после обновления пропали правки в jail.confфайл заменил пакетперенесите правки в jail.local
служба не запускается после restartошибка в настройкахfail2ban не запускается

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

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