rzaripov.kz

Настройка SSL-сертификата на PHP-сервере с Let's Encrypt

HTTPS давно стал базовым требованием для сайтов на PHP: он защищает авторизацию, формы, cookies и обмен данными между браузером и сервером. Бесплатный центр сертификации Let's Encrypt позволяет получить доверенный SSL-сертификат без покупки лицензии и автоматизировать его продление.

Настройка обычно выполняется на уровне веб-сервера Apache или Nginx, а не внутри самого PHP. При этом приложению важно корректно определять защищённое соединение, формировать HTTPS-ссылки и передавать серверу необходимые заголовки. Ниже приведён практический сценарий для Linux-сервера с доменным именем и доступом по SSH.

Что проверить перед установкой

Сначала домен должен указывать на публичный IP-адрес сервера. Записи A и, при необходимости, AAAA проверяют через DNS-инструменты или команду dig. Если IPv6 настроен неправильно, центр сертификации может обратиться к серверу по адресу AAAA и завершить проверку ошибкой. В таком случае IPv6 нужно корректно настроить либо временно удалить соответствующую запись.

Сервер должен принимать входящие соединения на портах 80 и 443. Порт 80 нужен для первоначальной проверки домена и последующего перенаправления на HTTPS, а порт 443 используется для защищённого трафика. В брандмауэре обычно открывают HTTP и HTTPS командами, зависящими от дистрибутива, например:

sudo ufw allow 'Nginx Full'

Для Apache следует выбрать профиль Apache Full. До выпуска сертификата полезно убедиться, что сайт уже открывается по обычному HTTP, а виртуальный хост содержит правильный server_name или ServerName. Если приложение размещено в каталоге вроде /var/www/example.com/public, путь к нему должен совпадать с настройкой веб-сервера.

Установка Certbot и выпуск сертификата

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

sudo snap install core
sudo snap refresh core
sudo snap install --classic certbot
sudo ln -s /snap/bin/certbot /usr/bin/certbot

Для Apache можно сразу запустить автоматическую настройку виртуального хоста:

sudo certbot --apache -d example.com -d www.example.com

Для Nginx команда будет выглядеть так:

sudo certbot --nginx -d example.com -d www.example.com

Certbot предложит указать электронную почту, принять условия использования и выбрать поведение для HTTP-запросов. Рекомендуемый вариант — постоянное перенаправление на HTTPS. Если автоматическое изменение конфигурации нежелательно, сертификат можно получить отдельно через certbot certonly, а пути к файлам прописать вручную.

При успешной проверке файлы обычно сохраняются в каталоге /etc/letsencrypt/live/example.com/. Основные из них — fullchain.pem, содержащий сертификат вместе с цепочкой доверия, и privkey.pem, содержащий закрытый ключ. Права доступа к ключу должны оставаться ограниченными: его нельзя размещать в каталоге сайта или открывать для чтения обычным пользователям.

Подключение HTTPS в конфигурации PHP-сервера

При ручной настройке Nginx HTTPS-сервер обычно содержит такие параметры:

server {
    listen 443 ssl http2;
    server_name example.com www.example.com;

    root /var/www/example.com/public;
    index index.php index.html;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.2-fpm.sock;
    }
}

Отдельный HTTP-блок перенаправляет посетителей на защищённый адрес:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

После изменений конфигурацию проверяют до перезагрузки:

sudo nginx -t
sudo systemctl reload nginx

В Apache используются директивы SSLEngine on, SSLCertificateFile и SSLCertificateKeyFile, а перенаправление выполняется через модуль mod_rewrite или отдельный SSL-виртуальный хост. Не следует одновременно оставлять несколько противоречащих друг другу правил редиректа в .htaccess, конфигурации Apache и PHP-коде: это часто приводит к циклическим перенаправлениям.

Приложение должно понимать, что запрос пришёл по HTTPS. Для PHP за прокси или балансировщиком проверяют заголовок X-Forwarded-Proto, но доверять ему следует только от известного прокси. Иначе злоумышленник сможет подменить значение. В Laravel, Symfony и других фреймворках это настраивается через доверенные прокси и параметры URL-схемы.

Проверка работы и устранение типичных ошибок

После установки сертификата страницу проверяют в браузере, через curl и внешние анализаторы TLS. Команда покажет заголовки ответа и цепочку перенаправлений:

curl -I http://example.com
curl -I https://example.com

Ожидаемый результат — один редирект с HTTP на HTTPS и ответ сайта по защищённой схеме. Если браузер показывает смешанное содержимое, в HTML, CSS, JavaScript или настройках CMS остались ссылки вида http://. Их заменяют на относительные пути, HTTPS-адреса или используют безопасную настройку базового URL.

Ошибка connection refused обычно связана с закрытым портом, остановленным веб-сервером или неправильной записью DNS. Ошибка unauthorized при выпуске сертификата часто означает, что домен не указывает на этот сервер, каталог проверки недоступен или другой виртуальный хост перехватывает запросы к /.well-known/acme-challenge/.

Для PHP-сайта важно проверить cookies с флагами Secure и HttpOnly, корректную генерацию абсолютных ссылок и работу callback-адресов. Если приложение получает данные из внешних API или подключается к базам данных, HTTPS веб-сайта не заменяет шифрование этих соединений. Например, вопросы удалённого доступа к MySQL из приложений Delphi рассматриваются в материале о подключению MySQL через ODBC, где отдельно важны сетевые и серверные настройки.

Продление сертификата и безопасная эксплуатация

Сертификаты Let's Encrypt действуют 90 дней, поэтому ручное обновление неудобно и повышает риск простоя. В большинстве установок Certbot создаёт системный таймер. Его состояние проверяют так:

sudo systemctl status snap.certbot.renew.service
sudo certbot renew --dry-run

Тестовый запуск не заменяет реальное продление, но показывает, сможет ли клиент пройти проверку в будущем. После обновления сертификата веб-сервер иногда требуется перезагрузить, особенно если процесс держит старый сертификат в памяти. Это можно оформить hook-командой:

sudo certbot renew --deploy-hook "systemctl reload nginx"

Для Apache вместо Nginx указывают systemctl reload apache2. Журнал Certbot находится в /var/log/letsencrypt/, а журналы веб-сервера помогают определить причины ошибок ACME, отказов PHP-FPM и неожиданных редиректов.

Компонент Что настраивается Как проверить
DNS Записи A и AAAA домена dig example.com
Брандмауэр Открытые порты 80 и 443 sudo ufw status
Let's Encrypt Выпуск и обновление сертификата sudo certbot renew --dry-run
Nginx или Apache Сертификат, ключ, HTTPS-виртуальный хост Тест конфигурации
PHP-приложение Схема HTTPS, cookies, абсолютные ссылки Проверка страниц и форм
Безопасность Ограниченные права на privkey.pem ls -l /etc/letsencrypt/live/

Регулярно обновлять следует сам сервер, PHP, веб-сервер и Certbot. Закрытый ключ нельзя передавать в репозиторий, резервные копии нужно защищать, а доступ по SSH — ограничивать ключами и правилами брандмауэра. Для проверки внешних демонстрационных страниц и веб-инструментов можно использовать тематический каталог веб-ресурсов, однако итоговую диагностику собственного домена всегда выполняют с учётом его DNS, прокси и конфигурации PHP-сервера.