Nginx HTTP/2: включить и не сломать SSL
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.