Wildcard-сертификат Certbot на все поддомены: как получить и как продлевать
Wildcard-сертификат — это один сертификат на все поддомены сразу: shop.example.ru, blog.example.ru и любые новые. Получить его через --nginx нельзя: Let's Encrypt проверяет такой сертификат только через DNS. Здесь — как пройти эту проверку вручную, подключить сертификат к nginx и не забыть про продление.
Содержание 8
Что сделать прямо сейчас
Сначала решите, нужен ли wildcard. Если поддоменов два-три и они известны заранее, проще перечислить их через -d в одном сертификате — он будет продлеваться сам, без DNS: добавить домен в сертификат.
Если wildcard всё-таки нужен:
- Откройте панель, где управляете DNS домена — у регистратора или DNS-хостинга. Там нужно будет добавить TXT-запись.
- Подключитесь к серверу по SSH (как подключиться).
- Запустите получение сертификата. Звёздочку обязательно в одинарных кавычках:
sudo certbot certonly --manual --preferred-challenges dns -d example.ru -d '*.example.ru' - Certbot покажет имя и значение TXT-записи. Добавьте её в панели DNS — как в разделе ниже.
- Certbot попросит вторую запись с тем же именем и другим значением. Добавьте и её, первую не удаляйте.
- Проверьте, что обе записи видны, — с сервера или с вашего компьютера:
dig +short TXT _acme-challenge.example.ru @8.8.8.8В ответе должны быть оба значения.
- Вернитесь в окно с Certbot и нажмите Enter. Строка
Successfully received certificate.— сертификат получен. - Подключите его в nginx и настройте продление — разделы ниже.
Что покрывает wildcard
| Адрес | *.example.ru | example.ru |
|---|---|---|
example.ru | нет | да |
www.example.ru, shop.example.ru | да | нет |
a.shop.example.ru | нет | нет |
Звёздочка заменяет ровно один уровень. Поэтому в команде два -d: example.ru и *.example.ru, иначе основной домен окажется без сертификата.
Как добавить TXT-запись
Certbot показывает:
Please deploy a DNS TXT record under the name:
_acme-challenge.example.ru.
with the following value:
gfj9Xq...Rg85nMВ панели DNS:
| Поле | Что ввести |
|---|---|
| Тип | TXT |
| Имя (хост, поддомен) | _acme-challenge |
| Значение (текст) | строка из ответа Certbot целиком |
| TTL | самое маленькое из доступных |
Имя вводите так, как просит панель. Если она сама дописывает домен, а вы введёте _acme-challenge.example.ru, получится запись _acme-challenge.example.ru.example.ru — и проверка не пройдёт. Как устроены TXT-записи — TXT-запись.
Для example.ru и *.example.ru Certbot попросит две записи с одним и тем же именем _acme-challenge.example.ru. Это нормально: DNS разрешает несколько TXT-записей с одним именем. Certbot так и пишет — do not remove, replace, or undo the previous challenge tasks yet.
Новая запись появляется в DNS не сразу — по словам самого Certbot, от нескольких секунд до нескольких минут. Не нажимайте Enter, пока dig не покажет оба значения: если проверка не пройдёт, команду придётся запускать заново, и значения будут уже другие.
Если у домена есть CAA-запись, в ней должен быть разрешён letsencrypt.org.
Как подключить сертификат к nginx
С certonly Certbot только получает сертификат, nginx он не трогает. Добавьте строки в блок server каждого поддомена, который слушает 443 порт:
ssl_certificate /etc/letsencrypt/live/example.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.ru/privkey.pem;Путь — из строки Certificate is saved at: в ответе Certbot. Затем:
sudo nginx -t && sudo systemctl reload nginxКак устроен блок с https — перенаправление на https и настройки nginx.
Как продлевать сертификат с manual
После получения Certbot предупреждает:
This certificate will not be renewed automatically.Причина: при продлении никто не добавит новую TXT-запись. Таймер запустит certbot renew, и продление закончится ошибкой An authentication script must be provided with --manual-auth-hook when using the manual plugin non-interactively.
Есть три пути:
| Путь | Что делать | Подходит, если |
|---|---|---|
| продлевать вручную | раз в 1–2 месяца повторять ту же команду certonly --manual и менять TXT-записи | сертификат нужен ненадолго |
| скрипт-хук | написать скрипт, который сам добавляет TXT-запись через API DNS-хостинга | у DNS-хостинга есть API |
| отказаться от wildcard | перечислить нужные поддомены через -d в одном сертификате | поддоменов немного |
Ручное продление удобно забыть. Сертификаты Let's Encrypt живут 90 дней, с 10 февраля 2027 года — 64, а Let's Encrypt больше не присылает писем о том, что срок кончается. Поставьте себе напоминание или выберите второй или третий путь.
Как устроен скрипт-хук
Certbot запускает скрипт --manual-auth-hook для каждой записи и передаёт ему:
| Переменная | Что в ней |
|---|---|
CERTBOT_DOMAIN | домен без *.: example.ru |
CERTBOT_VALIDATION | значение для TXT-записи |
CERTBOT_REMAINING_CHALLENGES | сколько записей осталось после этой |
CERTBOT_ALL_DOMAINS | все домены сертификата через запятую |
Скрипт должен добавить TXT-запись _acme-challenge.$CERTBOT_DOMAIN со значением $CERTBOT_VALIDATION и подождать, пока она появится в DNS. Как именно добавить запись — зависит от API вашего DNS-хостинга, смотрите его справку. Второй скрипт, --manual-cleanup-hook, удаляет запись после проверки.
Получите сертификат заново, уже с хуками, — Certbot запомнит их в файле renewal:
sudo certbot certonly --manual --preferred-challenges dns \
--manual-auth-hook /etc/letsencrypt/dns-auth.sh \
--manual-cleanup-hook /etc/letsencrypt/dns-cleanup.sh \
-d example.ru -d '*.example.ru'Скрипты должны быть исполняемыми: sudo chmod 700 /etc/letsencrypt/dns-*.sh (права на файлы). Затем проверьте продление:
sudo certbot renew --dry-runCongratulations, all simulated renewals succeeded: — сертификат будет продлеваться сам.
У Certbot есть готовые плагины для API нескольких DNS-сервисов — список в справке Certbot. Если вашего DNS-хостинга там нет, нужен свой скрипт.
После продления nginx нужно перечитать сертификат — добавьте deploy-хук: хуки Certbot.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
Client with the currently selected authenticator does not support any combination of challenges that will satisfy the CA. | wildcard просили через --nginx, --webroot или --standalone | только --manual --preferred-challenges dns или DNS-плагин |
DNS problem: NXDOMAIN looking up TXT for _acme-challenge.example.ru | записи ещё нет в DNS или имя введено с лишним доменом | проверьте dig, затем запустите команду заново |
Incorrect TXT record | значение не то: старое от прошлой попытки или скопировано не целиком | удалите старые записи _acme-challenge, запустите заново |
An authentication script must be provided with --manual-auth-hook when using the manual plugin non-interactively. | таймер пытается продлить сертификат без хука | как продлевать |
| в сертификате не те домены, что вы ждали | звёздочка без кавычек, и оболочка подставила вместо неё имена файлов из текущей папки | пишите '*.example.ru' в одинарных кавычках |
Some challenges have failed. | одна из проверок не прошла | смотрите строку Detail: выше, разбор |
Всё сверено с Certbot 5.9.0 из snap. В Certbot 2.9.0 из пакета Ubuntu команды и тексты те же.
Источники
- Исходный код Certbot 5.9.0: плагин manual — тексты про TXT-запись, переменные для хука.
- Исходный код Certbot 5.9.0: main.py — предупреждение, что сертификат с manual не продлится сам.
- Справка Certbot: хуки для manual — на английском.
- Let's Encrypt: письма о сроке больше не приходят — на английском.
Сверено 6 ноября 2026 года.
Что почитать дальше
- TXT-записькак она устроена.
- Хуки Certbotперезагрузить nginx после продления.
- Добавить домен в сертификатесли поддоменов немного.