SSL в nginx: сертификат, версии TLS, шифры и кэш сессий
Строки, которые начинаются с ssl_, задают, каким сертификатом nginx подтверждает сайт и какими версиями TLS и шифрами защищает соединение. Если сертификат ставил Certbot, нужные строки он уже дописал — разберём, что они значат и что можно поменять.
Содержание 11
Что сделать прямо сейчас
- Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
- Посмотрите, какие строки ssl_ действуют на сервере:
sudo nginx -T | grep ssl_. Команда показывает все файлы настроек вместе с подключёнными через include. - Сравните их с таблицей ниже. Если сертификат ставил Certbot, в файле сайта менять ничего не нужно — что он дописал.
- Проверьте, какие версии TLS принимает сайт — как проверить.
- Если сервер принимает TLS 1.0 и TLS 1.1, оставьте только TLS 1.2 и TLS 1.3 — как это сделать.
Что дописывает Certbot
Когда Certbot ставит сертификат, он добавляет в блок server сайта такие строки. Вместо example.com будет ваш домен:
listen 443 ssl; # managed by Certbot
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # managed by Certbot
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # managed by Certbot
include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot| Строка | Что значит |
|---|---|
listen 443 ssl | принимать HTTPS на порту 443 — listen в nginx |
ssl_certificate | файл с сертификатом сайта и промежуточными сертификатами. fullchain.pem — это вся цепочка в одном файле |
ssl_certificate_key | закрытый ключ сертификата: его не публикуют и никому не передают |
include …options-ssl-nginx.conf | подключить файл Certbot с версиями TLS, шифрами и кэшем сессий — что в нём |
ssl_dhparam | параметры для шифров DHE. Файл создаёт Certbot |
Если у сайта есть строка listen [::]:80, Certbot добавит и строку для IPv6 на порту 443. Продлевает сертификат Certbot сам, а пути в строках не меняются: в папке /etc/letsencrypt/live/ лежат ссылки на последние файлы сертификата.
Если сертификат куплен, строк include и ssl_dhparam не будет: пути к своим файлам впишите в ssl_certificate и ssl_certificate_key. Сертификат и промежуточные должны лежать в одном файле, сначала сертификат сайта — как собрать цепочку.
Файл options-ssl-nginx.conf
Файл /etc/letsencrypt/options-ssl-nginx.conf кладёт Certbot. В Certbot 2.9.0 из пакетов Ubuntu 24.04 в нём такие строки (список шифров сокращён):
ssl_session_cache shared:le_nginx_SSL:10m;
ssl_session_timeout 1440m;
ssl_session_tickets off;
ssl_protocols TLSv1.2 TLSv1.3;
ssl_prefer_server_ciphers off;
ssl_ciphers "ECDHE-ECDSA-AES128-GCM-SHA256:…";Не правьте этот файл: в нём написано, что после ручной правки Certbot перестанет обновлять его сам. Если нужно другое значение, задайте его в nginx.conf или в файле сайта, но не повторяйте строку, которая уже есть в этом файле, в том же блоке server: nginx -t ответит "ssl_protocols" directive is duplicate.
Строки ssl_ и значения по умолчанию
Значения по умолчанию — для nginx 1.24 из Ubuntu 24.04. Все директивы из таблицы пишут в блоке http или server.
| Директива | По умолчанию в 1.24 | Что задаёт |
|---|---|---|
ssl_certificate | нет | файл сертификата с цепочкой |
ssl_certificate_key | нет | файл закрытого ключа |
ssl_protocols | TLSv1 TLSv1.1 TLSv1.2 TLSv1.3 | версии TLS |
ssl_ciphers | HIGH:!aNULL:!MD5 | шифры для TLS 1.2 и более ранних версий |
ssl_prefer_server_ciphers | off | on — выбирать шифр по списку сервера, а не браузера |
ssl_session_cache | none | кэш сессий: повторное подключение без полного обмена ключами |
ssl_session_timeout | 5m | сколько хранится сессия |
ssl_session_tickets | on | возобновление сессий по билетам |
Строка ssl_ciphers действует только на TLS 1.2 и более ранние версии: шифры TLS 1.3 OpenSSL задаёт отдельно, и этой строкой их не поменять.
Версии TLS
В nginx.conf из пакета Ubuntu стоит строка:
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; # Dropping SSLv3, ref: POODLETLS 1.0 и TLS 1.1 объявлены устаревшими в стандарте RFC 8996, и Chrome по ним уже не подключается. Оставьте TLS 1.2 и TLS 1.3 для всех сайтов сервера:
- Откройте файл:
sudo nano /etc/nginx/nginx.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter. - Найдите строку ssl_protocols: Ctrl+W, слово
ssl_protocols, Enter. Замените её наssl_protocols TLSv1.2 TLSv1.3;. - Сохраните файл — Ctrl+O, Enter, затем Ctrl+X — и проверьте настройки:
sudo nginx -t. В ответе должны быть слова syntax is ok и test is successful. Тогда примените их:sudo systemctl reload nginx. Если команда ничего не ответила, настройки применены.
Если проверка нашла ошибку, nginx назовёт файл и номер строки, а сайт продолжит работать на старых настройках. Что значит сообщение — Все ошибки nginx.
Почему в nginx.conf, а не в файле сайта: nginx выбирает сайт по имени уже во время установки защищённого соединения, и строка ssl_protocols из блока server может не сработать — тогда действует значение сайта по умолчанию для этого порта. Строка в блоке http одна на все сайты. То же сказано в документации nginx про ssl_session_cache, ssl_session_timeout и ssl_session_tickets.
Кэш сессий
Без кэша браузер при каждом новом соединении заново договаривается о ключах с сервером. Кэш сохраняет параметры сессии, и повторное подключение проходит быстрее:
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1h;Строки пишут в блок http в nginx.conf. shared — кэш один на все рабочие процессы nginx, SSL — его имя, 10m — размер. В 1 МБ по документации nginx помещается около 4000 сессий. Если подключён файл Certbot, кэш уже включён — дописывать эти строки не нужно.
Как проверить
Подставьте свой домен. Проверка TLS 1.2:
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/nullЕсли версия принимается, в выводе будут строки Protocol и Cipher с версией TLS и шифром. Если нет, команда завершится ошибкой соединения. Для TLS 1.3 замените -tls1_2 на -tls1_3. Подробнее о проверке — ERR_SSL_VERSION_OR_CIPHER_MISMATCH.
Версию OpenSSL, с которой собран nginx, покажет nginx -V в строке built with OpenSSL. Срок и имена сертификата — Бесплатный SSL-сертификат.
Самоподписанный сертификат
В Ubuntu есть пробный сертификат snakeoil, и пакет nginx кладёт для него файл snippets/snakeoil.conf. Браузеры такому сертификату не доверяют и покажут предупреждение. Он годится, чтобы проверить настройки nginx до выпуска настоящего, а для сайта нужен сертификат от удостоверяющего центра — разбор ошибки.
Ошибки и как их исправить
| Что видите | Что делать |
|---|---|
nginx -t: cannot load certificate | нет файла или неверный путь — разбор |
nginx -t: no "ssl_certificate" is defined | в блоке с listen 443 ssl нет строки сертификата — разбор |
nginx -t: key values mismatch | ключ не от этого сертификата — разбор |
| ERR_SSL_VERSION_OR_CIPHER_MISMATCH в браузере | сервер и браузер не нашли общей версии TLS или шифра — разбор |
| ERR_SSL_PROTOCOL_ERROR в браузере | на порту 443 нет HTTPS или настройки не применены — разбор |
| ERR_CERT_AUTHORITY_INVALID, на телефоне ошибка, на компьютере нет | в ssl_certificate нет промежуточных сертификатов — разбор |
| Certbot не ставит сертификат | ошибки Certbot |
Источники
- Документация nginx: модуль ngx_http_ssl_module — ssl_certificate, ssl_certificate_key, ssl_protocols, ssl_ciphers, ssl_session_cache и ssl_session_timeout.
- Документация nginx: настройка HTTPS-серверов — цепочка сертификатов в одном файле, один сервер для HTTP и HTTPS, кэш сессий.
- Исходный код nginx 1.24.0: ngx_http_ssl_module.c — значения по умолчанию в 1.24: протоколы TLSv1, TLSv1.1, TLSv1.2 и TLSv1.3, шифры HIGH:!aNULL:!MD5, время сессии 5 минут.
- Файл nginx.conf из пакета nginx в Ubuntu 24.04 — строки
ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3иssl_prefer_server_ciphers on. - Файл options-ssl-nginx.conf из Certbot 2.9.0 — кэш сессий 10 МБ, время сессии 1440 минут, TLSv1.2 и TLSv1.3, список шифров и просьба не править файл вручную.
- Исходный код Certbot 2.9.0: configurator.py — какие строки Certbot дописывает в блок server: listen 443 ssl, ssl_certificate, ssl_certificate_key, include и ssl_dhparam.
- Файл snippets/snakeoil.conf из пакета nginx в Ubuntu 24.04 — самоподписанный сертификат ssl-cert-snakeoil для проверки, не для рабочего сайта.
- RFC 8996 — на английском: TLS 1.0 и TLS 1.1 объявлены устаревшими.
Сверено 23 октября 2026 года.
Что почитать дальше
- Бесплатный SSL-сертификаткак выпустить и продлевать сертификат.
- Переадресация на HTTPSс http и с www.
- listen в nginxпорты, IPv6 и сайт по умолчанию.
- Ошибки Certbotразбор по сообщениям.
- Настройки nginxкак устроены файлы и блоки, главные директивы.