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

Справочник по установщику

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

Установщик install.sh устанавливает, обновляет, переустанавливает и удаляет Excubius на одном сервере. Он запускается от имени root из распакованного пакета установщика. В этом справочнике перечислены его параметры, предварительные проверки, вопросы, которые он задает, и то, что он оставляет на сервере. Порядок установки описан в статье Установка Excubius.

sudo ./install.sh [options]

Параметры​

ПараметрДействие
(нет)Установка. На сервере, где Excubius уже установлен, предлагает Upgrade (по умолчанию: сохраняет данные и параметры и задает только вопросы, появившиеся в этой версии), Reinstall, Purge или Cancel
--check-onlyВыполнить только предварительные проверки. Ничего не меняет
--images FILEУстановить из архива образов без доступа к реестру. Архив в каталоге images/ рядом со скриптом, как в автономном пакете, используется автоматически
--answers FILEНеинтерактивный режим: строки key=value, включая секреты. См. раздел Файл ответов
--reconfigureПри обновлении заново задать все вопросы. Ответы по TLS, данные при этом, применяются к работающей платформе
--reinstallУдалить установленное программное обеспечение с сохранением базы данных, затем выполнить установку, задав все вопросы
--purgeУдалить все, включая базу данных, затем выполнить установку с нуля
--uninstallУдалить программное обеспечение. Сначала записывает итоговый дамп базы данных в <dir>/backups/, затем удаляет пользовательские юниты, контейнеры, образы, <dir>/releases, <dir>/current, /etc/excubius и параметр портов для режима rootless. Сохраняет тома базы данных и сертификатов, <dir>/backups, <dir>/.env и служебную учетную запись, чтобы последующая установка нашла данные
--uninstall --purgeТакже удалить все тома, весь каталог установки с резервными копиями, служебную учетную запись, созданную установщиком, вместе с хранилищем ее контейнеров и службы брандмауэра, добавленные установкой. Просит ввести purge
--no-backupНе создавать итоговый дамп базы данных при --uninstall или --reinstall
--yes, -yПринять все имеющиеся значения по умолчанию; обязательные ответы по-прежнему должны поступать из --answers или с клавиатуры. На сервере с установленной платформой означает Upgrade и подтверждает полное удаление
--dry-runВывести то, что будет сделано, ничего не меняя. При установке файлы конфигурации все равно записываются для проверки; рядом с существующим .env — как .env.dry-run
--skip-checksПродолжить, даже если предварительные проверки не пройдены, в неподдерживаемых системах, на ваш страх и риск
--help, -hВывести список параметров

Следующие сочетания отклоняются: --uninstall с --reinstall или --reconfigure; --purge с --reinstall; --check-only с --uninstall, --purge или --reinstall; --reconfigure с --purge или --reinstall.

Удаляется только записанный каталог установки — никогда системный путь или домашний каталог.

Предварительные проверки​

ПроверкаТребованиеЕсли не выполнено
Операционная системаRocky Linux или другая система семейства RHELОшибка
Основная версия9 или 10Предупреждение
Архитектураx86-64Ошибка
Система инициализацииsystemdОшибка
Диспетчер пакетовdnfОшибка
Память4 ГиБПредупреждение
Процессоры2 vCPUПредупреждение
Диск20 ГиБ свободно в /home, где служебная учетная запись хранит образы и базу данныхПредупреждение
Порты80 и 443 свободны при новой установкеОшибка
SELinuxСообщается состояние—
Реестрыghcr.io и docker.io доступны по HTTPS, или есть читаемый архив образовОшибка
ЧасыСинхронизированыПредупреждение; включается chrony

Вопросы​

Нажмите клавишу ВВОД, чтобы принять значение в квадратных скобках. При обновлении задаются только вопросы, появившиеся после версии, которая записала ваши ответы; столбец С версии показывает, в какой версии появился каждый вопрос.

