limit_req в nginx: как ограничить число запросов с одного адреса
Ограничение числа запросов в nginx ставят двумя строками: limit_req_zone задаёт, сколько запросов в секунду разрешено одному адресу, а limit_req включает проверку для сайта или страницы. Лишние запросы получают ответ 503 или код, который вы выберете.
Содержание 11
Что сделать прямо сейчас
Пример ограничивает страницу входа WordPress: не больше одного запроса в секунду с одного адреса и запас на пять подряд. Так подбор паролей становится медленным, а посетители этого не замечают.
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Создайте файл для зоны:
sudo nano /etc/nginx/conf.d/limit.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Впишите в него строку
limit_req_zone $binary_remote_addr zone=login:10m rate=1r/s;и сохраните: Ctrl+O, Enter, Ctrl+X. Файлы из папки conf.d nginx в Ubuntu подключает внутри блока http — туда, где и должна стоять эта строка. - Откройте файл сайта:
sudo nano /etc/nginx/sites-available/example.com. Вместо example.com — имя файла вашего сайта: список покажетls /etc/nginx/sites-enabled/. Если система спросит пароль, введите пароль своего пользователя на сервере. Символы при вводе не видны — наберите пароль и нажмите Enter. - Внутри блока server, рядом с другими location, добавьте блок из раздела ниже.
- Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены. - Проверьте, что ограничение работает, — как проверить.
Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.
Как устроены две строки
limit_req_zone $binary_remote_addr zone=login:10m rate=1r/s;| Часть | Что значит |
|---|---|
$binary_remote_addr | считать запросы отдельно для каждого IP-адреса |
zone=login:10m | имя зоны и память под неё: 10 мегабайт |
rate=1r/s | один запрос в секунду с адреса. Для меньших значений — запросы в минуту: 30r/m — один запрос в две секунды |
Строка limit_req_zone работает только в блоке http. В 1 мегабайт зоны помещается около 8 тысяч адресов на 64-битном сервере — 10 мегабайт хватит примерно на 80 тысяч. Когда место кончается, nginx удаляет самые давние записи.
limit_req zone=login burst=5 nodelay;| Часть | Что значит |
|---|---|
zone=login | какую зону использовать |
burst=5 | запас: до пяти запросов сверх нормы не отклоняются. Без burst отклоняется каждый лишний запрос |
nodelay | запросы из запаса выполнять сразу, а не растягивать по скорости rate |
Строку limit_req пишут в блоках http, server и location. Строк может быть несколько — с разными зонами. Блок location получает строки limit_req из блока server, только если в нём нет своих.
Без nodelay nginx задерживает запросы из запаса: страница откроется, но медленнее. С параметром delay=3 первые три запроса сверх нормы проходят сразу, а остальные из запаса ждут.
Страница входа WordPress
location = /wp-login.php {
limit_req zone=login burst=5 nodelay;
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}Блок со знаком = срабатывает только на этот адрес и перехватывает его у блока location ~ \.php$. Поэтому строки include и fastcgi_pass нужно повторить: скопируйте их из блока для PHP в вашем файле. Иначе nginx не передаст файл в PHP. Как устроена связка — nginx и PHP-FPM.
Весь сайт
Для всего сайта лимит ставят выше — страница с картинками, стилями и скриптами даёт десятки запросов за раз. Зона: limit_req_zone $binary_remote_addr zone=site:10m rate=10r/s;, строка в блоке server: limit_req zone=site burst=50 nodelay;.
Подберите числа по своему сайту в пробном режиме. Ограничение помогает против одного навязчивого адреса, но не против атаки с тысяч адресов — об этом Защита от DDoS.
Что получает посетитель
Лишний запрос получает ответ 503 — код 503. Чтобы отвечать кодом 429 Too Many Requests, рядом со строкой limit_req добавьте limit_req_status 429; — код 429.
В журнал ошибок nginx пишет строку на каждый отклонённый запрос:
limiting requests, excess: 5.120 by zone "login"Число после excess — на сколько запросов адрес превысил норму. Задержанные запросы записываются строкой delaying request на уровне warn, а в журнал Ubuntu попадают записи от уровня error и выше — их там не будет.
Пробный режим
Строка limit_req_dry_run on; рядом с limit_req включает проверку без ограничения: запросы проходят, а в журнале появляются строки limiting requests с пометкой dry run. Оставьте её на день, посмотрите, кого задело бы ограничение, и подберите rate и burst. Потом уберите строку.
sudo grep "dry run" /var/log/nginx/error.log | tail -n 20Если перед сервером CDN
Если сайт работает через CDN или другой сервер перед nginx, все запросы приходят с его адресов. Тогда лимит на адрес срабатывает на всех посетителей разом. Проверьте журнал доступа: sudo tail -n 20 /var/log/nginx/access.log — если адреса в начале строк одни и те же, сначала настройте модуль realip по инструкции вашего CDN, а потом ставьте ограничение.
То же с офисами и мобильными сетями: за одним адресом бывает много людей. Поэтому на весь сайт ставьте запас burst с избытком.
Как проверить
Запустите на сервере 20 запросов подряд к ограниченной странице:
for i in $(seq 1 20); do curl -s -o /dev/null -w '%{http_code}\n' https://example.com/wp-login.php; done | sort | uniq -cКоманда посчитает ответы по кодам. С сервера запросы идут быстрее нормы, поэтому кроме 200 должны быть ответы 503 или 429. Если все ответы 200, ограничение не включилось: проверьте, что строка limit_req стоит в нужном блоке, командой sudo nginx -T | grep -n limit_req.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
"limit_req_zone" directive is not allowed here | строка зоны стоит в блоке server или location: перенесите её в conf.d или в блок http — разбор |
zero size shared memory zone "login" | строка limit_req ссылается на зону, которой нет: проверьте имя в limit_req_zone |
invalid rate "rate=10r/h" | nginx понимает только r/s и r/m: один запрос в час не задать |
"limit_req" must have "zone" parameter | в строке limit_req нет zone=имя |
| посетители жалуются на ошибки 503 | лимит слишком строгий: увеличьте burst, добавьте nodelay, проверьте в пробном режиме |
| ограничение срабатывает на всех сразу | nginx видит адрес CDN вместо адреса посетителя — что делать |
| после правки PHP-страница скачивается файлом | в блоке location = нет строк include и fastcgi_pass — пример |
Источники
- Документация nginx: модуль ngx_http_limit_req_module — limit_req_zone, limit_req с burst, nodelay и delay, limit_req_status, limit_req_log_level и limit_req_dry_run.
- Исходный код nginx 1.24.0: ngx_http_limit_req_module.c — код ответа по умолчанию 503, записи limiting requests и delaying request в журнале ошибок.
- Исходный код nginx 1.24.0: ngx_cycle.c — зона нулевого размера — ошибка zero size shared memory zone при запуске.
- Файл nginx.conf из пакета nginx в Ubuntu 24.04 —
worker_processes auto,worker_connections 768,gzip on, журналы в /var/log/nginx/, подключение conf.d и sites-enabled. - Документация nginx: модуль ngx_http_realip_module — set_real_ip_from и real_ip_header: настоящий адрес посетителя за другим сервером.
- Как nginx собран в Ubuntu 24.04: файл debian/rules — модуль realip входит в сборку.
Сверено 23 октября 2026 года.
Что почитать дальше
- Настройки nginxкак устроены файлы и блоки, главные директивы.
- Ошибка 429 Too Many Requestsчто видит посетитель и как найти причину.
- Пароль на сайт в nginxещё одна защита страницы входа.
- Доступ по IP в nginxоткрыть страницу только своим адресам.
- Защита от DDoSчто делать, когда запросы идут с тысяч адресов.
- fail2ban для nginxблокировать ботов и подбор пароля к сайту.