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

Начало работы

Введение

Что такое Maran, из каких трёх процессов состоит сервер и что корневой демон делать не станет, в том числе почему он не принимает shell-команд.

Maran это панель управления веб-хостингом для серверов Linux. Установите её на сервер и управляйте сайтами, версиями PHP, SSL-сертификатами, базами данных, файлами, резервными копиями и брандмауэром из браузера, с отдельным кабинетом для каждого клиента хостинга и API, которым биллинговая система создаёт аккаунты сама.

Три процесса, и root есть только у одного

На сервере с Maran работают ровно три процесса, и разделение между ними является главным решением продукта:

  • maran-api: сама панель. В ней вся бизнес-логика, и только она обращается к базе данных. Работает от непривилегированного системного пользователя.
  • maran-agent: единственный процесс с root. Он не хранит состояние и не имеет базы; его единственные настройки: два стартовых значения в /etc/maran/agent.env. Только он трогает веб-сервер, php-fpm, сервер баз данных, SSH и передачу файлов, планировщик, брандмауэр и сертификаты.
  • PostgreSQL: доступен только из maran-api, через unix-сокет, вообще без TCP-порта.

Панель просит у агента именованные операции через unix-сокет, с типизированными и проверенными аргументами. Нет операции, которая запускает переданную вызывающей стороной программу, и между ними нигде нет shell-строки. Всё, что можно заставить сделать корневой процесс, конечно, записано и поддаётся ревью.

Что такое аккаунт хостинга

Настоящий пользователь Linux со своим домашним каталогом и правами файловой системы. Его PHP работает в собственном пуле под собственным uid, и файловые операции идут от этого же uid, никогда от root. Каждая таблица, принадлежащая арендатору, ограничена аккаунтом на уровне базы, а запрос чужого ресурса отвечает 404, а не 403, чтобы ошибка не подтверждала, что такая строка существует.

Ни брокеров, ни сайдкаров

Фоновая работа идёт через надёжные очереди в PostgreSQL. Установка Maran не добавляет на сервер ни брокера сообщений, ни сайдкар, ни второй демон.

Клавиатура, экранные дикторы и анимация

Панель объявляет выбранный вами язык, поэтому экранный диктор читает армянский или русский интерфейс на этом языке, а не по-английски. На каждой странице после входа первое нажатие Tab ставит фокус на ссылку «Перейти к содержимому», которая переносит его мимо верхней панели и навигации прямо на страницу. Если в операционной системе включено уменьшение движения, переходы в панели завершаются сразу. Экран входа, сводка и списки аккаунтов, сайтов и баз данных автоматически проверяются на соответствие WCAG 2.2 AA при каждом изменении, в тёмной и в светлой теме.