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

Команда certbot renew: как продлить сертификат и проверить продление

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

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

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

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Проверьте продление — команда ничего не меняет в ваших сертификатах:
    sudo certbot renew --dry-run
  3. Посмотрите на последние строки ответа: - Congratulations, all simulated renewals succeeded: — продление сработает, больше ничего делать не нужно; - All simulated renewals failed. или The following simulated renewals failed: — найдите причину на странице renew --dry-run не прошёл.
  4. Проверьте, что продление запускается само по расписанию, — автопродление Certbot.

Что делает certbot renew

Команда читает все файлы в /etc/letsencrypt/renewal/ — по одному на сертификат — и про каждый решает, пора ли его продлевать.

  • Если пора — Certbot получает новый сертификат тем же способом, что и в первый раз: способ записан в файле renewal. Новые файлы появляются в /etc/letsencrypt/live/имя/.
  • Если не пора — сертификат пропускается.

Вводить домены и отвечать на вопросы не нужно: всё берётся из файла renewal. Поэтому команду и запускает таймер без вас.

Когда сертификат считается готовым к продлению

Certbot 5.9.0 проверяет по порядку:

  1. Подсказка Let's Encrypt (ARI). Сервер Let's Encrypt сам говорит, когда продлевать. Certbot спрашивает его об этом с версии 4.1.0. Если Let's Encrypt соберётся отозвать сертификат, ARI попросит продлить его раньше, и Certbot сделает это сам.
  2. Отзыв через OCSP. Отозванный сертификат продлевается сразу. Let's Encrypt с августа 2025 года OCSP не поддерживает, для его сертификатов эту роль взял на себя ARI.
  3. Ваш срок renew_before_expiry, если вы его задали в файле renewal.
  4. Срок по умолчанию: когда осталась треть срока. Сертификат на 90 дней продлевается через 60 дней, на 64 дня — примерно через 43 дня. Сертификаты короче 10 дней продлеваются на половине срока.

В пакете Ubuntu 24.04 стоит Certbot 2.9.0: он не спрашивает ARI и продлевает за 30 дней до конца срока. Для сертификатов на 90 и 64 дня этого хватает.

Как прочитать ответ

Каждый сертификат в ответе начинается со строки Processing /etc/letsencrypt/renewal/example.ru.conf. Дальше одна из строк:

СтрокаЧто значит
Certificate not yet due for renewalсрок не подошёл, сертификат пропущен
Renewing an existing certificate for example.ruсертификат продлевается; при --dry-run — Simulating renewal of an existing certificate for example.ru
Failed to renew certificate example.ru with error: …продлить не вышло, причина — после error:

В конце — итог за все сертификаты:

ИтогЧто значит
The following certificates are not due for renewal yet: и строки … expires on 2027-01-20 (skipped)все сертификаты свежие, продлевать нечего
No renewals were attempted.ни один сертификат не продлевался
No hooks were run.ваши хуки не запускались, потому что продлевать было нечего
Congratulations, all renewals succeeded:всё продлено
The following renewals succeeded: и The following renewals failed:часть продлена, часть нет
All renewals failed. The following certificates could not be renewed:не продлился ни один

При --dry-run в этих строках вместо renewals написано simulated renewals.

Как проверить продление: --dry-run

sudo certbot renew --dry-run

С --dry-run Certbot проходит всё продление по-настоящему, но на тестовом сервере Let's Encrypt (staging). Ваши сертификаты в /etc/letsencrypt/live не меняются, а лимиты Let's Encrypt на выдачу не тратятся. Срок при этом не важен: проверяется каждый сертификат, даже свежий.

Запускайте --dry-run после каждой правки, которая может помешать продлению: смены настроек nginx, переноса сайта, правил фаервола, хуков.

С --dry-run хуки pre и post запускаются, а deploy — нет. Если хук останавливает nginx, во время проверки сайт тоже будет недоступен несколько секунд. Подробно — хуки Certbot.

Как продлить один сертификат

Если сертификатов несколько, а нужен один, укажите его имя:

sudo certbot renew --cert-name example.ru

Имя сертификата — строка Certificate Name: в ответе sudo certbot certificates (как читать). --dry-run с --cert-name тоже работает.

Как продлить сертификат досрочно

Срок не подошёл, а продлить нужно сейчас — например, вы поменяли ключ или ARI сообщил об отзыве, а ждать таймер не хочется:

sudo certbot renew --cert-name example.ru --force-renewal

--force-renewal продлевает без проверки срока. Без --cert-name команда продлит все сертификаты сразу.

Не ставьте --force-renewal в cron или таймер. Let's Encrypt ограничивает, сколько одинаковых сертификатов можно получить за неделю, и ежедневное принудительное продление упрётся в лимит — ошибка too many certificates.

Почему продление ждёт несколько минут

Когда certbot renew запускает таймер, перед первым продлением Certbot ждёт случайное время — до 8 минут. Так серверы по всему миру не обращаются к Let's Encrypt в одну секунду. Если вы запускаете команду сами в окне терминала, паузы нет. Пакет Ubuntu выключает паузу ключом --no-random-sleep-on-renew: его таймер и так выбирает случайное время в пределах 12 часов.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Certificate not yet due for renewal, а сертификат нужно продлитьсрок не подошёлsudo certbot renew --cert-name example.ru --force-renewal
Failed to renew certificate … with error: Some challenges have failed.Let's Encrypt не смог проверить доменSome challenges have failed
Could not bind TCP port 80порт 80 занят, а сертификат получен через standaloneCould not bind TCP port
An authentication script must be provided with --manual-auth-hook when using the manual plugin non-interactively.сертификат получен через --manual без хукаwildcard и manual
too many certificates (5) already issued for this exact set of identifiersслишком много принудительных продлений за неделюtoo many certificates
продление прошло, а браузер показывает старый срокnginx не перечитал сертификатsudo systemctl reload nginx, затем deploy-хук

Всё сверено с Certbot 5.9.0 из snap, отличия пакета Ubuntu 24.04 (Certbot 2.9.0) указаны отдельно.

Источники

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

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

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