Перейти к содержимому

// Engineering Log

HTTPS и веб-сервер на практике: Часть 7 — Эталонный конфиг Nginx для HTTPS-сайта и чек-лист проверки

Опубликовано 13.11.2026 · Автор:

// Быстрый маршрут

Эта статья относится к теме Безопасность и защита.

Настройки HTTPS разбросаны по десятку тем: сертификат и цепочка, версии TLS, редиректы, HSTS, заголовки безопасности, HTTP/2 и HTTP/3, кеширование, проксирование в приложение, WebSocket, таймауты. В этой статье всё собрано в один конфиг, который можно взять за основу для нового сайта, и в чек-лист команд, которыми проверяется результат. Конфиг проверен на Nginx 1.31 в Docker: nginx -t проходит, а все проверки из чек-листа дают ожидаемый результат.

Исходные условия: сайт example.ru, сертификат Let’s Encrypt от certbot в /etc/letsencrypt/live/example.ru/, приложение слушает 127.0.0.1:8080, собранная статика с хешем в имени лежит в /var/www/example.ru/public/assets/. Нужен Nginx 1.25.1 или новее (директивы http2 on и http3 on); официальные пакеты с nginx.org собраны с поддержкой HTTP/3.

Структура файлов

/etc/nginx/
├── nginx.conf                  # из пакета, не меняем: подключает conf.d/*.conf
├── conf.d/
│   ├── 00-common.conf          # общие настройки: журнал, сжатие, upstream
│   ├── 10-default.conf         # сервер по умолчанию для чужих имён
│   └── example.ru.conf         # сайт
└── snippets/
    ├── ssl.conf                # параметры TLS
    ├── security-headers.conf   # заголовки безопасности
    └── proxy.conf              # заголовки для проксирования в приложение

Сниппеты подключаются директивой include. Это не только сокращает повторы, но и обходит главную ловушку add_header, о которой ниже.

snippets/ssl.conf

nginx
ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
ssl_prefer_server_ciphers off;
ssl_session_timeout 1d;
ssl_session_cache shared:SSL:10m;
ssl_session_tickets off;

Профиль intermediate из генератора Mozilla: TLS 1.2 и 1.3, для TLS 1.2 — только наборы с прямой секретностью и AEAD. ssl_session_tickets off — билеты сессий без регулярной смены ключа ослабляют прямую секретность; возобновление сессий работает через кеш ssl_session_cache. Почему именно такие шифры — в статье «Версии TLS, шифронаборы, SNI, ALPN, ECH и mTLS».

snippets/security-headers.conf

nginx
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
add_header X-Content-Type-Options "nosniff" always;
add_header Referrer-Policy "strict-origin-when-cross-origin" always;
add_header X-Frame-Options "DENY" always;
add_header Permissions-Policy "camera=(), microphone=(), geolocation=()" always;
add_header Content-Security-Policy-Report-Only "default-src 'self'; img-src 'self' data:; object-src 'none'; base-uri 'none'; frame-ancestors 'none'" always;
add_header Alt-Svc 'h3=":443"; ma=86400' always;
  • HSTS на год с поддоменами. Если у вас есть поддомены без HTTPS, уберите includeSubDomains; на новом сайте начните с max-age=300 и увеличивайте постепенно («Переход на HTTPS: редиректы, HSTS, HTTPS-First»);
  • CSP в режиме Report-Only: браузер сообщает о нарушениях в консоли, но ничего не блокирует. Соберите нарушения, поправьте политику под свои скрипты и счётчики, затем замените заголовок на Content-Security-Policy;
  • Alt-Svc сообщает браузеру о HTTP/3. Он стоит здесь, а не в блоке server, чтобы не потеряться в location со своими add_header;
  • always — заголовки отдаются и в ответах с ошибками.

Ловушка add_header. Если в location есть хотя бы один add_header, все add_header с уровня server в нём перестают действовать. Поэтому в каждый location со своим add_header (ниже — кеш статики) сниппет подключается ещё раз.

snippets/proxy.conf

nginx
proxy_http_version 1.1;
proxy_set_header Host              $host;
proxy_set_header X-Real-IP         $remote_addr;
proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Forwarded-Host  $host;

Приложение за прокси получает настоящий адрес клиента и схему. Без X-Forwarded-Proto приложение считает, что работает по HTTP, и может уйти в бесконечный редирект на HTTPS.

conf.d/00-common.conf

nginx
server_tokens off;

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

log_format main_timing '$remote_addr - [$time_local] "$request" $status $body_bytes_sent '
                       '"$http_referer" "$http_user_agent" '
                       'rt=$request_time urt=$upstream_response_time us=$upstream_status '
                       'proto=$server_protocol tls=$ssl_protocol';

gzip on;
gzip_comp_level 5;
gzip_min_length 1024;
gzip_proxied any;
gzip_vary on;
gzip_types text/css application/javascript application/json image/svg+xml text/plain text/xml application/xml;

