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

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

Хостинг-аккаунты

Что такое хостинг-аккаунт на сервере Maran: настоящий пользователь Linux с домашним каталогом, квотой и лимитами, и что с машиной делают создание и удаление.

Хостинг-аккаунт не просто строка в таблице, которую панель как-то трактует. Это системный пользователь на сервере со своим uid, своим домашним каталогом и дисковой квотой по тарифу. Всё, что принадлежит клиенту (его сайты, файлы, пул php-fpm) работает от имени этого пользователя.

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

Что происходит при создании

Панель просит агента, и агент делает работу на хосте:

  1. Создаёт системного пользователя и его домашний каталог.
  2. Применяет к нему дисковую квоту тарифа.
  3. Назначает домашнему каталогу группу веб-сервера с режимом 0750, чтобы сервер мог пройти в корень сайта, а домашний каталог не стал при этом читаемым для всех локальных пользователей.

Только после этого появляется строка в базе. Порядок намеренный: сначала действует агент, потом появляется строка, поэтому панель никогда не заявляет аккаунт, которого на сервере нет. Если хост отказал, нет и строки, которую пришлось бы потом сверять.

Форма нового аккаунта

Администратор создаёт аккаунт в разделе Аккаунты → Новый аккаунт. Форма запрашивает:

  • Основной домен: без www.. Панель отклоняет основной домен, начинающийся с www..
  • Имя пользователя: системное имя аккаунта. Оно заполняется по домену по мере ввода (www.my-shop.example.com даёт myshop), пока вы не измените его сами, и должно содержать от 3 до 30 строчных латинских букв, цифр или подчёркиваний и начинаться с буквы.
  • Тариф: его дисковая квота, количества и ограничения на процессор, память и процессы действуют на аккаунт.
  • Почта владельца: куда отправляется приглашение.
  • Язык владельца выбирается из списка языков, на которых у панели есть тексты (английский, русский и армянский), каждый назван на себе самом; вводить ничего не нужно, а сервер отклоняет любое другое значение. По умолчанию выбран язык вашего интерфейса. Приглашение владельцу пишется на этом языке и при создании аккаунта, и при каждой повторной отправке, на каком бы языке ни работал отправляющий администратор.

Рядом с формой панель перечисляет, что будет создано на сервере. Владелец сам задаёт пароль по приглашению, поэтому администратор его не знает. Сервер заново проверяет каждое поле, что бы ни пропустила форма.

Приостановка: состояние, а не удаление

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

Приостановка закрывает и панель для этого аккаунта, и только для него. Все, кто работает в аккаунте (владелец и люди, которых он добавил), получают отказ при входе, при обновлении сессии и при переключении на него, а сессии, работавшие в этом аккаунте, завершаются. Это относится и к приглашённому, который ещё не принял приглашение: если он примет его, пока аккаунт приостановлен, войти он всё равно не сможет. Коротко: приглашённым участникам приостановленного аккаунта отказывают и при входе, и при каждом вызове API, сделанном для этого аккаунта. Токен доступа, выданный до приостановки, тоже перестаёт работать: на каждый его запрос для этого аккаунта панель отвечает «Этот аккаунт приостановлен, поэтому работать в нём нельзя, пока он не будет возобновлён» (409), а не только при следующем входе. Человек, у которого два аккаунта, продолжает работать в другом: приостановленный аккаунт исчезает из селектора аккаунтов, а переключение на него отклоняется сообщением «Этот аккаунт приостановлен, поэтому работать в нём нельзя, пока он не будет возобновлён». При входе отказывают только тому, у кого приостановлены все аккаунты, и ответ тот же, что при неверном пароле. После возобновления аккаунта они снова могут войти.

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

  • При приостановке панель отвечает «Аккаунт не приостановлен: не удалось убедиться, что сервер действительно его остановил. Ничего не изменено; повторите попытку.»
  • При возобновлении панель отвечает «Аккаунт не возобновлён: не удалось убедиться, что сервер действительно запустил его снова. Ничего не изменено; повторите попытку.»

