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

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

Сайты и PHP

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

Сайт бывает статический, на PHP или обратным прокси. У него могут быть алиасы доменов, а корень документов лежит внутри домашнего каталога его аккаунта и никогда не выходит за его пределы.

Конфигурацию проверяет сам сервер

Риск в панели управления не в плохом поле формы. Он в том, что плохое поле формы становится сломанным конфигурационным файлом, а сломанный конфигурационный файл роняет все остальные сайты на машине при ближайшей перезагрузке.

Поэтому запись никогда не бывает просто записью. Она состоит из шагов:

  1. рендер конфигурации во временный файл,
  2. fsync и атомарное переименование на место,
  3. проверка результата штатным валидатором сервера,
  4. перезагрузка; а если проверка или перезагрузка отказали, прежний файл возвращается на место.

Проверяет настоящий валидатор, который поставляется с сервером. Разборщик, написанный в этом проекте, мог бы согласиться там, где сервер не согласен.

Значения проверяются, а не экранируются

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

Имена, которые не являются публичным именем хоста, тоже отклоняются для сайтов, алиасов и сертификатов: IP-адрес (то есть любое имя с числом в последней метке), localhost и его поддомены, служебные суффиксы .local, .localdomain, .internal, .lan, .home.arpa и .invalid, а также собственное имя хоста панели, в том числе с www.. FTPS применяет фиксированный набор, но собственное имя панели не проверяет. Отказ сообщает лишь, что имя использовать нельзя, и не повторяет его. Сайт, который уже существует под таким именем, не удаляется: его по-прежнему можно отключить и удалить.

Одно следствие, которое стоит знать: адрес назначения обратного прокси проверяется на форму, а не на назначение, поэтому сайт можно направить на службу на петлевом интерфейсе той же машины.

Псевдонимы

Сайт отвечает на своём домене и ещё на 99 псевдонимах, то есть дополнительных именах хоста, которые обслуживает тот же vhost. Лимит задан не тарифом: один сертификат может назвать не больше 100 хостов, и одно из этих мест занимает собственный домен сайта, поэтому на псевдонимы остаётся 99. Больше один сертификат сайта не покроет.

Форма создания сайта считает список по мере ввода («3 из 99 дополнительных имён.»), сообщает «У сайта может быть не больше 99 дополнительных имён.», как только список слишком длинный, и не создаёт сайт, пока он не уложится. Сервер соблюдает ту же границу независимо от формы: запрос с большим числом псевдонимов отклоняется с 400 SiteAliasLimitExceeded и сообщением «У сайта не может быть больше дополнительных имён, чем покрывает один сертификат.». Агент сервера отклоняет его же при каждой операции, которая записывает конфигурацию сайта. Отключить или удалить сайт можно всегда, сколько бы псевдонимов у него ни было. Программа может прочитать границу из GET /api/v1/sites/limits, который отвечает {"maximumAliases": 99}.

Закрытые наборы выбирают, а не вводят

Если значение должно быть одним из фиксированного набора, интерфейс предлагает список вместо текстового поля, а список приходит от сервера. Выбор бэкенда в форме создания сайта и фильтры по бэкенду и состоянию в списке сайтов читаются из GET /api/v1/sites/choices: каждый вариант приходит как value и label, уже написанный на языке интерфейса. В выборе версии PHP перечислены только версии, установленные на сервере. Список служит подсказкой: сервер проверяет каждое присланное значение по тому же набору и отказывает во всём, что вне его, что бы ни позволила форма.

Несколько версий PHP одновременно

У каждого аккаунта свой пул php-fpm на каждую версию, работающий от имени пользователя Linux этого аккаунта, с бюджетом воркеров по тарифу. Два клиента на одном сервере могут работать на разных версиях PHP, и ни один не прочитает файлы другого, потому что пулы принадлежат разным пользователям, а не одному пользователю с разными настройками.

Администратор добавляет версию в разделе Сайты и домены, версии PHP, выбирая её из списка, а не вводя вручную. В списке версии, которые репозиторий пакетов сервера может установить, от новых к старым; уже установленные версии в него не входят. Панель ещё раз проверяет выбранную версию по тому же списку на сервере, поэтому версия вне него отклоняется с понятным сообщением и не доходит до менеджера пакетов.

Каждый пул слушает unix-сокет в /run/maran-php. Это отдельный каталог, который установщик создаёт и пересоздаёт при каждой загрузке. Он доступен для прохода всем (root:root, режим 0755), чтобы веб-сервер мог добраться до сокетов; сам файл сокета остаётся 0660 и принадлежит пользователю веб-сервера, поэтому аккаунт не может подключиться к пулу другого. Собственный каталог агента /run/maran остаётся закрытым (root:maran, 0750) и сокетов PHP не содержит. На сервере, установленном до этого изменения, панель при запуске после обновления переписывает пул каждого PHP-сайта, а затем его виртуальный хост; ручных действий не требуется.

Клиент может менять разрешённое подмножество настроек. Имя вне списка отклоняется, а не отбрасывается молча: так никто не остаётся в уверенности, что настройка применилась, когда это не так. Строки усиления над его настройками пишутся как php_admin_value, и настройка клиента их не перебьёт.

Логи

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