Документация

SIVO документация

От установки одной командой до абонентов, которые смотрят в своих приложениях.

Быстрая установка

Панель за несколько минут, одной командой.

Запустите от root на новом сервере Ubuntu 24.04 или 26.04 (x86_64) внутри вашей сети.

Прочтите полное руководство по установке
Ubuntu — bash
curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

Руководство по началу работы

Обзор

SIVO — это платформа IPTV, которую вы развёртываете на собственном сервере внутри своей сети. Она получает каждый телеканал из Интернета один раз и раздаёт его всем абонентам, которые его смотрят, поэтому затраты на исходящий трафик канала не растут вместе с аудиторией. Фильмы, сериалы и записи архива хранятся на том же сервере.

Абоненты смотрят в приложениях, которыми уже пользуются: IPTV Smarters, TiviMate, VLC, приложения для смарт-ТВ. SIVO работает с API Xtream Codes и M3U, поэтому вам достаточно отправить им адрес сервера, логин и пароль или одну ссылку M3U.

  • Панель (порт 80) — здесь вы управляете каналами, контентом и абонентами.
  • Потоковый порт (по умолчанию 8080) — это то, к чему подключаются приложения; каждый запрос на нём проверяется: учётная запись включена, не истекла, пакет разрешает канал, число одновременных устройств.

Руководство по началу работы

Требования

  • Ubuntu 24.04 или 26.04, x86_64 (amd64). ARM и Docker не поддерживаются.
  • 4 ядра CPU и 8 GB RAM для нескольких сотен зрителей; при большем числе зрителей важнее сеть, а не процессор, так как каналы копируются, а не перекодируются.
  • Диск для библиотеки и архива: фильм занимает от 1 до 20 GB, сутки архива одного HD-канала — примерно 30–40 GB.
  • Сетевой доступ из Интернета для получения каналов и от ваших абонентов к серверу.

Руководство по началу работы

Установка

Запустите от root на новом сервере:

curl -fsSL https://sivo.securytik.com/install.sh | sudo bash

Установщик загружает последний подписанный релиз (с GitHub или с зеркала dl.securytik.com, если GitHub заблокирован), устанавливает PostgreSQL, потоковый движок, nginx и панель и в конце выводит пароль администратора. Повторный запуск безопасен: ваши данные и настройки сохраняются.

Руководство по началу работы

Первый вход в систему