Панель не объявляет состояние, которого не видела. Откройте сайты аккаунта, найдите тот, у которого конфигурация повреждена или не читается, исправьте её и повторите запрос. В журнале аудита нет записи об изменении, потому что ничего не менялось.

Удаление убирает то, что аккаунт оставил

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

  • его базы данных и их пользователи,
  • его логины для передачи файлов,
  • его jail и юнит монтирования этого jail,
  • его поставленные в очередь задания at, если at установлен,
  • оставшийся менеджер сеансов (systemd --user), если на хосте работает systemd,
  • его запущенные процессы: каждый процесс аккаунта завершается, и удаление проверяет, что не осталось ни одного,
  • его разделяемая память, очереди сообщений и семафоры,
  • его файлы в общих временных каталогах (/tmp, /var/tmp, /dev/shm) вне домашнего каталога.

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

Тарифы

Тариф задаёт пакет, на котором создаётся аккаунт: название и лимиты, в рамках которых живёт каждый аккаунт на нём. Администраторы управляют тарифами в пункте Аккаунты › Тарифы навигации панели: тариф можно создать, изменить и удалить. Клиенты эту страницу не видят, только лимиты своего тарифа. При создании аккаунта администратор выбирает его тариф в поле Тариф, которое ищет тарифы на сервере по мере ввода.

  • Дисковая квота: место, которое может занять домашний каталог аккаунта, в мегабайтах. Её обеспечивает ядро.
  • Сайты, базы данных и SFTP-логины: наибольшее число каждого, которое может иметь аккаунт; каждое значение не меньше 1.
  • FTPS-логины и записи cron устроены так же, но 0 допустим и означает, что их нет в тарифе.
  • Воркеры PHP на пул: бюджет воркеров пула php-fpm аккаунта.

Прежде чем менять тариф, стоит знать несколько правил:

  • Названия уникальны без учёта регистра: Business и business считаются одним названием, и панель откажет во втором.
  • Тариф, который используется, удалить нельзя. Пока на нём есть хотя бы один аккаунт, удаление отклоняется и ничего не меняется; сначала переведите эти аккаунты на другой тариф или удалите их.
  • Изменение тарифа доходит до уже существующих аккаунтов. Изменённая дисковая квота применяется ко всем аккаунтам на тарифе.
  • Квоту нельзя снизить ниже потребления любого аккаунта. Панель сначала измеряет все аккаунты тарифа; если какой-то использует больше нового значения, вся правка отклоняется и ни один аккаунт не затрагивается.
  • Лимиты по количеству ограничивают только новое. Уменьшение числа сайтов или баз не удаляет то, что у аккаунта уже есть; оно лишь не даёт добавлять новое, пока аккаунт не вернётся в рамки лимита.

Функции тарифа

Кроме лимитов, тариф указывает, какими функциями пользуются его аккаунты. В Тарифы → Новый тариф и в форме изменения группа Функции содержит по одному флажку на функцию: Почта, DNS, Базы данных, Запланированные задачи (cron), Передача файлов (SFTP и FTPS), Резервные копии, Сайты, SSL-сертификаты, Фоновые задачи и Версии PHP. Новый тариф создаётся со всеми отмеченными флажками, а существовавшие до этой функции тарифы сохраняют все функции, включая последние четыре, которые они и раньше предоставляли неявно.

  • Изменение доходит до каждого аккаунта на тарифе при его следующем запросе и записывается в аудит как изменение тарифа с функциями до и после.
  • Меню клиента следует за тарифом. Пункт функции, которой нет в тарифе, скрыт, а раздел исчезает, когда скрыты все его пункты.
  • Панель отклоняет запрос и сама. Базы данных, запланированные задачи, передача файлов, резервные копии, сайты, сертификаты, фоновые задачи и выбор версии PHP сайта отвечают на прямой запрос кодом 403 и сообщением «Эта возможность не входит в ваш тарифный план.»
  • Администраторов функции тарифа не ограничивают.
  • Почту и DNS можно отметить, но страниц для них пока нет.

Командный доступ: пользователи

