ModSecurity: WAF для Nginx — установка и настройка

Настройка сервера
ModSecurity: WAF для Nginx — установка и настройка

ModSecurity — это веб-файрвол (WAF), который встраивается в Nginx и фильтрует HTTP-запросы до того, как они дойдут до вашего сайта. Связка ModSecurity + Nginx с набором правил OWASP Core Rule Set закрывает типовые атаки на веб-приложения: SQL-инъекции, XSS, попытки залить веб-шелл, обращения к служебным файлам. В статье пошагово настроим WAF для сайта на VPS с Ubuntu 22.04/24.04: соберём модуль, подключим правила, разберёмся с режимами работы и ложными срабатываниями.

Зачем сайту WAF, если есть файрвол

Обычный сетевой файрвол (UFW, nftables) работает на уровне портов и IP-адресов: он решает, кто вообще может подключиться к порту 443. Но атака на сайт приходит как легитимный HTTPS-запрос на открытый порт — сетевой экран её пропустит. WAF работает уровнем выше: он читает сам HTTP-запрос (URL, параметры, заголовки, тело POST) и отклоняет те, что похожи на атаку.

Правильная архитектура защиты — многослойная: сетевой файрвол ограничивает порты (как это сделать — в статье о настройке firewall UFW), ModSecurity фильтрует HTTP-трафик, а базовые практики из нашего чек-листа безопасности VPS закрывают остальное.

Установка ModSecurity 3 для Nginx

Для Nginx используется ModSecurity версии 3 (libmodsecurity) плюс модуль-коннектор. В Ubuntu 22.04+ и Debian 12 библиотека есть в репозиториях, а коннектор придётся собрать под вашу версию Nginx.

Шаг 1. Ставим Nginx и зависимости

sudo apt update
sudo apt install -y nginx libmodsecurity3 libmodsecurity-dev \
  git build-essential libpcre2-dev zlib1g-dev libssl-dev

# Запоминаем точную версию Nginx — под неё будем собирать модуль
nginx -v

Допустим, вывод показал nginx/1.24.0. Число понадобится на следующем шаге.

Шаг 2. Собираем динамический модуль-коннектор

cd /usr/local/src

# Исходники коннектора
sudo git clone --depth 1 https://github.com/owasp-modsecurity/ModSecurity-nginx.git

# Исходники Nginx ТОЙ ЖЕ версии, что установлена
sudo wget https://nginx.org/download/nginx-1.24.0.tar.gz
sudo tar -xzf nginx-1.24.0.tar.gz
cd nginx-1.24.0

# Собираем только динамический модуль, не сам Nginx
sudo ./configure --with-compat --add-dynamic-module=../ModSecurity-nginx
sudo make modules

# Кладём модуль в стандартный каталог модулей Nginx
sudo cp objs/ngx_http_modsecurity_module.so /usr/lib/nginx/modules/

Флаг --with-compat обеспечивает бинарную совместимость модуля с пакетным Nginx — без него модуль может не загрузиться.

Шаг 3. Подключаем модуль к Nginx

Добавляем строку загрузки в самое начало /etc/nginx/nginx.conf, до блока http:

load_module modules/ngx_http_modsecurity_module.so;

Проверяем конфигурацию:

sudo nginx -t && sudo systemctl reload nginx

Если nginx -t ругается на несовместимость модуля («module is not binary compatible»), значит версии исходников и установленного Nginx не совпали — пересоберите модуль под точную версию.

Подключение правил OWASP Core Rule Set

Сам ModSecurity — только движок. Атаки распознают правила, и стандарт де-факто здесь — OWASP CRS.

# Каталог конфигурации ModSecurity
sudo mkdir -p /etc/nginx/modsec

# Рекомендованный базовый конфиг движка
sudo wget -O /etc/nginx/modsec/modsecurity.conf \
  https://raw.githubusercontent.com/owasp-modsecurity/ModSecurity/v3/master/modsecurity.conf-recommended

# Файл unicode mapping, нужен движку
sudo wget -O /etc/nginx/modsec/unicode.mapping \
  https://raw.githubusercontent.com/owasp-modsecurity/ModSecurity/v3/master/unicode.mapping

# Скачиваем OWASP CRS
cd /etc/nginx/modsec
sudo git clone --depth 1 https://github.com/coreruleset/coreruleset.git
sudo cp coreruleset/crs-setup.conf.example coreruleset/crs-setup.conf

Создаём главный файл, который Nginx будет подключать:

