Перейти к содержимому

Статья 36 из 141

Безопасность

Wildcard-сертификат Let's Encrypt (*.example.com) через DNS-01: certbot с Cloudflare и acme.sh

Wildcard-сертификат *.example.com подходит для любого поддомена первого уровня: panel.example.com, api.example.com, n8n.example.com. Он удобен, когда поддоменов много или они появляются часто. Let’s Encrypt выдаёт такие сертификаты бесплатно, но только через проверку DNS-01: вы доказываете владение доменом, создав TXT-запись _acme-challenge.example.com.

Обычный сертификат на один-два домена проще получить через HTTP-проверку: Let’s Encrypt и certbot.

Вопрос Ответ
Какой тип проверки Только DNS-01. HTTP-проверка для wildcard не работает
Что покрывает *.example.com Поддомены первого уровня. Не покрывает сам example.com и a.b.example.com
Срок действия Сейчас 90 дней. Let’s Encrypt постепенно сокращает срок, поэтому продление должно быть автоматическим
Что нужно для автопродления API вашего DNS-провайдера, который поддерживает certbot или acme.sh

Если попросить wildcard через HTTP-проверку, certbot откажет. Так выглядит ответ при --standalone:

Simulating a certificate request for *.example.com
Client with the currently selected authenticator does not support any combination of challenges that will satisfy the CA.

Поэтому в запросе всегда указывайте два имени: example.com и *.example.com. Тогда один сертификат покроет и корень, и поддомены.

Подходит, если DNS домена обслуживает Cloudflare. Для других провайдеров есть свои плагины certbot-dns-* с тем же принципом работы.

В панели Cloudflare откройте «My Profile → API Tokens → Create Token» и выберите шаблон «Edit zone DNS». В разделе зон оставьте только нужный домен. Токен с правом Zone → DNS → Edit на одну зону безопаснее глобального API-ключа.

Сохраните токен на сервере:

Окно терминала
mkdir -p /root/.secrets
nano /root/.secrets/cloudflare.ini
dns_cloudflare_api_token = ВАШ_ТОКЕН_CLOUDFLARE
Окно терминала
chmod 600 /root/.secrets/cloudflare.ini

Если оставить права шире, certbot предупредит: Unsafe permissions on credentials configuration file.

Рекомендуемый способ от разработчиков certbot — snap. На ноябрь 2026 в канале stable версия 5.10.0:

Окно терминала
snap install --classic certbot
ln -s /snap/bin/certbot /usr/bin/certbot
snap set certbot trust-plugin-with-root=ok
snap install certbot-dns-cloudflare

Если certbot уже стоит из apt, удалите его перед установкой из snap: apt remove certbot.

Вариант через apt в Ubuntu 24.04 тоже рабочий, но старее (certbot 2.9.0, плагин 2.0.0):

Окно терминала
apt install -y certbot python3-certbot-dns-cloudflare

Проверьте, что плагин виден:

