Коротко о главном

HTTP/3 работает поверх QUIC и UDP, быстрее устанавливает соединение и лучше переносит потери пакетов. Nginx поддерживает его в свежих версиях, но не во всех дистрибутивных сборках. Прежде чем включать, нужно проверить версию и модули.

Для сайта HTTP/3 даёт ускорение на мобильных и нестабильных соединениях. Даже если выигрыш невелик, браузеры выбирают протокол автоматически, а откат на HTTP/2 остаётся доступным.

Этот материал — быстрый старт по HTTP/3 в Nginx. За 15 минут вы получите рабочую конфигурацию и поймёте, куда смотреть дальше.

Установка

В Debian, Ubuntu и Linux Mint используется пакетный менеджер APT:

sudo apt install nginx

В Fedora и RHEL-совместимых системах пакет ставится через DNF:

sudo dnf install nginx

В Arch Linux и производных пакет доступен в официальных репозиториях:

sudo pacman -S nginx

Минимальная настройка

1. Проверьте поддержку

Модуль HTTP/3 должен быть собран в бинарнике. Если в выводе нет http_v3, потребуется другая сборка или репозиторий с новой версией.

nginx -V 2>&1 | tr ' ' '\n' | grep -i http_v3
nginx -v

2. Откройте UDP-порт

HTTP/3 использует UDP 443. Если открыт только TCP, браузер не сможет подключиться по новому протоколу.

sudo ufw allow 443/tcp
sudo ufw allow 443/udp
sudo ufw status numbered

3. Настройте сервер

Добавьте директивы quic и http3 к существующему блоку. Не отключайте HTTP/2: он нужен как запасной вариант.

sudo nginx -t
sudo systemctl reload nginx

4. Проверьте извне

Локальная проверка может не показать QUIC. Используйте curl с поддержкой HTTP/3 и внешний тест.

curl --http3 -I https://example.com
curl -I https://example.com

Минимальный конфиг

Начните с минимального рабочего варианта. Не копируйте большой конфиг целиком: добавляйте параметры по одному и проверяйте результат после каждого изменения.

server {
    listen 443 ssl;
    listen 443 quic reuseport;
    http2 on;
    http3 on;
    add_header Alt-Svc 'h3=":443"; ma=86400' always;
    ssl_protocols TLSv1.2 TLSv1.3;
}

Шпаргалка по командам

  • Проверьте поддержку: nginx -V 2>&1 | tr ‘ ‘ ‘\n’ | grep -i http_v3
  • Откройте UDP-порт: sudo ufw allow 443/tcp
  • Настройте сервер: sudo nginx -t
  • Проверьте извне: curl —http3 -I https://example.com
  • Подготовьте откат: sudo cp /etc/nginx/sites-available/example.conf ~/example.conf.bak

Практические советы

Эти рекомендации проверены на повседневных задачах. Начните с тех, которые закрывают вашу текущую боль, а не со всего списка сразу.

Совет 1. HTTP/3 требует TLS 1.3: без него протокол не включится.

HTTP/3 требует TLS 1.3: без него протокол не включится.

Совет 2. Не полагайтесь только на UDP: часть сетей блокирует его, и HTTP/2 долж

Не полагайтесь только на UDP: часть сетей блокирует его, и HTTP/2 должен оставаться рабочим.

Совет 3. Проверяйте поведение через мобильную сеть, а не только из локальной се

Проверяйте поведение через мобильную сеть, а не только из локальной сети.

Совет 4. Alt-Svc кэшируется браузером: после изменений может понадобиться очист

Alt-Svc кэшируется браузером: после изменений может понадобиться очистка.

Что дальше

Быстрый старт не означает «настроить навсегда». Когда базовый сценарий заработает, вернитесь к конфигурации и проверьте, что она переживёт перезагрузку: файлы на месте, служба включена в автозагрузку, путь к данным не зависит от текущего каталога.

Дальше имеет смысл разобраться с резервной копией и журналами HTTP/3 в Nginx. Это не самая заметная часть работы, но именно она превращает эксперимент в инструмент, которым можно пользоваться каждый день.

Чек-лист

  • Команды из шпаргалки выполняются без ошибок после перезагрузки.
  • Пароли и токены не хранятся в истории команд и конфигурации в открытом виде.
  • Понятно, где смотреть логи и что считать признаком проблемы.
  • Есть копия конфигурации, которую можно восстановить.

Короткие ответы на частые вопросы

Нужно ли запускать всё от root?

Нет. Права root нужны для установки пакетов и изменения системных файлов, но сама программа и её данные должны принадлежать отдельному пользователю. Постоянная работа под root превращает любую ошибку в критическую.

Что делать, если после перезагрузки ничего не работает?

Сначала проверьте, включена ли служба в автозагрузку и не изменился ли путь к конфигурации. Посмотрите журнал текущей загрузки: он почти всегда указывает на отсутствующий файл, неверные права или занятый порт.

Как обновлять без сюрпризов?

Читайте примечания к версии, делайте резервную копию конфигурации и проверяйте обновление на тестовом стенде. Не обновляйтесь в пятницу вечером перед выходными: время на откат должно быть частью плана.

Итог

Этого достаточно, чтобы начать. Дальше углубляйтесь по мере задач: документация HTTP/3 в Nginx станет понятнее, когда появится реальный сценарий использования.

Насколько публикация полезна?

Нажмите на звезду, чтобы оценить!

Средняя оценка 0 / 5. Количество оценок: 0

Оценок пока нет. Поставьте оценку первым.

Поделиться: Telegram ВКонтакте