Поиск
Справочник

SSL в nginx: сертификат, версии TLS, шифры и кэш сессий

Строки, которые начинаются с ssl_, задают, каким сертификатом nginx подтверждает сайт и какими версиями TLS и шифрами защищает соединение. Если сертификат ставил Certbot, нужные строки он уже дописал — разберём, что они значат и что можно поменять.

≈ 9 мин чтения
Содержание 11

Что сделать прямо сейчас

  1. Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне.
  2. Посмотрите, какие строки ssl_ действуют на сервере: sudo nginx -T | grep ssl_. Команда показывает все файлы настроек вместе с подключёнными через include.
  3. Сравните их с таблицей ниже. Если сертификат ставил Certbot, в файле сайта менять ничего не нужно — что он дописал.
  4. Проверьте, какие версии TLS принимает сайт — как проверить.
  5. Если сервер принимает 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_protocolsTLSv1 TLSv1.1 TLSv1.2 TLSv1.3версии TLS
ssl_ciphersHIGH:!aNULL:!MD5шифры для TLS 1.2 и более ранних версий
ssl_prefer_server_ciphersoffon — выбирать шифр по списку сервера, а не браузера
ssl_session_cachenoneкэш сессий: повторное подключение без полного обмена ключами
ssl_session_timeout5mсколько хранится сессия
ssl_session_ticketsonвозобновление сессий по билетам

Строка 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: POODLE

TLS 1.0 и TLS 1.1 объявлены устаревшими в стандарте RFC 8996, и Chrome по ним уже не подключается. Оставьте TLS 1.2 и TLS 1.3 для всех сайтов сервера:

  1. Откройте файл: sudo nano /etc/nginx/nginx.conf. sudo может спросить пароль вашего пользователя на сервере: символы при вводе не видны, наберите пароль и нажмите Enter.
  2. Найдите строку ssl_protocols: Ctrl+W, слово ssl_protocols, Enter. Замените её на ssl_protocols TLSv1.2 TLSv1.3;.
  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

Источники

Сверено 23 октября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше