sxg_max_payload

Директива `sxg_max_payload` задаёт максимальный размер тела HTTP, для которого разрешена генерация SXG в NGINX.

Синтаксисsxg_max_payload size;
По умолчанию67108864
Контекстserver
Аргументы1

Описание

Директива sxg_max_payload указывает верхний предел размера тела HTTP, который будет обрабатываться модулем NGINX Signed HTTP Exchange (SXG). Это позволяет администраторам серверов контролировать использование ресурсов, задавая порог, выше которого запросы не могут быть конвертированы в формат SXG. Это особенно важно, так как SXG направлен на повышение скорости загрузки веб-приложений за счёт эффективного кэширования и доставки signed exchanges. Принудительное ограничение размера уменьшает риск чрезмерного использования ресурсов и возможного ухудшения производительности.

Директива принимает один аргумент — числовое значение, представляющее максимальный размер полезной нагрузки в байтах. Если тело входящего HTTP-запроса превышает указанный предел, NGINX не будет генерировать SXG, фактически пропуская обработку SXG для крупных запросов. Значение по умолчанию — 67108864 байт, что соответствует 64 MiB; это компромисс между поддержкой типичных размеров веб-контента и удержанием использования ресурсов в пределах разумного. Следовательно, настройка этого параметра зависит от возможностей сервера и ожидаемой нагрузки от клиентов, что обеспечивает возможность использования SXG без перегрузки системных ресурсов.

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

server {
    listen 80;
    server_name example.com;

    sxg;
    sxg_certificate /path/to/certificate.pem;
    sxg_certificate_key /path/to/private.key;
    sxg_cert_url https://example.com/cert;
    sxg_max_payload 10000000;  # Set max payload size to 10 MiB
}

Убедитесь, что указанный размер не превышает максимально допустимый предел, заданный конфигурацией сервера или ограничениями операционной системы.

Установка слишком малого размера полезной нагрузки может ограничить возможность обслуживать более крупное содержимое в формате SXG.

← Ко всем директивам