Файл renewal Certbot: что в нём записано и как поменять настройки продления
Когда Certbot получает сертификат, он записывает все выбранные настройки в файл renewal: каким способом проверять домен, какие хуки запускать, какой ключ делать. При каждом продлении certbot renew берёт настройки отсюда — поэтому продление и идёт без вопросов. Здесь — как прочитать этот файл и как правильно его поменять.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Посмотрите, какие файлы есть. На каждый сертификат — один файл, имя файла — имя сертификата:
sudo ls /etc/letsencrypt/renewal/ - Откройте нужный для чтения:
sudo cat /etc/letsencrypt/renewal/example.ru.conf - Найдите в нём строки
authenticator =иinstaller =— что они значат, в таблице ниже. - Менять настройки — командой
certbot reconfigure, а не в редакторе: как поменять настройки.
Как выглядит файл
Для сертификата, полученного через --nginx, файл выглядит примерно так:
version = 5.9.0
archive_dir = /etc/letsencrypt/archive/example.ru
cert = /etc/letsencrypt/live/example.ru/cert.pem
privkey = /etc/letsencrypt/live/example.ru/privkey.pem
chain = /etc/letsencrypt/live/example.ru/chain.pem
fullchain = /etc/letsencrypt/live/example.ru/fullchain.pem
[renewalparams]
account = 1a2b3c4d5e6f…
authenticator = nginx
installer = nginx
server = https://acme-v02.api.letsencrypt.org/directory
key_type = ecdsaСтроки в [renewalparams] могут идти в другом порядке. Их бывает больше: Certbot записывает туда всё, что вы указали в команде при получении, — хуки, папку webroot, тип ключа.
Certbot 2.9.0 из пакета Ubuntu ставит первой строкой подсказку # renew_before_expiry = 30 days. Это комментарий, на продление он не влияет.
Какие строки за что отвечают
| Строка | Что значит |
|---|---|
version | какой версией Certbot записан файл |
archive_dir | папка, где лежат все версии сертификата |
cert, privkey, chain, fullchain | пути к файлам сертификата в /etc/letsencrypt/live/ (что лежит в /etc/letsencrypt) |
account | номер учётной записи Let's Encrypt на этом сервере |
server | адрес Let's Encrypt; если в нём есть acme-staging, это тестовый сервер, и браузеры такой сертификат не примут |
authenticator | способ проверки домена: nginx, webroot, standalone, manual |
installer | кто прописывает сертификат в веб-сервер: nginx; None — никто, сертификат подключали вы сами |
webroot_path и раздел [[webroot_map]] | папки для способа webroot |
renew_hook | команда после продления; так Certbot записывает ключ --deploy-hook (хуки) |
pre_hook, post_hook | команды до и после продления |
manual_auth_hook, manual_cleanup_hook | скрипты, которые ставят TXT-запись для wildcard |
key_type, elliptic_curve, rsa_key_size | тип ключа: ECDSA или RSA |
reuse_key = True | при продлении остаётся прежний закрытый ключ |
autorenew = False | сертификат получали с --no-autorenew, таймер его не продлевает |
Как поменять настройки: certbot reconfigure
Команда есть в Certbot с версии 2.3.0 — и в snap, и в пакете Ubuntu 24.04. Она меняет настройки продления, но сам сертификат не перевыпускает.
sudo certbot reconfigure --cert-name example.ru <новые ключи>Что происходит:
- Certbot берёт файл renewal и подставляет ваши ключи вместо старых значений.
- Делает пробное продление на тестовом сервере Let's Encrypt — с новыми настройками.
- Если пробное продление прошло, записывает новые настройки в файл и пишет
Successfully updated configuration.иChanges will apply when the certificate renews.Если не прошло — файл не меняется.
Если вы указали то же, что уже записано, ответ будет No changes were made to the renewal configuration.
Примеры:
| Что нужно | Команда |
|---|---|
| перезагружать nginx после продления | sudo certbot reconfigure --cert-name example.ru --deploy-hook "systemctl reload nginx" |
| перейти со standalone на nginx | sudo certbot reconfigure --cert-name example.ru --nginx (зачем) |
| останавливать nginx на время продления | sudo certbot reconfigure --cert-name example.ru --pre-hook "systemctl stop nginx" --post-hook "systemctl start nginx" |
Когда вы задаёте --deploy-hook, Certbot спросит, запускать ли хук при пробном продлении: Run deploy hooks или Do not run deploy hooks. Подробно — хуки Certbot.
После любой правки проверьте продление:
sudo certbot renew --cert-name example.ru --dry-runЧто reconfigure поменять не может
| Что | Почему | Что делать |
|---|---|---|
| домены | Certbot ответит You have specified domains, but this function cannot be used to modify the domains in a certificate. | добавить или убрать домен |
| учётную запись и сервер | ответ Using reconfigure to change the ACME account or server is not supported. | получить сертификат заново |
папку webroot, если в файле есть [[webroot_map]] | Certbot возьмёт пути из этого раздела, а не из нового -w | получить сертификат заново: webroot |
Ключи в команде renew
Ключи в certbot renew важнее файла: sudo certbot renew --cert-name example.ru --deploy-hook "…" выполнит продление с этим хуком. После настоящего продления Certbot запишет такие ключи в файл, а с --dry-run — нет.
Поэтому пробовать новые ключи можно через renew --dry-run, а сохранять — через reconfigure: он сохраняет только то, что прошло проверку.
Можно ли править файл вручную
Можно, но без проверки: ошибка в файле — и при следующем продлении Certbot пропустит сертификат со строкой Renewal configuration file /etc/letsencrypt/renewal/example.ru.conf is broken. Сертификат истечёт, а вы узнаете об этом от посетителей.
Если всё-таки правите в редакторе nano:
- Сохраните копию вне папки renewal — Certbot читает в ней все файлы
.conf, и копия с этим окончанием станет вторым сертификатом:sudo cp /etc/letsencrypt/renewal/example.ru.conf /root/example.ru.conf - Поправьте файл и сразу проверьте:
sudo certbot renew --cert-name example.ru --dry-run - Если проверка не прошла, верните копию:
sudo cp /root/example.ru.conf /etc/letsencrypt/renewal/example.ru.conf
Строка renew_before_expiry
Задаёт, за сколько до конца срока продлевать. Пишется в начале файла, до [renewalparams]:
renew_before_expiry = 30 daysВ Certbot 2.9.0 она уже есть первой строкой с # — уберите # и поставьте своё число дней.
Задавать её не нужно: Certbot и без неё продлевает вовремя — когда сертификат готов к продлению. В Certbot 5.9.0 Let's Encrypt сам подсказывает, когда продлевать, и Certbot продлит по тому сроку, что наступит раньше: по этой строке или по подсказке Let's Encrypt. Отложить продление этой строкой не получится.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Renewal configuration file … is broken. и ниже Skipping. | файл испорчен | верните копию или получите сертификат заново |
Renewal configuration file … does not specify an authenticator. Skipping. | из файла пропала строка authenticator = | верните копию или допишите строку в [renewalparams], например authenticator = nginx; reconfigure с таким файлом не работает и пишет Could not load certificate. See logs for errors. |
An existing certificate with name example.ru could not be found. | имя сертификата не то | имя — в sudo certbot certificates (команда) |
в журнале Certbot строка Attempting to parse the version 5.9.0 renewal configuration file found at … with version 2.9.0 of Certbot. This might not work. | файл записан snap-версией, а запускается версия из пакета Ubuntu | оставьте одну версию Certbot: какая у вас стоит |
| после reconfigure ничего не поменялось | ответ был No changes were made to the renewal configuration. | вы указали то, что уже записано, — проверьте ключи |
Всё сверено с Certbot 5.9.0 из snap. В Certbot 2.9.0 из пакета Ubuntu команды и тексты те же, отличие — строка-подсказка в начале файла.
Источники
- Исходный код Certbot 5.9.0: storage.py — что записывается в файл,
renew_hookвместоdeploy_hook. - Исходный код Certbot 5.9.0: renewal.py — какие строки читаются,
renew_before_expiry, сообщения о сломанном файле. - Исходный код Certbot 5.9.0: main.py — команда reconfigure.
- Справка Certbot: как поменять настройки продления — на английском.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Команда certbot renewкак идёт продление.
- Хуки Certbotкоманды до и после продления.
- Перенос сертификатов на другой серверчто делать с этими файлами при переезде.