Fail2ban nginx настройка: связка с CrowdSec

Fail2ban и CrowdSec для nginx - схема защиты
Быстрый ответ
Fail2ban nginx настройка сводится к четырём действиям. Ставишь fail2ban 1.1.1, добавляешь свои джейлы под WordPress, проверяешь фильтры через fail2ban-regex. Потом ставишь CrowdSec 1.8.2 с коллекцией nginx и firewall-bouncer. Баны с обоих инструментов выносишь на периметр, в нашем случае на Микротик, в address-list. Дальше следишь, чтобы локальные и сетевые списки не расползались.

Fail2ban nginx настройка обычно заканчивается одинаково: джейл запущен, баны идут, а боты лезут. Потому что дефолтный конфиг закрывает ssh, а про wp-login.php молчит.

Знакомая картина. Ставишь fail2ban, он честно банит двести адресов в сутки. На следующий день те же двести приходят снова, половина уже из другой подсети. Мельница на месте, IP динамический.

Дальше вторая серия. Кто-то советует CrowdSec. Ставишь, он живёт рядом с fail2ban, оба пишут в логи, оба что-то банят. Через месяц на руках три списка блокировок, и никто не помнит, какой из них главный. Однажды ты попадаешь в один из них и узнаёшь об этом от клиента.

Статья про то, как поставить оба, связать их между собой и не превратить защиту в отдельный проект на полторы недели. Спойлер: полторы недели уходят не на установку.

Что ты получишь на выходе

Рабочую схему из двух уровней. Fail2ban закрывает точечные сервисные паттерны, где всё понятно: пять неудачных POST в wp-login.php с одного адреса — бан. CrowdSec добавляет поведенческий анализ и, что важнее, общую репутацию адресов: если этот IP долбит чужой сервер в Германии, ты узнаешь об этом раньше, чем он дойдёт до тебя.

Плюс единую точку исполнения банов на периметре. Не три локальных списка на трёх машинах, а один address-list на роутере, куда пишут оба инструмента.

Времени уйдёт от двух часов, если сервер один и логи уже настроены. Если nginx стоит за прокси и надо вытаскивать реальный IP клиента из X-Forwarded-For, добавь ещё час. Это самый частый затык, кстати.

Что понадобится:

  • root или sudo на сервере с nginx
  • работающий доступ к логам nginx по чтению
  • понимание, стоит ли nginx за прокси и в каком заголовке приходит реальный IP
  • доступ к роутеру или периметру, если хочешь выносить баны наружу
  • полчаса на тесты, чтобы не забанить себя

Содержание статьи

  • почему типовой конфиг не защищает
  • свои фильтры fail2ban под WordPress
  • реальный IP за прокси
  • установка и связка с CrowdSec
  • вынос банов на Микротик
  • проверка, разбор ошибок, профилактика

Системные требования

Компонент Версия на момент публикации Что проверено в этой статье
Debian 12 bookworm основная платформа, команды под apt
nginx 1.22.1 из репозитория Debian, upstream stable 1.28.3, mainline 1.31.8 1.22.1 в бою на WordPress-хосте
fail2ban 1.1.1 в upstream, 1.0.2 в репозитории Debian 12 работает 1.0.2 с шестью своими джейлами
CrowdSec v1.8.2 установка, collections, firewall-bouncer
fail2ban-ui v1.6.1, образ swissmakers/fail2ban-ui веб-морда для джейлов, если не любишь консоль

На момент публикации актуальны fail2ban 1.1.1, CrowdSec v1.8.2 и nginx stable 1.28.3. Перед установкой проверь свежие релизы: в fail2ban за последние мажоры менялся синтаксис фильтров, а в CrowdSec регулярно добавляются коллекции.

Порты и что куда смотрит

Порт Протокол Назначение Наружу?
80 TCP nginx plain, редирект на https да
443 TCP nginx, сайт да
8080 TCP Local API CrowdSec, слушает только 127.0.0.1 нет
22 TCP sshd, отдельный джейл fail2ban по ключам, с ограничением
443 TCP REST API Микротика, если баны выносятся на роутер только из LAN

Порт 8080 у CrowdSec — это LAPI. Bouncer ходит туда за решениями, поэтому наружу его не открывают никогда. Если увидел проброс 8080 в интернет, считай, что у тебя открытая раздача решений.

Как это работает в сборе

Блок-схема: Бот стучится, nginx пишет лог, fail2ban: regex, CrowdSec: сценарии, Решение о бане, Локальный бан
Как это работает в сборе

Ключевая мысль схемы: инструментов два, а решение одно. Оба пишут в один список на периметре, и именно периметр решает, кого дропать.

1. ДИАГНОЗ

Типовой сервер с nginx и WordPress выглядит так: fail2ban установлен из репозитория, включён один джейл sshd, в журнале красуются пять строк про успешный запуск. Дальше тишина.

При этом в access.log идёт ровная линия: сто запросов в минуту к wp-login.php, двести к xmlrpc.php, отдельным потоком попытки прочитать .env и wp-config.php.bak. Всё это пишется в лог и никем не читается, потому что fail2ban про эти файлы ничего не знает.

Дальше вариантов два. Либо ты живёшь с этим, либо добавляешь джейлы. И вот тут выясняется, что дефолтные фильтры nginx из коробки ловят не то, что нужно: nginx-http-auth реагирует на basic auth, которого у тебя нет, а nginx-botsearch ищет запросы к несуществующим путям и пропускает легитимный на вид POST к wp-login.php.

На выходе — связка, которая банит ботов на периметре, не трогает живых людей и не требует ежедневного разбора. Ниже конкретные шаги и места, где обычно всё ломается.

2. ПОЧЕМУ НЕ РАБОТАЕТ

Шесть причин. Все встречены в жизни, порядок примерно по частоте.

Дефолтные джейлы не знают про приложение

