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