Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется передачей или поклонником. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Канал студии | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Библиотека передач | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Уровень подписки | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Доступ поклонника | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Период оплаты | Срок действия линии, который продлевается пакетом, кредитом или через API | Срок действия линии и длительность пакета |
| Аккаунт аффилиата или дистрибьютора | Аккаунт реселлера: делегированная панель с кредитами, правами и собственными линиями | Users → добавить реселлера; Groups для его прав |
| Интеграция с магазином или членством | Reseller API и webhook: операции панели из вашей собственной системы | Ключи Reseller API и webhook в панели реселлера |
Требования
Что подготовить перед установкой.
- Сервер (Ubuntu 22.04 или 24.04) с публичным адресом или доменом и достаточной исходящей полосой для ожидаемой аудитории.
- Готовые выпуски, плейаут или кодировщик студии для канала и магазин на платформе с коннектором либо возможность вызывать HTTP API.
- Решение по уровням подписки и аффилиатам: что даёт каждая подписка и кто вправе её продавать.
Развёртывание инфраструктуры
Сначала один сервер, ноды — по мере роста аудитории.
- Запустите установщик на управляющем сервере и поставьте панель за reverse proxy с TLS; задайте доверенные прокси, чтобы IP-правила видели реальный адрес зрителя.
- Задайте базовый URL воспроизведения на публичный адрес, по которому заходит ваша аудитория.
- Зарегистрируйте ноду в разделе Servers в регионе, где смотрит много поклонников; панель устанавливает её по SSH и направляет на неё зрителей этого региона.
- Создайте партнёрский аккаунт (реселлер) для каждого сотрудника, который ведёт каталог или поклонников, с собственной группой прав.
Организация контента
Передачи как сериалы, уровни как букеты.
- Создайте категории по жанрам и по одному сериалу на передачу — с сезоном на каждую партию выпусков и серией на каждое видео.
- Создайте букет для прямого канала, один для бесплатного или начального контента и по одному для каждого более высокого уровня.
- Создайте по одному пакету на уровень со сроком действия, равным расчётному периоду, пробный пакет для новых посетителей, если он вам нужен, и цену в кредитах для аффилиатов.
- Держите архив выпусков в отдельной категории, чтобы его можно было переносить между уровнями, не трогая сериалы.
Настройка партнёров (реселлеров)
Аффилиаты и дистрибьюторы.
- Создайте группу для аффилиатов только с правами на линии, чтобы они не могли менять каталог.
- Добавьте каждого аффилиата как реселлера с этой группой и балансом кредитов; цену его пакета определяет студия.
- Дистрибьютор с суб-аффилиатами может создавать суб-реселлеров под своим аккаунтом, до пяти уровней в глубину.
Настройка доступа поклонников
Одна линия на поклонника.
- Установите коннектор вашего магазина (например, WooCommerce) и введите ключ Reseller API и пакет, соответствующий каждому товару.
- При подписке коннектор вызывает create_line с пакетом и идентификатором запроса; расчётный период — это срок действия пакета.
- Задайте максимальное число подключений по числу устройств, которыми может пользоваться поклонник, обычно два-три.
- Для розыгрыша или запуска создайте коды активации массово или добавьте линии через Lines → add с пробным пакетом.
Библиотека передач
Серии по запросу.
- Загрузите каждую серию как источник или загрузите её заданием VOD ingest; заполните название, сезон, номер серии и метаданные TMDB, если они есть у передачи.
- Подключите каждый сериал к букетам уровней, которым разрешено его смотреть.
- Проверьте воспроизведение с тестовой линией каждого уровня, прежде чем объявлять о выпуске.
Канал студии
Канал круглосуточно.
- Добавьте прямой поток для плейаута студии (RTMP push) и поместите его в букеты каждого уровня, включающего канал.
- Загрузите программу канала в формате XMLTV, чтобы поклонники видели, что идёт в эфире, и включите catch-up для передач, которые стоит пересматривать.
- Поддерживайте работу плейаута между релизами собственным запланированным контентом студии; панель лишь ретранслирует поток.
Срок действия подписки
Доступ следует за оплатой.
- Линия истекает в конце периода своего пакета; магазин продлевает её командой renew_line, когда приходит следующий платёж.
- Подпишите магазин на webhooks, чтобы он отправлял напоминание при line.expiring и понижал поклонника при line.expired.
- Поклонника, отменившего подписку, магазин отключает командой disable_line, а линию позже можно продлить без нового аккаунта.
Интеграция с магазином
Магазин продаёт, плеер воспроизводит.
- Коннектор создаёт, продлевает и отключает линии в соответствии с заказами; любой другой магазин использует Reseller API и webhooks.
- Аффилиаты видят свои линии в своей панели, а Reseller API позволяет им автоматизировать это.
- Единого входа (SSO) для зрителей нет: поклонники входят в плеер с учётными данными своей линии, которые отправляет им магазин.
Вопросы безопасности
Защищайте подписку, а не только сервер.
- Отдавайте панель и базовый URL воспроизведения по TLS и укажите в TRUSTED_PROXIES ваш reverse proxy.
- Двухфакторный вход для каждого аккаунта панели и группы прав, чтобы аффилиаты не могли менять каталог.
- Подписанные и истекающие ссылки воспроизведения и лимит подключений на линию; привяжите линию к стране, если лицензия территориальная.
- Зашифрованные резервные копии базы данных с копией вне площадки и журнал аудита для каждого изменения линий и каталога.
Устранение неполадок
Обычные первые проверки.
- Новый поклонник не может смотреть после оплаты: проверьте вызов коннектора магазина в журнале Reseller API и дату окончания линии.
- Поклонник видит контент более высокого уровня: проверьте пакет линии и выдаваемые им букеты.
- Канал останавливается в конце цикла плейаута: проверьте отправку потока кодировщиком в прямой поток и статус проверки потока.
- Продажа аффилиата не появляется: проверьте его кредиты и то, что использованный пакет принадлежит его группе.