Команда certbot renew: как продлить сертификат и проверить продление
Команда certbot renew проходит по всем сертификатам на сервере и продлевает те, у которых подходит срок. Остальные она пропускает — это не ошибка. Здесь — как проверить, что продление сработает, как продлить один сертификат или продлить его прямо сейчас и что значит каждая строка ответа.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте продление — команда ничего не меняет в ваших сертификатах:
sudo certbot renew --dry-run - Посмотрите на последние строки ответа: -
Congratulations, all simulated renewals succeeded:— продление сработает, больше ничего делать не нужно; -All simulated renewals failed.илиThe following simulated renewals failed:— найдите причину на странице renew --dry-run не прошёл. - Проверьте, что продление запускается само по расписанию, — автопродление Certbot.
Что делает certbot renew
Команда читает все файлы в /etc/letsencrypt/renewal/ — по одному на сертификат — и про каждый решает, пора ли его продлевать.
- Если пора — Certbot получает новый сертификат тем же способом, что и в первый раз: способ записан в файле renewal. Новые файлы появляются в
/etc/letsencrypt/live/имя/. - Если не пора — сертификат пропускается.
Вводить домены и отвечать на вопросы не нужно: всё берётся из файла renewal. Поэтому команду и запускает таймер без вас.
Когда сертификат считается готовым к продлению
Certbot 5.9.0 проверяет по порядку:
- Подсказка Let's Encrypt (ARI). Сервер Let's Encrypt сам говорит, когда продлевать. Certbot спрашивает его об этом с версии 4.1.0. Если Let's Encrypt соберётся отозвать сертификат, ARI попросит продлить его раньше, и Certbot сделает это сам.
- Отзыв через OCSP. Отозванный сертификат продлевается сразу. Let's Encrypt с августа 2025 года OCSP не поддерживает, для его сертификатов эту роль взял на себя ARI.
- Ваш срок
renew_before_expiry, если вы его задали в файле renewal. - Срок по умолчанию: когда осталась треть срока. Сертификат на 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 занят, а сертификат получен через standalone | Could 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) указаны отдельно.
Источники
- Исходный код Certbot 5.9.0: renewal.py — порядок проверки срока, треть срока по умолчанию, строки ответа, пауза до 8 минут.
- Журнал изменений Certbot — продление на трети срока с 4.0.0, ARI с 4.1.0, без ARI при --dry-run с 4.1.1.
- Справка Certbot: продление — на английском: --dry-run, --force-renewal, --cert-name.
- Служба certbot.service пакета Debian и Ubuntu —
certbot -q renew --no-random-sleep-on-renew.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Автопродление Certbotкто и когда запускает renew.
- Хуки Certbotперезагрузить nginx после продления.
- renew --dry-run не прошёлразбор ошибок проверки.