Настройка HTTPS в nginx с сертификатом Let's Encrypt
HTTPS в nginx включается двумя блоками server: один перенаправляет весь трафик с порта 80 на 443, второй отдаёт сайт по TLS с сертификатом Let's Encrypt. Конфиг ниже рабочий, его нужно только адаптировать под ваш домен и путь к сайту. После правок проверьте синтаксис через sudo nginx -t и перезагрузите nginx.
Конфиг
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
Как применить и проверить
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 создаст оба файла.
Ещё по теме
- Руководство · SSL Установка и настройка Certbot для nginx на Ubuntu 24.04 Пошаговая инструкция: установка certbot и плагина nginx, выпуск сертификата Let's Encrypt, проверка, автопродление и типичные ошибки с решениями.
- Ошибка · SSL Ошибка unable to get local issuer certificate: причины и исправление Ошибка unable to get local issuer certificate: почему клиент не находит промежуточный сертификат в цепочке, как проверить fullchain.pem через openssl и исправить…
- Руководство · SSL Самоподписанный SSL сертификат: настройка Let's Encrypt на Ubuntu 24.04 Как выпустить SSL сертификат Let's Encrypt на Ubuntu 24.04: установка certbot, настройка nginx, проверка продления и типичные ошибки.
- Руководство · SSL Как получить SSL-сертификат Минцифры на Ubuntu 24.04: пошаговое руководство Пошаговая инструкция по выпуску SSL-сертификата Let's Encrypt на Ubuntu 24.04 с nginx: команды certbot, настройка, проверка и типичные ошибки.
- Руководство · SSL Недействительный SSL сертификат: настройка Let's Encrypt на Ubuntu 24.04 Как выпустить и проверить SSL-сертификат Let's Encrypt на Ubuntu 24.04: установка certbot, команды, конфиг nginx и разбор ошибок проверки домена.
- Руководство · SSL Как получить сертификат Let's Encrypt на Ubuntu 24.04 Пошаговая инструкция: как получить SSL-сертификат Let's Encrypt на Ubuntu 24.04 с nginx. Команды certbot, проверка домена и порта 80, тестовый выпуск и продление.
Сертификат Let's Encrypt: выпуск и настройка на сервере: все материалы темы