NICE re/streamer pro

Руководства

Мастер и слейвы: установка и настройка

Как распределить зрителей между несколькими серверами. Главный сервер (мастер) хранит базу и решает, куда отправить каждого клиента. Дополнительные серверы (слейвы) раздают каналы вместо него.

Как это работает

  1. Клиент подключается к мастеру, как и раньше. Адреса в плейлистах не меняются.
  2. Мастер выбирает сервер и перенаправляет туда клиента. Плейлисты (Xtream, M3U, Stalker, NICE, TVIP) сразу содержат адрес выбранного слейва.
  3. Слейв проверяет абонента по своей копии данных и запускает поток. Фильмы и сериалы (VOD) воспроизводятся с мастера.
  4. Каждые 15 секунд слейв спрашивает мастер об изменениях и скачивает только изменённое, включая логотипы каналов. С ключом он также отправляет отчёт о нагрузке.

Слейв — это та же программа, что и мастер. Разница — одна настройка: Configuration → BALANCER.

Перед началом

1Сделайте сервер мастером

На главном сервере откройте Configuration → вкладка BALANCER.

Configuration → BALANCER на мастере: тип Master, ключ, Generate, Save
  1. Balancer type → Master.
  2. Balancer key — общий секрет мастера и слейвов. Всё, что передаётся между ними, включая пароли абонентов, шифруется и подписывается этим ключом.
  3. Generate создаёт случайный ключ. Можно ввести свой: 16–128 символов, буквы, цифры, - и _. Скопируйте ключ — он нужен каждому слейву.
  4. Save.
Без ключа тоже работает, но без защиты.

Тогда используется старый протокол: шифр одинаков для всех установок, а слейв распознаётся только по IP. Не работают и отчёт о нагрузке, и общий лимит подключений. Рекомендуем всегда задавать ключ.

2Добавьте слейв на мастере

На мастере: Channels → Balancers. Заполните данные нового сервера в строке Add.

Форма добавления балансировщика: Id, имя, адрес, страны
  1. Id — номер слейва. Предлагается свободный. Запомните его: тот же номер вводится на слейве.
  2. Имя — например DE-1. По этому имени абонента закрепляют за слейвом вручную.
  3. IP address or host name — адрес для клиентов: 203.0.113.21 или de1.example.com. Туда перенаправляются зрители, и он попадает в плейлисты.
  4. Страны и сети — кого обслуживает слейв: коды стран (DE,AT), подсети (10.20.0.0/16) или отдельные IP через запятую. Оставьте пустым, если слейв только для вручную закреплённых абонентов.
  5. Panel language на слейве — английский или болгарский.
  6. Stream workers — auto (рекомендуется) или точное число. См. «Настройки слейва с мастера» ниже.
  7. Source read, ms — по умолчанию 20.
  8. Add balancer.
Подсказка

При установке по SSH (вариант А на следующем шаге) эту строку можно пропустить — установка добавит слейв сама.

3Установите и настройте слейв

Вариант А — по SSH с мастераБыстрее всего. Мастер сам устанавливает панель на новый сервер и настраивает её.
Вариант Б — вручнуюЕсли у мастера нет root-доступа по SSH или панель там уже установлена.

Вариант А — установка по SSH

На мастере: Channels → Balancers → SSH installation (справа вверху).

Окно установки по SSH: IP, порт, пароль, имя и страны
  1. IP-адрес нового сервера.
  2. Порт SSH (обычно 22). Пользователь — root.
  3. Пароль root. Используется только для этой установки.
  4. Имя слейва, например DE-1.
  5. Страны и сети — как на шаге 2.
  6. Panel language на слейве.
  7. Stream workers — оставьте auto: мастер определяет число ядер нового сервера во время установки.
  8. Source read, ms — 20.
  9. Start install. Ход установки виден в чёрном поле.

Мастер устанавливает панель, делает её слейвом со своим адресом, записывает Id и ключ, включает Admin login from master и добавляет её в список. В панель слейва входят с тем же пользователем и паролем, что и на мастере (после первой синхронизации, до 60 с после запуска). Через несколько минут слейв появляется online — см. шаг 4.

Вариант Б — вручную

1. Установите панель на новый сервер как обычно (под root):

curl -s https://nice-panel.com/install3.sh | bash -s 5.5

2. Войдите в панель слейва → Configuration → BALANCER:

Configuration → BALANCER на слейве: тип, мастер, Id, ключ, скорость сети, вход администратора
  1. Balancer type → Slave.
  2. Master — адрес мастера с портом панели: IP:4300.
  3. Balancer Id — тот же, что в списке мастера (шаг 2). С ключом мастер узнаёт слейв по нему, независимо от IP (динамический IP, NAT, другой исходящий адрес).
  4. Balancer key — тот же ключ, что на мастере.
  5. Network speed (Mbps) — 0 = берётся из сетевой карты. Укажите значение (1000, 10000) на виртуальных серверах или если порт/тариф медленнее карты.
  6. Admin login from master — No: слейв сохраняет своего администратора и пароль. Yes: берёт их у мастера.

3. Save. Слейв скачивает с мастера всё: каналы, абонентов, EPG, VOD, настройки и логотипы. Если у мастера другие порты, слейв берёт их и сам перезапускается.