# /etc/nginx/modsec/main.conf
Include /etc/nginx/modsec/modsecurity.conf
Include /etc/nginx/modsec/coreruleset/crs-setup.conf
Include /etc/nginx/modsec/coreruleset/rules/*.conf

И включаем WAF в нужном виртуальном хосте:

# /etc/nginx/sites-available/example.com
server {
    listen 443 ssl;
    server_name example.com;

    modsecurity on;
    modsecurity_rules_file /etc/nginx/modsec/main.conf;

    # ... остальная конфигурация сайта
}

Применяем: sudo nginx -t && sudo systemctl reload nginx.

Режимы работы: DetectionOnly и On

По умолчанию рекомендованный конфиг включает режим наблюдения:

SecRuleEngine DetectionOnly

В этом режиме ModSecurity пишет срабатывания в лог, но ничего не блокирует. Не пропускайте этот этап: включите DetectionOnly на 3–7 дней на живом трафике и просмотрите лог /var/log/modsec_audit.log. Так вы найдёте ложные срабатывания до того, как WAF начнёт резать реальных посетителей.

Когда исключения настроены, переводим движок в боевой режим — правим строку в /etc/nginx/modsec/modsecurity.conf:

SecRuleEngine On

Проверить блокировку можно безопасным тестовым запросом к собственному сайту:

# Классический тестовый паттерн из документации CRS — должен вернуть 403
curl -I "https://example.com/?test=/etc/passwd"

Ответ 403 Forbidden означает, что WAF работает.

Борьба с ложными срабатываниями

Любой WAF иногда блокирует легитимные запросы — особенно у CMS с богатыми редакторами (WordPress, Bitrix), где в POST летит HTML. Типовые решения:

1. Повысить порог аномалии. CRS работает по скорингу: каждое правило добавляет очки, блокировка происходит при превышении порога. В crs-setup.conf:

SecAction "id:900110, phase:1, pass, t:none, nolog, \
  setvar:tx.inbound_anomaly_score_threshold=10"

Порог 5 (по умолчанию) — строго, 10 — мягче, меньше ложных блокировок.

2. Отключить конкретное правило по ID. Найдите ID в audit-логе и добавьте в конец main.conf:

SecRuleRemoveById 941100

3. Исключение для конкретного пути. Гибче — отключить правило только там, где оно мешает:

SecRule REQUEST_URI "@beginsWith /wp-admin/" \
  "id:10001, phase:1, pass, nolog, ctl:ruleRemoveById=941100"

Каждое срабатывание фиксируется в audit-логе с полным контекстом — какой запрос, какое правило, какие очки. Методику разбора таких записей мы описывали в статье об анализе логов сервера.

Что закрывает OWASP CRS

Категория правилЧто блокирует
SQLi (942xxx)SQL-инъекции в параметрах и теле запроса
XSS (941xxx)Внедрение JavaScript в формы и параметры
LFI/RFI (930xxx, 931xxx)Обращения к файлам системы, подключение чужих скриптов
RCE (932xxx)Попытки выполнить команды ОС через параметры
Scanner detection (913xxx)Сигнатуры автоматических сканеров уязвимостей
Protocol (920xxx)Некорректные HTTP-запросы, аномальные заголовки

Важно понимать: WAF — это страховочная сетка, а не замена обновлениям. Дырявый плагин CMS нужно обновлять, даже если CRS блокирует известные векторы его эксплуатации.

Производительность

libmodsecurity 3 с полным набором CRS добавляет единицы миллисекунд к обработке запроса и заметен по CPU только на высоком RPS. Практические советы:

  • включайте modsecurity on только в тех server/location, где он нужен — статику (/images/, /static/) можно исключить;
  • SecResponseBodyAccess Off (по умолчанию в рекомендованном конфиге) — анализ тел ответов почти всегда не нужен и дорог;
  • следите за размером audit-лога и настройте logrotate.

Частые вопросы

ModSecurity 2 или 3 — какую версию ставить для Nginx?

Только третью (libmodsecurity). Вторая версия — это модуль Apache, с Nginx она полноценно не работает. Всё описанное в статье относится к ModSecurity 3 + коннектор ModSecurity-nginx.

Замедлит ли WAF мой сайт?

На типичном сайте с посещаемостью до десятков тысяч визитов в день задержка незаметна — миллисекунды на запрос. При высоком RPS растёт расход CPU, поэтому WAF стоит запускать на VPS с запасом по ядрам и исключать из проверки статику.

Правила CRS нужно обновлять?

Да, набор развивается: добавляются сигнатуры новых техник, чинятся ложные срабатывания. Обновление — это git pull в каталоге coreruleset и systemctl reload nginx. Разумная частота — раз в месяц; перед обновлением просмотрите changelog на предмет изменившихся ID правил, на которые у вас настроены исключения.

Может ли ModSecurity защитить от перебора паролей к админке?

Частично: CRS детектирует сканеры и часть автоматизации. Но против упорного брутфорса логин-форм эффективнее связка WAF с инструментом банов по IP — например, CrowdSec или Fail2ban, которые прочитают лог ModSecurity/Nginx и заблокируют источник на уровне файрвола.

Как временно отключить WAF, не разбирая конфигурацию?

Поменяйте SecRuleEngine On на SecRuleEngine DetectionOnly в /etc/nginx/modsec/modsecurity.conf и выполните sudo systemctl reload nginx. Сайт продолжит работать без блокировок, а лог срабатываний сохранится — удобно для диагностики «это WAF режет запросы или нет».

Итог

ModSecurity с правилами OWASP CRS превращает обычный Nginx в полноценный WAF: SQL-инъекции, XSS и работа сканеров отсекаются до кода вашего сайта. Главное — не забыть этап DetectionOnly и настроить исключения под своё приложение. Для сборки модуля и комфортной работы WAF под нагрузкой возьмите VPS Pro от Cheap-Host: 750₽/мес за 12 vCPU, 16 ГБ RAM и 128 ГБ NVMe на KVM в Москве. Аптайм 99,9%, сервер готов через 45–60 секунд после оплаты — заказ на сайте Cheap-Host.

Читайте также