Установка

curl -fsSL http://cdn.aihummer.ru:9000/cdn/install.sh | sudo bash -s -- --version vX.Y.Z

/home/.aihummer/
├── bin/        бинарь gateway и CLI aihummer
├── etc/        конфигурация (gateway.env)
├── share/      статические ассеты (админка, виджет)
├── sidecars/   опциональные сервисы STT/TTS/и т.д.
├── plugins/    установленные плагины маркетплейса
├── systemd/    юнит-файлы (симлинки в /etc/systemd/system)
├── state/      рантайм-состояние
├── data/       хранилище блобов/медиа
└── logs/       логи сервисов

# Установить gateway с нативными STT/TTS и внешним SearXNG
curl -fsSL http://cdn.aihummer.ru:9000/cdn/install.sh | sudo bash -s -- \
  --version vX.Y.Z \
  --with-stt --with-tts \
  --external-searxng=https://searx.internal.example

# Установить закрытую ключом сборку alfa
curl -fsSL http://cdn.aihummer.ru:9000/cdn/install-alfa.sh | sudo bash -s -- \
  --version vX.Y.Z --key <CHANNEL_KEY>

# Эквивалент через окружение
AIHUMMER_CHANNEL_KEY=<CHANNEL_KEY>
# или
AIHUMMER_RELEASE_TOKEN=<CHANNEL_KEY>

systemctl status aihummer-gateway
curl -fsS http://localhost:8765/healthz
curl -fsS http://localhost:8765/readyz

AiHummer устанавливается **host-native**. Скрипт установки скачивает подписанный бандл под нужную архитектуру с CDN, раскладывает единый корень установки в `/home/.aihummer`, регистрирует systemd-юниты и при необходимости разворачивает сайдкары. Контейнеров в этом процессе нет нигде. > [!NOTE] > Это host-native установка — релизный tarball под управлением systemd, **а не** > Docker. Gateway, сайдкары и плагины работают каждый как свой systemd-сервис. ## Установка одной командой Запустите установщик от root и зафиксируйте нужную версию: ```bash curl -fsSL http://cdn.aihummer.ru:9000/cdn/install.sh | sudo bash -s -- --version vX.Y.Z ``` Скрипт определит архитектуру CPU, скачает подходящий бандл вместе с его контрольной суммой `.sha256` и cosign-подписью `.sig`, проверит обе, распакует корень установки и зарегистрирует сервис gateway. Замените `vX.Y.Z` на тот релиз, который собираетесь развернуть. ## Раскладка корня установки Всё лежит под одной директорией, `/home/.aihummer`: ```text /home/.aihummer/ ├── bin/ бинарь gateway и CLI aihummer ├── etc/ конфигурация (gateway.env) ├── share/ статические ассеты (админка, виджет) ├── sidecars/ опциональные сервисы STT/TTS/и т.д. ├── plugins/ установленные плагины маркетплейса ├── systemd/ юнит-файлы (симлинки в /etc/systemd/system) ├── state/ рантайм-состояние ├── data/ хранилище блобов/медиа └── logs/ логи сервисов ``` Юнит-файлы systemd, сгенерированные в `systemd/`, **симлинкуются в `/etc/systemd/system/`**, поэтому управляются обычными командами `systemctl`. ## Выбор сайдкаров Установщик может развернуть сайдкары нативно или подключить существующий инстанс по URL. Запустите его интерактивно, чтобы он спрашивал про каждый сайдкар, или управляйте флагами: | Флаг | Эффект | |---|---| | `--with-<name>` | Установить этот сайдкар нативно (например, `--with-stt`, `--with-tts`) | | `--external-<name>=URL` | Использовать существующий сайдкар по этому URL вместо установки | | `--no-<name>` | Пропустить этот сайдкар | | `--all` | Установить все доступные сайдкары | ```bash # Установить gateway с нативными STT/TTS и внешним SearXNG curl -fsSL http://cdn.aihummer.ru:9000/cdn/install.sh | sudo bash -s -- \ --version vX.Y.Z \ --with-stt --with-tts \ --external-searxng=https://searx.internal.example ``` Поскольку к сайдкарам обращаются по URL, можно свободно смешивать нативные и внешние и направлять несколько gateway на один общий сайдкар. ## Каналы релизов AiHummer поставляется по четырём каналам. Публично доступен только **stable**; остальные не опубликованы и закрыты ключом. | Канал | Опубликован | Обфусцирован | Установщик | |---|---|---|---| | stable | Да — публичный `install.sh` | — | `install.sh` | | alfa | Нет — закрыт ключом | Да | `install-alfa.sh` | | beta | Нет — закрыт ключом | Да | `install-beta.sh` | | dev | Нет — закрыт ключом | Нет (без обфускации) | `install-dev.sh` | Нестабильные каналы требуют ключ канала, передаваемый либо флагом, либо переменной окружения: ```bash # Установить закрытую ключом сборку alfa curl -fsSL http://cdn.aihummer.ru:9000/cdn/install-alfa.sh | sudo bash -s -- \ --version vX.Y.Z --key <CHANNEL_KEY> ``` ```ini # Эквивалент через окружение AIHUMMER_CHANNEL_KEY=<CHANNEL_KEY> # или AIHUMMER_RELEASE_TOKEN=<CHANNEL_KEY> ``` Для закрытых ключом каналов артефакты лежат за секретным путём CDN в виде tarball под каждую архитектуру вместе с контрольной суммой `.sha256` и cosign-подписью `.sig` — обе проверяются при установке. > [!WARNING] > Сборки `alfa` и `beta` обфусцированы; сборка `dev` — без обфускации. > Относитесь к ключам каналов как к секретам — любой с ключом может скачать > неопубликованные сборки. ## Проверка установки После завершения установщика проверьте сервис и эндпоинт готовности: ```bash systemctl status aihummer-gateway curl -fsS http://localhost:8765/healthz curl -fsS http://localhost:8765/readyz ``` `/healthz` сообщает о живости и версии; `/readyz` проверяет PostgreSQL и возвращает `503`, пока база недоступна. Встроенный CLI `aihummer` также предоставляет `aihummer status` и `aihummer doctor` для быстрого обзора здоровья. ## Куда дальше - Первый запуск: см. [Первый вход](/v1.0/getting-started/first-login), чтобы получить одноразовый пароль администратора. - Настройка развёртывания: читайте [Конфигурацию](/v1.0/getting-started/configuration). - Хотите пройти первый запуск по шагам? Используйте [Квикстарт](/v1.0/getting-started/quickstart).