Certbot

18 ноября 2026 · ~15 мин чтения

инструмент безопасность tls веб devops

Certbot

Certbot — это бесплатная консольная утилита с открытым исходным кодом от фонда Electronic Frontier Foundation (EFF), которая автоматически выпускает, подключает к веб-серверу и без участия человека продлевает криптографические TLS-сертификаты по протоколу ACME.

История

История Certbot выросла из главной головной боли веба начала 2010-х. К 2014 году больше половины мирового трафика всё ещё передавалась открытым текстом по незашифрованному HTTP. Причиной был высокий барьер входа: коммерческий TLS-сертификат (цифровой документ, подтверждающий подлинность домена и включающий шифрование) стоил от десятков до сотен долларов в год, а его выпуск превращался в ручной квест. Администратору приходилось генерировать ключи в консоли, отправлять заявку, ловить проверочное письмо на admin@example.ru, склеивать файлы цепочки сертификатов в нужном порядке и прописывать их в веб-сервере. А через год кто-нибудь забывал повторить процедуру — и живой сайт встречал клиентов красным экраном «Ваше подключение не защищено».

Чтобы зашифровать весь веб по умолчанию, правозащитный фонд Electronic Frontier Foundation (EFF) из Сан-Франциско (США) объединился с Mozilla Foundation, Мичиганским университетом, Cisco и Akamai в некоммерческий консорциум ISRG (Internet Security Research Group) — так родился бесплатный автоматизированный удостоверяющий центр Let's Encrypt. Но серверу выдачи сертификатов нужен был умный напарник на стороне обычного администратора. Первые версии такого клиента в 2014–2015 годах создали главный научный сотрудник EFF Питер Эккерсли (Peter Eckersley), инженер Мичиганского университета Джеймс Кастен (James Kasten), Сет Шён (Seth Schoen) и Джейкоб Хоффман-Эндрюс (Jacob Hoffman-Andrews); позже многолетним ведущим мейнтейнером проекта в EFF стал Брэд Уоррен (Brad Warren).

В декабре 2015 года утилита вышла в публичную бету под именем letsencrypt, после чего прошла четыре знаковые вехи:

Сегодня Certbot — открытый проект на языке Python под лицензией Apache License 2.0, который развивает Electronic Frontier Foundation (EFF).

Что это такое

Certbot — это консольный агент-автоматизатор полного жизненного цикла TLS-сертификатов на твоём сервере. Ты запускаешь его на машине с сайтом, указываешь домен, и Certbot берёт всю криптографическую рутину на себя: генерирует секретный ключ на диске, связывается с удостоверяющим центром, доказывает владение доменом, раскладывает сертификаты по папкам, подключает их к веб-серверу и ставит в расписание фоновую задачу, которая каждые два месяца тихо освежает сертификат до истечения его 90-дневного срока.

Важная деталь: Certbot — не висящий в памяти демон. Почти всё время он спит и расходует ноль ресурсов. Дважды в сутки системный таймер будит его на пару секунд: Certbot проверяет срок годности сертификатов и, если в запасе больше 30 дней, сразу завершается.

Срок жизни в 90 дней — двигатель надёжности, а не ограничение

Сертификаты сроком на 1–3 года приучали компании откладывать автоматизацию «на потом» и роняли продакшен, когда увольнялся настроивший их админ. 90-дневный цикл Let's Encrypt (с обновлением на 60-й день) заставляет один раз включить Certbot сразу — человеческий фактор исчезает навсегда, а скомпрометированный ключ устаревает в разы быстрее.

Чтобы не путаться в терминах вокруг HTTPS, разведём три ключевые пары:

Аналогии из жизни

Прочувствовать механику Certbot проще всего через три аналогии из разных сфер.

1. Личный ассистент и магнитный пропуск в бизнес-центр. Представь офис, где пропуск по регламенту действует ровно 90 дней. Раньше ты сам следил за датой, стоял в очереди в бюро пропусков и менял карточку. Теперь на 60-й день ассистент сам подтверждает управляющей компании, что ваша фирма по-прежнему арендует кабинет, забирает новый пропуск и незаметно кладёт его в твой бумажник вместо старого.
- Где работает: точно передаёт работу системного таймера, упреждающее продление за 30 дней до истечения и бесшовную замену сертификата.
- Где ломается: в жизни ассистент носит в бюро твои документы, а в криптографии секретный private key (приватный ключ) никогда не покидает твой сервер — на подпись уходит только открытый ключ.