Откройте http://SERVER-IP/admin/ и войдите как admin с паролем, который вывел установщик. Измените его в своём профиле.

  • Настройки → Потоковая передача: укажите публичный адрес, который будут использовать абоненты (например, http://tv.example.net:8080). Он попадает в каждые данные для входа и каждую ссылку M3U.
  • Телеканалы в эфире → Стартовые каналы: добавляет бесплатные каналы, которые вещатели транслируют сами.
  • Система → Лицензия: зарегистрируйте установку в своей учётной записи SecuryTik (тариф Free включает 100 пользователей).

Руководство по началу работы

Настройки потоковой передачи

  • Публичный адрес и порт: то, к чему подключаются приложения.
  • Качество, получаемое из источников: максимально доступное или ограничение (1080p, 720p, 576p, 480p), если ваш интернет-канал небольшой.
  • Неактивные подключения завершаются автоматически по истечении заданного вами времени ожидания.
  • Папка медиафайлов: где хранятся фильмы, сериалы и архив передач.

Контент

Телеканалы в эфире

Добавьте канал с адресом источника (HLS, RTMP, RTSP, SRT, UDP) и, при желании, резервным источником. Канал «по запросу» запускается, когда его открывает первый зритель, и останавливается через минуту после того, как уйдёт последний; для каналов, которые должны работать постоянно, отключите режим «по запросу».

  • Состояние: идёт трансляция, простой или экран «Нет сигнала» (источник не отвечает; зрители видят ваш экран).
  • Номер, категория, логотип и ID программы передач — то, что показывают приложения.
  • Импорт M3U добавляет сразу много каналов из файла или по адресу.

Контент

Экран «Нет сигнала»

Если источник не отвечает, зрители видят экран SIVO вместо ошибки приложения, а изображение возвращается само, когда источник снова появляется. Измените две строки текста или загрузите собственное изображение в разделе Настройки → Экран «Нет сигнала».

Контент

Источники и импорт

В разделе «Источники» хранятся учётные записи провайдеров (Xtream Codes), на которые у вас есть права. Добавьте сервер, логин и пароль; SIVO проверяет вход и считывает телеканалы в эфире, фильмы и сериалы аккаунта. Ответственность за добавляемое лежит на вас: см. Условия и политику.

  • Откройте учётную запись, отфильтруйте по типу или категории, найдите нужное, отметьте нужные названия и выберите «Импортировать выбранное».
  • Фильмы и эпизоды загружаются на ваш сервер через одну очередь, по одному файлу за раз, поэтому учётная запись, допускающая одно подключение, никогда не используется дважды. После загрузки они появляются в приложениях.
  • Сериал импортируется со всеми сезонами и эпизодами, которые есть у провайдера, с постерами и описанием.
  • Телеканалы в эфире, импортированные из учётной записи, получаются из неё, пока кто-то их смотрит; каждый канал, который смотрят одновременно, занимает одно из подключений аккаунта.

Импортируйте только тот контент, на распространение которого у вас есть право.

Контент

Фильмы

  • Загрузите файл или укажите его адрес и выберите «Сохранить на этом сервере», чтобы загрузить его.
  • Статус показывает: в очереди, загрузка с процентом, готово или ошибка.
  • Описание, актёры, режиссёр, постер и фон — вручную или из TMDB (добавьте ключ TMDB в настройках).
  • Добавьте аудиодорожки и файлы субтитров; SIVO объединяет их в один файл, чтобы приложения показывали их в своих меню.

Контент

Сериалы

  • Сериалы → сериал → его сезоны → эпизоды сезона; каждый уровень — это список, который можно искать, сортировать и обрабатывать массово.
  • Файлы с именами S01E01, S01E02… сами получают номера сезона и эпизода.
  • Названия сезонов, описания и постеры показываются в приложениях.

Контент

Архив передач

Задайте дни архива (от 1 до 30) для канала. SIVO записывает его фрагментами по 10 секунд, приложения предлагают прошедшие передачи из телепрограммы, а записи старше заданного срока удаляются. В разделе «Записи» показано, сколько места на диске занимает каждый канал.

Контент

Телепрограмма

Добавьте адреса XMLTV в разделе «Телепрограмма». Они загружаются каждые 6 часов и сопоставляются с каналами по ID программы. Приложения абонентов получают телепрограмму по их собственной ссылке.

Абоненты

Пакеты

Пакет открывает выбранные категории каналов, фильмов и сериалов. Абонент без пакета видит всё.

Абоненты

Абоненты

  • Логин и пароль (используются в приложении), полное имя, телефон, пакет, срок действия и число одновременных устройств.
  • Вкладка «Доступ» показывает сервер, логин, ссылки M3U и телепрограммы для отправки.
  • Продлить добавляет дни от сегодняшней даты или от текущего срока действия — в зависимости от того, что позже; Отключить завершает то, что смотрит абонент.
  • Каждый новый абонент учитывается в лимите пользователей лицензии.

Абоненты

Приложения и ссылки

В IPTV Smarters, TiviMate и большинстве приложений выберите Xtream Codes и введите адрес сервера, логин и пароль. Приложения, которые принимают только плейлист, используют ссылку M3U из раздела «Доступ».

http://tv.example.net:8080/get.php?username=USER&password=PASS&type=m3u_plus&output=ts

Абоненты

Смотрят сейчас

«Смотрят сейчас» показывает каждое открытое подключение: абонент, канал или название, устройство и адрес. Завершите подключение через его меню; абоненту, превысившему число одновременных устройств, следующий поток будет отказан.

Эксплуатация

Поиск, фильтры и экспорт

  • Введите текст в поле поиска, чтобы отфильтровать строки; нажмите Enter, чтобы сохранить его как фильтр-токен.
  • В меню рядом с полем есть фильтры, «Группировать по», сохранённые поиски и пользовательские фильтры.
  • Отметьте строки для массовых действий; «Экспорт» загружает CSV.

Эксплуатация

Администраторы и роли

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

Эксплуатация

Резервное копирование и восстановление

Инструменты → Резервная копия создаёт копию базы данных и настроек (медиатека в неё не входит; скопируйте папку медиафайлов отдельно). Восстановление — на той же странице.

Эксплуатация

Обновления

Обновления подписываются SecuryTik и проверяются перед установкой. «Система → Обновления» показывает текущую и последнюю версию; обновления можно устанавливать вручную или автоматически.

Эксплуатация

Лицензирование и тарифы

Каждая установка лицензируется отдельно по количеству пользователей (абонентов). Незарегистрированная установка обслуживает до 25 пользователей; зарегистрированная на тарифе Free — 100. Платные тарифы: Lite 500, Plus 1,000, Pro 2,000, Mega 5,000, Max 10,000 и Unlimited. См. Цены.

Запросить тариф можно в разделе «Система → Лицензия» или на панели управления; первый запрос для учётной записи — бесплатный месяц. Если платная лицензия истекает, сначала появляется предупреждение, затем льготный период; данные никогда не удаляются.

Эксплуатация

Cloudflare Tunnel

«Система → Cloudflare Tunnel» открывает панель (и, если вы выберете, потоковый порт) на вашем домене по HTTPS без открытия портов.

Справочник

REST API

«Система → API» создаёт токены с областями доступа. API управляет абонентами (создание, изменение, продление, включение, отключение, удаление, ссылки доступа), пакетами, каналами, фильмами, сериалами, списком тех, кто смотрит, и итогами. Полный справочник с кнопкой «Попробовать» доступен на вашей установке по адресу /api/v1/docs.

curl -H "Authorization: Bearer sivo_YOUR_TOKEN" http://SERVER/api/v1/subscribers

Справочник

Webhooks

«Система → API → Webhooks» отправляет subscriber.created, subscriber.updated и subscriber.deleted на ваш адрес в формате JSON, подписанные X-Sivo-Signature: sha256=HMAC тела запроса. Неудачные отправки повторяются.

Справочник

Устранение неполадок

  • Канал показывает экран «Нет сигнала»: его источник не отвечает с вашего сервера; откройте меню канала и выберите «Проверить».
  • Канал открывается медленно или тормозит: качество источника выше, чем позволяет ваш интернет-канал; задайте ограничение качества в «Настройки → Потоковая передача».
  • Приложение сообщает, что вход неверный: проверьте публичный адрес в настройках и убедитесь, что абонент включён и срок его действия не истёк.
  • Слишком много устройств: достигнуто число одновременных устройств абонента; завершите старое подключение в разделе «Смотрят сейчас».