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

Белый список fail2ban: ignoreip и ignoreself

Белый список — адреса, которые fail2ban не блокирует, сколько бы неверных паролей с них ни пришло. Туда стоит добавить адрес, с которого вы заходите на сервер, если он у вас не меняется. Здесь — как записать белый список, проверить его и чего он не умеет.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Узнайте свой адрес:
    echo $SSH_CLIENT

    Первое значение в ответе — адрес вашего компьютера, например 203.0.113.10.

  3. Откройте файл настроек: sudo nano /etc/fail2ban/jail.local (как работать в nano). Если файла нет, nano создаст его.
  4. Если в файле уже есть строка [DEFAULT], допишите под ней строку ignoreip. Если нет — добавьте в начало файла обе строки:
    [DEFAULT]
    ignoreip = 127.0.0.1/8 ::1 203.0.113.10

    203.0.113.10 замените на свой адрес.

  5. Сохраните: Ctrl+O, Enter, Ctrl+X.
  6. Проверьте и примените:
    sudo fail2ban-client -t
    sudo fail2ban-client reload
  7. Проверьте, что адрес в списке: 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показывает список
Так добавленный адрес действует до reload или перезапуска службы, потом fail2ban снова берёт список из файлов. Чтобы адрес остался, запишите его в jail.local.

Если адрес уже заблокирован

Белый список не снимает блокировку, которая уже стоит. Добавили адрес в 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.

Источники

Сверено 6 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

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