Перейти к основному содержимому
Версия: 0.4 · текущая

Настройка экземпляра

Практическое руководствоПроверено 11 октября 2026 г.
Область применения:Excubius 0.4Роли: Суперадминистратор
ПланыFree · Core · Pro · EnterpriseРазвертываниеСамостоятельное размещение

Каждая установка Excubius поставляется со всеми возможностями. Раздел Settings › Instance определяет, какие из них показывает установка и под каким названием, логотипом и темой. Изменения сразу применяются для всех и записываются в журнал аудита. В этом руководстве показано, как переключать функции, применять предустановку и настраивать фирменное оформление.

Перед началом работы​

  • Вам нужна роль Super admin (суперадминистратор). Другим пользователям этот экран не отображается.
  • Некоторым функциям также требуется настройка на сервере, например токен Slack или учетные данные Jira. Включение функции делает ее видимой, но не настраивает ее.

Открытие экрана​

  1. Выберите Settings, затем Instance.
  2. Найдите разделы Presets, Features и Branding, описанные ниже. В нижней части экрана указано, скрываются ли отключенные функции только визуально или также отклоняются API, и когда было внесено последнее изменение.

Для имен сервера и TLS есть отдельный экран, ссылка на который находится вверху: Server names and HTTPS. См. статью Настройка имен и TLS.

Начало работы с предустановки​

Предустановка — это именованная отправная точка: набор переключателей функций и фирменное оформление. Каждая предустановка отображается в виде карточки с описанием. Предустановки общего назначения:

ПредустановкаСодержимое
enterpriseВсе включено; используется по умолчанию для новой установки
databasesИнфраструктура, оповещения, страница состояния и модули баз данных
coreИнфраструктура, оповещения и страница состояния
внимание

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

Даже в предустановке enterprise источники Defender for Cloud и Wazuh остаются отключенными, пока вы их не включите.

Включение и отключение функции​

  1. В разделе Features найдите функцию в ее группе: Sources, Monitoring, Security, Collaboration, Access или Interface. В каждой строке показаны ключ функции, ее назначение и, если есть, функция, от которой она зависит.
  2. Используйте ее переключатель.

Изменение применяется сразу.

  • Функция, зависящая от другой функции, неактивна, пока та отключена. Отключение обязательной функции отключает и зависящие от нее функции; например, отключение security также отключает security.defender и security.wazuh.
  • Отключение функции, которой принадлежат модули каталога, удаляет эти модули из списка каталога.
  • По умолчанию скрытие носит только визуальный характер: навигация, экраны и мини-приложения следуют переключателям, а сбор, хранение данных и API продолжают работать. Когда вы снова включаете функцию, ее история сохраняется. Чтобы API также отклонял отключенные функции, задайте EXCUBIUS_FEATURES_ENFORCE_API=true в конфигурации сервера; тогда их конечные точки будут отвечать 404.
  • Некоторые переключатели применяются принудительно в любом случае. Если access.google_login отключена, вход через Google отклоняется.

Функции, на которые ссылаются другие руководства:

ФункцияЧем она управляет
monitoring.databasesМодули SQL Server (включая группы доступности), Azure SQL, Managed Instance и PostgreSQL
monitoring.updatesСтраница Updates & advisories и ее проверки
securityСтраница Security posture, замечания и оценка безопасности
security.defender, security.wazuhСбор данных из Microsoft Defender for Cloud и из Wazuh. По умолчанию отключены
security.recommendationsПоказывает рекомендации Defender for Cloud рядом с замечаниями
collab.jiraCreate Jira ticket для оповещений и замечаний; требует collab.assign
access.google_loginВход через Google
access.directory_groupsРоли для групп Microsoft Entra ID
ui.public_status_pageОбщедоступные страницы состояния
ui.i18nЯзыки, кроме английского, в консоли и в сообщениях Slack
ui.themesЦветовые темы помимо светлой и темной

Настройка фирменного оформления​

  1. В разделе Branding заполните поля:

    ПолеДействие
    Product nameЗаголовок браузера, шапка, страница входа, имя установленного приложения, а также префикс и метка задач Jira. Не более 60 символов
    TaglineОтображается рядом с названием на широких экранах и в описании установленного приложения. Не более 120 символов
    LogoNone, Built-in mark или Image URL: адрес https или путь на этом сервере, начинающийся с /
    Default themeТема страницы входа и новых пользователей. Пользователи по-прежнему могут выбрать собственную
    Show "powered by" lineСтрока с указанием авторства в нижнем колонтитуле, отображается только со встроенным знаком
  2. Выберите Save.

Если для Logo задано значение None, везде используется нейтральный значок, в том числе на вкладке браузера и в установленном приложении, поэтому ничто в браузере не называет продукт. Сообщения Slack и общедоступные страницы состояния никогда не называют продукт, независимо от фирменного оформления.

Доступны темы Midnight, Daylight, Slate and amber, Ops room (high contrast), Okabe–Ito (colour-blind safe) и Paper. Если ui.themes отключена, установка предлагает только светлую и темную темы.

У ветви клиента могут быть собственные тема и логотип по умолчанию; см. раздел Настройка оформления ветви.

Выполнение через API​

Для каждого запроса нужна роль Super admin, и каждый запрос проходит аудит.

ЗадачаЗапрос
Чтение полной конфигурации, предустановок и реестра функцийGET /api/v1/instance/admin
Применение предустановкиPOST /api/v1/instance/preset с {"name": "databases"}
Переключение функцийPATCH /api/v1/instance/features с {"changes": {"collab.jira": false}}
Изменение фирменного оформленияPATCH /api/v1/instance/branding с любыми из product_name, tagline, logo, show_powered_by, theme_default

GET /api/v1/instance не требует входа: возвращает фирменное оформление и переключатели в том виде, в каком их видит вызывающая сторона. Именно эти данные консоль считывает при загрузке.