Владелец аккаунта может открыть часть аккаунта другим людям в Мой аккаунт → Пользователи. Владелец приглашает человека, указав логин, адрес e-mail и функции, которые открываются; функции можно изменить позже, а человека можно удалить после подтверждения. Приглашённый получает по e-mail одноразовую ссылку и сам задаёт пароль, поэтому владелец его не знает.

Повторной отправки приглашения и предложения места существующему логину в 1.0.0-beta.4 ещё нет: они появятся в следующем выпуске.

  • Функции, которые можно открыть: Почта, DNS, Базы данных, Cron, Передача файлов, Резервные копии, Сайты, SSL-сертификаты, Фоновые задачи и Версии PHP. Функция также должна входить в тариф аккаунта. Участник без этих функций не попадает ни в один из этих разделов. Для смены версии PHP сайта кроме «Сайтов» нужна функция «Версии PHP».
  • Изменения применяются при следующем запросе человека. Удаление действует сразу везде: панель при каждом запросе проверяет, что человек всё ещё входит в аккаунт, поэтому уже выданный ему вход перестаёт работать немедленно, а не по истечении срока.
  • После обновления нужно действие: заново выдайте функции Сайты, SSL-сертификаты, Фоновые задачи и Версии PHP. Приглашённые до появления этих ограничений сохраняют выданные им функции, но не получают эти четыре, поэтому, пока владелец не выдаст их в Пользователи → Изменить функции, такие участники теряют доступ к сайтам, сертификатам, задачам и настройкам PHP, которые были им доступны раньше.
  • Управлять командой может только владелец. Участникам и администраторам это запрещено.
  • Ожидающее приглашение можно отправить повторно. Для человека, который ещё не принял приглашение, Отправить приглашение повторно в списке отправляет новое письмо на адрес, уже сохранённый у этого логина, а не на тот, что указан в запросе. Прежняя ссылка перестаёт работать сразу, поэтому действует только одна. Если человек уже принял приглашение, отправлять нечего, и панель отвечает SubUserNotPending (409). Повторная отправка входит в лимит отправки, о котором ниже, и записывается в аудит как «Приглашение пользователю отправлено повторно».
  • Существующему логину можно предложить место. В блоке Добавить существующий логин укажите логин или адрес e-mail и функции, которые предлагаете. Человек в аккаунт пока не попадает: ему приходит письмо без ссылки, а при следующем входе на странице Мой аккаунт появляется карточка приглашения, где он нажимает Принять или Отклонить. Он присоединяется ровно с предложенными функциями и только если примет. Предложение действует 14 дней, в вашем списке отображается как «Предложение отправлено», а Отменить предложение его отзывает. Предложить можно только действующему клиентскому логину, которого ещё нет в команде, и только пока ваш аккаунт активен. Как и в случае приглашения, панель отвечает одинаково, существует такой логин или нет, а настоящий итог записывается для администратора в журнал аудита. Пока аккаунт приостановлен, принять предложение нельзя: MembershipOfferAccountSuspended (409). Предложение, которого нет, истёкшее или уже закрытое даёт MembershipOfferNotFound (404). Предложения считаются в предел команды, о котором ниже, а администратор, просматривающий панель от имени человека, не может принять или отклонить предложение за него.
  • Панель не сообщает, был ли логин или адрес уже занят. На просьбу пригласить человека всегда приходит один и тот же ответ (принято, с введённым вами именем и адресом), независимо от того, принадлежит ли это имя или адрес уже какому-либо логину на этом сервере. Если они были свободны, человек появляется в списке как «Приглашён» и получает письмо; если нет, ничего не создаётся и ничего не отправляется. Приглашение никогда не добавляет существующий логин в ваш аккаунт: для этого есть предложение. Администратору отказ фиксируется в журнале аудита.
  • У команды есть предел. В одном аккаунте может быть 25 пользователей, приглашённых или активных, если администратор не задал другое число (SubUsers__MaxPerAccount, от 1 до 1000). Сверх предела панель отвечает кодом SubUserLimitReached, пока вы кого-нибудь не удалите.
  • У отправки приглашений свой лимит запросов, отдельный для каждого аккаунта и не связанный с принятием приглашения: по умолчанию 20 приглашений в час (RateLimiting__InvitationSendMaxRequests и RateLimiting__InvitationSendWindowSeconds). На дальнейшие запросы приходит ответ 429 с заголовком Retry-After.
  • Приглашение, изменение функций и удаление записываются в журнал аудита.
  • В списке пользователей показываются состояния Активен, Приглашён и Предложение отправлено. Приостановка здесь не отображается: в приостановленный аккаунт никто не может войти, чтобы открыть список. Пока аккаунт приостановлен, выдать приглашение нельзя. Сначала возобновите аккаунт.

