ACLClouds
ACLClouds

Как установить и настроить 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, а затем показано, как проверить, заблокировать и разблокировать адрес.

Пошаговая инструкция

  1. Установите Fail2ban

    Обновите список пакетов, затем установите fail2ban вместе с nftables и python3-systemd: они позволяют ему блокировать через nftables и читать журнал systemd. Сервис сразу запускается с конфигурацией по умолчанию.

  2. Создайте файл jail.local

    Никогда не редактируйте /etc/fail2ban/jail.conf: он заменяется при каждом обновлении. Записывайте свои настройки в /etc/fail2ban/jail.local: срок блокировки, окно наблюдения, число неудачных попыток, адреса, которые нельзя блокировать, и действие nftables.

  3. Защитите SSH

    Включите jail [sshd] с backend = systemd: в Debian SSH пишет в журнал systemd, а файла /var/log/auth.log часто нет. Если SSH слушает не порт 22, укажите его в port.

  4. Добавьте jail для nginx

    Если на VPS работает nginx, включите nginx-http-auth для неверных паролей HTTP-аутентификации и nginx-botsearch для ботов, которые ищут страницы администрирования. Оба jail читают /var/log/nginx/error.log.

  5. Проверьте и перезапустите

    Проверьте синтаксис командой fail2ban-client -t, перезапустите сервис командой systemctl restart fail2ban, затем выведите активные jail командой fail2ban-client status.

  6. Проверьте, заблокируйте и разблокируйте адрес

    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-ключ, отключённый вход по паролю, брандмауэр, пропускающий только нужные порты, и регулярные обновления остаются обязательными.