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