Certbot webroot: сертификат без остановки сайта и без правки nginx
Webroot — способ, при котором Certbot кладёт проверочный файл в папку сайта, а уже работающий nginx отдаёт его Let's Encrypt. Сайт при этом не останавливается, а настройки nginx Certbot не трогает. Нужно одно: правильно указать папку, из которой nginx отдаёт сайт.
Содержание 10
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Найдите папку сайта — директиву
rootв настройках nginx:sudo grep -Rn "root " /etc/nginx/sites-enabled/Нужна строка из блока
serverс вашим доменом, напримерroot /var/www/example.ru;. Подробнее — root и alias в nginx. - Проверьте, что файл из этой папки открывается по http. Создайте проверочный файл:
sudo mkdir -p /var/www/example.ru/.well-known/acme-challenge echo ok | sudo tee /var/www/example.ru/.well-known/acme-challenge/testОткройте его:
curl http://example.ru/.well-known/acme-challenge/testОтвет
ok— всё готово. Другой ответ — смотрите раздел если проверочный файл не открывается. - Удалите проверочный файл:
sudo rm /var/www/example.ru/.well-known/acme-challenge/test - Получите сертификат. После
-w— папка из шага 2, после-d— домены:sudo certbot certonly --webroot -w /var/www/example.ru -d example.ru -d www.example.ru - Строка
Successfully received certificate.— сертификат получен. Путь к нему — в строкеCertificate is saved at:. Подключите его в nginx и добавьте хук, чтобы nginx перечитывал сертификат после продления, — раздел ниже.
Как работает webroot
- Certbot кладёт файл с длинным случайным именем в папку
.well-known/acme-challenge/внутри папки из-w. - Let's Encrypt открывает этот файл по адресу
http://example.ru/.well-known/acme-challenge/имя— по 80 порту. - Если nginx отдал файл с нужным содержимым, домен подтверждён. Certbot удаляет файл.
Let's Encrypt идёт по перенаправлениям — до 10 подряд, только на 80 и 443 порт, — и сертификат на https при этом не проверяет. Поэтому перенаправление с http на https получению не мешает: главное, чтобы файл открывался по конечному адресу.
Wildcard-сертификат так не получить: Certbot прямо пишет про webroot HTTP challenge only (wildcards not supported). Для *.example.ru нужен wildcard через DNS.
Webroot, nginx или standalone
| Способ | Что делает | Когда выбирать |
|---|---|---|
--nginx | сам находит блок server, получает сертификат, прописывает его в nginx и перезагружает nginx после продления | сайт на nginx, вас устраивает, что Certbot правит настройки |
certonly --webroot | кладёт файл в папку сайта, nginx не трогает | настройки nginx вы ведёте сами или их правит панель |
certonly --standalone | на время проверки сам занимает 80 порт | на сервере нет веб-сервера, standalone |
Если проверочный файл не открывается
Ответ curl | Причина | Что сделать |
|---|---|---|
404 Not Found | папка из -w не та, из которой nginx отдаёт сайт, или запрос попал в другой блок server | проверьте root и server_name в блоке с вашим доменом |
403 Forbidden | в настройках есть запрет на скрытые папки, например location ~ /\. { deny all; } | добавьте отдельный location, как в разделе ниже |
| страница сайта или ответ приложения | nginx передаёт все адреса приложению на Node.js, Python или в контейнере | отдельный location, как в разделе ниже |
| ничего не приходит, команда долго ждёт | 80 порт закрыт | откройте его: sudo ufw allow 80/tcp (команда ufw) |
Если сайт — это приложение
Когда сайт — это приложение на Node.js, Python или в контейнере, у nginx нет папки с файлами сайта: все адреса он передаёт приложению. Тогда сделайте для проверочных файлов отдельную папку.
- Создайте папку:
sudo mkdir -p /var/www/letsencrypt - В блок
serverс вашим доменом, который слушает 80 порт, добавьте ещё одинlocation:location ^~ /.well-known/acme-challenge/ { root /var/www/letsencrypt; }^~значит: для этих адресов nginx не смотрит другиеlocationс регулярными выражениями — поэтому не сработает и запрет на скрытые папки. Подробнее — директива location. - Проверьте настройки и перезагрузите nginx:
sudo nginx -t && sudo systemctl reload nginx - Получайте сертификат с этой папкой:
sudo certbot certonly --webroot -w /var/www/letsencrypt -d example.ru -d www.example.ru
Если в блоке на 80 порту стоит только return 301 https://…, добавьте этот location в блок на 443 порту: Let's Encrypt пройдёт по перенаправлению и запросит файл уже по https.
Несколько сайтов в одной команде
Каждый -w действует на домены -d, которые идут после него:
sudo certbot certonly --webroot \
-w /var/www/example.ru -d example.ru -d www.example.ru \
-w /var/www/shop -d shop.example.ruПолучится один сертификат на три домена. Первый -w должен стоять раньше всех -d, иначе Certbot ответит If you specify multiple webroot paths, one of them must precede all …
Для разных сайтов проще получить отдельные сертификаты — по команде на сайт. Тогда ошибка проверки одного сайта не помешает продлению другого.
Что сделать после получения
С certonly Certbot nginx не трогает. Сделайте два шага.
- Пропишите сертификат в блок
serverна 443 порту и перезагрузите nginx:ssl_certificate /etc/letsencrypt/live/example.ru/fullchain.pem; ssl_certificate_key /etc/letsencrypt/live/example.ru/privkey.pem;sudo nginx -t && sudo systemctl reload nginx - Добавьте хук, который перезагружает nginx после каждого продления, иначе nginx будет отдавать старый сертификат: как перезагрузить nginx после продления.
Папку из -w Certbot запоминает в файле renewal: строки authenticator = webroot, webroot_path = и раздел [[webroot_map]] с доменами. Продление пойдёт через ту же папку. Проверьте его:
sudo certbot renew --dry-runЕсли папку сайта потом перенесли, продление не пройдёт. Получите сертификат заново с новой папкой и тем же именем — sudo certbot certonly --webroot -w /новая/папка --cert-name example.ru -d example.ru -d www.example.ru — и на вопрос Certbot выберите Renew & replace the certificate.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
/var/www/example.ru does not exist or is not a directory | такой папки нет | проверьте путь в root у nginx: шаг 2 |
Invalid response from http://example.ru/.well-known/acme-challenge/…: 404 | nginx отдаёт сайт не из папки -w | если файл не открывается, разбор 404 |
Invalid response from …: 403 | запрет на скрытые папки в nginx | отдельный location |
Timeout during connect (likely firewall problem) | 80 порт закрыт | разбор ошибки |
Connection refused | на 80 порту никто не слушает | разбор ошибки |
Every requested identifier must have a webroot when using the webroot plugin. | папку не указали: нет -w или на вопрос Input the webroot for нажали отмену | добавьте -w с папкой перед -d |
Client with the currently selected authenticator does not support any combination of challenges that will satisfy the CA. | просили wildcard | wildcard через DNS |
Всё сверено с Certbot 5.9.0 из snap. В Certbot 2.9.0 из пакета Ubuntu команды те же, а в двух строках вместо identifier написано domain: Every requested domain must have a webroot when using the webroot plugin. и …must precede all domain flags.
Источники
- Исходный код Certbot 5.9.0: плагин webroot — папка
.well-known/acme-challenge, ключи-wи--webroot-map, тексты ошибок. - Справка Certbot: webroot — на английском.
- Let's Encrypt: способы проверки домена — на английском: только 80 порт, до 10 перенаправлений.
Сверено 6 ноября 2026 года.
Что почитать дальше
- Хуки Certbotперезагрузить nginx после продления.
- Standaloneесли на сервере нет веб-сервера.
- Invalid response 404если проверка не проходит.