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

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

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

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

• Машина с 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 catena

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

Одного пакета достаточно. catena делает эту машину установкой Catena и тянет за собой всё, что для этого нужно: стриминговый сервер соответствующей версии и PostgreSQL.

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

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

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

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

Войдите в интерфейс¶

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

grep EDIT_AUTH_PASSWORD /etc/catena/secrets.env

Откройте в браузере http://<адрес-сервера>/ и войдите как admin с этим паролем. Вы попадёте на Панель управления: один стример — эта самая машина — и пока ни одного стрима.

Заведите первый стрим¶

Перейдите в Стримы. На свежей установке их ещё нет.

Введите имя quickstart и нажмите Create. Стрим откроется на вкладке Sources, где пока ничего не настроено.

Нажмите + Add Source и выберите протокол Synthetic — встроенный генератор, чтобы проверить воспроизведение до подключения реального источника. Отметьте обе галочки — Generate video (SMPTE bars) и Generate audio (beep/bop): подставившиеся значения (1280×720 при 25 кадрах, 48 кГц стерео) как раз те, что нужны. Нажмите Save.

Генератор отдаёт несжатые кадры, которые обычный плеер не читает, поэтому стриму нужен ещё и транскодер. Откройте вкладку Транскодер и нажмите Стандартная лестница 1080/720/360 + AAC — один пресет закрывает всю задачу. Нажмите Save.

Central записывает стрим и передаёт его стримеру. Через несколько секунд стрим показывается запущенным.

Посмотрите его¶

Вернитесь на вкладку Basic Settings. На странице стрима есть встроенный плеер: тестовые полосы с бегущими часами означают, что весь путь работает — источник, транскодер, стример, воспроизведение.

Тот же стрим доступен любому внешнему плееру по адресу http://<адрес-сервера>/streaming/v/quickstart/index.m3u8.

Если что-то пошло не так¶

Посмотрите сервис и его лог:

systemctl status catena
journalctl -u catena -n 50

• Сервис не запущен, в логе упоминается лицензия. Ключ при установке не ввели. Положите его в /etc/catena/license.txt и выполните systemctl start catena.
• Установка сообщила, что PostgreSQL недоступен. База не заведена. Создайте её сами, впишите DATABASE_URL в /etc/catena/secrets.env и выполните systemctl restart catena.
• Плеер пишет, что не может загрузить видео. Стрим работает, но наружу не выходит ничего воспроизводимого — почти всегда это отсутствующий транскодер: синтетический генератор отдаёт сырые кадры, а плееру нужны H.264 и AAC. Проверьте вкладку Транскодер.
• Транскодер настроен, но стрим всё равно ничего не отдаёт. Проверьте, что плагины кодирования установлены: dpkg -l | grep sapsan-transcoder. Если стоит только пакет -base, коробку ставили без рекомендуемых пакетов — выполните apt install --install-recommends catena.
• Стрим есть, но не запускается. Посмотрите страницу стрима: там видно, размещён ли стрим на стримере и жив ли его источник.

Что дальше¶

Всё это делается на той же одной машине, дополнительной настройки не требуется:

• подключить реальные источники, настроить резервные входы и переключение между ними;
• добавить мультибитрейтный транскодинг, запись архива и nPVR;
• настроить воспроизведение и авторизацию на нём.

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