Параметр http2#

Группа параметров, позволяющая регулировать настройки входящих подключений по протоколу http2.

Доступен, начиная с версии 2.4.

Параметр http2 включает в себя следующие параметры:

Опциональные параметры:

  • body_preread_size

    Задает размер буфера для каждого запроса, в который может сохраняться тело запроса до того, как оно начнет обрабатываться.

    Тип параметра: текстовое значение с суффиксом:

    • число без суффикса - байты;

    • k / K - килобайты;

    • m / M - мегабайты.

    По умолчанию:

    body_preread_size: 64k
    
  • chunk_size

    Задает максимальный размер частей, на которое будет разделяться тело ответа. Слишком маленькое значение может привести к росту накладных расходов. Слишком большое значение может негативно сказаться на приоритезации из-за возможной блокировки очереди.

    Тип параметра: текстовое значение с суффиксом:

    • число без суффикса - байты;

    • k / K - килобайты;

    • m / M - мегабайты.

    По умолчанию:

    chunk_size: 8k
    
  • max_concurrent_pushes

    Ограничивает максимальное число параллельных push-запросов в соединении.

    Тип параметра: целочисленное значение.

    По умолчанию:

    max_concurrent_pushes: 10
    
  • max_concurrent_streams

    Задает максимальное число параллельных HTTP/2-потоков в соединении.

    Тип параметра: целочисленное значение.

    По умолчанию:

    max_concurrent_streams: 10
    
  • push_preload

    Разрешает автоматическое преобразование preload links, указанных в полях “Link” заголовка ответа, в push-запросы.

    Тип параметра:

    • on;

    • off.

    По умолчанию:

    push_preload: off
    
  • recv_buffer_size

    Размер входного буфера рабочего процесса.

    Тип параметра: текстовое значение с суффиксом:

    • число без суффикса - байты;

    • k / K - килобайты;

    • m / M - мегабайты.

    По умолчанию:

    recv_buffer_size: 256k
    
  • pushes

    Группа параметров, определяющая набор запросов, которые будут заблаговременно отправлены (push) к заданному uri вместе с ответом на оригинальный запрос.

    Каждый элемент последовательности представляет собой следующую структуру:

    Тип параметра: группа параметров и их значения.

    По умолчанию: не имеет значения по умолчанию.

    • push_parent

      Включает/отключает наследование параметров push_uri с верхних уровней иерархии.

      Тип параметра:

      • on;

      • off.

      По умолчанию: off.

    • *push_uri *

      Список uri, к которым будут отправлены push запросы, каждый элемент списка может содержать переменные.

      Допустимо задавать только относительные URI с абсолютными путями.

      Тип параметра: текстовая строка.

      По умолчанию: не имеет значения по умолчанию.

Пример настройки http2:

service_main_proxy:
  ...
  optional:
    http2:
       pushes:
         push_parent: on
         push_uri:
            -  /images/icon.ico
            -  /licenses/$1