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

Переменные среды

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

Excubius считывает параметры установки из файла .env в каталоге установки — по умолчанию /opt/excubius/.env с режимом 0600, владелец — служебная учетная запись. Установщик записывает этот файл на основе ваших ответов и один раз создает секреты. В этом справочнике перечислены ключи, которые можно задать, сгруппированные как в файле.

Большинство параметров находится в консоли, а не здесь: фирменное оформление и переключатели функций — в Settings › Instance, имена и сертификаты — в Settings › Server, источники — в Settings › Sources, учетные данные для мониторинга — в Settings › Credentials. После изменения файла перезапустите платформу от имени служебной учетной записи командой systemctl --user restart excubius.

внимание

Создайте резервную копию файла .env, а вместе с ним и EXCUBIUS_DATA_KEY. Без этого ключа секреты, хранящиеся в базе данных, невозможно расшифровать.

Установка​

КлючПо умолчаниюЗначение
EXCUBIUS_HOME/opt/excubiusКаталог установки. Записывается установщиком
SERVER_NAME—Основное имя: узел общедоступного URL-адреса
REGISTRYghcr.io/custorius-labs/excubiusПрефикс реестра и репозитория образов
PROXY_MODEhttphttp или https. Действует, только пока управление не перешло к службе сертификатов; после этого решает Settings › Server
COOKIE_SECUREпустоПусто: файлы cookie сеанса получают атрибут Secure, если запрос пришел по HTTPS. true или false задают его принудительно. Оставьте пустым

Имена и TLS​

Эти ключи задают начальные параметры TLS только при первом запуске, когда у платформы их еще нет. После этого имена и сертификаты управляются в Settings › Server без перезапуска. Установщик удаляет из файла учетные данные DNS и закрытый ключ, как только платформа их сохранит.

КлючПо умолчаниюЗначение
TLS_MODEпустоletsencrypt_http, letsencrypt_dns, selfsigned, custom, gateway или http. Также принимаются имена установщика letsencrypt, letsencrypt-dns и later
TLS_ALIASESпустоДругие имена, которые могут открывать пользователи, через пробел
TLS_CERT_NAMESпустоИмена для сертификата через пробел. Пусто: все имена
TLS_EMAILпустоАдрес электронной почты учетной записи Let's Encrypt
TLS_ACME_SERVERproductionstaging — для репетиции с тестовыми сертификатами, которым браузеры не доверяют
TLS_DNS_PROVIDERпустоИдентификатор dnsapi в acme.sh для поставщика DNS, например dns_cf или dns_azure
TLS_DNS_CREDENTIALSпустоПары KEY=VALUE, разделенные переводами строк или ;, либо base64:<…>
TLS_CERT_FILE, TLS_KEY_FILEпустоbase64:<PEM contents> вашей цепочки сертификатов и закрытого ключа
TLS_ACME_DNSSLEEP0Сколько секунд ждать распространения DNS вместо проверки через общедоступные сопоставители DNS-over-HTTPS. Используйте в сетях, из которых они недоступны

Продукт​

КлючПо умолчаниюЗначение
PRODUCT_NAMEExcubiusТолько резервное значение. Название продукта берется из фирменного оформления в Settings › Instance
DEFAULT_LOCALEenЯзык по умолчанию
BASE_URL—Общедоступный URL-адрес, например https://monitoring.example.com. Его используют ссылки в сообщениях
EXCUBIUS_DEFAULT_PRESETenterpriseПредустановка, с которой запускается экземпляр: enterprise, databases или core
EXCUBIUS_FEATURES_ENFORCE_APIfalsetrue: отключенные функции также отклоняются API. По умолчанию они только скрываются в интерфейсе

База данных и секреты​

КлючПо умолчаниюЗначение
POSTGRES_USERexcubiusПользователь базы данных
POSTGRES_PASSWORDсоздаетсяТолько буквы и цифры, потому что пароль встраивается в URL-адрес подключения
POSTGRES_DBexcubiusИмя базы данных
DATABASE_URLстроится из трех ключей вышеURL-адрес подключения. Контейнеры получают его построенным из трех ключей выше
EXCUBIUS_DATA_KEYсоздаетсяКлюч, которым шифруются секреты в базе данных: учетные данные, секреты источников, ключи API DNS. 32 случайных байта в URL-безопасном base64. Никогда не меняйте его в работающей установке
EXCUBIUS_COLLECTOR_TOKENсоздаетсяОбщий секрет сборщика и API. Пусто: сборщик простаивает, а конечные точки сборщика отключены

Вход​

КлючПо умолчаниюЗначение
JWT_SECRETсоздаетсяПодписывает токены сеанса. 64 случайных символа
ACCESS_TOKEN_MINUTES15Время жизни токена доступа
REFRESH_TOKEN_DAYS14Время жизни сеанса
ENTRA_TENANT_ID, ENTRA_CLIENT_ID, ENTRA_CLIENT_SECRETпустоВход через Microsoft Entra ID с одним клиентом: идентификатор каталога, а не common или organizations. Предлагается, когда заданы все три ключа. URI перенаправления: <BASE_URL>/api/v1/auth/entra/callback
GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRETпустоВход через Google. URI перенаправления: <BASE_URL>/api/v1/auth/google/callback
ALLOWED_SIGNUP_DOMAINSпустоДомены электронной почты через запятую; пользователи из них при первом входе получают учетную запись с ролью наблюдателя в корне. Действует, только пока в корневой сущности не сохранен режим регистрации. Пусто: только по приглашению

Секреты клиентов никогда не хранятся в базе данных и не записываются в журналы.

Ядро мониторинга​

