Ограничение числа соединений, частоты запросов и скорости передачи#

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

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

Ограничение числа соединений#

Ограничение числа соединений настраивается с помощью двух основных директив:

  • limit_conn_zone: задает зону разделяемой памяти. Через эту зону рабочие процессы совместно используют счетчики для значений ключа.

  • limit_conn: задает максимально допустимое число соединений для одного значения ключа. Учитываются только те соединения, в которых обрабатывается запрос и полностью прочитан его заголовок.

Примеры#

В следующем примере число соединений ограничивается для каждого IP-адреса, для запросов к location /download/ разрешается не более одного соединения с одного адреса:

http {
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    server {
        location /download/ {
            limit_conn addr 1;
        }
    }
}

Здесь с помощью директивы limit_conn_zone задан ключ $binary_remote_addr (IP-адрес клиента) и параметры зоны разделяемой памяти zone=addr:10m. С помощью директивы limit_conn ограничение применено в контексте location /download/: указано имя зоны разделяемой памяти addr и допустимое число соединений на один ключ 1.

Ограничить число соединений для конкретного сервера можно также с помощью переменной $server_name:

http {
    limit_conn_zone $server_name zone=servers:10m;

    server {
        limit_conn servers 1000;
    }
}

Директив limit_conn может быть несколько. Например, следующая конфигурация одновременно ограничивает число соединений с одного IP-адреса и общее число соединений с виртуальным сервером:

limit_conn_zone $binary_remote_addr zone=perip:10m;
limit_conn_zone $server_name zone=perserver:10m;

server {
    limit_conn perip 10;
    limit_conn perserver 100;
}

При превышении ограничения сервер возвращает клиенту код 503; его можно переопределить директивой limit_conn_status.

Примечание

В HTTP/2 и HTTP/3 каждый параллельный запрос считается отдельным соединением.

Пробный запуск#

Прежде чем включать ограничение в рабочем режиме, поведение можно проверить с помощью директивы limit_conn_dry_run. В режиме пробного запуска число соединений фактически не ограничивается, но число избыточных соединений учитывается в зоне разделяемой памяти, что позволяет оценить корректность ограничений без влияния на клиентов. Каждое соединение, которое превысило бы заданное ограничение, будет записано в лог с пометкой «dry run».

Примечание

Ограничение числа соединений доступно и для TCP/UDP-трафика: директивы limit_conn и limit_conn_zone задаются в блоках stream и server.

Ограничение частоты запросов#

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

Ограничение частоты запросов работает по алгоритму «дырявого ведра» (leaky bucket): запросы поступают в ведро с разной скоростью, а покидают его с фиксированной. Для ограничения частоты запросов нужно настроить глобальные параметры «дырявого ведра»:

  • ключ — параметр, по которому один клиент отличается от другого, обычно переменная;

  • зону разделяемой памяти — имя и размер зоны, в которой хранятся состояния этих ключей («дырявое ведро»);

  • скорость — предельная частота запросов, заданная в запросах в секунду (r/s) или в запросах в минуту (r/m) («вытекание из дырявого ведра»). Запросы в минуту используются, чтобы задать частоту меньше одного запроса в секунду.

Ограничение частоты запросов настраивается с помощью двух основных директив:

  • limit_req_zone: задает параметры ограничения — ключ, зону разделяемой памяти и среднюю скорость;

  • limit_req применяет ограничение в контекстах server, location или http.

Примеры#

В следующем примере обработка запросов к /search/ ограничивается в среднем одним запросом в секунду с одного IP-адреса:

http {
    limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

    server {
        location /search/ {
            limit_req zone=one;
        }
    }
}

Примечание

Размер зоны разделяемой памяти выбирайте из расчета примерно 16 000 IP-адресов на 1 мегабайт; подробнее см. limit_req_zone.

Всплески запросов#

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

limit_req zone=one burst=5;

Такая конфигурация допускает в среднем не более одного запроса в секунду со всплесками до пяти запросов.

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

limit_req zone=one burst=5 nodelay;

Параметр delay задает число запросов в пределах всплеска, которые обрабатываются без задержки; последующие избыточные запросы задерживаются до достижения заданной скорости:

limit_req zone=one burst=5 delay=3;

Пробный запуск#

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

limit_req zone=one burst=5 nodelay;
limit_req_dry_run on;

Каждый запрос, который превысил бы заданное ограничение частоты, будет записан в лог с пометкой «dry run».

Ограничение скорости передачи#

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

Директива limit_rate_after задает начальный объем данных, который передается без ограничения; ограничение начинает действовать только после его превышения. Это удобно, например, при отдаче медиафайлов, когда начало ролика нужно передать быстро, а дальнейшую загрузку — ограничить:

Примечание

Директивы limit_rate и limit_rate_after применимы только к HTTP-трафику. Для ограничения полосы пропускания в TCP/UDP (stream) используйте директивы proxy_download_rate и proxy_upload_rate.

Примеры#

location /download/ {
    limit_rate_after 500k;
    limit_rate       50k;
}

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

http {
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    server {
        location /download/ {
            limit_conn       addr 1;
            limit_rate_after 1m;
            limit_rate       50k;
        }
    }
}

Динамическое ограничение скорости#

В значении limit_rate можно использовать переменные, это позволяет менять ограничение в зависимости от условий. В следующем примере скорость передачи выбирается с помощью директивы map в зависимости от версии протокола TLS (встроенная переменная $ssl_protocol): чем новее протокол, тем выше допустимая скорость:

map $ssl_protocol $response_rate {
    "TLSv1.1"  10k;
    "TLSv1.2"  100k;
    "TLSv1.3"  1000k;
}

server {
    listen 443 ssl;

    ssl_certificate     example.com.crt;
    ssl_certificate_key example.com.key;

    location / {
        limit_rate $response_rate;
    }
}