2. Инспектор на кассе магазина против записи в реестре недвижимости. Банк проверяет, что твоя фирма реально распоряжается помещением на Тверской, 10. Первый путь: курьер заходит с улицы в открытый зал и сверяет на кассе карточку с одноразовым кодом дня (проверка HTTP-01 через веб-сервер). Второй путь: магазин на Тверской ещё закрыт на ремонт, поэтому банк просит опубликовать проверочный код в городском реестре собственников (проверка DNS-01 через текстовую запись домена).
- Где работает: наглядно объясняет, почему при подготовке нового сервера до переключения домена обычный HTTP-метод бессилен (курьер придёт на старый сервер), а DNS-проверка срабатывает заранее.
- Где ломается: бумажный реестр обновляется сутками, а DNS-запись разлетается за секунды или минуты с учётом TTL (Time to Live — времени кэширования ответа). При этом API-токен на редактирование всей DNS-зоны опаснее при утечке, чем доступ к одной папке сайта.

3. Замена колёс в закрытом гараже против пит-стопа без глушения мотора. Режим --standalone требует на несколько секунд остановить веб-сервер, чтобы Certbot сам занял 80-й порт — как загнать машину в бокс и заглушить двигатель. А режим --webroot кладёт крошечный файл в папку работающего Nginx и после получения сертификата шлёт команду reload (мягкого перечитывания конфигурации без обрыва соединений).
- Где работает: показывает разницу между паузой в обслуживании клиентов при --standalone и нулевым простоем при --webroot.
- Где ломается: болид на пит-лейне всё же теряет секунды, тогда как при nginx -s reload старые процессы дообслуживают активные запросы без единой миллисекунды паузы, а новые клиенты мгновенно получают свежий сертификат.

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

Внутри Certbot разделены две роли: authenticator (аутентификатор) доказывает владение доменом, а installer (инсталлятор) прописывает сертификат в конфиг веб-сервера. Весь цикл укладывается в пять шагов:

1. Регистрация аккаунта ACME. При первом запуске Certbot генерирует ключевую пару учётной записи, связывается по HTTPS с сервером центра (например acme-v02.api.letsencrypt.org) и регистрирует аккаунт в /etc/letsencrypt/accounts/. Паролей нет — личность удостоверяется криптографической подписью ключа.

2. Заказ сертификата и прохождение испытания (challenge). Ты запрашиваешь сертификат для example.ru и www.example.ru. Центр выдаёт случайный токен и просит подтвердить оба имени одним из способов:

3. Генерация приватного ключа и CSR. После успешной проверки Certbot локально создаёт свежий секретный ключ (privkey.pem, по умолчанию ECDSA P-256) и отправляет в центр CSR (Certificate Signing Request — запрос на подпись с публичным ключом и списком доменов). В ответ прилетает подписанный сертификат.

4. Раскладка поколений и симлинков. Файлы каждого выпуска нумеруются в /etc/letsencrypt/archive/example.ru/, а в /etc/letsencrypt/live/example.ru/ лежат аккуратные symlinks (символические ссылки на актуальное поколение):
- privkey.pem — секретный ключ сервера;
- fullchain.pem — сертификат сайта плюс промежуточная цепочка центра (указывается в ssl_certificate Nginx);
- chain.pem и cert.pem — раздельная цепочка и сертификат для OCSP Stapling (прикрепления справки о неотзыве) и старых демонов.

Настройки конкретного домена сохраняются в /etc/letsencrypt/renewal/example.ru.conf.

5. Фоновый renew, reconfigure и репетиция --dry-run. Системный таймер certbot.timer запускает проверку дважды в сутки со случайной задержкой (jitter — разброс по времени, чтобы миллионы серверов не били в API ровно в полночь). Когда остаётся меньше 30 дней, Certbot обновляет файлы, переключает симлинки и выполняет --deploy-hook (например systemctl reload nginx). Команда certbot reconfigure позволяет поменять метод продления без лишнего перевыпуска, а флаг --dry-run репетирует весь процесс на тренировочном стенде.

