Nginx HTTP/2: включить и не сломать SSL

Категория: Nginx · Обновлено:

HTTP/2 включают на TLS-сервере: браузеры договариваются о протоколе через ALPN, а не по обычному HTTP. В nginx 1.25.1 и новее используется отдельная директива http2 on;; старый вариант listen 443 ssl http2; объявлен устаревшим. Синтаксис зависит от версии, поэтому проверяйте nginx -v.

Включить HTTP/2 на 443

Текст
server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;

    http2 on;

    location / {
        proxy_pass http://backend;
    }
}

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

http2 on действует в контексте server. Для nginx 1.25.0 и старше используйте listen 443 ssl http2;; после обновления уберите http2 из listen, иначе получите предупреждение. Модуль ngx_http_v2_module должен быть собран: проверьте nginx -V 2>&1 | grep http_v2.

HTTP/2 мультиплексирует запросы в одном соединении, но не отменяет TLS и не заменяет настройки keepalive к upstream. Для бэкенда обычно оставляют HTTP/1.1 (proxy_http_version 1.1), если приложение не умеет h2c. HTTP/3 настраивается отдельно через QUIC и не включается этой директивой.

Не включайте HTTP/2 на порту 80 для браузеров: они не используют h2c. Server push в браузерах удалён, директиву http2_push не стоит добавлять в новый конфиг. Проверьте протокол через curl -I --http2 https://example.com или DevTools → Network → Protocol.

После изменения конфигурации выполните nginx -t и перезагрузите Nginx. Если сайт за CDN или балансировщиком, HTTP/2 может терминироваться там, а до Nginx доходить HTTP/1.1 — это нормально.

Документация: ngx_http_v2_module, http2 directive.