Статья 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.comClient with the currently selected authenticator does not support any combination of challenges that will satisfy the CA.Поэтому в запросе всегда указывайте два имени: example.com и *.example.com. Тогда один сертификат покроет и корень, и поддомены.
Способ 1: certbot с плагином Cloudflare
Заголовок раздела «Способ 1: certbot с плагином Cloudflare»Подходит, если DNS домена обслуживает Cloudflare. Для других провайдеров есть свои плагины certbot-dns-* с тем же принципом работы.
Токен Cloudflare
Заголовок раздела «Токен Cloudflare»В панели Cloudflare откройте «My Profile → API Tokens → Create Token» и выберите шаблон «Edit zone DNS». В разделе зон оставьте только нужный домен. Токен с правом Zone → DNS → Edit на одну зону безопаснее глобального API-ключа.
Сохраните токен на сервере:
mkdir -p /root/.secretsnano /root/.secrets/cloudflare.inidns_cloudflare_api_token = ВАШ_ТОКЕН_CLOUDFLAREchmod 600 /root/.secrets/cloudflare.iniЕсли оставить права шире, certbot предупредит: Unsafe permissions on credentials configuration file.
Установка
Заголовок раздела «Установка»Рекомендуемый способ от разработчиков certbot — snap. На ноябрь 2026 в канале stable версия 5.10.0:
snap install --classic certbotln -s /snap/bin/certbot /usr/bin/certbotsnap set certbot trust-plugin-with-root=oksnap 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-cloudflareDescription: 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.comError 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 |
Подключение к Nginx
Заголовок раздела «Подключение к Nginx»Один сертификат на все поддомены:
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. Ручной режим годится для разовой проверки, но не для рабочего сайта.
Способ 2: acme.sh
Заголовок раздела «Способ 2: acme.sh»acme.sh — скрипт на shell без зависимостей от Python. Он поддерживает больше сотни DNS-провайдеров. На ноябрь 2026 актуальна версия 3.1.7.
curl https://get.acme.sh | sh -s email=you@your-domain.rusource ~/.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.comacme.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. |