# Выпуск без остановки Nginx через общую папку webroot:
sudo certbot certonly --webroot -w /var/www/letsencrypt   -d example.ru -d www.example.ru   --deploy-hook "systemctl reload nginx"

# Безопасная репетиция автопродления на тестовом стенде (staging):
sudo certbot renew --dry-run
[ Сервер: Certbot ]                           [ Let's Encrypt (ACME API) ]
        | 1. Заказ сертификата для example.ru          |
        |--------------------------------------------->|
        | 2. Токен проверки для /.well-known/          |
        |<---------------------------------------------|
        | 3. Кладёт токен в /var/www/letsencrypt       |
        | 4. Готово к проверке                         |
        |--------------------------------------------->|
[ Nginx :80 ] <======= HTTP-запросы с узлов центра ====|
        | 5. Владение доказано -> отправка CSR         |
        |--------------------------------------------->|
        | 6. Готовый fullchain.pem                     |
        |<---------------------------------------------|
        v
  Смена симлинков в /etc/letsencrypt/live/ + reload nginx

Не тестируй настройку вслепую без флага --dry-run

Боевой Let's Encrypt жёстко считает лимиты (rate limits): максимум 5 неудачных проверок на аккаунт и домен в час и 5 дублирующих выпусков одного набора имён за 7 дней. Отлаживая скрипт без --dry-run или --test-cert, легко поймать блокировку в разгар релиза. Тренировочный контур Staging боевые квоты не тратит.

Где встречается в обычной жизни

Даже не открывая терминал, ты каждый день сталкиваешься с результатом работы Certbot:

Где встречается в IT и бизнесе

В коммерческой инфраструктуре Certbot закрывает четыре типовых класса задач:

На сложных проектах выбирай certonly --webroot вместо автоправки --nginx

Режим --nginx сам дописывает директивы в твои конфиги, что удобно на простом сайте, но чревато сюрпризами при сложной маршрутизации, кастомных редиректах или управлении через Git и Ansible. Надёжнее один раз прописать пути /etc/letsencrypt/live/... и папку /.well-known/acme-challenge/ в собственном шаблоне Nginx, а Certbot запускать с certonly --webroot.

Кто пользуется

Точной телеметрии установок у свободной утилиты нет, но масштаб виден по открытым цифрам индустрии:

Альтернативы и конкуренты

Когда НЕ стоит использовать

  1. Динамические кластеры контейнеров (Kubernetes и автоскейлинг). Ставить Certbot внутрь каждого контейнера нельзя, потому что эфемерные узлы при перезапуске теряют папку /etc/letsencrypt и за час выжгут недельный лимит дубликатов Let's Encrypt — здесь нужен cert-manager или облачный балансировщик.
  2. Управляемые бессерверные платформы и CDN (Cloudflare Pages, Vercel, GitHub Pages). Настраивать Certbot там не нужно и невозможно, потому что у тебя нет доступа к ОС пограничных серверов, а сама платформа бесплатно ротирует сертификаты на периметре.
  3. Контуры с требованием сертификатов OV/EV, аппаратных токенов или ГОСТ. Связка Certbot с публичным Let's Encrypt не подойдёт, потому что бесплатные ACME-центры подтверждают только владение доменом (DV — Domain Validation) на стандартных алгоритмах RSA и ECDSA, без юридической проверки компании в теле сертификата.

Связанные понятия

Литература и источники

Где встретилось у меня

Вчера при бесшовном переносе боевого веб-проекта на новый сервер без остановки трафика на новой машине заранее выпустили сертификат через Certbot методом DNS-01 с проверкой TXT-записей на серверах имён (пока трафик ещё шёл на старый хостинг), а сразу после переключения A-записей перевели домен через certbot reconfigure на автопродление по webroot и проверили цикл командой certbot renew --dry-run. При сборе вчерашних логов сработала отсечка по объёму ([...достигнут лимит вывода, дальше обрезано]), поэтому понятие выбиралось по дошедшим записям, где Certbot уверенно занял первое место среди неразобранных тем с 30 упоминаниями.

Краткое резюме