Настройки fail2ban: какие файлы есть и куда писать свои
У fail2ban несколько файлов настроек, и правит из них нужно только один — jail.local. Остальные ставятся вместе с пакетом, и обновление может их заменить. Здесь — какой файл за что отвечает, в каком порядке они читаются, как записать свою настройку, проверить её и применить так, чтобы защита SSH не выключилась из-за опечатки.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться). Если fail2ban ещё не установлен — установка fail2ban.
- Посмотрите, есть ли у вас свой файл настроек:
ls /etc/fail2ban/jail.local - Если в ответе путь к файлу — свои настройки уже есть, их можно посмотреть:
sudo cat /etc/fail2ban/jail.local. Если система ответила, что такого файла нет, — fail2ban работает с настройками Ubuntu, а свои вы запишете по шагам из раздела как написать jail.local. - Проверьте, что настройки читаются без ошибок:
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.
В каком порядке читаются файлы
jail.conf- файлы
.confиз папкиjail.d, по алфавиту jail.local- файлы
.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 = systemd | fail2ban читает журнал systemd, а не файлы журналов |
enabled = true в [sshd] | включено одно правило — защита SSH |
Строка backend = systemd записана в [DEFAULT], то есть касается всех правил. Для SSH это правильно, а nginx пишет журнал в файлы. Поэтому у правил для nginx в jail.local пишут backend = auto — подробно.
Как написать jail.local
- Откройте файл:
sudo nano /etc/fail2ban/jail.local. Если файла нет, nano создаст его. Как работать в nano. - Напишите только то, что хотите изменить. Пример:
[DEFAULT] bantime = 1h findtime = 10m maxretry = 5 [sshd] mode = extraСтроки под
[DEFAULT]касаются всех правил, под[sshd]— только защиты SSH. Что значат bantime, findtime и maxretry — на отдельной странице, что значит mode — в настройке правила sshd. - Сохраните: Ctrl+O, Enter, Ctrl+X.
- Проверьте:
sudo fail2ban-client -t. ОтветOK: configuration test is successful— можно применять. - Примените:
sudo fail2ban-client reload. - Проверьте, что настройка дошла:
sudo fail2ban-client get sshd bantime. Ответ — число секунд: для 1h это3600.
Как записывать время
bantime, findtime и другие сроки пишут числом секунд или числом с буквой:
| Запись | Сколько |
|---|---|
600 | 600 секунд, то есть 10 минут |
10m | 10 минут |
1h | 1 час |
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.
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.
Источники
- Справка jail.conf для Ubuntu 24.04 — на английском: порядок чтения файлов, совет писать свои настройки в .local, формат времени, комментарии.
- Файл defaults-debian.conf в Ubuntu 24.04 — banaction = nftables, backend = systemd, правило sshd включено.
- Файл jail.conf в Ubuntu 24.04 — значения по умолчанию, port = ssh у правила sshd.
- Исходный код fail2ban 1.0.2: fail2banclient.py — reload не передаёт службе настройки с ошибкой, restart — остановка и запуск.
- Исходный код fail2ban 1.0.2: mytime.py — буквы m, h, d, w, mo в сроках.
- Файл службы fail2ban.service — ExecReload: fail2ban-client reload.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Установка fail2ban на Ubuntuс чего начать.
- Команды fail2ban-clientстатус, разблокировка, проверка.
- bantime, findtime и maxretryна сколько и за что блокировать.