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

Wildcard-сертификат Certbot на все поддомены: как получить и как продлевать

Wildcard-сертификат — это один сертификат на все поддомены сразу: shop.example.ru, blog.example.ru и любые новые. Получить его через --nginx нельзя: Let's Encrypt проверяет такой сертификат только через DNS. Здесь — как пройти эту проверку вручную, подключить сертификат к nginx и не забыть про продление.

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

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

Сначала решите, нужен ли wildcard. Если поддоменов два-три и они известны заранее, проще перечислить их через -d в одном сертификате — он будет продлеваться сам, без DNS: добавить домен в сертификат.

Если wildcard всё-таки нужен:

  1. Откройте панель, где управляете DNS домена — у регистратора или DNS-хостинга. Там нужно будет добавить TXT-запись.
  2. Подключитесь к серверу по SSH (как подключиться).
  3. Запустите получение сертификата. Звёздочку обязательно в одинарных кавычках:
    sudo certbot certonly --manual --preferred-challenges dns -d example.ru -d '*.example.ru'
  4. Certbot покажет имя и значение TXT-записи. Добавьте её в панели DNS — как в разделе ниже.
  5. Certbot попросит вторую запись с тем же именем и другим значением. Добавьте и её, первую не удаляйте.
  6. Проверьте, что обе записи видны, — с сервера или с вашего компьютера:
    dig +short TXT _acme-challenge.example.ru @8.8.8.8

    В ответе должны быть оба значения.

  7. Вернитесь в окно с Certbot и нажмите Enter. Строка Successfully received certificate. — сертификат получен.
  8. Подключите его в nginx и настройте продление — разделы ниже.

Что покрывает wildcard

Адрес*.example.ruexample.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-run

Congratulations, 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 команды и тексты те же.

Источники

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

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

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