fail2ban — это конструктор. Он не понимает, что такое WordPress, потому что WordPress — это набор PHP-скриптов за nginx. Без твоего фильтра он видит просто POST на /wp-login.php и не знает, успешный он или нет.

Почему ломает: боты долбят именно приложение, а не сервер. Сервер отвечает 200 на страницу логина, и для fail2ban всё хорошо.

Фильтр не матчит реальные строки лога

Классика. Конфиг фильтра скопирован из статьи, у которой другой формат лога. У тебя в access.log combined, в фильтре ожидается нечто иное, и regex не срабатывает ни разу.

Почему ломает: джейл формально работает, статус active, банов ноль. Самое коварное состояние, потому что выглядит как «всё настроено».

nginx за прокси, а fail2ban банит прокси

У нас сайт стоит за nginx-proxy-manager, а он сам за роутером. Реальный IP клиента приходит в X-Forwarded-For, а в логе nginx пишет адрес прокси. Fail2ban читает лог честно и банит прокси.

Почему ломает: ты банишь свой же балансировщик, сайт ложится целиком, и понять причину без чтения iptables невозможно.

Бан живёт только на одном сервере

fail2ban банит локально через iptables или nftables. Адрес остаётся ходить на остальные сервисы и на другие порты.

Почему ломает: бот получает отказ на 443 и спокойно идёт на 22, на почтовый порт и на VPN.

Два инструмента, два списка, ноль согласования

fail2ban пишет в iptables, CrowdSec пишет в свою базу и в свой bouncer. Пересечения нет, дедупликации нет, сроки банов разные.

Почему ломает: адрес, забаненный на час одним инструментом, через час снова свободен, потому что второй считает его безопасным. Разбираться в этом можно, но не хочется.

Баны не переживают перезагрузку

У fail2ban есть dbfile, который по умолчанию лежит в /var/lib/fail2ban/fail2ban.sqlite3. У CrowdSec своя база в /var/lib/crowdsec/data. Обе живут в файловой системе, и обе можно случайно снести при переустановке.

Почему ломает: после обновления пакета список банов обнуляется, и первая же атака проходит по чистому листу.

Что делать с распределённой атакой

Отдельный разговор, потому что тут ломаются обе системы сразу.

Схема простая. Берётся пул из нескольких тысяч адресов, и с каждого делается по одному запросу. Порог maxretry не достигается ни на одном адресе, потому что каждый приходит один раз. CrowdSec видит то же самое: поведение размазано по адресам и не складывается в сценарий.

Что помогает на практике. Ограничение частоты на уровне nginx, потому что оно режет по скорости, а не по адресу. Общий список репутации, который CrowdSec подтягивает из Central API: там адреса из таких пулов появляются раньше, чем ты успеваешь их заметить. И захват подсети вместо отдельного адреса прямо в фильтре.


# /etc/fail2ban/filter.d/nginx-wp-login-subnet.local
[Definition]
# захватываем не адрес, а подсеть /24 целиком
failregex = ^(?P<ip>\d+\.\d+\.\d+)\.\d+ - .*"POST /wp-login\.php.*" (200|302)

Fail2ban банит ровно то, что попало в именованную группу ip. Захватил три октета вместо четырёх — получил бан на всю подсеть. Тридцать попыток с одной подсети за десять минут это уже не человек и не поисковый бот.

Полностью распределённую атаку домашними средствами не выиграть. Но снизить её до уровня, при котором сайт жив, а ты спишь, вполне реально.

3. РЕЦЕПТ

Подготовка: зависимости и проверка среды

Начни с того, что вообще есть на сервере. Пять команд, тридцать секунд.


nginx -v
fail2ban-client --version
systemctl is-active fail2ban
curl -s ifconfig.me
ls -la /var/log/nginx/

Последняя команда важнее остальных. Нужно точно знать, какие файлы существуют и обновляются. Если access.log пустой или ротируется каждый час, фильтр придётся настраивать иначе.

Определи, стоит ли nginx за прокси. Признак простой: посмотри адреса в access.log. Если там один и тот же адрес для всех запросов, а сайт посещают разные люди, значит это прокси.


awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -5

Результат: если в топе один адрес с тысячами запросов, а рядом десятки адресов с единицами, ты за прокси и видишь его адрес. Это ещё не проблема, просто надо помнить при настройке.

Не бань себя
Перед первым запуском джейла внеси свои адреса и адреса мониторинга в ignoreip. Иначе первый же тест на себе закончится звонком от коллег.

Шаг 1. Базовая защита ssh

Делаем это первым, потому что ssh — единственная точка, потеря которой означает поездку в дата-центр. Файл jail.local перекрывает jail.conf и переживает обновления пакета.


cat > /etc/fail2ban/jail.local <<'EOF'
[DEFAULT]
ignoreip = 127.0.0.1/8 ::1 192.168.168.0/24
bantime  = 1h
findtime = 10m
maxretry = 5
backend  = systemd

[sshd]
enabled = true
port    = ssh
maxretry = 3
bantime  = 24h
EOF

systemctl restart fail2ban
fail2ban-client status

Должно быть так: в списке джейлов появился sshd, а fail2ban-client status показывает его активным. Джейл не поднялся - смотри journalctl -u fail2ban и читай причину, а не перезапускай по кругу.

Шаг 2. Свой фильтр под wp-login

Теперь главное. Бот, который долбит wp-login.php, отдаёт ровно один признак: он получает 200 и идёт снова. Признак для фильтра - серия POST на один адрес с одного IP.

Прежде чем писать фильтр, посмотри реальные строки. Не выдумывай формат, а возьми его из лога.


grep -E "POST /wp-login.php" /var/log/nginx/access.log | tail -5

Результат: увидишь точный формат строки. Дальше фильтр под этот формат, а не под формат из чужой статьи.


