http3_hq

Включает поддержку HTTP/3 в NGINX. — NGINX HTTP Core

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

Описание

Директива `http3_hq` — это параметр конфигурации в NGINX, который включает или отключает поддержку HTTP/3, третьей крупной версии протокола передачи гипертекста. Эту директиву можно разместить в контексте `http` или `server`, что позволяет выполнять настройку как на глобальном уровне, так и для конкретного сервера. При включении NGINX будет слушать соединения QUIC, которые HTTP/3 использует в качестве транспортного уровня, и обрабатывать запросы по этому протоколу. Использование этой директивы может существенно улучшить время отклика и обеспечить более устойчивую обработку потерь пакетов, поскольку HTTP/3 построен на QUIC, который предоставляет такие возможности, как мультиплексирование и миграция соединений. Когда директива `http3_hq` установлена в `on`, NGINX будет обрабатывать запросы HTTP/3 соответствующим образом, а при установке в `off` будет возвращаться к традиционным протоколам HTTP/1.1 или HTTP/2 для обслуживания веб-контента. Важно убедиться, что серверные сертификаты соответствуют необходимым требованиям, поскольку QUIC и HTTP/3 обычно используются совместно с HTTPS. Административная осведомленность имеет важное значение, поскольку включение HTTP/3 может потребовать специальных дополнительных настроек, например использования UDP для трафика QUIC и соответствующих правил файрвола, чтобы избежать блокировки запросов HTTP/3.

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

server {
    listen 443 ssl http3;
    http3_hq on;
    ssl_certificate /etc/ssl/certs/example.com.crt;
    ssl_certificate_key /etc/ssl/private/example.com.key;
}

Убедитесь, что ваша система поддерживает QUIC и UDP; в противном случае HTTP/3 не сможет работать должным образом.

Может потребоваться настроить брандмауэры, чтобы разрешить UDP-трафик, который критически важен для HTTP/3.

Сертификаты должны быть корректно настроены для работы с QUIC; недействительный сертификат приведёт к сбоям при установлении HTTP/3-соединений.