Больше одного аккаунта на вход

Один вход может владеть несколькими аккаунтами. Клиент, у которого их два или больше, выбирает активный в селекторе аккаунтов в шапке, как описано в разделе об интерфейсе панели. Вход начинается с самого старого аккаунта, каждое переключение записывается в аудит как Переключение активного аккаунта, а переключение на аккаунт, которому вход не принадлежит, отклоняется как «не найдено».

Просмотр как аккаунт

Администратор может открыть Посмотреть как этот аккаунт на странице аккаунта. Панель тогда показывает клиентскую панель от имени логина этого аккаунта, с баннером на каждой странице: «Вы просматриваете как {имя аккаунта} ({логин})» и кнопкой возврата, которая возвращает администратора к его собственному сеансу, на страницу аккаунта. Просмотр заканчивается сам через 15 минут.

  • Просмотр доступен только для чтения, кроме короткого списка разрешённых действий. Всё, что клиент может прочитать, можете прочитать и вы. Любое действие, что-то меняющее, запрещено, если его нет в списке безопасных изменений; действие, которое никто не классифицировал, запрещено по умолчанию. Безопасные изменения: закрепить и открепить страницу и завершить просмотр. Создание SFTP- или FTP-логина, базы данных, записи cron, запуск задания cron, создание и удаление сайта, сертификата или резервной копии, смена пароля, настройки двухфакторной аутентификации, сеансы, пользователи, переключение аккаунтов и запуск второго просмотра запрещены, потому что каждое оставило бы после себя то, что переживёт 15 минут. Запрещённое действие отвечает 403 с кодом HostViewAsNotAllowed. Чтобы сделать такое изменение, завершите просмотр и выполните его как администратор.
  • Записывается в аудит в обе стороны. Начало и конец записываются как Начат просмотр от имени аккаунта и Завершён просмотр от имени аккаунта, с администратором как исполнителем. Действия во время просмотра записывают администратора как подменяющего.
  • Клиент это видит. Просмотр появляется на экране его сеансов.
  • Просмотр от имени реселлера и просмотр реселлером собственных аккаунтов (в 1.0.0-beta.4 этого нет, появится в следующем выпуске). Администратор сможет посмотреть панель от имени реселлера со страницы реселлера, а реселлер, от имени владельца любого из своих аккаунтов, но не чужих. Это всегда один шаг: из просмотра нельзя начать другой просмотр.
  • Экран аудита показывает, кто просматривал (со следующего выпуска; в 1.0.0-beta.4 этого нет). Запись, сделанная, пока администратор просматривал панель как клиент, показывается под исполнителем со словом «через» и именем администратора, в списке аудита и в последних событиях на панели управления. Поиск по аудиту находит и имя администратора.

Лимиты ресурсов

Кроме дисковой квоты и счётчиков, тариф задаёт три потолка на то, что каждый его аккаунт может использовать одновременно. Каждый задаётся числом или значением Без лимита:

  • Процессор (% одного ядра): доля одного ядра; 50 равно половине ядра, 200 равно двум целым ядрам.
  • Память (МБ): сколько памяти процессы аккаунта могут занимать вместе.
  • Процессы: сколько процессов и потоков аккаунт может держать одновременно.

Агент записывает их в systemd-слайс аккаунта, user-<uid>.slice: при создании аккаунта, при изменении потолков тарифа (для всех его аккаунтов) и при переводе аккаунта на тариф с другими потолками. Новый аккаунт всегда получает все три, включая «Без лимита», поэтому аккаунт с повторно использованным uid не наследует потолки предшественника. Если сервер их не принял, аккаунт не создаётся.

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