# /etc/fail2ban/filter.d/nginx-wp-login.local
[Definition]
failregex = ^<HOST> - .*"(POST|GET) /wp-login\.php.*" (200|302) 
            ^<HOST> - .*"(POST|GET) /xmlrpc\.php.*" 200 
ignoreregex =

Обрати внимание на пробел в конце failregex перед переводом строки. В fail2ban многострочные регулярки склеиваются, и без пробела вторая строка приклеится к первой, получится мусор. Это ровно та мелочь, на которую уходит вечер.

Критично: проверь фильтр до включения
Не включай джейл, пока не проверишь фильтр на живом логе. Ниже команда, которая покажет, сколько строк матчится и какие именно. Если ноль совпадений, джейл бесполезен.

fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/nginx-wp-login.local

Результат: в конце отчёта строка Lines: и число matched. Ноль совпадений означает, что regex не подходит. Пять тысяч совпадений на два IP означают, что фильтр слишком широкий и забанит живых.

Шаг 3. Джейлы под WordPress

Теперь включаем фильтры. Отдельный файл на джейл, как принято в Debian: так проще откатывать и видно, что твоё, а что из пакета.


# /etc/fail2ban/jail.d/wp-login-error.local
[nginx-wp-login]
enabled  = true
filter   = nginx-wp-login
logpath  = /var/log/nginx/access.log
maxretry = 10
findtime = 5m
bantime  = 4h
action   = iptables-multiport[name=wp-login, port="http,https"]

# /etc/fail2ban/jail.d/nginx-xmlrpc-attack.local
[nginx-xmlrpc]
enabled  = true
filter   = nginx-xmlrpc
logpath  = /var/log/nginx/access.log
maxretry = 5
findtime = 5m
bantime  = 24h

Порог в 10 попыток за 5 минут выбран не случайно. Человек может ошибиться паролем трижды. Бот не ошибается, он перебирает, и на десятый запрос его видно отчётливо.

Проверь, что джейлы поднялись и что баны идут.


systemctl reload fail2ban
fail2ban-client status
fail2ban-client status nginx-wp-login

Смотри второй вывод: строки Banned IP list и Banned IP list total. Список пуст через час после включения на живом сайте - фильтр слишком узкий.

Шаг 4. Реальный IP за прокси

Этот шаг пропускают чаще всего, а потом удивляются, откуда бан на адрес балансировщика. Решение в двух местах: nginx должен писать реальный IP в лог, fail2ban должен его оттуда читать.


# /etc/nginx/conf.d/realip.conf
set_real_ip_from 192.168.168.0/24;
set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;
real_ip_recursive on;

nginx -t && systemctl reload nginx
awk '{print $1}' /var/log/nginx/access.log | sort | uniq -c | sort -rn | head -5

Должно измениться: в топе больше нет одного и того же прокси, пошли разные адреса клиентов. Только после этого включай джейлы WordPress, иначе первые же баны уйдут не туда.

Порядок важен
Сначала реальный IP в логе, потом джейлы. Если сделать наоборот, fail2ban успеет забанить прокси и уронит сайт целиком.

Шаг 5. CrowdSec рядом с fail2ban

CrowdSec решает другую задачу. Он смотрит не на отдельные запросы, а на поведение: сколько разных URL перебрал один адрес, как быстро, с какими кодами ответа. Плюс получает общую репутацию из Central API: если адрес уже замечен на чужих серверах, он приходит с готовым ярлыком.

Ставим из официального репозитория. Скрипт добавляет источник пакетов, дальше обычный apt.


curl -s https://install.crowdsec.net | sudo sh
apt update && apt install -y crowdsec
cscli version

Результат: cscli version печатает версию движка. Дальше ставим коллекцию для nginx. Коллекция - это набор парсеров и сценариев, то есть описание того, что считать атакой.


cscli collections install crowdsecurity/nginx
cscli collections list
cscli parsers list | head -20

Результат: в списке коллекций появилась crowdsecurity/nginx. Она тянет за собой парсеры для access и error логов и набор сценариев, включая обход директорий и перебор логина.

Шаг 6. Скажи CrowdSec, где логи

По умолчанию он смотрит в стандартные пути, но если логи лежат не там или в контейнере, нужен acquis. Это файл, где перечислены источники и их тип.


# /etc/crowdsec/acquis.yaml
filenames:
  - /var/log/nginx/access.log
  - /var/log/nginx/error.log
labels:
  type: nginx

systemctl restart crowdsec
cscli metrics

Результат: в cscli metrics появится таблица Acquisition Metrics с ростом строк. Если счётчик стоит на нуле, CrowdSec не видит файл: проверь права и путь.

Шаг 7. Bouncer: кто применяет решения

Движок CrowdSec только принимает решения. Применяет их bouncer. Вариантов два, и выбор простой.

Bouncer Как работает Когда выбирать
firewall-bouncer пишет правила в nftables или iptables по умолчанию, ставится в одну команду, банит всё
nginx-bouncer Lua-модуль внутри nginx, отдаёт 403 до PHP когда нужно банить только HTTP, а не весь трафик

Мы берём firewall-bouncer. Причина простая: он не требует Lua-модуля и банит адрес целиком, включая ssh и почту. Для сервера, который ещё и почту возит, это важнее гибкости.


apt install -y crowdsec-firewall-bouncer-iptables
systemctl status crowdsec-firewall-bouncer --no-pager | head -5
cscli bouncers list

Результат: cscli bouncers list показывает зарегистрированный bouncer с валидным ключом. Если список пуст, bouncer не смог подключиться к LAPI, смотри его журнал.

Если всё же нужен nginx-bouncer, добавь Lua-модуль. На Debian 12 он ставится отдельным пакетом и требует перезагрузки nginx, а не reload.


apt install -y libnginx-mod-http-lua
# в /etc/nginx/nginx.conf, внутри блока http:
# lua_shared_dict crowdsec_cache 50m;
# lua_package_path "/usr/share/lua/5.1/?.lua;;";
nginx -t && systemctl restart nginx

