limit_conn_dry_run

Директива `limit_conn_dry_run` позволяет тестировать лимиты соединений без их принудительного применения. — NGINX HTTP Core

limit_conn_dry_run
httpserverlocation
Синтаксисlimit_conn_dry_run on | off;
По умолчаниюoff
Контекстhttp, server, location
МодульNGINX HTTP Core
Аргументыflag

Описание

Директива `limit_conn_dry_run` — это функция, позволяющая администраторам тестировать настройки лимитов соединений без фактического отказа в соединении. Когда она включена, сервер не блокирует соединения, превышающие заданные лимиты, но фиксирует в логах случаи, в которых эти лимиты были бы применены. Это особенно полезно при настройке и валидации конфигураций без влияния на опыт пользователей, поскольку позволяет администратору собрать данные о возможных последствиях введения лимитов до их полного применения. Директива может быть задана в контекстах `http`, `server` или `location` и принимает в качестве аргумента флаг (on/off). Когда она включена (установлена в 'on'), NGINX будет симулировать применение лимитов без блокировки дополнительных соединений. Важно отметить, что пока эта директива активна, реальные соединения не будут отклоняться, что даёт ясное представление об использовании относительно лимитов без нарушения работы. Тем не менее, администраторам следует проявлять осторожность при использовании этой директивы в продуктивной среде, поскольку сервер по‑прежнему будет записывать в логи случаи превышения лимитов, что может ввести в заблуждение при наблюдении, если директиву принять за реальное принудительное ограничение. Идеально использовать её временно при оценке конфигураций.

Пример конфига

http {
    limit_conn_zone $binary_remote_addr zone=addr:10m; 
    server {
        limit_conn addr 10;
        limit_conn_dry_run on;
    }
}

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

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