КлючВопросПо умолчаниюКогда задаетсяС версии
install_dirКаталог установки/opt/excubiusВсегда; абсолютный путь0.2.0
service_userСлужебная учетная запись, от имени которой работает платформаexcubiusВсегда; создается при отсутствии, запускает контейнеры в режиме rootless0.2.0
public_urlОбщедоступный URL-адрес, который будут открывать пользователиhttps://monitoring.example.comВсегда; его узел — основное имя сервера0.2.0
server_aliasesДругие имена этого серверанетВсегда; через пробел, ВВОД — без имен0.3.0
tls_modeКак предоставляется HTTPSletsencryptВсегда: letsencrypt, letsencrypt-dns, selfsigned, custom, gateway или later0.2.0
tls_cert_namesИмена для сертификатаallЕсть псевдонимы, и режим создает сертификат0.3.0
tls_emailАдрес электронной почты для учетной записи Let's Encrypt—letsencrypt или letsencrypt-dns0.2.0
tls_dns_providerПоставщик DNS для зоны имен—letsencrypt-dns; идентификатор dnsapi в acme.sh, например dns_cf, dns_dreamhost или dns_azure0.3.0
tls_dns_credentialsУчетные данные API DNS—letsencrypt-dns; вводятся по одному без отображения0.3.0
tls_cert_fileФайл цепочки сертификатов—custom; PEM, сертификат сервера первым0.3.0
tls_key_fileФайл закрытого ключа—custom; PEM без парольной фразы, соответствует сертификату0.3.0
default_presetБазовая предустановкаenterpriseВсегда: enterprise, databases или core0.2.0
registry_user, registry_tokenПользователь реестра и токен только для чтения для образов—Без архива образов0.2.0
slack_bot_tokenТокен бота Slack—Всегда; необязательно0.2.0
slack_default_channelКанал Slack для оповещений#alertsВсегда0.2.0
entra_tenant_idИдентификатор клиента Entra ID для входа—Всегда; необязательно0.2.0
entra_client_id, entra_client_secretИдентификатор приложения и секрет клиента Entra ID—Указан идентификатор клиента0.2.0

Режимы TLS:

РежимКогда использовать
letsencryptВсе имена есть в общедоступной DNS и указывают на сервер, а порт 80 доступен из Интернета
letsencrypt-dnsУ вас есть учетные данные API для зоны DNS этих имен. Сервер не обязан быть доступен из Интернета
selfsignedГде угодно. Браузеры выводят предупреждение, пока пользователи не начнут доверять сертификату
customСертификат выпускает ваша организация
gatewayTLS завершается на подсистеме балансировки нагрузки или обратном прокси-сервере перед сервером
laterПока обычный HTTP

В режимах Let's Encrypt установщик проверяет имена в общедоступной DNS и по HTTP проверяет, что они указывают на этот сервер. Если это не так, он объясняет альтернативы, но никогда не останавливается из-за этого. Ответы по TLS только задают начальные параметры платформы; после этого они управляются в Settings › Server.

Создаваемые значения​

Установщик создает следующие значения один раз и никогда их не перезаписывает: пароль базы данных (POSTGRES_PASSWORD), секрет подписи сеансов (JWT_SECRET), ключ шифрования хранимых секретов (EXCUBIUS_DATA_KEY) и токен сборщика (EXCUBIUS_COLLECTOR_TOKEN). См. статью Переменные среды.

Файл ответов​

Для автоматической установки передайте --answers FILE с одной строкой key=value на каждый вопрос. Этот файл содержит секреты: защитите его и удалите после установки. Учетные данные DNS указываются в одной строке через ;. Для отсутствующего ответа берется значение по умолчанию; если обязательный ответ отсутствует или недопустим, установщик останавливается и называет ключ, чтобы вы могли дополнить файл и запустить установку снова.

Фрагмент:

install_dir=/opt/excubius
service_user=excubius
public_url=https://monitoring.areito.example
server_aliases=
tls_mode=letsencrypt-dns
tls_email=ops@areito.example
tls_dns_provider=dns_cf
tls_dns_credentials=CF_Token=<token>
default_preset=enterprise
registry_user=<registry user>
registry_token=<read-only token>
slack_bot_token=<bot token>
slack_default_channel=#areito-alerts
sudo ./install.sh --answers ./answers.conf --yes

Обновления и ответы с версиями​

Установщик записывает ваши несекретные ответы в <dir>/install.answers вместе с версией установщика, которая их записала, и признаком того, завершился ли этот запуск. При обновлении он задает только вопросы, появившиеся после этой версии. Незавершенный запуск считается новой установкой: все вопросы задаются снова, а прежние ответы предлагаются как значения по умолчанию. Секреты никогда не записываются в install.answers.

На сервере​

ПутьСодержимое
<dir>/.envКонфигурация и секреты; режим 0600, владелец — служебная учетная запись
<dir>/install.answersВаши несекретные ответы, версия, которая их записала, и признак завершения этого запуска
<dir>/currentУстановленный выпуск — ссылка в <dir>/releases/
<dir>/backupsЕжедневные дампы базы данных (хранятся последние 14) и итоговый дамп при удалении
~<service account>/.config/systemd/user/excubius.service и таймер резервного копирования
/var/log/excubius-install.logЖурнал установщика без секретов

От имени служебной учетной записи:

sudo -iu excubius
export XDG_RUNTIME_DIR=/run/user/$(id -u) # once per shell, for systemctl --user
systemctl --user status excubius # the platform
<dir>/current/scripts/compose.sh ps # the containers
<dir>/current/scripts/compose.sh logs -f backend # the API's log
<dir>/current/scripts/backup-db.sh # a database backup now
<dir>/current/scripts/enable-tls.sh --status # TLS without the console
<dir>/current/scripts/rollback.sh # back to the previous release