Результат: nginx запускается с новым модулем. Не перепутай reload и restart: после добавления dynamic-модуля reload не подхватит его, нужен полный перезапуск.

Шаг 8. Свои пороги под сайт

Дефолтные сценарии CrowdSec рассчитаны на средний сайт. У нас WordPress с REST API и админкой, поэтому тюнинг обязателен. Основное правило: не банить то, что делает живой редактор в админке.


cscli decisions list
cscli alerts list
cscli metrics show scenarios

Результат: cscli alerts list покажет, что именно сработало. Читай причины, а не только адреса. Если в топе сценарий про много 404 от одного адреса и это поисковый бот, его надо в белый список, а не в бан.


cscli parsers install crowdsecurity/whitelists
# затем в /etc/crowdsec/parsers/s02-enrich/whitelists.yaml
# добавить свои подсети и адреса мониторинга
systemctl reload crowdsec

Результат: свои адреса не попадают в решения. Проверяется командой cscli decisions list после попытки создать условие для бана.

Шаг 9. Баны на периметр

Локальный бан защищает один сервер. Чтобы адрес перестал ходить ко всем сервисам сразу, решение надо вынести на роутер. У нас периметр - Микротик, и оба инструмента пишут в его address-list.

Формально это выглядит так: fail2ban вызывает скрипт, который добавляет адрес в список fail2ban-permanent. CrowdSec отдельным скриптом забирает свои решения через cscli и заливает в crowdsec-direct. Роутер дропает всё, что попало в эти списки.

Диаграмма последовательности: Бот, nginx, fail2ban, CrowdSec, Микротик, Bot as Бот
Шаг 9. Баны на периметр

Файл действий для fail2ban, который ходит на роутер. Ключ и пользователь - заранее заведённый отдельный аккаунт с правами на запись правил и ничем больше.


# /etc/fail2ban/action.d/mikrotik.conf
[Definition]
actionstart =
actionstop  =
actioncheck =
actionban   = ssh -i /root/.ssh/f2b_router f2b@192.168.168.1 "/ip firewall address-list add list=fail2ban-permanent address=<ip> timeout=1d comment=managed"
actionunban = ssh -i /root/.ssh/f2b_router f2b@192.168.168.1 "/ip firewall address-list remove [find address=<ip> and list=fail2ban-permanent]"

Не перепутай кавычки и угловые скобки. fail2ban подставляет адрес вместо <ip>, и если кавычки не закрыты, ssh молча съест часть команды. Проверяй на одном адресе руками, а потом включай в джейл.

Критично: считай список
Список fail2ban-permanent растёт и никогда не уменьшается сам. Снимай бэкап перед чисткой, удаляй записи только по таймауту и следи за количеством. Девять сотен записей в списке на слабом роутере заметно бьют по производительности.

Шаг 10. Логи в JSON для обоих инструментов

Необязательный шаг, но он экономит часы потом. Текстовый лог можно парсить регуляркой, а можно отдавать готовую структуру. Второе надёжнее: формат не поедет от смены настроек логирования.


# /etc/nginx/nginx.conf, внутри блока http
log_format json_combined escape=json
  '{"time":"$time_iso8601",'
  '"remote_addr":"$remote_addr",'
  '"request":"$request",'
  '"status":$status,'
  '"bytes":$body_bytes_sent,'
  '"referer":"$http_referer",'
  '"ua":"$http_user_agent",'
  '"req_time":$request_time}';

access_log /var/log/nginx/access.log json_combined;

nginx -t && systemctl reload nginx
tail -1 /var/log/nginx/access.log | python3 -m json.tool
cscli metrics | head -12

Результат: строка лога разбирается как JSON. CrowdSec понимает такой формат через парсер crowdsecurity/nginx, а fail2ban получает стабильные поля. Регулярка перестаёт зависеть от порядка частей в строке.

Дальше адрес в failregex привязывается к имени поля, а не к позиции. Это заметно снижает шанс получить джейл, который молча ничего не банит.

Шаг 11. Согласование двух инструментов

Тут заканчивается установка и начинается инженерия. Два инструмента независимо принимают решения про одни и те же адреса, и без правил они мешают друг другу.

Правило Зачем
Один список на периметре для обоих иначе два списка расходятся и никто не знает, какой главный
fail2ban отвечает за сервисные паттерны wp-login, xmlrpc, ssh - тут точность важнее охвата
CrowdSec отвечает за поведение и репутацию перебор, сканирование, адреса из общего списка
Общий ignoreip и общий белый список свой адрес не должен баниться ни одним инструментом
Разные сроки по умолчанию 4 часа за сервис, 24 часа за поведение, неделя за повтор

Если правила не завести, получится ровно то, с чего статья началась: два инструмента, три списка, ноль понимания.

Пороги: откуда берутся числа

Числа в конфигах не берутся из воздуха. Их считают от реального трафика, и вот как это делается за десять минут.

Сначала посмотри, сколько запросов к защищаемому адресу делает нормальный пользователь. Для wp-login это один-три запроса на успешный вход. Потом посмотри, сколько делает бот: там счёт идёт на сотни. Порог ставится между этими двумя величинами, ближе к боту, чтобы не задеть человека, который забыл пароль.


grep "POST /wp-login.php" /var/log/nginx/access.log \
 | awk '{print $1}' | sort | uniq -c | sort -rn | head -10

Результат: увидишь распределение. Адреса с одним-двумя запросами это люди. С десятками и сотнями это боты. Порог maxretry ставь выше человеческого максимума и ниже ботового минимума.

Что защищаем maxretry findtime bantime Почему так
sshd 3 10m 24h человек не ошибается ключом трижды подряд
wp-login 10 5m 4h редактор может забыть пароль, бот не остановится
xmlrpc 5 5m 24h легитимных обращений почти нет, порог держим низким
Обход директорий 20 10m 24h много ложных от сканеров уязвимостей и своих проверок
Поведение в CrowdSec сценарий сценарий 24h пороги заданы в коллекции, правятся через cscli
Повторный бан 1 7d 168h адрес, вернувшийся после бана, второй раз не исправится
Белый список - - - свои адреса и поисковые боты вне правил

