Ошибка unable to get local issuer certificate: причины и исправление
Ошибка unable to get local issuer certificate означает, что клиент не нашёл в цепочке сертификат промежуточного центра, которым подписан ваш сертификат. Чаще всего сервер отдаёт только листовой сертификат без промежуточного, и первым делом нужно проверить, что в ssl_certificate указан fullchain.pem, а не cert.pem.
01В nginx указан cert.pem вместо fullchain.pem
В /etc/letsencrypt/live/example.com/ лежат cert.pem (только листовой сертификат) и fullchain.pem (листовой вместе с промежуточным). Если в директиве ssl_certificate стоит cert.pem, клиент получает один сертификат и не может построить цепочку до корневого центра. Проверьте конфиг и замените путь на fullchain.pem, затем перезагрузите nginx.
grep -n ssl_certificate /etc/nginx/sites-enabled/example.com
# в конфиге должно быть так:
# ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
sudo nginx -t && sudo systemctl reload nginx
02Сертификат выпущен вручную и промежуточный не приложен
При выпуске через --manual или через ACME-клиент без плагина nginx сертификат и цепочка сохраняются отдельными файлами. В fullchain.pem промежуточный сертификат попадает только тогда, когда клиент его скачал. Посмотрите, сколько сертификатов в файле: в цепочке Let's Encrypt их должно быть два и больше, первый листовой, остальные промежуточные.
openssl crl2pkcs7 -nocrl -certfile /etc/letsencrypt/live/example.com/fullchain.pem | openssl pkcs7 -print_certs -noout
03Клиент не доверяет корневому центру
Ошибка возникает и на стороне клиента: в его хранилище нет корневого сертификата, которым подписан промежуточный. На Ubuntu 24.04 проверьте пакет ca-certificates и обновите хранилище. Если сервер отдаёт полную цепочку, а ошибка остаётся только у одного клиента, ищите причину в его доверенных корневых сертификатах.
sudo apt install --reinstall ca-certificates
sudo update-ca-certificates
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
04Проверка, что ошибка ушла
Убедитесь, что сервер отдаёт всю цепочку: openssl s_client должен показать Verify return code: 0 (ok) и несколько сертификатов в выводе. Затем проверьте сайт с другой машины или через внешний SSL-тест. Если ошибка повторяется, сравните отдаваемую цепочку с файлом fullchain.pem на сервере.
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer
curl -vI https://example.com 2>&1 | grep -i 'SSL certificate'
Что не помогает
-
Перевыпускать сертификат через
certbot --nginx, когда проблема только в пути к файлу в конфиге.Сначала проверьте
sudo certbot certificatesи директивуssl_certificate. Если сертификат действует, исправьте путь наfullchain.pemи перезагрузите nginx. -
Добавлять промежуточный сертификат в
ssl_certificate_keyили менять порядок файлов в цепочке.ssl_certificate_keyсодержит толькоprivkey.pem. Цепочка должна идти вssl_certificateфайломfullchain.pem, где листовой сертификат первый, промежуточные за ним. -
Считать ошибку признаком просроченного сертификата или несовпадения имени.
Просроченный сертификат даёт
certificate has expired, другое имя,hostname mismatch.unable to get local issuer certificateговорит именно об отсутствии промежуточного сертификата в цепочке.
Deploykin
Как это делается в Deploykin
В Deploykin SSL выпускается из панели в один клик для домена и всех алиасов и дальше продлевается сам. Журнал выпуска сертификатов читается в панели вместе с остальными логами, а срок действия сертификата виден у каждого сайта.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем fullchain.pem отличается от cert.pem?
cert.pem содержит только сертификат вашего домена. fullchain.pem содержит его же и промежуточный сертификат центра, которым он подписан. Для ssl_certificate в nginx нужен fullchain.pem.
Почему ошибка появляется только в браузере, а curl работает?
Разные клиенты используют разные хранилища корневых сертификатов. Если сервер отдаёт неполную цепочку, одни клиенты находят промежуточный сертификат у себя, другие нет. Проверьте цепочку через openssl s_client.
Может ли ошибка возникнуть из-за истёкшего промежуточного сертификата?
Да, если в fullchain.pem попал старый промежуточный сертификат. Перевыпустите сертификат через sudo certbot renew --force-renewal или дождитесь планового продления, чтобы цепочка обновилась.
Как проверить, что nginx отдаёт правильную цепочку?
Выполните openssl s_client -connect example.com:443 -servername example.com -showcerts. В выводе должно быть несколько сертификатов и строка Verify return code: 0 (ok).
Ещё по теме
- Ошибка · SSL Ошибка проверки домена Let's Encrypt: как найти причину и исправить Разбираем ошибку проверки домена Let's Encrypt: почему challenge failed, как проверить DNS, nginx и firewall, команды certbot для диагностики и исправления.
- Ошибка · SSL Ошибка nginx ssl certificate not found: где искать сертификат и как исправить Почему nginx не находит SSL-сертификат: проверка путей в конфиге, права доступа, certbot certificates и команды для исправления ошибки.
- Ошибка · SSL Ошибка err_ssl_protocol_error: причины и исправление Почему браузер выдаёт err_ssl_protocol_error: разбор причин на nginx и Let's Encrypt, команды проверки сертификата, портов и конфига, способы исправления.
- Руководство · SSL Установка и настройка Certbot для nginx на Ubuntu 24.04 Пошаговая инструкция: установка certbot и плагина nginx, выпуск сертификата Let's Encrypt, проверка, автопродление и типичные ошибки с решениями.
- Руководство · 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, настройка, проверка и типичные ошибки.
Сертификат Let's Encrypt: выпуск и настройка на сервере: все материалы темы