upstream app {
    server 127.0.0.1:8080;
    keepalive 32;
    keepalive_timeout 4s;
}
  • server_tokens off — не показывать версию Nginx;
  • журнал с таймингами: rt — полное время запроса, urt — время ответа приложения, us — код от приложения. По ним сразу видно, где теряется время и кто вернул ошибку («Ошибки 502, 504, 499 и 413 в Nginx»);
  • gzip для текстовых типов; gzip_vary on добавляет Vary: Accept-Encoding, чтобы кеши не перепутали сжатую и несжатую версии. Картинки и шрифты woff2 уже сжаты — их в списке нет;
  • upstream с keepalive: соединения к приложению используются повторно. keepalive_timeout 4s должен быть меньше таймаута простоя у приложения (у Node.js по умолчанию 5 с), иначе будут редкие 502.

conf.d/10-default.conf

nginx
# Запросы с неизвестным именем и по IP: закрыть соединение, не раскрывая сертификатов
server {
    listen 80 default_server;
    listen [::]:80 default_server;
    listen 443 ssl default_server;
    listen [::]:443 ssl default_server;
    ssl_reject_handshake on;
    return 444;
}

Отвечает на запросы с неизвестным именем и по IP-адресу. По HTTP Nginx закрывает соединение без ответа (код 444), по HTTPS отклоняет рукопожатие, не раскрывая сертификатов (ssl_reject_handshake, Nginx 1.19.4+). Так закрываются подмена Host и сканирование по IP («Атаки на уровне HTTP»).

conf.d/example.ru.conf

nginx
# HTTP: только проверка Let's Encrypt и редирект на HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name example.ru www.example.ru;

    location /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
    }
    location / {
        return 301 https://example.ru$request_uri;
    }
}

# www → основной домен
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    http2 on;
    server_name www.example.ru;

    ssl_certificate     /etc/letsencrypt/live/example.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.ru/privkey.pem;
    include snippets/ssl.conf;

    return 301 https://example.ru$request_uri;
}

# Основной сайт
server {
    listen 443 ssl;
    listen [::]:443 ssl;
    listen 443 quic reuseport;
    listen [::]:443 quic reuseport;
    http2 on;
    http3 on;
    server_name example.ru;

    ssl_certificate     /etc/letsencrypt/live/example.ru/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.ru/privkey.pem;
    include snippets/ssl.conf;
    include snippets/security-headers.conf;

    access_log /var/log/nginx/example.ru.access.log main_timing;
    error_log  /var/log/nginx/example.ru.error.log warn;

    client_max_body_size 20m;
    root /var/www/example.ru/public;

    # Статика с хешем в имени — кешировать навсегда
    location /assets/ {
        include snippets/security-headers.conf;
        add_header Cache-Control "public, max-age=31536000, immutable" always;
        try_files $uri =404;
    }

    # Картинки и прочая статика без хеша
    location ~* \.(?:png|jpe?g|webp|avif|gif|svg|ico|woff2)$ {
        include snippets/security-headers.conf;
        add_header Cache-Control "public, max-age=86400" always;
        try_files $uri =404;
    }

    # WebSocket
    location /ws/ {
        proxy_pass http://127.0.0.1:8080;
        include snippets/proxy.conf;
        proxy_set_header Upgrade    $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 3600s;
    }

    # Приложение
    location / {
        try_files $uri @app;
    }
    location @app {
        proxy_pass http://app;
        include snippets/proxy.conf;
        proxy_set_header Connection "";   # keepalive к приложению
        proxy_connect_timeout 5s;
        proxy_read_timeout    60s;
    }
}

Что здесь происходит:

  • порт 80 — только проверка Let’s Encrypt и постоянный редирект сразу на итоговый адрес https://example.ru с сохранением пути;
  • www — отдельный блок с редиректом на основной домен; сертификат должен включать оба имени;
  • основной сайт — HTTP/2 по TCP и HTTP/3 по QUIC на том же порту 443. reuseport для QUIC указывается только в одном блоке server на адрес;
  • статика с хешем — кеш на год с immutable; остальная статика — на сутки («Кеширование HTTP и CDN»);
  • WebSocket — прямо к приложению, с заголовками Upgrade и Connection и длинным таймаутом чтения;
  • всё остальное — сначала файл с диска, если он есть, иначе в приложение через upstream с keepalive.

Установка

bash
sudo mkdir -p /etc/nginx/snippets /var/www/letsencrypt
# разложить файлы по местам, затем:
sudo certbot certonly --webroot -w /var/www/letsencrypt \
  -d example.ru -d www.example.ru --deploy-hook 'systemctl reload nginx'
sudo nginx -t && sudo systemctl reload nginx
sudo ufw allow 80/tcp && sudo ufw allow 443/tcp && sudo ufw allow 443/udp