Семь строк, и по каждой видно, откуда взялось число. Через месяц сможешь объяснить, почему порог именно такой, а не перезапустить и посмотреть.

Пересматривать пороги стоит после каждого крупного изменения на сайте. Появился REST API или форма комментариев, и часть запросов к защищённым адресам стала легитимной. Старый порог начнёт банить живых.

4. ПРОВЕРКА

Проверять надо все четыре уровня: фильтр, джейл, движок CrowdSec и периметр. Иначе не поймёшь, где именно не работает.


# 1. фильтр матчит лог
fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/nginx-wp-login.local | tail -5

# 2. джейл активен и что-то банит
fail2ban-client status
fail2ban-client status nginx-wp-login

# 3. что придумал CrowdSec
cscli metrics
cscli decisions list
cscli alerts list | head -20

# 4. bouncer жив
cscli bouncers list
systemctl is-active crowdsec-firewall-bouncer

# 5. список на периметре
ssh f2b@192.168.168.1 "/ip firewall address-list print where list=fail2ban-permanent count-only"
ssh f2b@192.168.168.1 "/ip firewall address-list print where list=crowdsec-direct"

Результат: фильтр показывает ненулевое число совпадений, джейл активен, в cscli alerts есть свежие события, bouncer active, а на роутере списки растут. Все пять пунктов должны быть зелёными одновременно.

Тест на живом бане. Возьми адрес, который не жалко, и проверь, что он реально появляется в списке и реально не проходит.


fail2ban-client set nginx-wp-login banip 203.0.113.10
fail2ban-client status nginx-wp-login
iptables -L -n | grep 203.0.113.10
ssh f2b@192.168.168.1 "/ip firewall address-list print where address=203.0.113.10"
fail2ban-client set nginx-wp-login unbanip 203.0.113.10

203.0.113.10 - адрес из диапазона документации, его нет в интернете. Тест безопасный: даже если бан не снимется, вреда нет.

5. ОСЛОЖНЕНИЯ

Семь ситуаций. Формат один: ошибка, причина, решение, команда.

Jail failed to start: logpath does not exist

Причина: в джейле указан путь, которого нет. Часто из-за ротации или работы nginx в контейнере.

Решение: проверь путь и права. Fail2ban читает лог от root, но если лог в контейнере, его надо вынести на хост.


ls -la /var/log/nginx/access.log
journalctl -u fail2ban -n 30 --no-pager | grep -i "logpath\|error"

Джейл активен, банов ноль

Причина: regex не матчит строки. Почти всегда из-за неверного формата лога или пробела в регулярке.

Решение: прогони fail2ban-regex и посмотри на число совпадений. Ноль - переписывай фильтр по реальной строке из лога.


fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/nginx-wp-login.local

Забанил сам себя

Причина: не заполнен ignoreip, либо nginx за прокси и банится адрес прокси.

Решение: снять бан и добавить свои адреса. Снимать придётся с консоли, потому что сайт уже недоступен.


fail2ban-client unban --all
fail2ban-client set sshd unbanip 192.168.168.10
grep ignoreip /etc/fail2ban/jail.local

CrowdSec не видит логи

Причина: неправильный acquis или нет прав на файл. Метрики покажут ноль строк.

Решение: проверь источник в metrics и права на файл.


cscli metrics | head -20
systemctl status crowdsec --no-pager | head -10
ls -la /var/log/nginx/access.log

Bouncer зарегистрирован, но не банит

Причина: bouncer не может достучаться до LAPI, или решения есть, а он их не забирает.

Решение: смотри журнал bouncer и проверь, что LAPI слушает на localhost.


journalctl -u crowdsec-firewall-bouncer -n 30 --no-pager
ss -tlnp | grep 8080
cscli decisions list

Список на роутере распух

Причина: баны добавляются с большим timeout или без него. Записи копятся годами.

Решение: всегда указывай timeout в action и периодически чисти список по расписанию.


ssh f2b@192.168.168.1 "/ip firewall address-list remove [find list=fail2ban-permanent and dynamic=no]"

fail2ban-ui не показывает джейлы

Причина: контейнер не видит сокет или конфиг fail2ban внутри контейнера, а не на хосте.

Решение: смонтировать /etc/fail2ban и сокет, и перезапустить контейнер.


docker inspect fail2ban-ui --format '{{json .Mounts}}' | head -c 400
docker restart fail2ban-ui

Как проверить защиту и не сломать сайт

Проверять защиту на живом сайте можно, если делать это аккуратно. Правило одно: сначала на своём адресе или на контуре, потом на боевом.

Начни с безопасного теста. Забань адрес из диапазона документации: он никому не принадлежит, поэтому промахнуться невозможно.


fail2ban-client set nginx-wp-login banip 203.0.113.10
sleep 2
iptables -L -n | grep -c 203.0.113.10
cscli decisions add --ip 203.0.113.11 --duration 1m --reason "manual test"
cscli decisions list | grep 203.0.113
fail2ban-client set nginx-wp-login unbanip 203.0.113.10
cscli decisions delete --ip 203.0.113.11

Результат: оба адреса появились в своих списках, а решение CrowdSec снялось само через минуту. Так проверяется вся цепочка, от команды до применения на периметре.

Тест на живом трафике выглядит иначе. Увеличь чувствительность фильтра до порога в одну попытку и пройди по wp-login с адреса, который не жалко. Через минуту адрес должен оказаться в списке джейла.

Не тестируй на боевом пользователе
Тест с рабочего адреса человека, который в этот момент пишет статью в админке, закончится потерянным черновиком и неприятным разговором. Для теста заведи отдельный адрес или используй контур.

