bantime, findtime и maxretry в fail2ban: на сколько и за что блокировать
Три настройки решают, когда fail2ban заблокирует адрес и надолго ли: maxretry — сколько ошибок можно сделать, findtime — за какое время они считаются, bantime — на сколько блокировать. Здесь — как они работают вместе, какие значения стоят после установки и как сделать, чтобы повторные нарушители получали блокировку дольше.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, какие значения работают у правила SSH:
sudo fail2ban-client get sshd maxretry sudo fail2ban-client get sshd findtime sudo fail2ban-client get sshd bantime - После установки ответы такие:
5,600,600. Сроки показываются в секундах: 600 секунд — 10 минут. - Если хотите другие значения, запишите их в jail.local по шагам из раздела как поменять.
Как они работают вместе
Адрес блокируется, если с него пришло maxretry неудачных попыток за последние findtime. Блокировка длится bantime.
| Настройка | Значение после установки | Что значит |
|---|---|---|
maxretry | 5 | сколько неудачных попыток допускается |
findtime | 10m | за какой срок считаются попытки |
bantime | 10m | на сколько блокируется адрес |
Пример с этими значениями: бот за 10 минут пять раз ввёл неверный пароль — его адрес закрыт на 10 минут. Через 10 минут блокировка снимается, и бот может пробовать снова.
Если бот делает 4 попытки, ждёт 10 минут и делает ещё 4, он не попадёт под блокировку: в окне findtime у него ни разу не набирается 5 попыток. Против таких ботов помогает findtime длиннее — например, час.
Время пишут числом секунд или с буквой: 10m — 10 минут, 1h — час, 1d — сутки, 1w — неделя. Подробно — как записывать время.
Как поменять значения
- Откройте файл:
sudo nano /etc/fail2ban/jail.local(как работать в nano). - Под строкой
[DEFAULT]напишите нужные значения. Если такой строки в файле нет, добавьте её. Пример:[DEFAULT] bantime = 1h findtime = 1h maxretry = 5 - Сохраните: Ctrl+O, Enter, Ctrl+X.
- Проверьте и примените:
sudo fail2ban-client -t sudo fail2ban-client reload - Проверьте:
sudo fail2ban-client get sshd bantime— ответ3600.
Значения под [DEFAULT] действуют на все правила, у которых нет своих. Чтобы поменять только для SSH, напишите их под строкой [sshd].
| Что хотите | Что поставить |
|---|---|
| строже к ботам, но без риска для себя | findtime = 1h, bantime = 1h, maxretry оставить 5 |
| вы заходите только по ключу | maxretry можно уменьшить до 3: по ключу вы не ошибаетесь паролем |
| вы заходите по паролю и бывает, что ошибаетесь | maxretry не меньше 5, bantime не больше часа |
Как растёт срок бана
bantime.increment — рост срока для тех, кого уже блокировали. Первая блокировка — bantime, каждая следующая — вдвое дольше: 10 минут, 20, 40, 1 час 20 минут и так далее. Для этого fail2ban ищет прошлые блокировки адреса в своей базе. База включена после установки, отдельно настраивать её не нужно.
Включить — в jail.local под [DEFAULT]:
[DEFAULT]
bantime = 10m
bantime.increment = true
bantime.maxtime = 1w| Настройка | Что значит |
|---|---|
bantime.increment = true | включает рост срока |
bantime.maxtime = 1w | потолок: дольше недели блокировка не будет |
bantime.rndtime = 10m | добавляет к сроку случайное время до 10 минут, чтобы бот не мог рассчитать, когда его разблокируют |
bantime.factor = 1 | множитель для увеличенных сроков: с 2 каждый из них вдвое длиннее |
bantime.multipliers = 1 2 4 8 16 32 64 | свой ряд множителей вместо удвоения: вторая блокировка — bantime × 2, третья — × 4 и так до последнего числа. С bantime 10m последний шаг — 64 × 10 минут, то есть 10 часов 40 минут |
bantime.overalljails = false | искать прошлые блокировки только в своём правиле. С true — во всех правилах |
После -t и reload проверьте: sudo fail2ban-client get sshd bantime.increment — ответ True.
Без потолка maxtime срок растёт удвоением до 2 в 20-й степени от bantime — это годы. Поэтому ставьте bantime.maxtime. Вместо maxtime можно задать bantime.multipliers: после последнего множителя срок перестаёт расти.
Когда срок увеличен, в журнале /var/log/fail2ban.log появляется строка со словами is bad и incr: там номер блокировки по счёту, старый и новый срок.
Как долго fail2ban помнит прошлые блокировки
Запись о блокировке хранится в базе /var/lib/fail2ban/fail2ban.sqlite3. Её удаляют, когда с блокировки прошло больше суток и ещё трёх её сроков. После 10-минутной блокировки адрес помнят сутки и 30 минут, после блокировки на 4 часа — сутки и 12 часов. Если за это время адрес не попался снова, следующая блокировка опять начнётся с bantime.
Сутки — это строка dbpurgeage = 1d в /etc/fail2ban/fail2ban.conf. Менять её в fail2ban.conf не нужно: если хотите помнить дольше, напишите в /etc/fail2ban/fail2ban.local:
[DEFAULT]
dbpurgeage = 7dи перезапустите службу: sudo systemctl restart fail2ban.
Бан без срока: bantime = -1
bantime = -1 — блокировка без срока: fail2ban сам её не снимет. Такие записи не удаляются из базы и восстанавливаются после каждого перезапуска.
Так делать не стоит: адреса ботов меняются, список блокировок растёт и не очищается, а если под блокировку попадёте вы, придётся снимать её через консоль хостера. Вместо -1 включите bantime.increment с потолком bantime.maxtime — повторные нарушители и так получат долгую блокировку. Для тех, кто попадается раз за разом, есть правило recidive.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
поменяли bantime, а get sshd bantime показывает старое | не применили изменения или у sshd своё значение | sudo fail2ban-client reload; проверьте, нет ли bantime под [sshd] |
ban time increment is not available as long jail database is not set | база выключена | в fail2ban.conf и fail2ban.local не должно быть dbfile = :memory: или пустого dbfile |
| срок блокировки огромный | bantime.increment без maxtime | добавьте bantime.maxtime = 1w и снимите блокировку: как разблокировать |
| бот подбирает пароль, а блокировок нет | попытки реже, чем maxretry за findtime | увеличьте findtime до 1h; проверьте, что правило видит попытки: sudo fail2ban-client status sshd, строка Total failed |
Всё сверено с fail2ban 1.0.2 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится fail2ban 1.1.0.
Источники
- Файл jail.conf в Ubuntu 24.04 — bantime, findtime, maxretry и настройки bantime.increment, maxtime, rndtime, factor, multipliers, overalljails.
- Файл fail2ban.conf в Ubuntu 24.04 — база /var/lib/fail2ban/fail2ban.sqlite3, dbpurgeage = 1d.
- Исходный код fail2ban 1.0.2: observer.py — как растёт срок, строка журнала is bad … incr.
- Исходный код fail2ban 1.0.2: database.py — когда удаляются записи о прошлых блокировках, записи с bantime -1 не удаляются.
- Справка jail.conf для Ubuntu 24.04 — на английском: формат времени.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Правило recidiveнеделя блокировки для тех, кто попадается раз за разом.
- Белый список fail2ban: ignoreipчтобы не заблокировать себя.
- Настройки fail2banкакие файлы есть и куда писать свои.