К содержимому

Wildcard-сертификат Let's Encrypt на Ubuntu 24.04

Wildcard-сертификат *.example.com Let's Encrypt выдаёт только через проверку DNS-01: certbot создаёт TXT-запись _acme-challenge.example.com, и вы добавляете её в DNS вручную или плагином. Плагин nginx и проверка HTTP-01 для wildcard не подходят.

Руководство SSL 3 мин чтения

01Проверьте, что certbot установлен

На сервере уже должен быть certbot из репозитория Ubuntu 24.04 версии 2.9. Проверьте это одной командой. Если пакета нет, установите его: sudo apt install certbot python3-certbot-nginx.

bash
certbot --version

02Убедитесь, что DNS-зона доступна для правки

Для wildcard нужен доступ к DNS-записям домена: панель регистратора или API DNS-провайдера. Certbot покажет значение TXT-записи, которую надо добавить. Без этого выпустить *.example.com нельзя.

03Запустите выпуск wildcard-сертификата через DNS-01

Certbot с --manual и --preferred-challenges dns попросит добавить TXT-запись _acme-challenge.example.com со значением, которое выведет в консоль. Домен в -d указывайте с звёздочкой. Для проб используйте --staging, чтобы не тратить лимиты Let's Encrypt.

bash
sudo certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com

04Добавьте TXT-запись и дождитесь проверки

Скопируйте значение из вывода certbot в TXT-запись _acme-challenge.example.com у DNS-провайдера. TTL поставьте минимальный, например 60 секунд. Проверьте распространение записи командой dig с другого хоста, затем нажмите Enter в консоли certbot.

bash
dig +short TXT _acme-challenge.example.com

05Проверьте, что сертификат выпущен

Certbot покажет пути к файлам в /etc/letsencrypt/live/example.com/. Команда sudo certbot certificates выводит имя, домены и срок действия. Для wildcard в списке доменов будет *.example.com.

bash
sudo certbot certificates

06Подключите сертификат в nginx

В блоке server для HTTPS укажите ssl_certificate с fullchain.pem и ssl_certificate_key с privkey.pem. Путь берите из вывода certbot certificates: у wildcard он может отличаться от example.com. После правки проверьте конфиг и перезагрузите nginx.

nginx
server {
    listen 443 ssl;
    server_name example.com www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    root /var/www/example.com;
    index index.html;
}

07Перезагрузите nginx и проверьте HTTPS

Сначала проверьте синтаксис конфига, затем перезагрузите nginx. Откройте сайт по HTTPS и посмотрите на сертификат в браузере: он должен быть выдан Let's Encrypt и действовать на *.example.com. Проверку удобно сделать через openssl s_client.

bash
sudo nginx -t
sudo systemctl reload nginx
openssl s_client -connect example.com:443 -servername example.com </dev/null | openssl x509 -noout -subject -dates

08Настройте продление wildcard-сертификата

Сертификат Let's Encrypt действует 90 дней. Systemd-таймер certbot.timer запускает certbot renew, но для --manual продление требует снова добавить TXT-запись вручную. Проверьте таймер и сделайте пробное продление через --dry-run.

bash
systemctl list-timers | grep certbot
sudo certbot renew --dry-run

Частые ошибки

  • Пытаются выпустить *.example.com через certbot --nginx. Certbot отвечает, что wildcard нельзя подтвердить через HTTP-01.

    Для wildcard используйте только DNS-01: sudo certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com или DNS-плагин провайдера.

  • В ssl_certificate указан путь /etc/letsencrypt/live/example.com/fullchain.pem, а nginx падает с BIO_new_file() failed: сертификат выпущен под другим именем, например example.com-0001.

    Посмотрите реальные пути командой sudo certbot certificates и подставьте их в конфиг nginx.

  • Повторяют выпуск после ошибки и получают too many certificates (5) already issued for this exact set of identifiers.

    Сработал лимит дублей: 5 сертификатов на один набор имён за 7 дней. Используйте уже выпущенный сертификат или дождитесь срока из сообщения, для проб применяйте --staging.

  • TXT-запись _acme-challenge добавлена, но проверка DNS-01 не проходит: запись ещё не разошлась или указана не у того провайдера.

    Проверьте запись с другого хоста командой dig +short TXT _acme-challenge.example.com и дождитесь её появления перед подтверждением в certbot.

Deploykin

Как это делается в Deploykin

В Deploykin SSL выпускается из панели в один клик, для основного домена и всех алиасов, а дальше продлевается автоматически. Certbot и консоль для этого не нужны.

7 дней бесплатно на тарифе Про, без привязки карты.

Вопросы и ответы

Можно ли выпустить wildcard-сертификат Let's Encrypt через nginx-плагин?

Нет. Wildcard *.example.com подтверждается только через DNS-01, а плагин nginx использует HTTP-01. Нужен --manual --preferred-challenges dns или DNS-плагин провайдера.

Нужно ли добавлять в сертификат и *.example.com, и example.com?

Wildcard *.example.com не покрывает сам домен example.com. Укажите оба имени в одной команде: -d '*.example.com' -d example.com.

Как продлевается wildcard-сертификат?

certbot.timer запускает certbot renew, когда до конца срока остаётся меньше 30 дней. При выпуске через --manual продление потребует снова добавить TXT-запись, поэтому удобнее DNS-плагин провайдера.

Сколько wildcard-сертификатов можно выпустить за неделю?

Let's Encrypt разрешает 5 сертификатов на один и тот же набор имён за 7 дней и 50 сертификатов на зарегистрированный домен за 7 дней. Для проверок используйте --staging.

Ещё по теме

Сертификат Let's Encrypt: выпуск и настройка на сервере: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.