Чего делать не стоит: гонять брутфорс по своему сайту с рабочего адреса. Сработает защита или нет, а адрес окажется в списках, включая общие. Выбираться оттуда будешь не один день.

Что смотреть в логах, когда что-то не так

Три файла и один вопрос по каждому. Этого хватает, чтобы найти причину без перезапуска вслепую.

fail2ban.log

Здесь видно, почему джейл не поднялся и что он забанил. Ищи не только слово error, а строки с названием своего джейла.


tail -50 /var/log/fail2ban.log
grep -E "nginx-wp-login|WARNING|ERROR" /var/log/fail2ban.log | tail -20

Журнал CrowdSec

Здесь видно, читает ли движок логи и срабатывают ли сценарии. Если парсер не находит строк, в журнале будет тишина, а метрики покажут ноль.


journalctl -u crowdsec -n 50 --no-pager | tail -20
cscli metrics show acquisition
cscli metrics show parsers

access.log nginx

Здесь видно исходную картину. Смотри на связку адрес, запрос и код ответа: именно она объясняет, почему фильтр сработал или промолчал.


awk '{print $1, $6, $7, $9}' /var/log/nginx/access.log | tail -30
grep -c " 404 " /var/log/nginx/access.log
grep -c " 403 " /var/log/nginx/access.log

Результат: рост 404 при ровном числе 403 означает перебор путей без бана. Рост 403 означает, что защита уже режет запросы до приложения.

Читать логи надо до того, как что-то сломалось, а не после. Тогда в момент аварии ты сравниваешь с известной картиной, а не угадываешь.

Сколько хранить логи

Две недели это минимум, месяц комфортно. Меньше недели хранить бессмысленно: разбор инцидента занимает больше времени, чем ты думаешь, а логи уже ротировались.


ls -la /etc/logrotate.d/nginx
grep -E "rotate|daily|weekly" /etc/logrotate.d/nginx
du -sh /var/log/nginx/

Результат: увидишь срок хранения и текущий объём. Для сайта, который постоянно долбят боты, месяц логов это обычно от одного до трёх гигабайт.

6. АЛЬТЕРНАТИВЫ

Четыре варианта, и у каждого своё место. Если у тебя нет почты и VPN на том же сервере, выбор может отличаться.

Только fail2ban

Минимальный стек, ноль зависимостей, всё понятно. Хорошо работает против прямолинейного брутфорса. Плохо работает против распределённых атак: тысяча адресов по одному запросу обойдёт любые пороги.

Выбирать, если сервер один и не жалко трафика на перебор.

Только CrowdSec

Один движок, одна база решений, общая репутация. Есть готовые сценарии и общий список. Минус в том, что тонкую настройку под конкретное приложение, как с wp-login, он делает хуже: у fail2ban фильтр под свою регулярку пишется за десять минут.

Выбирать, если хочется меньше движущихся частей.

Ограничение частоты в nginx

limit_req режет по скорости до попадания в приложение. Отлично снимает нагрузку, но не различает бота и человека с плохим интернетом.


limit_req_zone $binary_remote_addr zone=wp:10m rate=5r/s;
location = /wp-login.php {
    limit_req zone=wp burst=5 nodelay;
    include fastcgi_params;
}

Хорошо как первый слой, но не как замена бану.

WAF на ModSecurity с OWASP CRS

Самый мощный вариант и самый дорогой в сопровождении. Ловит SQL-инъекции и XSS на уровне запроса. Требует времени на разбор ложных срабатываний: первые недели ты только и делаешь, что добавляешь исключения.

Мы выбрали связку fail2ban и CrowdSec по одной причине: она даёт восемьдесят процентов результата за два часа и не требует отдельного человека на поддержку.

Антипаттерны

Шесть решений, которые выглядят разумно, а проблемы создают через месяц.

Бан без таймаута

Постоянный бан кажется надёжнее. По факту список растёт до тысяч записей, слабый роутер начинает захлёбываться, а адрес всё равно сменится. Всегда указывай timeout в действии.

Порог в одну попытку

Банить с первого запроса заманчиво. Первыми в бан уходят поисковые боты и люди с мобильным интернетом, который меняет адрес при каждом переподключении.

Два инструмента с одинаковыми правилами

Если fail2ban и CrowdSec ловят одно и то же, ты платишь двойную цену за один результат. Разделяй зоны ответственности: сервисные паттерны одному, поведение другому.

Белый список внутри боевого фильтра

Исключения, дописанные в тот же файл, что и правила, теряются при первом обновлении. Держи белые списки отдельно, в jail.local и в whitelists CrowdSec.

Правка файлов из пакета

Файлы в /etc/fail2ban/filter.d с суффиксом conf принадлежат пакету, и правка затирается при обновлении. Своё пиши в .local, оно перекрывает.

Защита без мониторинга

Джейл, который упал месяц назад, выглядит работающим ровно до первой атаки. Без проверки раз в неделю ты узнаешь об этом от клиента.

Ни один из этих пунктов не ломает систему сразу. Все они срабатывают через месяц, когда ты уже забыл, что и зачем настраивал.

7. ПРОФИЛАКТИКА

Мониторинг

Следить надо за тремя числами: размер списка банов, число активных джейлов, количество свежих алертов. Рост первого без роста второго означает, что периметр чистится, а сервер нет.


cat > /usr/local/bin/security-check.sh <<'EOF'
#!/bin/bash
echo "fail2ban jails: $(fail2ban-client status | grep -c 'Jail list')"
echo "banned total:   $(fail2ban-client status | grep -oE '[0-9]+' | paste -sd+ | bc)"
echo "crowdsec alerts: $(cscli alerts list -o json | grep -c '"id"')"
echo "router list:    $(ssh f2b@192.168.168.1 '/ip firewall address-list print where list=fail2ban-permanent count-only')"
EOF
chmod +x /usr/local/bin/security-check.sh
/usr/local/bin/security-check.sh

