HTTPS для сайта на Apache: Certbot с плагином apache
Certbot с плагином apache сам получает сертификат Let's Encrypt, создаёт для сайта файл с HTTPS, включает модуль ssl и добавляет переадресацию с HTTP на HTTPS. От вас нужны работающий сайт на порту 80 и домен, который указывает на сервер. Здесь — по шагам, что ввести и что Certbot поменяет.
Содержание 11
Что сделать прямо сейчас
- Подключитесь к серверу по SSH (как подключиться).
- Проверьте, что всё готово:
sudo apache2ctl -SВ ответе есть строка с
port 80и именем вашего сайта, напримерexample.ru. Если её нет, сначала сделайте файл сайта (VirtualHost). - Проверьте, что домен указывает на сервер (как проверить DNS):
dig +short example.ruОтвет — IP-адрес вашего сервера.
- Дальше — по шагам ниже.
Что нужно до запуска Certbot
| Что | Как проверить |
|---|---|
сайт описан в файле с <VirtualHost *:80> и строкой ServerName example.ru | sudo apache2ctl -S |
домен и www указывают на IP сервера | dig +short example.ru и dig +short www.example.ru |
| порты 80 и 443 открыты, если включён ufw | sudo ufw status — в списке Apache Full |
Если ufw включён, а Apache Full в списке нет, разрешите: sudo ufw allow 'Apache Full' (профили ufw). Порт 80 нужен и после получения сертификата: через него Let's Encrypt проверяет домен при продлении.
Как включить HTTPS
- Установите Certbot и плагин для Apache:
sudo apt update sudo apt install certbot python3-certbot-apache - Запустите Certbot для своего домена:
sudo certbot --apache -d example.ru -d www.example.ruВместо
example.ru— ваш домен. Каждое имя пишите после своего-d. - При первом запуске Certbot спросит почту — на неё придут письма о сертификате — и попросит согласиться с условиями Let's Encrypt: прочитайте их и ответьте сами.
- Дождитесь ответа. Если всё прошло, в нём будут строки:
Successfully received certificate. Certificate is saved at: /etc/letsencrypt/live/example.ru/fullchain.pem Key is saved at: /etc/letsencrypt/live/example.ru/privkey.pem Deploying certificate Successfully deployed certificate for example.ru to /etc/apache2/sites-available/example.ru-le-ssl.conf - Откройте сайт в браузере по адресу
https://example.ru.
Если не указать -d, Certbot покажет имена из файлов сайтов и спросит, для каких выпустить сертификат.
Что Certbot меняет в Apache
| Что | Где |
|---|---|
| новый файл сайта для HTTPS | /etc/apache2/sites-available/example.ru-le-ssl.conf, включён в sites-enabled |
модуль ssl включён | Apache начинает слушать порт 443 (ports.conf) |
модуль rewrite включён | для переадресации на HTTPS |
| строки переадресации | в старом файле сайта, например example.ru.conf |
| общие настройки шифрования | /etc/letsencrypt/options-ssl-apache.conf |
В файле example.ru-le-ssl.conf — копия вашего сайта на порту 443 и строки сертификата:
<IfModule mod_ssl.c>
<VirtualHost *:443>
ServerName example.ru
ServerAlias www.example.ru
...
SSLCertificateFile /etc/letsencrypt/live/example.ru/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.ru/privkey.pem
Include /etc/letsencrypt/options-ssl-apache.conf
</VirtualHost>
</IfModule>DocumentRoot, AllowOverride, журналы, — правьте оба файла: example.ru.conf и example.ru-le-ssl.conf. По HTTPS сайт открывается по второму.Переадресация с HTTP на HTTPS
Certbot добавляет её сам. В файле сайта на порту 80 появятся строки:
RewriteEngine on
RewriteCond %{SERVER_NAME} =www.example.ru [OR]
RewriteCond %{SERVER_NAME} =example.ru
RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]Посетитель, который открыл http://example.ru/about.html, попадёт на https://example.ru/about.html с кодом 301. Проверить:
curl -sI http://example.ru/ | grep -i -E '^HTTP|^location'Ответ — HTTP/1.1 301 Moved Permanently и Location: https://example.ru/.
Если переадресация не нужна, запускайте Certbot с --no-redirect. Если её нет, а нужна, добавьте эти четыре строки внутрь <VirtualHost *:80> своего сайта, затем sudo apache2ctl configtest и sudo systemctl reload apache2.
Как проверить HTTPS
curl -sI https://example.ru/ | head -n 1Ответ — HTTP/1.1 200 OK. Посмотреть все сертификаты и сроки:
sudo certbot certificatesВ ответе для каждого сертификата — имена в строке Domains: и дата в строке Expiry Date:.
Продление
Продлевать руками не нужно: пакет certbot ставит таймер certbot.timer, он запускает certbot renew в 00:00 и 12:00 со случайной задержкой до 12 часов и продлевает сертификаты, срок которых подходит к концу. После продления Certbot сам перезагружает Apache, чтобы тот взял новый сертификат.
Проверить, что продление сработает:
sudo certbot renew --dry-runПодробно — автопродление Certbot.
Добавить домен к сертификату
Если появился новый поддомен, например shop.example.ru, повторите команду со всеми именами сразу:
sudo certbot --apache --cert-name example.ru -d example.ru -d www.example.ru -d shop.example.ruCertbot покажет, какие домены добавятся, и спросит, что делать, — выберите Update certificate. Подробнее — добавить домен в Certbot.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
The requested apache plugin does not appear to be installed | не установлен плагин | sudo apt install python3-certbot-apache |
Unable to find a virtual host listening on port 80 | нет файла сайта на порту 80 | сделайте сайт с <VirtualHost *:80> (VirtualHost), затем снова certbot --apache |
Some challenges have failed. | Let's Encrypt не смог открыть сайт по домену | разбор ошибки |
Unable to find corresponding HTTP vhost | сертификат установлен, а переадресацию Certbot не добавил | добавьте строки переадресации вручную |
Could not install certificate | сертификат получен, а установить его в Apache не получилось | исправьте причину из строк выше в ответе, затем sudo certbot install --cert-name example.ru |
SSLCertificateFile: file … does not exist or is empty | в файле сайта путь к сертификату, которого нет | разбор ошибки |
| HTTPS работает, а правки сайта видны только по HTTP | правили только example.ru.conf | повторите правку в example.ru-le-ssl.conf и reload |
https://example.ru не открывается, а http:// работает | порт 443 закрыт в ufw | sudo ufw allow 'Apache Full' |
Другие ошибки Certbot — ошибки Certbot.
Всё сверено с Apache 2.4.58 из пакета Ubuntu 24.04.
Источники
- Документация Certbot — на английском: плагин apache.
- Исходный код Certbot 2.9.0: плагин apache — файл -le-ssl.conf и строки переадресации.
- Let's Encrypt: как это работает — проверка домена.
- Пакет python3-certbot-apache в Ubuntu 24.04 — версия плагина.
Сверено 9 ноября 2026 года.
Что почитать дальше
- Настройки Certbotвсе команды и файлы Certbot.
- ports.conf и Listenпорты 80 и 443.
- Настройки Apacheвсе настройки на одной странице.