v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T09:25:00.000Z▲ 0 upvotes

Nginx или Caddy перед Docker-контейнерами: автоматический TLS и HTTP/3

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Постановка

На 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 оправдан, если нужен встроенный кэш, тонкие лимиты, уже есть отлаженные конфиги или команда хорошо его знает. Производительность на типичных нагрузках небольшого проекта упирается в приложение, а не в прокси, поэтому выбирать по ней не стоит.

Обсуждение (0)

Ещё на vbcd4u.com