Система

Технический раздел для администратора. Основные вкладки: Обновление, Базы гео/клоак, JavaScript и Водяной знак. Здесь обновляют версию Qubix, управляют базами гео/клоака и настраивают защитные лимиты.

Обновление

Вкладка показывает текущие версии и позволяет обновить систему на нужный выпуск.

Сверху — две карточки версий:

• qubixd binary — версия исполняемого файла Qubix (build, дата сборки, версия схемы данных).
• live container — версия запущенного контейнера (тег и образ, версия обновлятора).

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

Как запустить обновление

1. В блоке Запустить обновление введите целевую версию — например, 1.1.2, либо latest для самой свежей.
2. Нажмите Обновить.
3. Следите за прогрессом: система скачает новый образ, остановит старую версию, поднимет новую и проверит её работоспособность. Этапы отображаются списком, по завершении можно раскрыть подробный лог.

Если проверка работоспособности новой версии не прошла, Qubix автоматически откатывается на предыдущий контейнер — вручную ничего делать не нужно.

Не прерывайте обновление

Пока идёт обновление, не перезагружайте сервер и не останавливайте контейнеры вручную. Авто-откат рассчитан только на штатную неудачу проверки здоровья. Если откат тоже не сработает (крайне редкий случай), потребуется ручное вмешательство администратора на сервере.

Ресурсы хоста

Ниже карточек версий Qubix отображает живой снимок ресурсов сервера. Данные собираются в фоне и обновляются автоматически, поэтому страница отражает актуальное состояние.

• Свободно на диске — свободное место на диске, где хранятся данные.
• Свободная память — доступная RAM на сервере.
• Память процесса Qubix — сколько RAM занимает сам процесс Qubix. Удобно понять: память ест Qubix или что-то другое на сервере.
• Подкачка (swap) — сколько swap использует процесс Qubix. В норме это ноль; заметное значение означает, что серверу не хватило RAM и он начал вытеснять данные на диск — это заметно замедляет всё.
• Загрузка процессора — средняя нагрузка на процессор за последние 5 минут относительно числа ядер.

Строка появляется только для тех метрик, которые сервер действительно умеет измерять; на некоторых конфигурациях отдельные показатели могут быть недоступны и скрываются.

Оповещения о ресурсах

Qubix не только отображает эти показатели — он самостоятельно следит за ними и отправляет Telegram-оповещение в технический канал, когда что-то идёт не так:

• заканчивается место на диске (с отдельным, более острым оповещением при критическом уровне);
• заканчивается доступная память (также с отдельным критическим оповещением);
• процесс Qubix начал использовать swap;
• процессор длительно загружен.

Так вы узнаёте о проблеме до того, как инстанс встанет, — даже не открывая эту страницу. Чтобы не создавать лишнего шума, кратковременные всплески не вызывают оповещение, а одно и то же предупреждение не повторяется слишком часто. Когда метрика возвращается в норму, Qubix отправляет сообщение о восстановлении.

Технический канал настраивается администратором в разделе Подключения → Telegram. Без него оповещениям некуда поступать.

Следите за swap

Процесс Qubix не должен уходить в swap. Если Подкачка (swap) показывает ненулевое значение (или пришло оповещение о swap) — серверу не хватает RAM, добавьте её. Работа из swap заметно замедляет всё.

Гео/клоак БД

Базы гео и клоака, которые используются для детекта и клоакинга. У вкладки два режима обновления:

• Автоматическое обновление — базы подтягиваются с лицензионного сервера по расписанию. Частоту задаёте полем Обновлять каждые (в часах).
• Ручное обновление — планировщик выключен; базы обновляются только по кнопке Обновить сейчас.

Ниже — Состояние баз (каждая база с её текущим состоянием и размером) и История обновлений — журнал запусков с временем, базой, статусом, триггером (по расписанию или вручную), размером и сообщением.

JavaScript

Лимиты для пользовательских скриптов. Эти настройки меняются на лету и применяются ко всем скриптам сразу. Сгруппированы в несколько блоков:

• Fetch — правила для внешних HTTP-запросов из скриптов:
  • Список хостов — список разрешённых адресов, по одному в строке. Если список пуст, внешние запросы из скриптов запрещены.
  • Default timeout и Max timeout — таймауты запроса по умолчанию и максимально допустимый (в миллисекундах).
  • Max body — предельный размер ответа в байтах.
  • Max calls на запуск — сколько внешних запросов разрешено за один запуск скрипта.
• Runtime — Max script runtime: максимальное время работы одного скрипта (в миллисекундах).
• SQL — лимиты на запросы к данным из скриптов: число запросов за запуск, число строк на запрос, таймауты. Запросы выполняются только на чтение и в пределах прав владельца скрипта.
• Память — лимит памяти; готовится к выпуску, пока недоступен.

После правки нажмите Сохранить.

Внимание

Звёздочка * в allowlist разрешает скриптам обращаться к любому адресу, включая внутренние. Используйте её осознанно — это ответственность администратора.

Водяной знак

Лимиты для инструмента снятия водяного знака. Задают потолок размера загружаемого изображения — это защита сервера от перегрузки памяти. Изображение сверх лимита отклоняется ещё до обработки.

• Max megapixels — предельная площадь изображения (ширина, умноженная на высоту).
• Max side — предельная длина любой из сторон в пикселях.

После правки нажмите Сохранить. Под каждым полем есть подсказка с рекомендуемым значением.

Что дальше

Подключения

ключи интеграций и API-токены.

Системные службы

список и ручной запуск регулярных задач.