// 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
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
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
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
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
# Запросы с неизвестным именем и по 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
# 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.
Установка
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.
Чек-лист проверки
Все команды — с вашего компьютера. Ожидаемый результат указан в комментарии.
# 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
Отзывы по теме
Спасибо Михаилу за отзывчивость. Созвонились, объяснил как сделать самому. Обращаюсь уже второй раз, все супер и оперативно.
Спасибо Михаилу за отзывчивость. Созвонились, объяснил как сделать самому. Обращаюсь уже второй раз, все супер и оперативно.
Хочу выразить огромную благодарность специалисту, который настроил мне ЧПУ на OpenCart. Настроить ЧПУ оказалось легко и просто, и я рад, что наконец нашел профессионала, который сделал всё качественно и без лишних сложностей. До этого я сменил четырёх специалистов, и каждый раз возникали проблемы с настройкой, но этот человек справился с задачей идеально.
Хочу выразить огромную благодарность специалисту, который настроил мне ЧПУ на OpenCart. Настроить ЧПУ оказалось легко и просто, и я рад, что наконец нашел профессионала, который сделал всё качественно и без лишних …
Отличная работа, обращаюсь не первый раз, находит решения к сложным задачам. Рекомендую.
Отличная работа, обращаюсь не первый раз, находит решения к сложным задачам. Рекомендую.
Отличная работа! Выполнил поставленную задачу в срок и без ошибок. Было приятно сотрудничать, рекомендую.
Отличная работа! Выполнил поставленную задачу в срок и без ошибок. Было приятно сотрудничать, рекомендую.
Отличный специалист, вник в проблему, разобрался, исправил. Рекомендую.
Отличный специалист, вник в проблему, разобрался, исправил. Рекомендую.
Нужно было решить проблему с SSL сертификатом на сервере, который был выпущен через Ngnix Proxy manager. Михаил уточнил все детали, как у меня все устроено, попросил доступы чтобы оценить реальность решения задачи, т. к. до этого не сталкивался с подобным сервисом. Быстро разобрался и решил мою проблему. Идеальное сотрудничество)
Нужно было решить проблему с SSL сертификатом на сервере, который был выпущен через Ngnix Proxy manager. Михаил уточнил все детали, как у меня все устроено, попросил доступы чтобы оценить реальность решения задачи, т. …
Диагностика Nginx Proxy Manager в docker контейнере и решение проблемы
15.03.2024 · ★ 5/5
// Contact
Нужна помощь?
Свяжись со мной и я помогу решить проблему
Написать в TelegramОтвечаю в течение рабочего дня (03:00–13:00 GMT)
Или оставьте заявку здесь:
// Related