Поиск
Справочник

Certbot webroot: сертификат без остановки сайта и без правки nginx

Webroot — способ, при котором Certbot кладёт проверочный файл в папку сайта, а уже работающий nginx отдаёт его Let's Encrypt. Сайт при этом не останавливается, а настройки nginx Certbot не трогает. Нужно одно: правильно указать папку, из которой nginx отдаёт сайт.

≈ 7 мин чтения
Содержание 10

Что сделать прямо сейчас

  1. Подключитесь к серверу по SSH (как подключиться).
  2. Найдите папку сайта — директиву root в настройках nginx:
    sudo grep -Rn "root " /etc/nginx/sites-enabled/

    Нужна строка из блока server с вашим доменом, например root /var/www/example.ru;. Подробнее — root и alias в nginx.

  3. Проверьте, что файл из этой папки открывается по 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 — всё готово. Другой ответ — смотрите раздел если проверочный файл не открывается.

  4. Удалите проверочный файл:
    sudo rm /var/www/example.ru/.well-known/acme-challenge/test
  5. Получите сертификат. После -w — папка из шага 2, после -d — домены:
    sudo certbot certonly --webroot -w /var/www/example.ru -d example.ru -d www.example.ru
  6. Строка Successfully received certificate. — сертификат получен. Путь к нему — в строке Certificate is saved at:. Подключите его в nginx и добавьте хук, чтобы nginx перечитывал сертификат после продления, — раздел ниже.

Как работает webroot

  1. Certbot кладёт файл с длинным случайным именем в папку .well-known/acme-challenge/ внутри папки из -w.
  2. Let's Encrypt открывает этот файл по адресу http://example.ru/.well-known/acme-challenge/имя — по 80 порту.
  3. Если 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 нет папки с файлами сайта: все адреса он передаёт приложению. Тогда сделайте для проверочных файлов отдельную папку.

  1. Создайте папку:
    sudo mkdir -p /var/www/letsencrypt
  2. В блок server с вашим доменом, который слушает 80 порт, добавьте ещё один location:
    location ^~ /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
    }

    ^~ значит: для этих адресов nginx не смотрит другие location с регулярными выражениями — поэтому не сработает и запрет на скрытые папки. Подробнее — директива location.

  3. Проверьте настройки и перезагрузите nginx:
    sudo nginx -t && sudo systemctl reload nginx
  4. Получайте сертификат с этой папкой:
    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 не трогает. Сделайте два шага.

  1. Пропишите сертификат в блок 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
  2. Добавьте хук, который перезагружает 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/…: 404nginx отдаёт сайт не из папки -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.просили wildcardwildcard через 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.

Источники

Сверено 6 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше