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.