Как это работает
Сертификат панели
Как панель заказывает доверенный сертификат для собственного имени хоста через ACME, что отдаёт блок на порту 80, как идёт продление и что при ошибке выпуска.
Свежая установка обслуживает панель с самоподписанным сертификатом, поэтому браузер предупреждает перед её открытием. Панель может заменить его доверенным сертификатом для своего имени хоста, заказанным у того же центра ACME, что и для сайтов, и сама продлевать его.
Заказать сертификат
Откройте Настройки → Сертификат панели под администратором и нажмите Запросить
доверенный сертификат. Панель подтверждает владение именем хоста по HTTP на порту 80,
устанавливает результат как /etc/maran/tls/panel.crt и /etc/maran/tls/panel.key и
перезагружает веб-сервер. Перезагрузите страницу, чтобы использовать новый сертификат.
Страница показывает имя хоста, дату выпуска и дату истечения. Когда сертификат уже установлен, Продлить сейчас сразу заказывает новый.
Страница и её API (GET и POST /api/v1/panel-certificate) доступны только администраторам.
Клиент не может ни заказать сертификат, ни прочитать его.
Имя хоста берётся с сервера
Имя никогда не вводится на странице. Это Panel__HostName в /etc/maran/panel.env, который
установщик записывает из собственного имени машины. Если это localhost, пустое имя или имя
с символами, кроме букв, цифр, точек и дефисов, установщик ничего не записывает, и сертификат
заказать нельзя.
Чтобы задать его самостоятельно, направьте DNS имени на этот сервер, добавьте или измените строку и перезапустите панель:
Panel__HostName=panel.example.com
Блок проверки на порту 80
В конфигурации веб-сервера панели есть один блок на порту 80 для её имени хоста. Он отвечает
только на /.well-known/acme-challenge/ из /var/lib/maran-acme и возвращает 404 на всё
остальное. Это не новый порт: веб-сервер уже слушает 80 для сайтов, а доступность порта 80
решает ваш межсетевой экран, так же как для сертификата сайта.
На сервере, установленном до этого выпуска, такого блока ещё нет. Запустите установщик повторно, чтобы его получить; до тех пор выпуск не проходит проверку.
Продление
Ежедневная задача продлевает доверенный сертификат панели, когда до истечения остаётся тридцать дней или меньше. Неудачное продление оставляет текущий, ещё действующий сертификат и повторяется на следующий день.
Если выпуск не удался
Ничего не заменяется. Сертификат, с которым работала панель, самоподписанный или доверенный, остаётся на месте. Обычные причины:
- имя хоста не указывает на этот сервер;
- порт 80 закрыт межсетевым экраном перед сервером;
- центр сертификации отказал в заказе;
- на сервере свободного места меньше порога, код
AgentBelowFreeSpaceFloor.
| Код | Статус | Значение |
|---|---|---|
PanelHostNameNotConfigured | 409 | Panel__HostName не задан. Задайте его в /etc/maran/panel.env и перезапустите панель. |
PanelCertificateNotIssued | 404 | Доверенный сертификат не выпускался; панель работает с самоподписанным. |
PanelChallengeWriteFailed | 500 | Файл проверки для имени хоста не удалось разместить на сервере. |
Ограничения
- Команды в CLI пока нет. Заказ и продление выполняются только в панели; команда
maranне может заказать сертификат, когда сама панель недоступна. - Вернуться к самоподписанному нельзя. После установки доверенного сертификата в панели нет действия, которое удалит его и вернёт самоподписанную пару установщика.
- Панель и агент сервера нужно обновлять вместе: функции нужны оба одного выпуска.