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

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

Установка

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

Устанавливайте на сервер, которым управляете сами, с доступом root и одной из поддерживаемых платформ.

Запустить установщик

bash
curl -sSL https://get.maran.innovayse.com | sudo bash

Установщик проверяет систему до того, как что-то изменить: дистрибутив и его версию по матрице поддержки, пороги по памяти и диску и нужные порты. Он собирает все отказы и выходит один раз, так что список исправляется целиком, а не по одной проблеме за запуск. Нехватка места для резервных копий не останавливает установку, это предупреждение: если на файловой системе, где они будут лежать, свободно меньше 10 ГиБ, установщик сообщает об этом и продолжает работу.

Если проверки пройдены, он ставит подписанные артефакты релиза, ужесточает systemd-юниты и разворачивает то, что нужно хостинговому серверу: веб-сервер, PostgreSQL для данных самой панели, сервер баз данных для аккаунтов, передачу файлов, брандмауэр и планировщик.

Установщик записывает имя хоста сервера в panel.env (Panel__HostName) и использует его как server_name панели. Если имя хоста непригодно (пустое, localhost или содержит символы, кроме букв, цифр, точек и дефисов), ничего не записывается, и панель отвечает на localhost. Повторный запуск установщика после исправления имени хоста обновляет и то и другое.

Установка без доступа в интернет

Сервер, который не может обратиться к узлу загрузки, ставится из пакета, доставленного на него вручную. Пакет представляет собой один файл, который команда maran release package собирает из релиза, построенного под архитектуру сервера (maran release build) и подписанного (maran release sign). Скопируйте его на сервер и из распакованного пакета установщика передайте установщику:

bash
sudo bash install.sh --offline-tarball <bundle>.tar.gz

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

Первый администратор

По завершении установщик печатает ссылку на страницу настройки, а на отдельной строке одноразовый токен настройки. Откройте ссылку и вставьте токен в соответствующее поле: это единственный способ создать первого администратора, больше его не создать ничем. Токен намеренно не входит в ссылку и перестаёт действовать, как только в панели появляется пользователь. Если вы его потеряли, прочитайте Setup__Token из /etc/maran/panel.env от имени root.

После первого входа

Включите двухфакторную аутентификацию и создайте первый аккаунт хостинга. Аккаунт здесь является настоящим пользователем Linux со своим домашним каталогом, своим пулом php-fpm и квотой по тарифу. Создание через панель разворачивает его на хосте.

Обновления

Обновление выполняется повторным запуском установщика, который безопасно повторять: он получает текущий подписанный релиз, до распаковки проверяет подпись и каждую контрольную сумму и до запуска панели применяет миграции базы данных каждого модуля. Обновления в один щелчок в панели пока нет, как нет и команды maran rollback, поэтому сначала сделайте резервную копию панели (см. Резервная копия и восстановление панели). Путь назад один: восстановить этот архив на чистую установку. Maran не настраивает автоматическую установку обновлений операционной системы.