Перейти к содержимому

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

Сертификат панели

Как панель заказывает доверенный сертификат для собственного имени хоста через 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 имени на этот сервер, добавьте или измените строку и перезапустите панель:

bash
Panel__HostName=panel.example.com

Блок проверки на порту 80

В конфигурации веб-сервера панели есть один блок на порту 80 для её имени хоста. Он отвечает только на /.well-known/acme-challenge/ из /var/lib/maran-acme и возвращает 404 на всё остальное. Это не новый порт: веб-сервер уже слушает 80 для сайтов, а доступность порта 80 решает ваш межсетевой экран, так же как для сертификата сайта.

На сервере, установленном до этого выпуска, такого блока ещё нет. Запустите установщик повторно, чтобы его получить; до тех пор выпуск не проходит проверку.

Продление

Ежедневная задача продлевает доверенный сертификат панели, когда до истечения остаётся тридцать дней или меньше. Неудачное продление оставляет текущий, ещё действующий сертификат и повторяется на следующий день.

Если выпуск не удался

Ничего не заменяется. Сертификат, с которым работала панель, самоподписанный или доверенный, остаётся на месте. Обычные причины:

  • имя хоста не указывает на этот сервер;
  • порт 80 закрыт межсетевым экраном перед сервером;
  • центр сертификации отказал в заказе;
  • на сервере свободного места меньше порога, код AgentBelowFreeSpaceFloor.
КодСтатусЗначение
PanelHostNameNotConfigured409Panel__HostName не задан. Задайте его в /etc/maran/panel.env и перезапустите панель.
PanelCertificateNotIssued404Доверенный сертификат не выпускался; панель работает с самоподписанным.
PanelChallengeWriteFailed500Файл проверки для имени хоста не удалось разместить на сервере.

Ограничения

  • Команды в CLI пока нет. Заказ и продление выполняются только в панели; команда maran не может заказать сертификат, когда сама панель недоступна.
  • Вернуться к самоподписанному нельзя. После установки доверенного сертификата в панели нет действия, которое удалит его и вернёт самоподписанную пару установщика.
  • Панель и агент сервера нужно обновлять вместе: функции нужны оба одного выпуска.