Результат: четыре числа, по которым видно состояние защиты без захода в каждый инструмент отдельно.

Резервное копирование

Что Как часто Где
/etc/fail2ban/ целиком перед каждым изменением /root/backups
/etc/crowdsec/ и база /var/lib/crowdsec/data раз в неделю отдельный хост
Экспорт address-list роутера перед чисткой списка роутер и внешний хост
Список белых адресов при каждом изменении git

mkdir -p /root/backups
cp -rp /etc/fail2ban "/root/backups/fail2ban_$(date +%Y-%m-%d_%H-%M-%S)"
tar czf "/root/backups/crowdsec_$(date +%Y-%m-%d).tgz" /etc/crowdsec /var/lib/crowdsec/data

Восстановление: распаковать архив, вернуть каталоги, перезапустить оба сервиса. Баны, накопленные после бэкапа, придётся набрать заново, это нормально.

Автозапуск


systemctl enable fail2ban crowdsec crowdsec-firewall-bouncer
systemctl is-enabled fail2ban crowdsec crowdsec-firewall-bouncer

Результат: три строки enabled. Если хотя бы одна disabled, после перезагрузки сервер останется без защиты, и никто об этом не узнает.

Обновление

Порядок такой: бэкап, обновление, проверка синтаксиса, только потом перезапуск. У fail2ban есть встроенная проверка конфига, ей и пользуйся.


apt update
apt install --only-upgrade fail2ban crowdsec crowdsec-firewall-bouncer
fail2ban-client --test 2>&1 | tail -5
systemctl restart fail2ban crowdsec crowdsec-firewall-bouncer
cscli metrics | head -10

Откат: вернуть каталоги из бэкапа, перезапустить сервисы. Если обновление поменяло синтаксис фильтров, fail2ban-client --test покажет это до перезапуска, а не после.

Порядок обновления
Бэкап, обновление, fail2ban-client —test, перезапуск, cscli metrics. Пять шагов, три минуты, и никаких сюрпризов после обновления пакета.

8. FAQ

Почему fail2ban не банит после настройки?

Три причины по частоте: фильтр не матчит строки лога, в джейле неверный logpath, либо nginx пишет адрес прокси вместо реального клиента. Проверяется одной командой fail2ban-regex по живому логу. Если совпадений ноль, дело в регулярке, а не в fail2ban.

Как проверить, что fail2ban и CrowdSec работают правильно?

Четыре проверки подряд: fail2ban-client status показывает активные джейлы, fail2ban-client status по конкретному джейлу показывает число банов, cscli alerts list выдаёт свежие события, cscli bouncers list показывает подключённый bouncer. Если все четыре отвечают, связка работает.

Что делать, если fail2ban забанил мой адрес?

Снимать с консоли, потому что сайт уже недоступен. Команда fail2ban-client unban с конкретным адресом или unban --all целиком. После этого добавить свой адрес и подсеть мониторинга в ignoreip в файле jail.local, иначе повтор через неделю.

Чем CrowdSec отличается от fail2ban?

fail2ban разбирает логи регулярками: нашёл совпадение, забанил. CrowdSec смотрит на поведение и на общую репутацию адресов через Central API. Проще говоря, fail2ban знает, что именно случилось на твоём сервере, а CrowdSec знает, что этот адрес уже отметился у других.

Нужны ли оба инструмента одновременно?

Не всегда. Если сервер один и трафик небольшой, хватит fail2ban с грамотными фильтрами. CrowdSec становится нужен, когда адреса меняются быстрее, чем ты успеваешь править пороги, или когда сервисов несколько и хочется один общий список банов.

Можно ли банить на роутере, а не на сервере?

Да, и это правильнее: адрес перестаёт ходить ко всем сервисам сразу, а не только к тому, который его заметил. У Микротика официального bouncer для CrowdSec нет, поэтому решение забирают скриптом через cscli и заливают в address-list. Fail2ban умеет то же самое через своё действие action.

Сколько записей в списке банов считается нормой?

Рабочий диапазон для домашней и небольшой корпоративной сети - от нескольких десятков до нескольких сотен адресов. Тысячи записей означают, что пороги слишком мягкие либо баны накапливаются без таймаута. Проверяй размер списка раз в неделю.

Ломает ли защита поисковых ботов?

Может, если не добавить их в белый список. Яндекс и Google ходят с большим числом запросов и иногда получают 404 на несуществующие страницы, что похоже на сканирование. Добавь их диапазоны в whitelists CrowdSec и в ignoreip fail2ban до включения джейлов.

Можно ли обойтись без выноса банов на роутер?

Да, если сервер один. Локального бана хватает, чтобы закрыть конкретный сервис. Вынос на периметр нужен, когда сервисов несколько и один адрес ходит по всем. Тогда бан на входе дешевле трёх независимых банов внутри.

Что будет, если забанить себя через мобильный интернет?

Оператор выдаёт адрес из большого пула, и он меняется при переподключении. Скорее всего, ты выйдешь из бана сам. Но если попал в список на роутере с длинным таймаутом, придётся ждать либо снимать вручную с консоли.

Как часто пересматривать настройки защиты?

Раз в квартал и после каждого крупного изменения на сайте. Меняется структура запросов, добавляются плагины, приходят новые боты. Пороги под прошлогодний трафик либо перестают ловить, либо начинают банить живых.

Почему CrowdSec не банит, хотя алерты есть?

Алерт это решение движка, а применяет его bouncer. Если алерты есть, а банов нет, смотри cscli bouncers list и журнал bouncer. Чаще всего он не смог подключиться к LAPI на порту 8080 или потерял ключ после переустановки.

Мешает ли fail2ban работе CrowdSec?

Нет, если разделить зоны ответственности. Проблема появляется, когда оба правят один и тот же список на периметре без общего правила. Тогда адрес, снятый одним инструментом, остаётся в списке второго, и разбираться придётся вручную.

