Белый список fail2ban: ignoreip и ignoreself
Белый список — адреса, которые fail2ban не блокирует, сколько бы неверных паролей с них ни пришло. Туда стоит добавить адрес, с которого вы заходите на сервер, если он у вас не меняется. Здесь — как записать белый список, проверить его и чего он не умеет.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Узнайте свой адрес:
echo $SSH_CLIENTПервое значение в ответе — адрес вашего компьютера, например
203.0.113.10. - Откройте файл настроек:
sudo nano /etc/fail2ban/jail.local(как работать в nano). Если файла нет, nano создаст его. - Если в файле уже есть строка
[DEFAULT], допишите под ней строку ignoreip. Если нет — добавьте в начало файла обе строки:[DEFAULT] ignoreip = 127.0.0.1/8 ::1 203.0.113.10203.0.113.10 замените на свой адрес.
- Сохраните: Ctrl+O, Enter, Ctrl+X.
- Проверьте и примените:
sudo fail2ban-client -t sudo fail2ban-client reload - Проверьте, что адрес в списке:
sudo fail2ban-client get sshd ignoreip.
Стоит ли добавлять свой адрес
| Ваш адрес | Добавлять ли |
|---|---|
| неизменный: офис, свой сервер, адрес, который провайдер закрепил за вами | да |
| домашний интернет, адрес меняется | нет смысла: завтра у вас будет другой адрес, а старый может достаться чужому |
| мобильный интернет | нет: адрес меняется и может быть общим для многих абонентов |
| второй ваш сервер, который подключается к этому | да, его адрес из панели хостера |
Если не знаете, меняется ли адрес, сравните ответ echo $SSH_CLIENT в разные дни. Или спросите у своего провайдера, есть ли у вас статический IP-адрес.
Лучшая защита от случайной блокировки — вход по ключу: неудачная попытка по ключу у существующего пользователя fail2ban не считает. Как настроить вход только по ключу.
Как записывать адреса
| Запись | Что значит |
|---|---|
203.0.113.10 | один адрес |
203.0.113.0/24 | все адреса от 203.0.113.0 до 203.0.113.255 |
127.0.0.1/8 ::1 | адреса самого сервера, на которых работают его внутренние программы |
2001:db8::/64 | подсеть IPv6 |
office.example.ru | имя: fail2ban узнает его адрес через DNS |
Адреса разделяют пробелом или запятой. Длинный список можно перенести на следующие строки — каждая новая строка начинается с пробела:
[DEFAULT]
ignoreip = 127.0.0.1/8 ::1
203.0.113.10
198.51.100.0/24В jail.conf строка ignoreip = 127.0.0.1/8 ::1 есть, но закомментирована. Когда пишете свою строку, оставьте 127.0.0.1/8 ::1 в начале: ваша строка заменяет список целиком, а не дописывает к нему.
Что такое ignoreself
ignoreself — не блокировать адреса, которые принадлежат самому серверу. Включено по умолчанию: sudo fail2ban-client get sshd ignoreself отвечает True. Менять не нужно.
Из-за ignoreself fail2ban не заблокирует сервер, если неудачные попытки идут с него самого: например, ваш скрипт на этом же сервере ошибся паролем.
Белый список для одного правила
Строка ignoreip в разделе [DEFAULT] касается всех правил. Если нужен адрес только для одного правила, напишите ignoreip в его разделе. Но список в разделе правила заменяет список из [DEFAULT], поэтому подставьте его в начало:
[nginx-http-auth]
ignoreip = %(default/ignoreip)s 198.51.100.7%(default/ignoreip)s fail2ban заменит списком из [DEFAULT], а 198.51.100.7 будет в белом списке только у правила nginx-http-auth. Если написать без %(default/ignoreip)s, адреса из [DEFAULT] у этого правила пропадут.
Как добавить адрес без правки файла
| Команда | Что делает |
|---|---|
sudo fail2ban-client set sshd addignoreip 203.0.113.10 | добавляет адрес в белый список правила sshd |
sudo fail2ban-client set sshd delignoreip 203.0.113.10 | убирает адрес из списка |
sudo fail2ban-client get sshd ignoreip | показывает список |
Если адрес уже заблокирован
Белый список не снимает блокировку, которая уже стоит. Добавили адрес в ignoreip — снимите блокировку отдельно:
sudo fail2ban-client unban 203.0.113.10Подробно — как разблокировать свой IP. При перезапуске службы fail2ban не возвращает блокировки адресов из белого списка.
Как проверить, что белый список работает
Когда fail2ban пропускает адрес из белого списка, он пишет в журнал строку:
[sshd] Ignore 203.0.113.10 by ipНайти такие строки: sudo grep 'Ignore' /var/log/fail2ban.log | tail -n 10. В конце строки — почему адрес пропущен: by ip — он в ignoreip, by dns — совпало имя, by ignoreself rule — это адрес самого сервера.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| адрес в ignoreip, а блокировка осталась | блокировка поставлена раньше | sudo fail2ban-client unban 203.0.113.10 |
get sshd ignoreip не показывает ваш адрес | не применили изменения или строка не в том разделе | sudo fail2ban-client reload; строка должна быть под [DEFAULT] или под [sshd] |
| вчера белый список работал, сегодня вас заблокировало | адрес сменился | проверьте echo $SSH_CLIENT и обновите список, а лучше настройте вход по ключу |
у правила nginx пропали адреса из [DEFAULT] | у правила свой ignoreip | допишите %(default/ignoreip)s в начало |
ERROR: test configuration failed после правки | опечатка в адресе или в имени раздела | исправьте строку, на которую указывает Failed during configuration: |
Всё сверено с fail2ban 1.0.2 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится fail2ban 1.1.0.
Источники
- Справка jail.conf для Ubuntu 24.04 — на английском: ignoreip, ignoreself.
- Файл jail.conf в Ubuntu 24.04 — ignoreip: адреса, подсети и имена через пробел или запятую; запись %(default/…)s.
- Исходный код fail2ban 1.0.2: filter.py — ignoreself включён по умолчанию, строка журнала Ignore … by.
- Исходный код fail2ban 1.0.2: jail.py — при запуске блокировки адресов из белого списка не восстанавливаются.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Как разблокировать свой IP в fail2banесли вас уже заблокировало.
- Настройки fail2banкакие файлы есть и куда писать свои.
- Вход по SSH только по ключучтобы не зависеть от адреса.