Certbot
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, после чего прошла четыре знаковые вехи:
- Май 2016 года (версия 0.6.0) — переименование в Certbot. В EFF отделили бренд универсального клиента от конкретного центра сертификации Let's Encrypt: Certbot научился работать с любым сервером, говорящим на открытом протоколе ACME.
- Март 2018 — март 2019 года — ACME v2 (RFC 8555) и wildcard-сертификаты. Начиная с Certbot 0.22.0, утилита освоила протокол ACME второй версии, утверждённый в марте 2019 года как стандарт IETF RFC 8555. Главным прорывом стали бесплатные
wildcard-сертификаты (групповые сертификаты вида *.example.ru на все поддомены сразу). - Декабрь 2019 — 2020 год — релиз 1.0 и переход на
snap. Проект вышел на стабильную ветку 1.0 и сменил основной канал доставки в Linux со стареющих системных репозиториевapt/yumна самообновляемые пакетыsnap. - Ноябрь 2022 — 2026 годы — Certbot 2.0+ и
reconfigure. В версии 2.0.0 ключи по умолчанию сменились с RSA-2048 на быстрые эллиптические ECDSA P-256 (secp256r1). В ветках 2.3+ и 3.x появились командаcertbot reconfigure(смена способа продления без перевыпуска сертификата) и поддержка ARI (ACME Renewal Information), когда центр сертификации сам подсказывает окно досрочного обновления.
Сегодня 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 vs Let's Encrypt. Let's Encrypt — это удалённый
CA (Certificate Authority — удостоверяющий центр), своего рода цифровой нотариус. А Certbot — программа на твоём сервере, которая ходит к этому нотариусу за подписью и умеет общаться не только с Let's Encrypt, но и с Google Trust Services или ZeroSSL (через флаг--server). - Certbot vs ACME. ACME (Automated Certificate Management Environment) — сетевой протокол стандарта RFC 8555, то есть правила диалога. Certbot — конкретный Python-клиент, реализующий эти правила, как почтовая программа реализует протокол SMTP.
- Certbot vs OpenSSL. Утилита
openssl— низкоуровневый криптографический инструмент: она создаст ключ или проверит соединение, но не пройдёт проверку домена и не перезагрузит Nginx по расписанию. Certbot использует криптобиблиотеки под капотом, выстраивая поверх них автономный конвейер.
Аналогии из жизни
Прочувствовать механику 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. Центр выдаёт случайный токен и просит подтвердить оба имени одним из способов:
HTTP-01(основной для живых сайтов). Certbot кладёт файл по адресуhttp://example.ru/.well-known/acme-challenge/<токен>на 80-м порту. Серверы центра скачивают его с нескольких географически разнесённых узлов (multi-perspective validation — многоточечная проверка против перехвата маршрутов) и сверяют ответ.DNS-01(дляwildcardи закрытых машин). В настройках домена публикуется запись_acme-challenge.example.ruтипаTXTс хешем токена — через плагин регистратора или скрипт--manual-auth-hook, ждущий обновления авторитетныхNS-серверов (серверов имён зоны). Только этим методом выпускаются сертификаты*.example.ru.TLS-ALPN-01(на порту 443). Проверка прямо внутри TLS-рукопожатия через расширениеALPN (согласование прикладного протокола), когда порт 80 закрыт; классический Certbot не держит под него штатный плагин, оставляя его встроенным ACME-серверам.
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:
- Сайты кафе, клиник и локальных магазинов. Когда сайт соседней пекарни или барбершопа открывается со спокойным значком защищённого соединения, чаще всего сертификат ему бесплатно выпустил и вовремя продлил именно Certbot на VPS или внутри хостинг-панели.
- Умный дом и семейное облако. Владельцы Home Assistant и домашних хранилищ Nextcloud подключают аддон с Certbot, чтобы мобильное приложение и голосовые ассистенты безопасно открывали дом снаружи по настоящему HTTPS.
- Почта на собственном домене. Почтовые сборки вроде Mailcow и iRedMail через Certbot шифруют протоколы
IMAPSиSMTPS, чтобы почтовый клиент на смартфоне не пугал ошибками самоподписанного сертификата. - Независимые блоги и образовательные проекты. Благодаря связке Let's Encrypt и Certbot текстовые сайты и медиа (включая этот ежедневный блог) работают по современному HTTP/2 и HTTPS без ежегодного налога на сертификаты.
Где встречается в IT и бизнесе
В коммерческой инфраструктуре Certbot закрывает четыре типовых класса задач:
- Защита виртуальных серверов с Nginx, Apache и HAProxy. Базовый стандарт для тысяч VPS: Certbot в режиме
--webrootведёт десятки доменов и API-шлюзов, мягко перечитывая веб-сервер после ротации ключей. - Бесшовный переезд сайта между серверами (
zero-downtime migration). Чтобы переключить нагруженный проект на новую площадку без единой секунды ошибки SSL, на новом сервере заранее выпускают сертификат методомDNS-01(покаA-записьдомена ещё смотрит на старый IP). Новый сервер встречает перенос DNS уже с рабочим HTTPS, а следом командойcertbot reconfigureпереводится на быстрое автопродление поwebroot. - Групповые
wildcard-сертификаты для SaaS-платформ. Когда сервис выдаёт клиентам поддоменыcompany1.app.ru,company2.app.ru, Certbot с DNS-плагином поддерживает единый сертификат*.app.ruбез упора в лимиты выпуска. - Шифрование СУБД, очередей и телефонии через
--deploy-hook. PostgreSQL, RabbitMQ, Asterisk или Postfix не умеют сами отвечать на вызовы ACME — Certbot обновляет сертификат и хуком копирует ключи с нужными правами доступа (0600), перезапуская демон.
На сложных проектах выбирай certonly --webroot вместо автоправки --nginx
Режим --nginx сам дописывает директивы в твои конфиги, что удобно на простом сайте, но чревато сюрпризами при сложной маршрутизации, кастомных редиректах или управлении через Git и Ansible. Надёжнее один раз прописать пути /etc/letsencrypt/live/... и папку /.well-known/acme-challenge/ в собственном шаблоне Nginx, а Certbot запускать с certonly --webroot.
Кто пользуется
Точной телеметрии установок у свободной утилиты нет, но масштаб виден по открытым цифрам индустрии:
- Экосистема Let's Encrypt (ISRG). К 2025–2026 годам обслуживает более 400–500 миллионов активных доменов и выпускает миллионы сертификатов в сутки, подняв долю HTTPS-загрузок в браузере Chrome с ~30% в 2014 году до более чем 95%. Certbot остаётся главным рекомендованным клиентом в официальной документации центра для классических серверов.
- Облачные хостинги (DigitalOcean, Linode/Akamai, Vultr, Hetzner, Timeweb). Преднастроенные образы виртуальных машин для WordPress, GitLab, Ghost, Django и Jitsi включают Certbot из коробки.
- Открытые серверные платформы. Mailcow, BigBlueButton, ISPConfig, Virtualmin и сотни инфраструктурных Ansible-ролей используют его как штатный механизм ротации ключей.
- Electronic Frontier Foundation, университеты и тысячи компаний малого и среднего бизнеса. Применяют Certbot на собственных фронтенд-узлах и шлюзах.
Альтернативы и конкуренты
acme.sh(Neil Pang). Ультралёгкий клиент на чистом языке оболочки Unix (POSIX sh).- Плюсы: не требует Python и
snap, содержит встроенную коллекцию из 150+ DNS-плагинов под любых регистраторов. - Минусы: по умолчанию смотрит на коммерческий ZeroSSL (для Let's Encrypt нужен флаг
--server letsencrypt), спартанский интерфейс. - Caddy (и реверс-прокси Traefik). Веб-серверы на Go со встроенным в ядро протоколом ACME.
- Плюсы: сертификаты заказываются и обновляются в памяти автоматически по одному имени домена в конфиге без внешних таймеров.
- Минусы: требуют заменить привычный Nginx или добавить лишний прокси-слой перед ним.
cert-manager(проект CNCF). Нативный контроллер сертификатов для кластеров Kubernetes.- Плюсы: декларативно управляет тысячами сертификатов через ресурсы кластера и
Kubernetes Secrets. - Минусы: живёт только внутри Kubernetes и не применим на обычном одиночном сервере.
lego(библиотека и CLI на Go). Одиночный скомпилированный бинарник без внешних зависимостей.- Плюсы: легко копируется одним файлом в минималистичные контейнеры и CI-пайплайны.
- Минусы: не настраивает веб-серверы и системные таймеры — всю обвязку нужно писать руками.
Когда НЕ стоит использовать
- Динамические кластеры контейнеров (Kubernetes и автоскейлинг). Ставить Certbot внутрь каждого контейнера нельзя, потому что эфемерные узлы при перезапуске теряют папку
/etc/letsencryptи за час выжгут недельный лимит дубликатов Let's Encrypt — здесь нуженcert-managerили облачный балансировщик. - Управляемые бессерверные платформы и CDN (Cloudflare Pages, Vercel, GitHub Pages). Настраивать Certbot там не нужно и невозможно, потому что у тебя нет доступа к ОС пограничных серверов, а сама платформа бесплатно ротирует сертификаты на периметре.
- Контуры с требованием сертификатов
OV/EV, аппаратных токенов или ГОСТ. Связка Certbot с публичным Let's Encrypt не подойдёт, потому что бесплатные ACME-центры подтверждают только владение доменом (DV — Domain Validation) на стандартных алгоритмах RSA и ECDSA, без юридической проверки компании в теле сертификата.
Связанные понятия
- ACME (RFC 8555) — стандартный протокол автоматической проверки владения доменом, выпуска и продления сертификатов.
- TLS (Transport Layer Security) — криптографический протокол шифрования сетевых соединений, пришедший на смену устаревшему SSL.
- X.509 — международный стандарт формата цифровых сертификатов открытого ключа в HTTPS.
- CSR (Certificate Signing Request) — подписанная заявка с публичным ключом и списком доменов, отправляемая в удостоверяющий центр.
- ECDSA — алгоритм цифровой подписи на эллиптических кривых, обеспечивающий компактные ключи и быстрое TLS-рукопожатие.
- OCSP Stapling — технология, при которой веб-сервер сам прикладывает свежую квитанцию от центра о том, что сертификат не отозван.
Литература и источники
- Официальный сайт и генератор инструкций: certbot.eff.org (en) — рецепты под любую связку ОС и веб-сервера и подробный
User Guide. - Репозиторий проекта: github.com/certbot/certbot (en) — исходный код и история релизов от EFF.
- Документация Let's Encrypt: letsencrypt.org/docs (en/ru) — описание типов проверок (
Challenge Types) и точных лимитов (Rate Limits). - Стандарт IETF RFC 8555: datatracker.ietf.org/doc/html/rfc8555 (en) — спецификация протокола ACME v2 (2019).
- Bulletproof SSL and TLS (Ivan Ristić, Feisty Duck, en) — классическая книга про устройство PKI, ключей и безопасную настройку HTTPS.
Где встретилось у меня
Вчера при бесшовном переносе боевого веб-проекта на новый сервер без остановки трафика на новой машине заранее выпустили сертификат через Certbot методом DNS-01 с проверкой TXT-записей на серверах имён (пока трафик ещё шёл на старый хостинг), а сразу после переключения A-записей перевели домен через certbot reconfigure на автопродление по webroot и проверили цикл командой certbot renew --dry-run. При сборе вчерашних логов сработала отсечка по объёму ([...достигнут лимит вывода, дальше обрезано]), поэтому понятие выбиралось по дошедшим записям, где Certbot уверенно занял первое место среди неразобранных тем с 30 упоминаниями.
Краткое резюме
- Certbot — бесплатный открытый Python-клиент от EFF, полностью автоматизирующий выпуск и продление TLS-сертификатов.
- Let's Encrypt — это удалённый удостоверяющий центр, ACME — язык общения с ним, а Certbot — программа-исполнитель на твоём сервере.
- Проверка
HTTP-01через папку--webrootидеальна для работающих сайтов без простоя, аDNS-01черезTXT-запись незаменима дляwildcard-сертификатов*.example.ruи подготовки серверов до переключения DNS. - Приватный ключ (
ECDSA P-256) никогда не покидает сервер, а фоновый таймер обновляет сертификат за 30 дней до конца 90-дневного срока с мягкимreloadвеб-сервера. - Любые эксперименты и хуки всегда проверяй с флагом
--dry-run, чтобы не заблокировать домен жёсткими лимитами боевого центра.