Нужен ли fail2ban, если уже стоит CrowdSec?

По желанию. CrowdSec закрывает поведение и репутацию, но точечные сервисные правила быстрее пишутся в fail2ban: фильтр под конкретный лог занимает десять минут. Если сервис один и паттерны простые, можно оставить только fail2ban.

Сработает ли защита, если nginx стоит в контейнере?

Сработает, но оба инструмента должны видеть логи контейнера. Проще всего смонтировать каталог с логами внутрь или настроить отправку на хост. Если контейнер пишет только в docker logs, ни fail2ban, ни CrowdSec их не увидят без промежуточного сборщика.

Что делать, если адрес клиента динамический?

Добавляй в белый список не адрес, а подсеть провайдера, если она известна. Иначе каждое переподключение будет давать новый повод для бана. С мобильными операторами это особенно неприятно: пул большой, попасть под фильтр легко.

Нужны ли отдельные правила для REST API WordPress?

Да, если им пользуется n8n или внешние интеграции. REST API делает много запросов с одного адреса, и мягкий порог начнёт банить своего же робота. Внеси адрес интеграции в белый список до включения джейлов на обход директорий.

Можно ли банить по геолокации?

Технически да, но осторожно. Если сайт работает только по России, отсечение чужих подсетей снимает заметную часть фонового шума. Ошибка стоит дорого: поисковые боты и корпоративные прокси приходят откуда угодно, и вместе с ботами отрежешь живых читателей.

9. ПРОГНОЗ

Мы собрали два уровня защиты и одну точку исполнения. Fail2ban закрывает сервисные паттерны: перебор wp-login, долбёжку xmlrpc, попытки ssh. CrowdSec добавляет поведение и общую репутацию адресов, то есть ловит то, что регуляркой не опишешь. Оба пишут решения в список на периметре, и роутер дропает адрес целиком, для всех сервисов сразу.

Что теперь работает: боты получают отказ на входе, а не на десятом запросе к PHP. Списки банов не расходятся по трём машинам. Пороги настроены под живой сайт, а не под абстрактный средний трафик. И у тебя есть четыре числа, по которым состояние защиты видно за пять секунд.

Не заработало?
Если джейл активен, а банов нет, или наоборот банит своих — пиши в комментарии. Кинь вывод fail2ban-regex и cscli alerts list, разберёмся. В девяноста случаях из ста дело в одной строке.

Ссылки и источники

Anton Kos
Author: Anton Kos

Оставайтесь на связи

Рецепты от IT-боли. Без воды, без рекламы, без маркетинговой шелухи.

Подписаться на IT-Аптеку →
Поделитесь:

4 комментария к “Fail2ban nginx настройка: связка с CrowdSec”

  1. Сергей Н.

    застрял на шаге с реальным IP за прокси. nginx пишет адрес прокси, fail2ban банит его. я прописал set_real_ip_from и real_ip_header X-Forwarded-For в nginx, но в логе по-прежнему адрес прокси. что я упускаю? может, дело в том, что используется cloudflare, и там нужен отдельный модуль?

    1. Если перед тобой ещё и Cloudflare, то real_ip_header X-Forwarded-For бесполезен: клиентский адрес там приходит в CF-Connecting-IP, а X-Forwarded-For легко подделать снаружи. Сначала смотри, кто именно ближний хоп. Если сайт стоит за nginx-proxy-manager, real_ip надо настраивать на нём, а не на бэкенд-nginx, и уже оттуда пробрасывать дальше.

      Проверка простая: nginx -T | grep -E ‘real_ip|set_real_ip’ и curl -H ‘X-Forwarded-For: 1.2.3.4’ https://твой-хост/ с внешней машины. Если в access.log появился 1.2.3.4, значит nginx доверяет заголовку от кого угодно, и это дыра.

      Если Cloudflare точно включён, ставь на периметре ngx_http_realip_module, real_ip_header CF-Connecting-IP и списком set_real_ip_from все подсети Cloudflare. Их актуальный перечень берётся из https://www.cloudflare.com/ips-v4, руками в конфиг не вбивай, иначе через месяц подсети поменяются и ты снова увидишь адрес CF.

      В fail2ban после этого ничего менять не надо, он читает лог как есть. Только проверь, что лог не буферизуется: fail2ban-regex /var/log/nginx/access.log ‘твой фильтр’ должен давать матчи на живых строках, а не на пустом списке.

  2. Сергей Н.

    Затык на проверке фильтра через fail2ban-regex. У меня access.log с nginx в combined, а тестовые строки из фильтра дают ноль совпадений. Ощущение, что regex как замок, а ключ не от этой двери. Как понять, где именно ломается сопоставление и какие поля строки реально попадают в regex-группу? Конкретно интересует, почему fail2ban не находит совпадений, если строка визуально совпадает с шаблоном.

    1. Смотри, fail2ban-regex разбирает строку по regex с именованными группами. Если в фильтре есть (?P…), то именно этот кусок идёт в ban. Часто ломается на экранировании: точки, слэши, кавычки в combined отличаются от того, что ты видишь в консоли. Сделай так: fail2ban-regex /var/log/nginx/access.log /etc/fail2ban/filter.d/твой.conf —print-all-matched. Он покажет, какие строки совпали и какие группы захватились. Если совпадений ноль, проверь, что в filter.d нет
      в конце шаблона и что fail2ban читает тот же файл, а не .1.gz после ротации. Ещё момент: в 1.0.2 из Debian 12 синтаксис префикса ignoreip и datepattern чуть иначе, чем в 1.1.1, так что сверь версию. И убедись, что в jail.local указан logpath с точным путём, а не logpath = /var/log/nginx/*.log, иначе ротация может путать. Проверить просто: добавь в фильтр одну строку с точным шаблоном и прогони вручную.

Оставьте комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *

Прокрутить вверх