Nginx або Caddy перед Docker-контейнерами: автоматичний 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 виправданий, якщо потрібний вбудований кеш, тонкі ліміти, вже є налагоджені конфіги чи команда добре його знає. Продуктивність на типових навантаженнях невеликого проекту впирається в додаток, а не в проксі, тому вибирати не варто.