4. Если ещё не сделали, добавьте слейв в список мастера (шаг 2).

Настройки слейва с мастера

Страница Configuration на слейве ограничена — большинство настроек приходит с мастера. Три настройки задаются для каждого слейва отдельно на мастере, в его строке в Balancers (Add, правка ✎ или SSH installation):

НастройкаЧто делает
Panel languageязык панели слейва. Применяется сразу, без перезапуска
Stream workersпроцессы, которые раздают каналы зрителям, на нескольких ядрах. Auto по ядрам слейва: до 4 ядер → 2, до 8 → 4, больше 8 → 8 (больше 8 не помогает). Или точное число (off, 1–16)
Source read, msкак часто слейв читает источники каналов. По умолчанию 20; 0 = выкл. Применяется сразу
Когда слейв перезапускается

Число процессов вступает в силу после перезапуска, поэтому слейв перезапускается сам — только если значение действительно изменилось. Его зрители отключаются на несколько секунд. При установке по SSH нужное число записывается сразу, перезапуска нет. Слейв, установленный вручную, получает его при первом обращении к мастеру — один перезапуск.

4Проверьте состояние

На мастере: Channels → Balancers. Состояние каждого слейва обновляется каждые 5 секунд.

Список балансировщиков: три слейва online, защищены, с клиентами, CPU, RAM, сетью и нагрузкой
Три слейва online, защищены, с числом клиентов и показателями. У BG-1 карта 1 Гбит/с и он загружен сильнее всех, поэтому новые зрители из Германии идут на DE-2.
ПоказаноЗначение
● online / offlineобращался ли слейв к мастеру за последние 150 с. Номер становится зелёным или красным
protected / unprotectedс ключом / старый протокол без ключа
from <IP>слейв подключается с IP, отличного от его адреса (NAT, имя хоста) — для информации
N clientsсколько зрителей обслуживает слейв
EN / BGязык панели, заданный для слейва
CPU · RAM · Mbpsзагрузка процессора (ядра), памяти и сети (трафик / скорость карты)
workers N (auto) · read N msфактические stream workers и source read слейва. Оранжевое → N — новое значение ждёт перезапуска слейва
load %самый загруженный из трёх ресурсов. По нему выбирается слейв; выше 90% выделяется цветом
syncкогда слейв последний раз подтвердил данные
changes waiting (N)сколько видов данных он ещё не скачал. Ненадолго после изменения или перезапуска — это нормально

Каждая панель показывает свою роль под логотипом на каждой странице — так вы всегда знаете, в какой панели находитесь:

Заголовок мастера: MASTER красным под логотипом
MASTER — красным
Заголовок слейва: SLAVE (201) оранжевым под логотипом, метка сервера оранжевая
SLAVE (Id) — оранжевым, с Id слейва из списка мастера; метка сервера тоже оранжевая

5Какой зритель на какой сервер

При каждом новом подключении мастер проверяет правила по порядку и останавливается на первом, которое даёт живой слейв:

ПравилоКак задать
1. ВручнуюUsers → поле Balancer абонента (или массово для отмеченных). Всегда в приоритете, пока слейв жив
2. ПодсетьIP зрителя входит в подсеть или IP из поля «страны» балансировщика
3. Странастрана зрителя по GeoIP указана в поле «страны»
4. Мастерничего не совпало или эти слейвы недоступны: зритель остаётся на мастере

Несколько слейвов для одного места

Если для одной страны или сети есть несколько живых слейвов, новый зритель идёт на наименее загруженный. Это не round robin: нагрузка — это максимум из процессора, памяти и сети, поэтому сервер с более быстрой картой или большим числом ядер получает пропорционально больше зрителей. При равенстве (до 5 пунктов) решает абонент, так что один абонент попадает на один и тот же сервер.

Слейв недоступен

Слейв, не обращавшийся к мастеру более 150 с, пропускается. Перенаправление временное (302), поэтому следующее подключение зрителя снова идёт через мастер и попадает на живой сервер. Если при запуске слейва мастер недоступен, слейв стартует с последними полученными данными.

Лимит подключений

С ключом лимит абонента общий для всех серверов: 2 разрешённых подключения — это 2 всего, а не по 2 на сервер.

Если что-то не работает

Сообщения находятся в журнале панели и начинаются с [BAL].

Сообщение / симптомЧто делать
old protocol – set the same bal_key thereу мастера есть ключ, у слейва нет. Введите ключ на слейве
bal_key mismatchключи разные или часы расходятся более чем на 10 минут
unknown slave … set the same IdId слейва не задан или его нет в списке мастера
IP not allowedбез ключа слейв должен подключаться с IP своего адреса. С ключом заполните Id на слейве
master … – no syncслейв не достаёт до мастера: сеть, файрвол, порт 4300
«offline» на мастереслейв остановлен или не достаёт до мастера. Его зрители уходят на другие серверы
«speed unknown»виртуальная карта не сообщает скорость. Задайте Network speed на слейве
Переход на ключ в работающей установке
  • обновите мастер и все слейвы;
  • задайте ключ (и Id) на слейвах;
  • в последнюю очередь — на мастере.

Пока ключи не совпадают, слейвы работают с последними полученными данными.