Настройки Certbot: где лежат сертификаты и какие команды нужны
Certbot получает бесплатный сертификат Let's Encrypt и сам продлевает его. Всё, что он знает о ваших сертификатах, лежит в одной папке — /etc/letsencrypt. Здесь — что в ней за файлы, какие можно открывать, а какие трогать нельзя, где смотреть журнал и с каких команд начинать, если с сертификатом что-то не так.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться). Если Certbot ещё не стоит — как поставить сертификат на свой VPS.
- Узнайте версию Certbot:
certbot --versionВ ответе строка вида
certbot 5.9.0. Если система не нашла команду — Certbot не установлен. - Посмотрите, какие сертификаты у вас есть и сколько им осталось:
sudo certbot certificatesКаждый сертификат — отдельный блок, начинается со строки
Certificate Name:. Как читать ответ — команда certbot certificates. - Проверьте, что продление сработает:
sudo certbot renew --dry-runСтрока
Congratulations, all simulated renewals succeeded:— всё в порядке. Если там ошибка — renew --dry-run не прошёл.
Какая версия у вас стоит
Certbot ставят двумя способами, и от способа зависит версия.
| Как поставлен | Версия на 6 ноября 2026 | Как узнать |
|---|---|---|
| snap (так советуют разработчики) | 5.9.0, обновляется сама | snap list certbot |
пакет Ubuntu 24.04 (apt install certbot) | 2.9.0 | apt policy certbot |
Разница заметна в двух местах: когда Certbot продлевает сертификат и как подписаны строки в ответе certbot certificates. На этой странице и в соседних всё сверено с 5.9.0, а там, где 2.9.0 ведёт себя иначе, это сказано отдельно.
Если certbot --version показывает 2.x, а вы хотите свежую версию — удалите пакет и поставьте snap по инструкции. Сертификаты в /etc/letsencrypt при этом остаются.
Что лежит в /etc/letsencrypt
Заглянуть в папку можно только с sudo: в ней лежат закрытые ключи.
sudo ls /etc/letsencrypt| Папка или файл | Что в ней | Можно ли править |
|---|---|---|
live/имя/ | ссылки на текущие файлы сертификата — их указывают в nginx | нет |
archive/имя/ | все версии сертификата: cert1.pem, cert2.pem и так далее | нет |
renewal/имя.conf | как продлевать этот сертификат: способ проверки, хуки, ключ | только командой, файл renewal |
renewal-hooks/ | ваши скрипты, которые Certbot запускает при продлении | да, хуки Certbot |
accounts/ | учётная запись у Let's Encrypt и её ключ | нет |
cli.ini | настройки по умолчанию (есть у пакета Ubuntu) | можно, но не нужно |
«Имя» — это имя сертификата. Certbot даёт его по первому домену из команды: для -d example.ru -d www.example.ru это example.ru. Если имя уже занято, к нему добавляется номер: example.ru-0001.
Какие файлы указывать в nginx
В папке live/имя/ четыре файла:
| Файл | Что это | Куда указывать |
|---|---|---|
fullchain.pem | сертификат вместе с цепочкой | ssl_certificate в nginx |
privkey.pem | закрытый ключ | ssl_certificate_key в nginx |
chain.pem | только цепочка | не нужен для nginx |
cert.pem | только сертификат, без цепочки | не указывайте: браузеры и curl покажут ошибку цепочки |
В настройках nginx это выглядит так:
ssl_certificate /etc/letsencrypt/live/example.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.ru/privkey.pem;Пишите путь именно к live, а не к archive. При продлении Certbot кладёт в archive новые файлы с новым номером и переводит на них ссылки в live. Путь в nginx остаётся прежним — nginx нужно только перечитать настройки, об этом в хуках Certbot.
Где журнал Certbot
Certbot пишет подробный журнал каждого запуска в /var/log/letsencrypt/letsencrypt.log. Последние строки:
sudo tail -n 40 /var/log/letsencrypt/letsencrypt.logУ snap-версии Certbot сам хранит 1000 старых журналов (letsencrypt.log.1, .2 и дальше). У пакета Ubuntu эта настройка выключена в /etc/letsencrypt/cli.ini строкой max-log-backups = 0: журналы раз в неделю сжимает logrotate и хранит 12 штук.
Таймер продления пишет и в журнал systemd. Как его смотреть — в автопродлении.
Основные команды
| Что нужно | Команда | Подробно |
|---|---|---|
| список сертификатов и сроки | sudo certbot certificates | certbot certificates |
| проверить продление | sudo certbot renew --dry-run | certbot renew |
| продлить сейчас | sudo certbot renew --cert-name example.ru --force-renewal | certbot renew |
| проверить расписание | systemctl list-timers | автопродление |
| добавить домен | sudo certbot --nginx --cert-name example.ru -d example.ru -d www.example.ru -d new.example.ru | добавить домен |
| удалить сертификат | sudo certbot delete --cert-name example.ru | удаление |
| поменять настройки продления | sudo certbot reconfigure --cert-name example.ru … | файл renewal |
| сертификат на все поддомены | sudo certbot certonly --manual --preferred-challenges dns -d 'example.ru' -d '*.example.ru' | wildcard |
Вместо example.ru подставьте имя своего сертификата — его покажет sudo certbot certificates.
Какие способы проверки домена есть
Перед выдачей сертификата Let's Encrypt проверяет, что домен ваш. Certbot умеет делать это по-разному — способ выбирается при первом получении и записывается в файл renewal.
| Способ | Как проверяет | Когда подходит |
|---|---|---|
--nginx | сам дописывает в nginx временное правило | сайт на nginx — самый простой путь |
--webroot | кладёт файл в папку сайта | webroot: сайт уже работает, nginx настроен руками |
--standalone | поднимает свой веб-сервер на порту 80 | standalone: веб-сервера нет |
--manual с DNS | вы добавляете TXT-запись у домена | wildcard: сертификат на все поддомены |
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
| система не нашла команду certbot | Certbot не установлен или snap не сделал ссылку | sudo ln -s /snap/bin/certbot /usr/local/bin/certbot |
No certificates found. | Certbot на этом сервере сертификатов не получал: сертификат мог поставить хостер или другая программа | получите сертификат по инструкции |
Expected … to be a symlink | файл в live заменён руками | верните ссылку или получите сертификат заново, удаление и перевыпуск |
Another instance of Certbot is already running. | Certbot уже работает в другом окне или по таймеру | разбор ошибки |
| в браузере ошибка цепочки, в nginx указан cert.pem | в cert.pem нет цепочки | укажите fullchain.pem в ssl_certificate |
| любая другая ошибка при получении | — | ошибки Certbot |
Всё сверено с Certbot 5.9.0 из snap, отличия пакета Ubuntu 24.04 (Certbot 2.9.0) указаны отдельно.
Источники
- Исходный код Certbot 5.9.0: storage.py — папки live, archive, renewal, файлы cert, privkey, chain, fullchain, проверка ссылок.
- Справка Certbot — на английском: где лежат сертификаты, какие файлы указывать в настройках сервера.
- Файл cli.ini пакета Debian и Ubuntu — max-log-backups = 0.
- Файл logrotate пакета Debian и Ubuntu — журналы раз в неделю, 12 штук.
- Пакет certbot в Ubuntu 24.04 — версия 2.9.0.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Команда certbot certificatesсколько осталось сертификату.
- Автопродление Certbotгде расписание и как проверить.
- Ошибки Certbotчто делать, если команда закончилась ошибкой.
- HTTPS для сайта на Apachecertbot --apache и переадресация на HTTPS.