Настройки стримера¶

У стримера нет собственной конфигурации: её хранит central и доставляет на машину. Форма настроек живёт внизу карточки стримера — откройте его из реестра кликом по строке.

Как применяются изменения¶

Кнопка Сохранить изменения отправляет только то, что вы поменяли, — параллельные правки других секций не затираются. Дальше за доставкой следит трасса из трёх индикаторов:

Сохранено — central принял изменения.
В полёте — конфигурация едет на стример; индикатор пульсирует. Если стример офлайн, форма прямо говорит: настройки применятся при восстановлении связи.
Применено — стример подтвердил применение; рядом — сколько секунд заняла доставка.

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

Жёлтый бейдж ENV у поля означает, что значение задано окружением самой машины: оно сильнее доставленного из central, и правка формы на этом стримере не подействует, пока переменную не уберут.

Листенеры¶

Порты, которые стример открывает по каждому протоколу: HTTP, RTSP, RTMP, WebRTC. Порт добавляется чипом; чип с пометкой tls означает, что на порту есть сертификат.

Сертификаты и HTTPS¶

Секция Сертификаты вешает TLS на HTTP-листенеры — сертификат живёт на порту, поэтому сначала нужен листенер. Кнопка Включить HTTPS делает и то и другое разом: заводит листенер на 443 и запись Let's Encrypt на нём. На один порт можно повесить несколько записей: клиенты выбирают сертификат по SNI.

Источник сертификата в записи:

Let's Encrypt — автоматическая выписка на перечисленные домены. Рядом появляется Контактный e-mail ACME, и он обязателен: без него выписка не пойдёт и сохранение не даст себя нажать, на него же CA шлёт предупреждения об истечении. Под Дополнительно лежат адрес каталога ACME и тумблер тестового CA — пустой адрес означает боевой Let's Encrypt.
Статический PEM — свой сертификат и приватный ключ: PEM целиком или путь к файлу на стримере.
Самоподписанный — для стендов и внутренних контуров.

Домены пишутся через запятую; форма подставляет имя хоста из адресов доставки стримера. На голый IP-адрес ACME сертификат не выпишет — нужен домен.

Состояние выписки видно рядом с самой записью и повторяется выше в карточке стримера: выписан (с сроком до истечения), выписывается, не выписан — с текстом ошибки. За две недели до истечения строка желтеет.

Весь путь целиком, с предусловиями и причинами, по которым выписка застревает, — Сертификат HTTPS.

DVR¶

Куда стример пишет архив: Корень архива, список дисков, когда их несколько, и Путь каталога. Выключатель Проверять монтирование перед записью включён по умолчанию: запись на раздел системного корня запрещена, диск без собственного монтирования репортится как «не смонтирован». Выключайте его только осознанно.

Блок DVR: архивные диски, кэш-диски и допуск в кэш

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

Кэш-диски¶

Второй список — Кэш-диски. Это диски другой роли: на них оседают архивные чтения — участки, которые стример достал для зрителя с другого стримера или со своих архивных дисков, — и повторное обращение обслуживает кэш: локально и с быстрого диска. Живая запись их не выбирает, ретенция стримов ими не распоряжается, а место освобождает вытеснение по давности чтения. Так из эджа делают эдж-кэш.

У каждого кэш-диска два необязательных ограничения:

Лимит кэша, ГиБ — сколько кэшу позволено занять; пусто — ограничен только свободным местом.
Свободно не меньше, ГиБ — сколько места оставить на томе; пусто — системный минимум.

Один и тот же путь нельзя указать и архивным диском, и кэш-диском — сохранение отклонит такую конфигурацию.

Ниже — допуск в кэш, общий на весь кэш стримера:

Свежее — сразу, часов — фрагменты моложе этой глубины кэшируются с первого запроса; пусто — сутки.
Старое — с какого запроса — с какого повтора кэшируется фрагмент старше этой границы; пусто — со второго, 1 — сразу.

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

Стример без кэш-дисков не ломается от стрима с включённым кэшированием: кэш просто не работает, а в лог идёт предупреждение.

Занятый объём кэша и хитрейт видны в разделе DVR кластера; механика кэша целиком — в документации Sapsan.

Подробно про запись и просмотр архива — страница DVR.

VOD¶

Секция VOD задаёт VOD-root'ы, которые нода отдаёт и в которые принимает загрузки. Без хотя бы одного root'а раздел Каталог VOD остаётся пустым: заливать некуда.

У каждого root'а — Имя root'а и Путь, плюс тонкая настройка: Макс. открытых файлов, Idle-таймаут, с, Макс. read-хендлов; отдельно есть Глобально макс. открытых файлов на всю ноду.

Имя — не подпись, а часть раскладки на диске, поэтому переименование root'а не поддерживается. Выбирайте имя сразу тем, каким оно останется.

Опечатка в имени поля отвергается сохранением: ответ 422 с путём до поля — например, unknown field "vod.root", если написать root вместо roots.

Префиксы публикации¶

Префиксы имён, под которыми стример принимает входящие публикации. Без префиксов публикация принимается только в существующие стримы.

Роль и размещение¶

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

Подключение и доставка¶

API URL стримера — адрес, по которому central обращается к management API машины. Без него у стримера в реестре загорается чип достижимости, а его сессии пропадают из выдачи.
CDN-зона — к какой зоне относится стример; по ней балансировщик проигрывания направляет зрителей.
Публичный payload URL — публичная база адресов для зрителей. Задана — плееры получают редирект прямо на стример; пуста — central проксирует медиа через себя.
Внутрикластерный payload URL — база для перекачек между стримерами и проксирования; по умолчанию совпадает с API URL.

Итоговый режим доставки виден в карточке стримера: внутрипроцессно (локальный стример), редирект, проксирует central или недостижима — красным, если не задано ничего. Отдельное предупреждение появляется, когда сертификат на имя выписан, а база доставки всё ещё http:// — TLS в этом случае не используется.

Reverse proxy и сброс¶

Секция Reverse proxy (JSON) — временный редактор сырой секции rproxy; невалидный JSON блокирует сохранение.

Кнопка Сбросить к дефолту в опасной зоне возвращает все настройки стримера к значениям по умолчанию — стример применит их при следующем sync. Действие необратимо.