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

Команды fail2ban-client: статус, блокировки, проверка настроек

fail2ban-client — программа, которой управляют fail2ban: смотрят, кто заблокирован, снимают блокировку, проверяют и перечитывают настройки. Здесь все команды, которые нужны на сервере с сайтом, с примерами ответов. Каждую команду пишите с sudo.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте, что fail2ban работает:
    sudo fail2ban-client ping

    Ответ Server replied: pong — служба работает. Если в ответе Is fail2ban running? — служба не запущена: fail2ban не запускается.

  3. Посмотрите, какие правила включены: sudo fail2ban-client status.
  4. Посмотрите, кого заблокировало правило SSH: sudo fail2ban-client status sshd.

Без sudo fail2ban-client не работает: в ответе будет you must be root. Если fail2ban ещё не установлен — установка fail2ban.

Как читать ответ status

Команда sudo fail2ban-client status показывает, сколько правил работает и как они называются:

Status
|- Number of jail:	1
`- Jail list:	sshd

Правило в fail2ban называется jail. Сразу после установки в Ubuntu работает одно — sshd. Если вы включили правила для nginx, они появятся в строке Jail list через запятую.

Команда sudo fail2ban-client status sshd показывает одно правило:

Status for the jail: sshd
|- Filter
|  |- Currently failed:	2
|  |- Total failed:	57
|  `- Journal matches:	_SYSTEMD_UNIT=sshd.service + _COMM=sshd
`- Actions
   |- Currently banned:	1
   |- Total banned:	9
   `- Banned IP list:	203.0.113.10
СтрокаЧто значит
Currently failedу скольких адресов сейчас есть неудачные попытки, но до блокировки они не дошли
Total failedсколько неудачных попыток насчитано с запуска правила
Journal matchesкакие записи журнала systemd читает правило. У правил, которые читают файлы, здесь File list и пути к файлам
Currently bannedсколько адресов заблокировано сейчас
Total bannedсколько блокировок было с запуска правила
Banned IP listсами заблокированные адреса

Числа в примере для образца — у вас будут свои. После перезапуска службы счётчики Total начинаются заново.

Кто заблокирован

КомандаЧто покажет
sudo fail2ban-client status sshdадреса, заблокированные правилом sshd
sudo fail2ban-client bannedвсе правила и адреса, заблокированные в каждом
sudo fail2ban-client banned 203.0.113.10в каких правилах заблокирован этот адрес
sudo fail2ban-client get sshd banip --with-timeадреса с временем: когда заблокирован, на сколько секунд и до какого времени
sudo fail2ban-client get sshd banned 203.0.113.101 — адрес заблокирован в sshd, 0 — нет

203.0.113.10 в примерах замените на нужный адрес.

Снять или поставить блокировку

КомандаЧто делает
sudo fail2ban-client set sshd unbanip 203.0.113.10снимает блокировку в правиле sshd
sudo fail2ban-client unban 203.0.113.10снимает блокировку во всех правилах сразу
sudo fail2ban-client unban --allснимает все блокировки во всех правилах
sudo fail2ban-client set sshd banip 203.0.113.10блокирует адрес вручную в правиле sshd

В ответ на unban — число снятых блокировок: 0 значит, что адрес не был заблокирован. Обе команды снимают блокировку и в базе fail2ban, поэтому после перезапуска службы адрес не заблокируется снова. Если заблокировали самого себя — как разблокировать свой IP.

Посмотреть и поменять настройки

КомандаЧто покажет
sudo fail2ban-client get sshd bantimeна сколько секунд блокирует правило
sudo fail2ban-client get sshd findtimeза сколько секунд считаются попытки
sudo fail2ban-client get sshd maxretryсколько неудачных попыток допускается
sudo fail2ban-client get sshd ignoreipадреса, которые правило не блокирует
sudo fail2ban-client get sshd ignoreselfTrue — адреса самого сервера не блокируются
sudo fail2ban-client get sshd logpathкакие файлы журнала читает правило
sudo fail2ban-client get sshd journalmatchкакие записи журнала systemd читает правило

Поменять можно и на ходу, без правки файлов:

КомандаЧто делает
sudo fail2ban-client set sshd bantime 3600блокировка на 3600 секунд — час
sudo fail2ban-client set sshd maxretry 3блокировать после трёх неудачных попыток
sudo fail2ban-client set sshd addignoreip 203.0.113.10не блокировать этот адрес
sudo fail2ban-client set sshd delignoreip 203.0.113.10убрать адрес из исключений
Изменения через set действуют до reload или перезапуска службы — потом fail2ban снова берёт значения из файлов. Чтобы сохранить настройку, запишите её в /etc/fail2ban/jail.local: как написать jail.local.

Проверить и перечитать настройки

КомандаЧто делает
sudo fail2ban-client -tпроверяет файлы настроек. OK: configuration test is successful — ошибок нет
sudo fail2ban-client reloadперечитывает настройки всех правил, служба не останавливается
sudo fail2ban-client reload sshdперечитывает одно правило
sudo fail2ban-client reload --unbanперечитывает и снимает все блокировки
sudo fail2ban-client restart sshdостанавливает и заново запускает одно правило
sudo fail2ban-client flushlogsзаново открывает файл журнала — это делает logrotate после ротации
sudo fail2ban-client versionверсия: в Ubuntu 24.04 — 1.0.2

Порядок после правки jail.local: сначала -t, потом reload. Почему не restart — как применить изменения.

sudo fail2ban-client stop останавливает fail2ban целиком, вместе с защитой SSH. Запустить снова: sudo systemctl start fail2ban.

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

Что видитеПричинаЧто делать
Failed to access socket path: /var/run/fail2ban/fail2ban.sock. Is fail2ban running?служба не запущенаsudo systemctl status fail2ban, разбор — fail2ban не запускается
в ответе есть you must be rootкоманда без sudoдобавьте sudo в начало
Sorry but the jail 'sshd2' does not existтакого правила нет или оно не включеноsudo fail2ban-client status покажет точные имена
Sorry but the command is invalidопечатка в командесверьте с таблицами выше или посмотрите sudo fail2ban-client help
Server already runningfail2ban уже запущенничего делать не нужно
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.

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