Справка по директиве

quic_retry

Директива `quic_retry` включает или отключает повторные попытки соединения QUIC в NGINX. — NGINX HTTP Core

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

Описание

Директива `quic_retry` используется для управления поведением протокола QUIC в отношении повторных попыток установления соединения. Когда она включена, NGINX будет отвечать входящим запросам на соединение, не содержащим действительного connection ID, пакетом retry. Этот механизм особенно важен, когда клиенты недавно установили соединение, которое может быть ещё не полностью завершено. Используя повторные попытки соединения, NGINX помогает справляться с ситуациями, когда у клиентов происходят обрывы соединения или переключения между сетями, позволяя им переподключаться без длительных задержек. Директива может принимать в качестве аргумента булев флаг: 'on' означает, что повторные попытки QUIC разрешены, а 'off' — что они запрещены. Такая гибкость позволяет системным администраторам включать или отключать функциональность повторных попыток QUIC в зависимости от конкретной сетевой среды или требований приложений. В контекстах `http` и `server` администраторы могут тонко настраивать реализацию QUIC, улучшая производительность и надёжность для пользователей, подключающихся по протоколу QUIC.

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

http {
    quic_retry on;
}

server {
    listen 443 quic;
    quic_retry on;
}
⚠

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

⚠

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

Связанные директивы

listenhttp2