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

Файл renewal Certbot: что в нём записано и как поменять настройки продления

Когда Certbot получает сертификат, он записывает все выбранные настройки в файл renewal: каким способом проверять домен, какие хуки запускать, какой ключ делать. При каждом продлении certbot renew берёт настройки отсюда — поэтому продление и идёт без вопросов. Здесь — как прочитать этот файл и как правильно его поменять.

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Посмотрите, какие файлы есть. На каждый сертификат — один файл, имя файла — имя сертификата:
    sudo ls /etc/letsencrypt/renewal/
  3. Откройте нужный для чтения:
    sudo cat /etc/letsencrypt/renewal/example.ru.conf
  4. Найдите в нём строки authenticator = и installer = — что они значат, в таблице ниже.
  5. Менять настройки — командой 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 <новые ключи>

Что происходит:

  1. Certbot берёт файл renewal и подставляет ваши ключи вместо старых значений.
  2. Делает пробное продление на тестовом сервере Let's Encrypt — с новыми настройками.
  3. Если пробное продление прошло, записывает новые настройки в файл и пишет 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 на nginxsudo 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:

  1. Сохраните копию вне папки renewal — Certbot читает в ней все файлы .conf, и копия с этим окончанием станет вторым сертификатом:
    sudo cp /etc/letsencrypt/renewal/example.ru.conf /root/example.ru.conf
  2. Поправьте файл и сразу проверьте:
    sudo certbot renew --cert-name example.ru --dry-run
  3. Если проверка не прошла, верните копию:
    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. Отложить продление этой строкой не получится.

Не ставьте срок больше, чем живёт сертификат. Тогда 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 команды и тексты те же, отличие — строка-подсказка в начале файла.

Источники

Сверено 6 ноября 2026 года.

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

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