В API провижининга потолок выглядит как {"kind": "limited" | "unlimited", "maximum": n}. Отсутствующий потолок, ограниченный ноль и неограниченный потолок с числом отклоняются с кодом 400.

Что слайс охватывает, а что нет:

  • Охватывает: SSH- и SFTP-сессии аккаунта и всё, что в них запущено.
  • Не охватывает воркеры PHP. Каждая версия PHP работает как один мастер php-fpm в виде системной службы, и воркеры всех пулов принадлежат ему, а не слайсу аккаунта. Нагруженный PHP-сайт ограничен только параметром Воркеры PHP на пул.
  • Не охватывает задания cron в семействе Debian. Стек PAM для cron в Debian не регистрирует сессию, поэтому задание работает в cgroup службы cron. В семействе RHEL задания cron попадают в слайс пользователя согласно поставляемым файлам PAM; на реальном сервере это ещё не проверено.

Запуск запланированной задачи сейчас

Запись cron можно запустить вручную: Запланированные задачи → Запустить сейчас, чтобы проверить её, не дожидаясь расписания. Она выполняется от имени пользователя аккаунта, внутри его слайса ресурсов, поэтому действуют лимиты тарифа на CPU, память и процессы, и с окружением crontab. Запуск останавливается через две минуты, а при выводе больше 64 КиБ в один поток останавливается без сохранения вывода. Запуск, дошедший до предела вывода, останавливается по-настоящему, а не просто бросается: сервер останавливает собственный юнит задания и дожидается подтверждения, и только потом запуск считается остановленным. Если остановку подтвердить не удалось, запуск не сообщается как остановленный, потому что задание может продолжать работать, пока его не завершит предельное время работы на сервере; вместо этого запрос получает ответ CronRunNotStopped (500): он сообщает, что задание может всё ещё выполняться и что его состояние нужно проверить, прежде чем запускать снова. В результате видно, чем он закончился, код выхода, длительность и оба потока вывода.

История запусков хранит последние двадцать таких запусков для каждой записи, с поиском по выводу и фильтром по результату. Запуски cron по расписанию в неё не входят; последний по-прежнему в Последний запуск. Отключённую запись можно запустить вручную; а записи приостановленного аккаунта нельзя.

Что видит клиент

Клиент входит в свой аккаунт и не видит ничего, что относится к серверу. В меню девять разделов: Состояние системы, Сайты и домены, DNS, Почта, Базы данных, Файлы и доступ, Резервные копии, Активность (фоновые задачи) и Мой аккаунт (профиль, двухэтапная проверка и сеансы). Раздел, в котором больше одной страницы, раскрывается подменю.

  • Ещё не готовые страницы показаны, но недоступны. Они приглушены, помечены «Скоро» и не открываются, так что устройство панели видно ещё до того, как готова каждая страница.
  • Функция, которой нет в тарифе, скрыта. Меню следует функциям тарифа (см. выше «Функции тарифа»), и пункт для функции, которой в тарифе нет, не предлагается.
  • На пределе тарифа вместо кнопки создания показана причина. Когда у аккаунта столько сайтов, баз данных, SFTP-логинов, FTPS-логинов или cron-записей, сколько разрешает тариф, экран сообщает об этом, а не предлагает создать ещё. Панель и сама откажет в создании: меню и экраны служат подсказкой, а не границей.
  • На телефоне в нижней панели находятся Главная, Сайты, Почта и Аккаунт, а Ещё открывает всё меню. Почта недоступна, пока не появится почтовый хостинг.

Одно ограничение, о котором стоит знать

У аккаунта, созданного до 1.0.0-beta.1, нет той групповой принадлежности домашнего каталога, которая позволяет веб-серверу дойти до корня сайта, и команды починки нет. Один такой чинится вручную: chgrp www-data /home/<аккаунт>; на семействе RHEL вместо www-data нужен nginx.

Каждое действие выше записывается в журнал аудита, который только дозаписывается.