КлючПо умолчаниюЗначение
EXCUBIUS_UNREACHABLE_AFTER3Число последовательных сбоев подключения, входа или по времени ожидания, после которого ресурс получает оповещение Cannot reach
EXCUBIUS_NOTIFY_QUIET_MINUTES10Минимальный интервал в минутах между двумя сообщениями об одном и том же условии. Сообщение о росте серьезности отправляется всегда
EXCUBIUS_COLLECTOR_VIA_PROXYfalsetrue только для сборщика вне сервера, который обращается к API через общедоступный адрес

Сборщик​

Контейнер сборщика получает только эти ключи, а не весь файл.

КлючПо умолчаниюЗначение
EXCUBIUS_COLLECTOR_TOKENсоздаетсяСм. раздел База данных и секреты
EXCUBIUS_COLLECTOR_TRANSPORTSвсе имеющиеся транспортыПодмножество для предоставления через запятую, например tsql,http,dns. Значения: tsql, http, dns, winrm, ssh, azure_graph, defender, entra, wazuh
EXCUBIUS_COLLECTOR_CONCURRENCY32Число одновременно выполняемых проверок
EXCUBIUS_TSQL_THREADS16Потоки для подключений к SQL Server
EXCUBIUS_SQL_APP_NAMEmonitoring-collectorИмя приложения для сеансов SQL Server сборщика
EXCUBIUS_ODBC_DRIVERODBC Driver 18 for SQL ServerИмя драйвера ODBC
AZURE_SUBSCRIPTION_IDSпустоПодписки через запятую для собственных проверок Resource Graph (безопасность облака, Azure Update Manager), если учетные данные их не задают. Пусто: все подписки, которые может читать удостоверение. У источника Azure Monitor свой список
AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRETпустоПусто: управляемое удостоверение сервера. Только AZURE_CLIENT_ID указывает на назначаемое пользователем управляемое удостоверение. Все три: вместо него используется этот субъект-служба

У сборщика есть также параметры интервалов опроса, размеров пакетов и буфера и имени узла, но установленная платформа не передает их в его контейнер, поэтому действуют значения по умолчанию: назначения каждые 30 секунд, задания каждые 10 секунд, пульс каждые 60 секунд, 200 результатов в пакете, 10 000 результатов хранится, пока API недоступен.

Уведомления и заявки​

КлючПо умолчаниюЗначение
SLACK_BOT_TOKENпустоТокен бота приложения Slack с областью chat:write. Пусто: в Slack ничего не отправляется
SLACK_DEFAULT_CHANNEL#alertsПолучает предупреждения и критические оповещения, если ни у одной сущности на пути нет канала
JIRA_BASE_URLпустоhttps://<site>.atlassian.net
JIRA_AUTHtokentoken (адрес электронной почты и токен API), oauth (учетные данные клиента служебной учетной записи Atlassian) или bearer
JIRA_EMAIL, JIRA_API_TOKENпустоУчетные данные для token
JIRA_OAUTH_CLIENT_ID, JIRA_OAUTH_CLIENT_SECRETпустоУчетные данные для oauth
JIRA_CLOUD_IDпустоТолько для oauth: облачный идентификатор сайта
JIRA_OAUTH_TOKEN_URLhttps://auth.atlassian.com/oauth/tokenURL-адрес токена для oauth
JIRA_DEFAULT_PROJECTпустоКлюч проекта для новых задач
JIRA_ISSUE_TYPETaskИмя типа задачи в этом проекте
JIRA_SYNC_MINUTES10Как часто считывается статус открытых задач
WEB_PUSH_VAPID_PUBLIC, WEB_PUSH_VAPID_PRIVATEпустоЗарезервировано для веб-push-уведомлений, недоступных в этом выпуске. Оставьте пустыми

Ключи Jira — это значения по умолчанию: каждая сущность может переопределить их в собственных параметрах Jira. См. статью Создание задач Jira из оповещений.

Обработчик обновлений и безопасности​

КлючПо умолчаниюЗначение
EXCUBIUS_SECURITY_WORKERtrueФоновый обработчик API: каналы поставщиков, истечение принятия рисков, проверки, выполняемые API, снимки оценки безопасности, статус Jira. Задавайте false только на дополнительных репликах API
EXCUBIUS_FEEDS_ENABLEDtruefalse: никогда не загружать каналы поставщиков — для изолированных установок. Используются копии, поставляемые с выпуском
EXCUBIUS_FEED_TIMEOUT_SECONDS60Время ожидания для каждого запроса к каналу
EXCUBIUS_FEED_SQLSERVER_BUILDS_URLSсайт dbatools, затем GitHubURL-адреса списка сборок SQL Server через пробел, перебираются по порядку. Поставьте внутреннее зеркало первым
EXCUBIUS_FEED_ENDOFLIFE_URLhttps://endoflife.date/apiБазовый URL-адрес канала окончания поддержки
EXCUBIUS_FEED_MSRC_URLhttps://api.msrc.microsoft.com/cvrf/v3.0Базовый URL-адрес бюллетеней безопасности Майкрософт
EXCUBIUS_FEED_MSRC_MONTHS3Число ежемесячных выпусков, которые поддерживаются в актуальном состоянии, от 1 до 24
HTTPS_PROXYпустоПрокси-сервер для запросов к каналам

Ключи, которые этот выпуск не считывает​

Поставляемый файл .env.example все еще содержит NEWRELIC_API_KEY, NEWRELIC_ACCOUNT_ID, NEWRELIC_WEBHOOK_SECRET, NINJAONE_CLIENT_ID, NINJAONE_CLIENT_SECRET, NINJAONE_REGION, WAZUH_API_URL, WAZUH_API_USER и WAZUH_API_PASSWORD. Этот выпуск их игнорирует. Настройте New Relic и NinjaOne в Settings › Sources, а Wazuh — с помощью учетных данных и параметров проверки; см. статьи Источники и Безопасность облака.