Пока сертификата нет, блоки на 443 не дадут Nginx запуститься. Выпустите сертификат, временно оставив только блок на порту 80, или используйте certbot --nginx. UDP/443 нужен для HTTP/3.

Чек-лист проверки

Все команды — с вашего компьютера. Ожидаемый результат указан в комментарии.

bash
# 1. HTTP → HTTPS с сохранением пути
curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' 'http://example.ru/page?x=1'
# 301 https://example.ru/page?x=1

# 2. www → основной домен
curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' https://www.example.ru/page
# 301 https://example.ru/page

# 3. чужое имя по HTTP и по HTTPS
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: evil.example' http://192.0.2.10/
# 000 (соединение закрыто, код 444)
curl -sk -o /dev/null -w '%{http_code}\n' --resolve evil.example:443:192.0.2.10 https://evil.example/
# 000 (рукопожатие отклонено)

# 4. заголовки безопасности, в том числе в ответах с ошибкой
curl -sI https://example.ru/ | grep -iE '^(strict|x-content|referrer|x-frame|permissions|content-security|alt-svc)'
curl -sI https://example.ru/no-such-page | grep -ic '^strict-transport-security'
# 1

# 5. кеш статики
curl -sI https://example.ru/assets/app.1a2b.js | grep -i '^cache-control'
# cache-control: public, max-age=31536000, immutable

# 6. версии протокола
curl -s -o /dev/null -w '%{http_version}\n' https://example.ru/            # 2
curl -s -o /dev/null -w '%{http_version}\n' --http3-only https://example.ru/   # 3, если curl собран с HTTP/3

# 7. TLS: цепочка, версия, шифр
openssl s_client -connect example.ru:443 -servername example.ru -brief </dev/null
# Protocol version: TLSv1.3 ... Verification: OK

# 8. полная проверка версий и шифров
testssl.sh example.ru

Дополнительно:

  • SSL Labs (ssllabs.com/ssltest) — итоговая оценка A или A+ (A+ требует HSTS);
  • DevTools → Network, колонка Protocol — h2, после повторного захода h3;
  • журнал example.ru.access.log — у запросов есть rt= и urt=, tls=TLSv1.3;
  • certbot renew --dry-run — продление сработает, а --deploy-hook перезагрузит Nginx.

Пример прокси для приложения с WebSocket и закрытой административной частью (Vaultwarden): «Часть 2 — Vaultwarden за Caddy или Nginx и первичная защита».

Что поменять под себя

  • Сайт без приложения (статический): уберите upstream, location /ws/ и @app, в location / оставьте try_files $uri $uri/ =404;, а для HTML добавьте Cache-Control: no-cache.
  • Загрузка больших файлов: увеличьте client_max_body_size в нужном location, а не на весь сайт.
  • Долгие запросы (отчёты, выгрузки): отдельный location с увеличенным proxy_read_timeout.
  • Сайт за CDN или балансировщиком: настройте set_real_ip_from для их адресов, иначе в журнале и в приложении будут адреса CDN, а не посетителей; решите, где ставить HSTS и заголовки — на CDN или на сервере, но не в обоих местах.
  • API для других сайтов: CORS — по списку источников через map («Что такое CORS»).

// Похожая задача

Если у вас похожая ситуация

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

Тема статьи

Безопасность и защита

SSL, hardening, доступы, защита сервисов и безопасные конфигурации.

Часто с этим приходят

  • Настроить SSL, сертификаты и безопасные подключения
  • Ограничить доступы и закрыть лишние точки входа
  • Усилить конфигурацию сервера и сервисов

// Следующий шаг

Если вам нужна не только статья, а помощь по этой теме, удобнее сразу перейти в услугу. Главная и подборка материалов остаются рядом.

Открыть услуги

// Reviews

Отзывы по теме

Спасибо Михаилу за отзывчивость. Созвонились, объяснил как сделать самому. Обращаюсь уже второй раз, все супер и оперативно.

Спасибо Михаилу за отзывчивость. Созвонились, объяснил как сделать самому. Обращаюсь уже второй раз, все супер и оперативно.

kireevk

kireevk

Консультация по nginx proxy manager и portainer

25.02.2025 · ★ 5/5

Освоившийся покупатель
apande

apande

Настройка nginx и opencart

07.09.2024 · ★ 5/5

Очень мощный покупатель
kireevk

kireevk

Диагностика Nginx Proxy Manager в docker контейнере и решение проблемы

15.03.2024 · ★ 5/5

Освоившийся покупатель

// Contact

Нужна помощь?

Свяжись со мной и я помогу решить проблему

Написать в Telegram

Отвечаю в течение рабочего дня (03:00–13:00 GMT)

Или оставьте заявку здесь:

Подтвердите, что вы не бот.

Написать и получить быстрый ответ