Быстрый старт¶

Эта страница доводит одну чистую машину до играющего эфира. Всё происходит на ней одной: пакет agora превращает её в полноценную установку — управляющий контур и стример одним процессом — и попутно заводит себе базу.

Базу данных, стримеры и кластер вы здесь не настраиваете. Это придёт позже, когда установка перерастёт одну коробку.

Что понадобится¶

• Машина с Ubuntu 24.04 и доступом root.
• Доступ в интернет — лицензия активируется онлайн.
• Лицензионный ключ. Скопируйте его в личном кабинете на my.flussonic.ru: установка спросит ключ сама, создавать license.txt руками не нужно.

Подключите репозиторий¶

Пакеты лежат в репозитории Flussonic:

curl -L http://apt.flussonic.ru/repo/master/dev.key > /etc/apt/trusted.gpg.d/dev.gpg
echo "deb http://apt.flussonic.ru/branch/sapsan/master repo/" > /etc/apt/sources.list.d/flussonic.list
apt update

Установите¶

apt install --install-recommends agora

Установка спросит лицензионный ключ — вставьте тот, что скопировали в личном кабинете. Пакет сам запишет его в /etc/agora/license.txt (владелец root, права 0600). Ответ можно оставить пустым: пакет поставится, но сервис не стартует, пока ключа нет. Если файл лицензии на машине уже есть, вопрос не задаётся — обновление ничего не переспрашивает.

Одного пакета достаточно. agora делает эту машину установкой Agora и тянет за собой всё, что для этого нужно.

--install-recommends здесь не для красоты: плагины транскодера — рекомендуемая зависимость, а не обязательная. Сервер работает и без них, но кодировать будет нечем. Apt ставит рекомендуемые пакеты по умолчанию, поэтому на обычной системе флаг ничего не меняет; на хосте с APT::Install-Recommends "false" именно он сохраняет кодирование рабочим.

При установке пакет agora:

• создаёт роль и базу agora;
• генерирует пароль базы и пароль администратора и пишет оба в /etc/agora/secrets.env (режим 0600, владелец root);
• запускает agora.service, который на первом старте накатывает схему базы.

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

Войдите в панель¶

Прочитайте пароль администратора:

grep EDIT_AUTH_PASSWORD /etc/agora/secrets.env

Откройте в браузере http://<адрес-сервера>/ и войдите как admin с этим паролем.

Вы попадёте в панель. Перейдите в раздел Стримы — на свежей установке их ещё нет.

Заведите первый эфир¶

Введите имя townhall и нажмите Создать. Эфир откроется на вкладке Источники, где пока ничего не настроено.

Одна пустая строка источника здесь уже есть. Выберите в ней протокол Synthetic — это встроенный генератор, он даёт проверить воспроизведение до того, как к серверу подключат настоящую студию. Отметьте обе галочки — Генерировать видео (полосы SMPTE) и Генерировать аудио (beep/bop): подставившиеся значения (1280×720 при 25 кадрах, 48 кГц стерео) как раз те, что нужны. Нажмите Сохранить.

Через несколько секунд под формой появится карточка с параметрами входа: сервер принял сигнал и разобрал его.

Включите транскодер¶

Генератор отдаёт несжатое видео и звук, которых не понимает ни один плеер, поэтому эфир нужно закодировать. Перейдите на вкладку Транскодер и нажмите пресет Стандартная лестница 1080/720/360 + AAC — он заводит три разрешения сразу, как для настоящей трансляции: ноутбук в офисе возьмёт верхнее, телефон через VPN — нижнее. Нажмите Сохранить.

Посмотрите эфир¶

Вернитесь на вкладку Основные настройки. Когда сервер соберёт первые сегменты, встроенный плеер покажет картинку генератора, а над ним — что пришло на вход и что получилось на выходе.

Одна машина работает. Дальше:

• Администраторы — завести живые учётные записи вместо аварийной.
• Эфиры — подключить настоящий источник вместо генератора.
• Кластер — добавить второй сервер, когда одного перестанет хватать.