Docker コンテナの前に Nginx または Caddy: 自動 TLS と HTTP/3
Постановка
На VPS работают несколько контейнеров: Next.js на порту 3000, API на 8080. Нужен один обратный прокси, который принимает 80 и 443, выпускает и продлевает сертификаты Let's Encrypt, отдаёт HTTP/2 и HTTP/3 и проксирует по доменам. Два реальных кандидата — Caddy и Nginx. Ниже рабочие конфигурации обоих и разбор, где каждый ломается.
Общее для обоих: публикуется только прокси. У контейнеров приложений секции ports нет, прокси ходит к ним по имени сервиса внутри compose-сети.
Caddy: минимум конфигурации
# compose.yml
services:
caddy:
image: caddy:2
restart: unless-stopped
ports:
- "80:80"
- "443:443"
- "443:443/udp" # HTTP/3 работает поверх QUIC, то есть UDP
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
- caddy_config:/config
web:
build: ./web
api:
build: ./api
volumes:
caddy_data:
caddy_config:# Caddyfile
{
email ops@example.com
}
example.com {
encode zstd gzip
reverse_proxy web:3000
}
api.example.com {
reverse_proxy api:8080
}
www.example.com {
redir https://example.com{uri} permanent
}Этого достаточно. Caddy сам получит сертификаты по ACME, будет продлевать их, перенаправит HTTP на HTTPS и включит HTTP/3 (в Caddy 2 он включён по умолчанию, нужен только проброшенный UDP-порт). Заголовки X-Forwarded-For и X-Forwarded-Proto выставляются автоматически.
Том caddy_data критичен. В нём лежат сертификаты и ключи аккаунта ACME. Без тома каждый пересозданный контейнер запрашивает сертификаты заново, и при частых деплоях вы упрётесь в лимиты Let's Encrypt на выпуск для одного домена.
Nginx: больше ручной работы
# conf.d/example.conf
map $http_upgrade $connection_upgrade {
default upgrade;
'' close;
}
server {
listen 80;
server_name example.com www.example.com;
location /.well-known/acme-challenge/ { root /var/www/certbot; }
location / { return 301 https://example.com$request_uri; }
}
server {
listen 443 ssl;
listen 443 quic reuseport;
http2 on;
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;
add_header Alt-Svc 'h3=":443"; ma=86400' always;
resolver 127.0.0.11 valid=10s;
set $web http://web:3000;
location / {
proxy_pass $web;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection $connection_upgrade;
}
}Пояснения к неочевидным строкам:
listen 443 quicи директиваhttp2 onпоявились в ветке 1.25. Модуль HTTP/3 должен быть собран: проверьтеdocker compose exec nginx nginx -V 2>&1 | grep -o http_v3_module.reuseportуказывается один раз на пару адрес:порт. Во второмserverсquicпишитеlisten 443 quic;без него, иначе nginx не стартует.Alt-Svcсообщает браузеру, что сервер умеет HTTP/3. Первый запрос всегда идёт по TCP, следующие — по QUIC.resolver 127.0.0.11и переменная вproxy_pass— обход классической проблемы. Nginx разрешает имяwebодин раз при старте. Если контейнер пересоздан и получил новый IP, прокси продолжит слать запросы на старый адрес и отдавать 502. С переменной имя разрешается через встроенный DNS Docker и кэшируется на 10 секунд. Без этого же приёма nginx вообще не запустится, еслиwebещё не поднят:host not found in upstream.
Сертификаты — отдельная задача: контейнер certbot с webroot /var/www/certbot, общий том с /etc/letsencrypt и регулярное продление с последующим nginx -s reload. Забытый reload — частая причина истёкшего сертификата при успешно продлённом файле.
Сравнение по существу
| Вопрос | Caddy | Nginx | |---|---|---| | Выпуск и продление TLS | встроено | certbot или acme.sh отдельно | | HTTP/3 | по умолчанию | нужен модуль и listen quic | | Пересоздание контейнеров | разрешает имена динамически | нужен resolver и переменная | | Кэширование ответов | через плагины | встроенный proxy_cache | | Лимиты запросов | через плагины | встроенные limit_req, limit_conn | | Готовые конфиги и ответы на форумах | меньше | очень много |
Как проверять
# HTTP/2 и заголовок Alt-Svc curl -sI https://example.com | grep -iE "^HTTP|alt-svc" # HTTP/3, если curl собран с его поддержкой curl --http3-only -sI https://example.com | head -1 # Сертификат и срок действия echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null \ | openssl x509 -noout -issuer -enddate
В браузере откройте DevTools, вкладку Network и включите колонку Protocol: после повторной загрузки там должно быть h3.
Где обычно ломается HTTP/3
- UDP 443 закрыт. Открыть порт в compose недостаточно: проверьте UFW (
ufw allow 443/udp) и облачный файрвол провайдера, где правила для TCP и UDP отдельные. - Сайт за Cloudflare с включённым проксированием. Тогда HTTP/3 с браузером терминирует Cloudflare, а до вашего сервера трафик идёт по TCP. Настраивать QUIC на origin бессмысленно.
- Корпоративные сети режут UDP. Браузер откатится на HTTP/2, и это нормальное поведение, а не ошибка.
Что выбрать
Для нескольких сервисов на одном сервере без особых требований Caddy даёт рабочий HTTPS и HTTP/3 с наименьшим числом мест для ошибки. Nginx оправдан, если нужен встроенный кэш, тонкие лимиты, уже есть отлаженные конфиги или команда хорошо его знает. Производительность на типичных нагрузках небольшого проекта упирается в приложение, а не в прокси, поэтому выбирать по ней не стоит.