К содержимому

Настройка HTTPS в nginx с сертификатом Let's Encrypt

HTTPS в nginx включается двумя блоками server: один перенаправляет весь трафик с порта 80 на 443, второй отдаёт сайт по TLS с сертификатом Let's Encrypt. Конфиг ниже рабочий, его нужно только адаптировать под ваш домен и путь к сайту. После правок проверьте синтаксис через sudo nginx -t и перезагрузите nginx.

Конфиг SSL 3 мин чтения

Конфиг

/etc/nginx/sites-available/example.com
server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com www.example.com;
    root /var/www/example.com/public;
    index index.php index.html;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    include /etc/letsencrypt/options-ssl-nginx.conf;
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem;

    add_header Strict-Transport-Security "max-age=31536000" always;

    location / {
        try_files $uri $uri/ =404;
    }
}

Что заменить под свой сервер

example.com
ваш домен, для него уже выпущен сертификат
options-ssl-nginx.conf
этот файл и ssl-dhparams.pem создаёт certbot с плагином nginx
http2
на nginx 1.25.1 и новее вместо http2 в listen пишут отдельную строку http2 on

Как применить и проверить

bash
sudo certbot certificates
sudo nginx -t
sudo systemctl reload nginx

Блок перенаправления с HTTP на HTTPS

Первый блок server слушает порт 80 по IPv4 и IPv6 и отвечает кодом 301 на любой запрос. Переменные $host и $request_uri сохраняют домен и полный путь, поэтому http://example.com/page?x=1 попадёт на https://example.com/page?x=1. Этот блок не содержит root и не отдаёт файлы: его задача только перенаправить. Если оставить порт 80 без редиректа, сайт будет открываться по обоим протоколам, и поисковики увидят дубли.

Блок HTTPS: порт, сертификат и корень сайта

Второй блок слушает 443 с параметрами ssl и http2. Директивы ssl_certificate и ssl_certificate_key указывают на файлы, которые certbot кладёт в /etc/letsencrypt/live/example.com/. Путь root /var/www/example.com/public замените на каталог вашего проекта, а index оставьте с index.php первым, если сайт на PHP. server_name должен совпадать с именем, на которое выпущен сертификат, иначе браузер покажет ошибку имени.

Параметры SSL от certbot

Строка include /etc/letsencrypt/options-ssl-nginx.conf подключает набор протоколов и шифров, который certbot считает безопасным. Файл ssl-dhparams.pem содержит параметры Диффи-Хеллмана для TLS. Оба файла создаёт certbot с плагином nginx при выпуске сертификата, вручную их не пишут. Если файлов нет, sudo nginx -t сообщит open() ... failed, и nginx не перезагрузится.

HSTS: заголовок Strict-Transport-Security

add_header Strict-Transport-Security "max-age=31536000" always велит браузеру год открывать домен только по HTTPS, даже если пользователь набрал http://. Параметр always добавляет заголовок и к ответам с ошибками. Включайте HSTS после того, как убедились, что HTTPS работает на всех поддоменах: отменить политику до истечения max-age на стороне клиента нельзя.

Применение конфига и проверка

Файл положите в /etc/nginx/sites-available/example.com и включите симлинком в sites-enabled. Перед перезагрузкой проверьте синтаксис: sudo nginx -t должен вывести syntax is ok и test is successful. Затем примените конфиг через sudo systemctl reload nginx, чтобы не рвать текущие соединения. Убедитесь, что сертификат на месте: sudo certbot certificates покажет домен и дату истечения.

nginx 1.25.1 и новее: директива http2

В nginx 1.25.1 параметр http2 в директиве listen объявлен устаревшим. Вместо listen 443 ssl http2; пишут listen 443 ssl; и отдельную строку http2 on; внутри блока server. Старый синтаксис пока работает, но при обновлении пакета nginx предупреждает о deprecated-параметре. Проверьте версию через nginx -v и выберите подходящий вариант.

Где ошибаются, когда правят конфиг

  • В server_name указан домен, на который не выпущен сертификат, например только example.com, а сайт открывают по www.example.com. Браузер выдаёт NET::ERR_CERT_COMMON_NAME_INVALID.

    Перечислите в server_name все имена из сертификата или выпустите сертификат на оба имени: sudo certbot --nginx -d example.com -d www.example.com.

  • После правки конфига выполняют sudo systemctl restart nginx без sudo nginx -t. Синтаксическая ошибка роняет nginx, и сайт перестаёт открываться по обоим протоколам.

    Сначала sudo nginx -t, и только при test is successful выполняйте sudo systemctl reload nginx.

  • HSTS включили до того, как заработал HTTPS на всех поддоменах. Браузеры год не пускают на них по HTTP, и откатить это с сервера нельзя.

    Сначала проверьте HTTPS на каждом имени, затем добавляйте add_header Strict-Transport-Security. Для теста ставьте маленький max-age, например 300.

  • В блоке с listen 443 оставили root от старого сайта или неверный путь. nginx отдаёт 404 или 403 на все страницы, хотя сертификат валиден.

    Сверьте root с реальным каталогом проекта и правами: ls -ld /var/www/example.com/public. Владельцем должен быть пользователь, от которого работает PHP-FPM.

Deploykin

Как это делается в Deploykin

В Deploykin SSL выпускается из панели в один клик, для основного домена и всех алиасов, а дальше продлевается автоматически. Certbot и консоль для этого не нужны.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Нужно ли перевыпускать сертификат после правки конфига nginx?

Нет, сертификат лежит в /etc/letsencrypt/live/example.com/ и не зависит от конфига. Проверьте срок через sudo certbot certificates и перезагрузите nginx.

Почему sudo nginx -t пишет cannot load certificate?

Путь в ssl_certificate не совпадает с реальным именем домена в /etc/letsencrypt/live/. Посмотрите каталоги через sudo ls /etc/letsencrypt/live/ и исправьте путь.

Как проверить, что редирект на HTTPS работает?

Выполните curl -I http://example.com и найдите строку 301 с Location: https://example.com/. Затем curl -I https://example.com должен вернуть 200.

Что делать, если certbot не создал options-ssl-nginx.conf?

Файл появляется при выпуске сертификата с плагином nginx. Перевыпустите сертификат командой sudo certbot --nginx -d example.com, и certbot создаст оба файла.

Ещё по теме

Сертификат Let's Encrypt: выпуск и настройка на сервере: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.