Эти руководства сопоставляют понятия отрасли с объектами, которые в платформе есть сегодня (букеты, линии, пакеты, аккаунты реселлеров, ноды, API). Это концептуальные соответствия, а не отраслевые функции, и аккаунт реселлера — делегированный аккаунт, а не изолированный тенант.
Концептуальное соответствие
В панели ничто не называется подпиской или точкой присутствия. Таблица показывает, какой объект какую роль играет; главы ниже настраивают их в этом порядке.
| В вашей отрасли | На платформе | Где в панели |
|---|---|---|
| Аккаунт дилера или регионального партнёра | Аккаунт реселлера: делегированная панель с кредитами, правами и собственными линиями | Users → добавить реселлера; Groups для его прав |
| Уровень каналов или дополнительный пакет | Букет: именованный набор каналов, фильмов или сериалов, который открывает пакет | Bouquets, из Streams и Movies / Series |
| Телеканал | Прямой канал: стрим со своими источниками, EPG и форматами вывода | Streams → добавить прямой стрим (URL источника или RTMP-поток) |
| Библиотека VOD | VOD-каталог: фильмы и сериалы с сезонами и эпизодами, категориями и метаданными | Movies и Series либо задача загрузки VOD |
| Телевизионный доступ абонента | Линия: один доступ со своим пакетом, букетами, сроком действия, лимитом подключений и выводами | Lines → добавить, либо коды активации, либо Reseller API |
| Конец расчётного периода | Срок действия линии, который продлевается пакетом, кредитом или через API | Срок действия линии и длительность пакета |
| Экранов на подписку | Максимум подключений линии: сколько устройств могут смотреть одновременно | Максимум подключений линии |
| Интеграция с биллингом и провижинингом | Reseller API и webhook: операции панели из вашей собственной системы | Ключи Reseller API и webhook в панели реселлера |
| Нода точки присутствия | Ноды стриминга: edge-серверы, подключённые из панели, по одной на объект или здание | Servers → добавить ноду, установка по SSH |
Требования
Что подготовить перед установкой.
- Сервер на центральной площадке (Ubuntu 22.04 или 24.04), установщик, домен или адрес, доступный абонентам, и сервер в каждой точке присутствия для нод.
- Лицензированные потоки каналов, библиотека VOD и биллинговая система, в которой живут подписки.
- Решение об уровнях подписки, длительности расчётного периода и о том, какие дилеры получают партнёрский аккаунт.
Развёртывание инфраструктуры
Центральная площадка, затем точки присутствия.
- Запустите установщик на центральном сервере; поставьте панель за ваш reverse proxy и задайте TRUSTED_PROXIES, чтобы логи и IP-правила видели реальный адрес абонента.
- Задайте базу воспроизведения на публичный адрес, по которому заходят абоненты, и лицензионный ключ на сервере.
- Зарегистрируйте ноду на каждую точку присутствия в разделе Servers; панель устанавливает её по SSH, либо нода регистрируется по одноразовому коду, и направляет на неё ближайших абонентов.
- Создайте партнёрский аккаунт (реселлер) для поддержки или биллинговой команды только с правами на линии.
Организация контента
Уровни и пакеты как букеты.
- Добавьте каналы в Streams, а библиотеку VOD — в Movies и Series, с категориями и источником EPG.
- Создайте букеты для базового набора каналов, премиум-каналов и библиотеки VOD.
- Создайте по одному пакету на уровень подписки с выдаваемыми им букетами, расчётным периодом в качестве срока действия и ценой в кредитах.
- Создайте короткий пробный пакет для акции или нового клиента.
Настройка партнёров (реселлеров)
Дилеры с кредитами.
- Создайте группу для дилеров с правами на их собственные линии и без доступа к каталогу и настройкам.
- Добавьте каждого регионального дилера как партнёрский аккаунт с этой группой, пакетами, которые он вправе продавать, и балансом кредитов; у дилера могут быть суб-реселлеры до пяти уровней в глубину.
- Webhook credits.low и уведомление о малом остатке кредитов подсказывают дилеру пополнить баланс, пока продажи не остановились.
Настройка линий абонентов
Одна линия на подписку.
- Биллинг создаёт линию при начале подписки через коннектор или action=create_line Reseller API с пакетом уровня и идентификатором запроса.
- Задайте максимальное число подключений для каждого уровня — число экранов, которые домохозяйство может использовать одновременно.
- Привяжите линию к адресу, стране или провайдеру абонента, если предложение действует только в вашей сети.
- Для пилота или случая поддержки добавьте линии через Lines → add и выдайте учётные данные.
Библиотека VOD
Каталог по запросу.
- Добавьте фильмы и сериалы с сезонами и сериями, загруженные заданием VOD ingest или вручную, с метаданными TMDB для постеров и описаний.
- Сгруппируйте названия в букеты по уровню или дополнению, чтобы пакет выдавал ровно то, что включает подписка.
- Ноды кэшируют файлы VOD, поэтому популярные названия раздаются из точки присутствия рядом с абонентом.
Прямые каналы
Набор каналов.
- Добавьте каждый лицензированный канал в Streams с его потоком и включайте catch-up или timeshift только там, где это разрешают права.
- Добавьте источник EPG, чтобы приложения и приставки показывали программу передач.
- Каждая нода забирает прямой канал у origin один раз и раздаёт его своим абонентам.
Срок действия, продление и отмена
Расчётный период как срок действия линии.
- Линия действует в течение периода своего пакета; биллинг продлевает её каждый период командой action=renew_line или через коннектор.
- Когда подписка истекает или отменяется, биллинг вызывает action=disable_line, а при повторной активации снова включает линию.
- Подпишите биллинг на webhooks, чтобы сверять истекающие и истёкшие линии со своими записями.
Интеграция с биллингом
Биллинг управляет доступом, плеер воспроизводит.
- Установите коннектор для вашей биллинговой системы на её стороне (WHMCS, Blesta, Odoo и другие) или вызывайте Reseller API с ключом и идентификатором запроса из собственной системы.
- Единого входа (SSO) для зрителей нет: абонент входит в приложение или на приставку с учётными данными линии, которые биллинг может показывать в личном кабинете клиента.
- Используйте ключи Admin API с флагом «только чтение», списком разрешённых IP и сроком действия для инструментов отчётности.
Вопросы безопасности
Сервис — для абонентов.
- Поставьте панель за reverse proxy с TLS и задайте TRUSTED_PROXIES; управляющий трафик нод держите в частной сети.
- Двухфакторный вход для каждого аккаунта панели и группы прав для поддержки и дилеров; reCAPTCHA или Turnstile на входе.
- Подписанные и истекающие ссылки воспроизведения, лимит подключений на подписку и привязка к адресу, стране или провайдеру там, где это уместно.
- Зашифрованные резервные копии базы данных с копией вне площадки и журнал аудита для каждого изменения линий и кредитов.
Устранение неполадок
Обычные первые проверки.
- У абонента нет телевидения: проверьте, что линия включена и не истекла, затем вызов биллинга в журнале вызовов Reseller API.
- Канала нет у одного уровня: проверьте букеты пакета этого уровня.
- Точка присутствия буферизует: проверьте heartbeat её ноды и то, что её абоненты направлены на неё.
- Дилер не может создать линию: проверьте его кредиты и то, что пакет входит в число тех, которые он вправе продавать.