Руководства
Мастер и слейвы: установка и настройка
Как распределить зрителей между несколькими серверами. Главный сервер (мастер) хранит базу и решает, куда отправить каждого клиента. Дополнительные серверы (слейвы) раздают каналы вместо него.
Как это работает
- Клиент подключается к мастеру, как и раньше. Адреса в плейлистах не меняются.
- Мастер выбирает сервер и перенаправляет туда клиента. Плейлисты (Xtream, M3U, Stalker, NICE, TVIP) сразу содержат адрес выбранного слейва.
- Слейв проверяет абонента по своей копии данных и запускает поток. Фильмы и сериалы (VOD) воспроизводятся с мастера.
- Каждые 15 секунд слейв спрашивает мастер об изменениях и скачивает только изменённое, включая логотипы каналов. С ключом он также отправляет отчёт о нагрузке.
Слейв — это та же программа, что и мастер. Разница — одна настройка: Configuration → BALANCER.
Перед началом
- Одинаковая версия (5.5+) на мастере и всех слейвах.
- Слейв → мастер: слейв достаёт до порта панели мастера (по умолчанию
4300). - Мастер → слейв: мастер достаёт до порта панели слейва (для списка подключений и «kick»).
- Клиенты → слейв: клиенты достают до портов вещания слейва:
3000MPEGTS,4000Xtream,4001Stalker,4002NICE API,4003TVIP,9888HLS (или ваших, если вы их меняли — слейв берёт их у мастера). - Точное время на всех серверах (NTP). Допускается разница до 10 минут, иначе защищённые запросы отклоняются.
- Для установки по SSH: доступ root к новому серверу.
1Сделайте сервер мастером
На главном сервере откройте Configuration → вкладка BALANCER.

- Balancer type → Master.
- Balancer key — общий секрет мастера и слейвов. Всё, что передаётся между ними, включая пароли абонентов, шифруется и подписывается этим ключом.
- Generate создаёт случайный ключ. Можно ввести свой: 16–128 символов, буквы, цифры,
-и_. Скопируйте ключ — он нужен каждому слейву. - Save.
Тогда используется старый протокол: шифр одинаков для всех установок, а слейв распознаётся только по IP. Не работают и отчёт о нагрузке, и общий лимит подключений. Рекомендуем всегда задавать ключ.
2Добавьте слейв на мастере
На мастере: Channels → Balancers. Заполните данные нового сервера в строке Add.

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

- IP-адрес нового сервера.
- Порт SSH (обычно
22). Пользователь —root. - Пароль root. Используется только для этой установки.
- Имя слейва, например
DE-1. - Страны и сети — как на шаге 2.
- Panel language на слейве.
- Stream workers — оставьте auto: мастер определяет число ядер нового сервера во время установки.
- Source read, ms —
20. - Start install. Ход установки виден в чёрном поле.
Мастер устанавливает панель, делает её слейвом со своим адресом, записывает Id и ключ, включает Admin login from master и добавляет её в список. В панель слейва входят с тем же пользователем и паролем, что и на мастере (после первой синхронизации, до 60 с после запуска). Через несколько минут слейв появляется online — см. шаг 4.
Вариант Б — вручную
1. Установите панель на новый сервер как обычно (под root):
curl -s https://nice-panel.com/install3.sh | bash -s 5.52. Войдите в панель слейва → Configuration → BALANCER:

- Balancer type → Slave.
- Master — адрес мастера с портом панели:
IP:4300. - Balancer Id — тот же, что в списке мастера (шаг 2). С ключом мастер узнаёт слейв по нему, независимо от IP (динамический IP, NAT, другой исходящий адрес).
- Balancer key — тот же ключ, что на мастере.
- Network speed (Mbps) —
0= берётся из сетевой карты. Укажите значение (1000,10000) на виртуальных серверах или если порт/тариф медленнее карты. - 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 / 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) | сколько видов данных он ещё не скачал. Ненадолго после изменения или перезапуска — это нормально |
Каждая панель показывает свою роль под логотипом на каждой странице — так вы всегда знаете, в какой панели находитесь:


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 Id | Id слейва не задан или его нет в списке мастера |
IP not allowed | без ключа слейв должен подключаться с IP своего адреса. С ключом заполните Id на слейве |
master … – no sync | слейв не достаёт до мастера: сеть, файрвол, порт 4300 |
| «offline» на мастере | слейв остановлен или не достаёт до мастера. Его зрители уходят на другие серверы |
| «speed unknown» | виртуальная карта не сообщает скорость. Задайте Network speed на слейве |
- обновите мастер и все слейвы;
- задайте ключ (и Id) на слейвах;
- в последнюю очередь — на мастере.
Пока ключи не совпадают, слейвы работают с последними полученными данными.