Как установить и настроить Fail2ban на VPS с Debian или Ubuntu?
Установка Fail2ban, файл jail.local для SSH и nginx, блокировка и разблокировка IP, проверка статуса jail и типичные ошибки с nftables или UFW.
Fail2ban читает журналы ваших сервисов и на заданное время блокирует IP-адреса, с которых копятся неудачные попытки: перебор паролей SSH, сканирование страниц администрирования, неудачные входы на сайт. На VPS, доступном из интернета, попытки на порт 22 начинаются через несколько минут после выдачи сервера. В этом руководстве Fail2ban устанавливается на Debian 12 / 13 или Ubuntu 22.04 / 24.04, защищает SSH и nginx, а затем показано, как проверить, заблокировать и разблокировать адрес.
Пошаговая инструкция
-
Установите Fail2ban
Обновите список пакетов, затем установите fail2ban вместе с nftables и python3-systemd: они позволяют ему блокировать через nftables и читать журнал systemd. Сервис сразу запускается с конфигурацией по умолчанию.
-
Создайте файл jail.local
Никогда не редактируйте /etc/fail2ban/jail.conf: он заменяется при каждом обновлении. Записывайте свои настройки в /etc/fail2ban/jail.local: срок блокировки, окно наблюдения, число неудачных попыток, адреса, которые нельзя блокировать, и действие nftables.
-
Защитите SSH
Включите jail [sshd] с backend = systemd: в Debian SSH пишет в журнал systemd, а файла /var/log/auth.log часто нет. Если SSH слушает не порт 22, укажите его в port.
-
Добавьте jail для nginx
Если на VPS работает nginx, включите nginx-http-auth для неверных паролей HTTP-аутентификации и nginx-botsearch для ботов, которые ищут страницы администрирования. Оба jail читают /var/log/nginx/error.log.
-
Проверьте и перезапустите
Проверьте синтаксис командой fail2ban-client -t, перезапустите сервис командой systemctl restart fail2ban, затем выведите активные jail командой fail2ban-client status.
-
Проверьте, заблокируйте и разблокируйте адрес
fail2ban-client status sshd показывает число учтённых неудачных попыток и заблокированные адреса. fail2ban-client set sshd unbanip 198.51.100.7 разблокирует адрес, fail2ban-client set sshd banip 198.51.100.7 блокирует его вручную.
Установка в Debian и Ubuntu
apt update
apt install -y fail2ban nftables python3-systemd
systemctl enable --now fail2ban
fail2ban-client version
/etc/fail2ban/jail.local
[DEFAULT]
bantime = 1h
findtime = 10m
maxretry = 5
bantime.increment = true
bantime.maxtime = 1w
ignoreip = 127.0.0.1/8 ::1 203.0.113.10
banaction = nftables-multiport
banaction_allports = nftables-allports
[sshd]
enabled = true
port = ssh
backend = systemd
journalmatch = _SYSTEMD_UNIT=ssh.service + _COMM=sshd + _COMM=sshd-session
maxretry = 4
[nginx-http-auth]
enabled = true
[nginx-botsearch]
enabled = true
Проверка и применение конфигурации
fail2ban-client -t
systemctl restart fail2ban
fail2ban-client status
fail2ban-client status sshd
Блокировка, разблокировка и список адресов
fail2ban-client banned
fail2ban-client set sshd banip 198.51.100.7
fail2ban-client set sshd unbanip 198.51.100.7
fail2ban-client unban 198.51.100.7
nft list table inet f2b-table
Проверка, распознаёт ли фильтр неудачные попытки
fail2ban-regex systemd-journal sshd
fail2ban-regex /var/log/nginx/error.log nginx-botsearch
tail -n 50 /var/log/fail2ban.log
Вариант с UFW
[DEFAULT]
banaction = ufw
banaction_allports = ufw
Перед началом
Подключитесь под root командой ssh root@IP или добавляйте sudo перед каждой командой. Запишите публичный IP-адрес, с которого вы администрируете VPS, и добавьте его в ignoreip: иначе нескольких опечаток в собственном пароле хватит, чтобы заблокировать самого себя.
- Fail2ban дополняет вход по SSH-ключу, но не заменяет его: после установки ключа отключите аутентификацию по паролю (см. « Что нужно защитить перед моим первым развертыванием VPS? »).
- Адреса 203.0.113.10 и 198.51.100.7 в примерах предназначены для документации: замените их своими.
- Если вы заблокировали себя, консоль noVNC в панели ACLClouds работает не через SSH: через неё всегда можно разблокировать свой адрес.
Что означают настройки jail.local
Jail связывает фильтр (выражения, которые распознают неудачную попытку в журнале), источник журналов и действие блокировки. Секция [DEFAULT] задаёт общие значения, каждый jail может их переопределить.
- maxretry, findtime и bantime: здесь 5 неудачных попыток за 10 минут дают блокировку на час; для SSH хватает 4 попыток.
- bantime.increment = true увеличивает срок блокировки при каждом повторном нарушении, вплоть до bantime.maxtime (одна неделя).
- ignoreip принимает адреса и диапазоны через пробел, как IPv4, так и IPv6.
- banaction = nftables-multiport создаёт в nftables таблицу inet f2b-table и закрывает в ней порты jail для заблокированных адресов, как по IPv4, так и по IPv6.
- backend = systemd и journalmatch заставляют jail [sshd] читать журнал systemd, а не файл. Строка journalmatch подходит для Ubuntu и Debian, включая OpenSSH 10 в Debian 13, где сообщения приходят от sshd-session.
Fail2ban с nftables или UFW
Debian 12 и 13 используют nftables. Действие nftables-multiport работает там без дополнительных настроек, даже если установлен UFW: Fail2ban хранит свои правила в собственной таблице. В Ubuntu можно выбрать действие ufw (блок « Вариант с UFW »), чтобы видеть блокировки в ufw status.
Fail2ban блокирует трафик, входящий на сам VPS. Порты, опубликованные Docker, проходят через цепочку FORWARD и обходят эти правила: чтобы защитить сервис в контейнере, используйте banaction = iptables-multiport и добавьте chain = DOCKER-USER в его jail.
Типичные ошибки
У большинства установок, которые « ничего не блокируют », одна из этих причин. Различить их помогает fail2ban-client status sshd: если Total failed остаётся на 0, хотя попытки идут, фильтр читает не тот журнал.
- Правка jail.conf вместо jail.local: изменения пропадут при следующем обновлении пакета.
- Включение jail для nginx, когда nginx не установлен: файла журнала нет, и Fail2ban отказывается запускаться.
- Смена порта SSH без обновления port в [sshd]: адрес блокируется на порту 22, а не на новом.
- Свой адрес не добавлен в ignoreip, и вы блокируете самого себя во время тестов.
- backend = systemd в [DEFAULT]: jail для nginx, которые читают файлы, перестают что-либо видеть.
Быстрая проверка
- systemctl is-active fail2ban отвечает active.
- fail2ban-client status показывает sshd и, если установлен nginx, jail для nginx.
- fail2ban-regex systemd-journal sshd находит совпадающие строки.
- Ваш собственный IP-адрес указан в ignoreip.
- nft list table inet f2b-table показывает заблокированные адреса.
Часто задаваемые вопросы
Fail2ban не запускается и пишет Have not found any log file for sshd jail: что делать?
Jail ищет /var/log/auth.log, которого нет, когда SSH пишет только в журнал systemd, что часто бывает в Debian. Добавьте backend = systemd в секцию [sshd] файла jail.local, установите python3-systemd, затем снова выполните systemctl restart fail2ban.
Как разблокировать IP-адрес в Fail2ban?
Выполните fail2ban-client set sshd unbanip 198.51.100.7, подставив свой jail и адрес, или fail2ban-client unban 198.51.100.7, чтобы снять блокировку во всех jail. Если это ваш собственный адрес и SSH больше не отвечает, войдите через консоль noVNC в панели и выполните команду там.
Как посмотреть заблокированные адреса?
fail2ban-client status sshd показывает число заблокированных адресов и их список для одного jail; fail2ban-client banned выводит их для всех jail. На стороне брандмауэра nft list table inet f2b-table показывает наборы заблокированных адресов.
В Ubuntu 24.04 Fail2ban останавливается с ошибкой No module named 'asynchat': почему?
Первая версия Fail2ban в Ubuntu 24.04 была несовместима с Python 3.12. Исправление уже опубликовано в репозиториях: выполните apt update && apt install --only-upgrade fail2ban, затем systemctl restart fail2ban.
Попытки идут, но Total failed остаётся на 0: что проверить?
Фильтр читает не те сообщения. Проверьте его командой fail2ban-regex systemd-journal sshd: значение в строке Lines: ... matched должно быть больше 0. Если нет, проверьте backend = systemd и строку journalmatch в jail [sshd], затем имя сервиса командой systemctl status ssh.
Достаточно ли Fail2ban для защиты VPS?
Нет. Он снижает шум от атак перебором и разгружает журналы, но SSH-ключ, отключённый вход по паролю, брандмауэр, пропускающий только нужные порты, и регулярные обновления остаются обязательными.