Команды fail2ban-client: статус, блокировки, проверка настроек
fail2ban-client — программа, которой управляют fail2ban: смотрят, кто заблокирован, снимают блокировку, проверяют и перечитывают настройки. Здесь все команды, которые нужны на сервере с сайтом, с примерами ответов. Каждую команду пишите с sudo.
Содержание 9
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, что fail2ban работает:
sudo fail2ban-client pingОтвет
Server replied: pong— служба работает. Если в ответеIs fail2ban running?— служба не запущена: fail2ban не запускается. - Посмотрите, какие правила включены:
sudo fail2ban-client status. - Посмотрите, кого заблокировало правило 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.10 | 1 — адрес заблокирован в 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 ignoreself | True — адреса самого сервера не блокируются |
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 | убрать адрес из исключений |
Проверить и перечитать настройки
| Команда | Что делает |
|---|---|
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 running | fail2ban уже запущен | ничего делать не нужно |
ERROR: test configuration failed | ошибка в файлах настроек | причина — в строке с Failed during configuration: |
Всё сверено с fail2ban 1.0.2 — эта версия ставится из пакетов Ubuntu 24.04. В Ubuntu 26.04 ставится fail2ban 1.1.0.
Источники
- Справка fail2ban-client для Ubuntu 24.04 — на английском: все команды и ключ -t.
- Исходный код fail2ban 1.0.2: protocol.py — список команд: unban во всех правилах и в базе, banned, get … banip --with-time.
- Исходный код fail2ban 1.0.2: beautifier.py — как выглядят ответы ping и status.
- Исходный код fail2ban 1.0.2: actions.py — снятие блокировки удаляет адрес и из базы.
- Исходный код fail2ban 1.0.2: fail2bancmdline.py — сообщения Failed to access socket path и configuration test is successful.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Настройки fail2banкакие файлы есть и куда писать свои.
- Как разблокировать свой IP в fail2banесли не пускает на сервер.
- Журнал fail2banкого и когда блокировали.