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 не подходят.
01Проверьте, что certbot установлен
На сервере уже должен быть certbot из репозитория Ubuntu 24.04 версии 2.9. Проверьте это одной командой. Если пакета нет, установите его: sudo apt install certbot python3-certbot-nginx.
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.
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.
dig +short TXT _acme-challenge.example.com
05Проверьте, что сертификат выпущен
Certbot покажет пути к файлам в /etc/letsencrypt/live/example.com/. Команда sudo certbot certificates выводит имя, домены и срок действия. Для wildcard в списке доменов будет *.example.com.
sudo certbot certificates
06Подключите сертификат в nginx
В блоке server для HTTPS укажите ssl_certificate с fullchain.pem и ssl_certificate_key с privkey.pem. Путь берите из вывода certbot certificates: у wildcard он может отличаться от example.com. После правки проверьте конфиг и перезагрузите 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.
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.
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.
Ещё по теме
- Руководство · SSL Установка и настройка Certbot для nginx на Ubuntu 24.04 Пошаговая инструкция: установка certbot и плагина nginx, выпуск сертификата Let's Encrypt, проверка, автопродление и типичные ошибки с решениями.
- Руководство · SSL Самоподписанный SSL сертификат: настройка Let's Encrypt на Ubuntu 24.04 Как выпустить SSL сертификат Let's Encrypt на Ubuntu 24.04: установка certbot, настройка nginx, проверка продления и типичные ошибки.
- Руководство · SSL Как получить SSL-сертификат Минцифры на Ubuntu 24.04: пошаговое руководство Пошаговая инструкция по выпуску SSL-сертификата Let's Encrypt на Ubuntu 24.04 с nginx: команды certbot, настройка, проверка и типичные ошибки.
- Руководство · SSL Недействительный SSL сертификат: настройка Let's Encrypt на Ubuntu 24.04 Как выпустить и проверить SSL-сертификат Let's Encrypt на Ubuntu 24.04: установка certbot, команды, конфиг nginx и разбор ошибок проверки домена.
- Руководство · SSL Как получить сертификат Let's Encrypt на Ubuntu 24.04 Пошаговая инструкция: как получить SSL-сертификат Let's Encrypt на Ubuntu 24.04 с nginx. Команды certbot, проверка домена и порта 80, тестовый выпуск и продление.
- Руководство · SSL Как скачать сертификат Let's Encrypt на сервере Ubuntu 24.04 Скачать сертификат Let's Encrypt с сайта нельзя. Пошагово выпускаем его через Certbot на Ubuntu 24.04, находим файлы fullchain.pem и privkey.pem и проверяем HTTPS.
Сертификат Let's Encrypt: выпуск и настройка на сервере: все материалы темы