Окно терминала
certbot plugins
* dns-cloudflare
Description: Obtain certificates using a DNS TXT record (if you are using
...
* standalone
* webroot

Сначала всегда --dry-run. Он обращается к тестовому серверу Let’s Encrypt и не тратит лимиты:

Окно терминала
certbot certonly \
--dns-cloudflare \
--dns-cloudflare-credentials /root/.secrets/cloudflare.ini \
--dns-cloudflare-propagation-seconds 30 \
-d example.com -d '*.example.com' \
--dry-run

Звёздочку берите в кавычки, иначе оболочка может подставить вместо неё имена файлов.

Если токен неверный, ошибка будет такой:

Simulating a certificate request for example.com and *.example.com
Error determining zone_id: 9109 Error code: 403 - {'success': False, 'errors': [{'code': 9109, 'message': 'Invalid access token'}], ...

С правильным токеном пробный запуск заканчивается строкой The dry run was successful.

Уберите --dry-run и запустите ту же команду. Certbot сам создаст TXT-запись через API, подождёт указанное число секунд, пройдёт проверку и удалит запись. Файлы окажутся в /etc/letsencrypt/live/example.com/:

Файл Что это
fullchain.pem сертификат с цепочкой, указывается в ssl_certificate
privkey.pem закрытый ключ, указывается в ssl_certificate_key

Один сертификат на все поддомены:

server {
listen 443 ssl;
server_name panel.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
}
}

Подробнее про настройку сервера: Nginx.

certbot из snap и из apt ставит таймер, который дважды в день проверяет сертификаты (в пакете apt это certbot.timer). Сертификаты, полученные через DNS-плагин, продлеваются сами, параметры сохранены в /etc/letsencrypt/renewal/example.com.conf.

Чтобы Nginx подхватил новый сертификат, добавьте хук перезагрузки:

Окно терминала
certbot reconfigure --cert-name example.com --deploy-hook "systemctl reload nginx"
certbot renew --dry-run

--deploy-hook выполняется только после успешного продления.

Если API DNS-провайдера нет, можно выпустить сертификат вручную:

Окно терминала
certbot certonly --manual --preferred-challenges dns -d example.com -d '*.example.com'

Certbot покажет имя _acme-challenge.example.com и значение для TXT-записи. Для двух имён значений будет два, и обе записи с одинаковым именем должны существовать одновременно. Создайте их в панели DNS и перед нажатием Enter проверьте:

Окно терминала
dig TXT _acme-challenge.example.com +short

Главный минус: такой сертификат не продлевается автоматически. При запуске без участия человека certbot останавливается с ошибкой:

The manual plugin is not working; there may be problems with your existing configuration.
The error was: PluginError('An authentication script must be provided with --manual-auth-hook when using the manual plugin non-interactively.')

Значит, каждые два-три месяца вам придётся повторять процедуру руками, иначе сайт откроется с ошибкой сертификата. Выход: свой скрипт в --manual-auth-hook, который создаёт TXT-запись через API провайдера (certbot передаёт значение в переменной CERTBOT_VALIDATION), или переход на DNS-провайдера с поддержкой API. Ручной режим годится для разовой проверки, но не для рабочего сайта.

acme.sh — скрипт на shell без зависимостей от Python. Он поддерживает больше сотни DNS-провайдеров. На ноябрь 2026 актуальна версия 3.1.7.

Окно терминала
curl https://get.acme.sh | sh -s email=you@your-domain.ru
source ~/.bashrc

Укажите реальный email: адреса на служебных доменах вроде example.org Let’s Encrypt отклоняет. Установщик добавляет задание cron для продления, проверить можно командой crontab -l.

По умолчанию acme.sh выпускает сертификаты у ZeroSSL. Переключите на Let’s Encrypt:

Окно терминала
acme.sh --set-default-ca --server letsencrypt

Выпуск через Cloudflare. Токен нужен с теми же правами, что и для certbot:

Окно терминала
export CF_Token="ВАШ_ТОКЕН_CLOUDFLARE"
acme.sh --issue --dns dns_cf -d example.com -d '*.example.com' --staging

--staging работает как пробный запуск. Если всё прошло, повторите команду без него и с --force. После первого успешного запуска acme.sh сохраняет токен в ~/.acme.sh/account.conf, и продление работает без export.

Не используйте файлы из ~/.acme.sh/ напрямую. Установите сертификат в постоянное место с командой перезагрузки:

Окно терминала
mkdir -p /etc/ssl/example.com
acme.sh --install-cert -d example.com --ecc \
--key-file /etc/ssl/example.com/privkey.pem \
--fullchain-file /etc/ssl/example.com/fullchain.pem \
--reloadcmd "systemctl reload nginx"

По умолчанию acme.sh создаёт ECC-ключ, поэтому нужен флаг --ecc. При каждом продлении acme.sh скопирует файлы заново и перезагрузит Nginx.

Симптом Причина и решение
does not support any combination of challenges Wildcard запрошен через HTTP-проверку. Нужен DNS-плагин или --manual --preferred-challenges dns.
Invalid access token или Error determining zone_id Неверный токен Cloudflare или у него нет доступа к этой зоне.
No TXT record found at _acme-challenge... Запись не успела распространиться. Увеличьте --dns-cloudflare-propagation-seconds до 60–120.
Сертификат не подходит для example.com В запросе был только *.example.com. Добавьте -d example.com.
Не открывается a.b.example.com Wildcard покрывает один уровень. Нужен отдельный *.b.example.com.
Продление падает с --manual-auth-hook Сертификат получен вручную. Перевыпустите через DNS-плагин.
Новый сертификат выпущен, а браузер видит старый Nginx не перезагружен. Добавьте --deploy-hook или --reloadcmd.
too many certificates Лимит Let’s Encrypt на повторные выпуски. Отлаживайте с --dry-run или --staging.