Návody
Master a slave servery: instalace a nastavení
Jak rozdělit diváky mezi více serverů. Hlavní server (master) drží databázi a rozhoduje, kam každý klient půjde. Další servery (slave) místo něj vysílají kanály.
Jak to funguje
- Klient se připojuje k masteru jako dosud. Adresy v playlistech se nemění.
- Master vybere server a klienta na něj přesměruje. Playlisty (Xtream, M3U, Stalker, NICE, TVIP) rovnou obsahují adresu vybraného slave serveru.
- Slave ověří uživatele podle své kopie dat a spustí stream. Filmy a seriály (VOD) se přehrávají z masteru.
- Každých 15 sekund se slave zeptá masteru na změny a stáhne jen to, co se změnilo, včetně log kanálů. S klíčem posílá i hlášení o zátěži.
Slave běží na stejném programu jako master. Liší se jen jedním nastavením: Configuration → BALANCER.
Než začnete
- Stejná verze (5.5+) na masteru i všech slave serverech.
- Slave → master: slave se dostane na port panelu masteru (výchozí
4300). - Master → slave: master se dostane na port panelu slave serveru (seznam připojení a „kick“).
- Klienti → slave: klienti se dostanou na vysílací porty slave serveru:
3000MPEGTS,4000Xtream,4001Stalker,4002NICE API,4003TVIP,9888HLS (nebo vaše, pokud jste je změnili — slave je přebírá z masteru). - Přesný čas na všech serverech (NTP). Tolerance je až 10 minut, jinak jsou chráněné požadavky odmítnuty.
- Pro instalaci přes SSH: přístup root k novému serveru.
1Nastavte server jako master
Na hlavním serveru otevřete Configuration → záložka BALANCER.

- Balancer type → Master.
- Balancer key — sdílené tajemství masteru a slave serverů. Vše, co mezi nimi putuje, včetně hesel uživatelů, je tímto klíčem šifrováno a podepsáno.
- Generate vytvoří náhodný klíč. Můžete zadat i vlastní: 16–128 znaků, písmena, číslice,
-a_. Klíč si zkopírujte — potřebuje ho každý slave. - Save.
Pak se používá starý protokol: jeho šifra je stejná pro všechny instalace a slave se rozpoznává jen podle IP. Nefunguje ani hlášení o zátěži a společný limit připojení. Doporučujeme klíč vždy nastavit.
2Přidejte slave na masteru
Na masteru: Channels → Balancers. Vyplňte nový server v řádku Add.

- Id — číslo slave serveru. Nabídne se volné. Zapamatujte si ho: stejné číslo se zadává na slave serveru.
- Název — např.
DE-1. Podle něj se uživatel ke slave serveru přiřadí ručně. - IP address or host name — adresa pro klienty:
203.0.113.21nebode1.example.com. Sem jsou diváci přesměrováni a tato adresa je v playlistech. - Země a sítě — koho slave obsluhuje: kódy zemí (
DE,AT), podsítě (10.20.0.0/16) nebo jednotlivé IP, oddělené čárkou. Nechte prázdné, pokud slave slouží jen ručně přiřazeným uživatelům. - Panel language na slave — angličtina nebo bulharština.
- Stream workers — auto (doporučeno) nebo pevný počet. Viz „Nastavení slave z masteru“ níže.
- Source read, ms — výchozí
20. - Add balancer.
Při instalaci přes SSH (možnost A v dalším kroku) tento řádek vynechte — instalace slave přidá sama.
3Nainstalujte a nastavte slave
Možnost A — instalace přes SSH
Na masteru: Channels → Balancers → SSH installation (vpravo nahoře).

- IP adresa nového serveru.
- Port SSH (obvykle
22). Uživatel jeroot. - Heslo roota. Použije se jen pro tuto instalaci.
- Název slave serveru, např.
DE-1. - Země a sítě — jako v kroku 2.
- Panel language na slave.
- Stream workers — nechte auto: master zjistí počet jader nového serveru už při instalaci.
- Source read, ms —
20. - Start install. Průběh je vidět v černém poli.
Master nainstaluje panel, nastaví ho jako slave s adresou masteru, zapíše mu Id a klíč, zapne Admin login from master a přidá ho do seznamu. Do panelu slave se přihlásíte stejným uživatelem a heslem admina jako na masteru (po první synchronizaci, do 60 s po startu). Za několik minut se slave objeví jako online — viz krok 4.
Možnost B — ručně
1. Nainstalujte panel na nový server jako obvykle (jako root):
curl -s https://nice-panel.com/install3.sh | bash -s 5.52. Přihlaste se do panelu slave serveru → Configuration → BALANCER:

- Balancer type → Slave.
- Master — adresa masteru s portem panelu:
IP:4300. - Balancer Id — stejné jako v seznamu masteru (krok 2). S klíčem podle něj master slave pozná bez ohledu na IP (dynamická IP, NAT, jiná odchozí adresa).
- Balancer key — stejný klíč jako na masteru.
- Network speed (Mbps) —
0= zjistí se ze síťové karty. Zadejte hodnotu (1000,10000) na virtuálních serverech nebo když je port/tarif pomalejší než karta. - Admin login from master — No: slave si ponechá vlastního admina a heslo. Yes: převezme je z masteru.
3. Save. Slave stáhne z masteru vše: kanály, uživatele, EPG, VOD, nastavení a loga. Pokud má master jiné porty, slave je převezme a sám se restartuje.
4. Pokud jste to ještě neudělali, přidejte slave do seznamu masteru (krok 2).
Nastavení slave z masteru
Stránka Configuration na slave je omezená — většina nastavení přichází z masteru. Tři nastavení patří každému slave zvlášť a zadávají se na masteru, v jeho řádku v Balancers (Add, úprava ✎ nebo SSH installation):
| Nastavení | Co dělá |
|---|---|
| Panel language | jazyk panelu na slave. Platí hned, bez restartu |
| Stream workers | procesy, které posílají kanály divákům, na více jádrech. Auto podle jader slave: do 4 jader → 2, do 8 → 4, nad 8 → 8 (víc než 8 nepomáhá). Nebo pevný počet (off, 1–16) |
| Source read, ms | jak často slave čte zdroje kanálů. Výchozí 20; 0 = vypnuto. Platí hned |
Počet procesů začne platit po restartu, proto se slave restartuje sám — jen když se hodnota opravdu změní. Jeho diváci se na několik sekund odpojí. Při instalaci přes SSH se správný počet zapíše už při instalaci, restart tedy není. Ručně nainstalovaný slave ho dostane při prvním kontaktu s masterem — jeden restart.
4Zkontrolujte stav
Na masteru: Channels → Balancers. Stav každého slave serveru se obnovuje každých 5 sekund.

| Zobrazeno | Význam |
|---|---|
| ● online / offline | zda se slave za posledních 150 s ozval masteru. Číslo zezelená nebo zčervená |
| protected / unprotected | s klíčem / starý protokol bez klíče |
| from <IP> | slave se připojuje z jiné IP, než je jeho adresa (NAT, název hostitele) — pro informaci |
| N clients | kolik diváků slave obsluhuje |
| EN / BG | jazyk panelu nastavený pro slave |
| CPU · RAM · Mbps | vytížení procesoru (jádra), paměti a sítě (provoz / rychlost karty) |
| workers N (auto) · read N ms | skutečné stream workers a source read na slave. Oranžové → N — nová hodnota čeká na restart slave |
| load % | nejvytíženější ze tří zdrojů. Podle ní se slave vybírá; nad 90 % je zvýrazněna |
| sync | kdy slave naposledy potvrdil data |
| changes waiting (N) | kolik druhů dat ještě nestáhl. Krátce po změně nebo restartu je to normální |
Každý panel také ukazuje svou roli pod logem, na každé stránce — vždy víte, ve kterém panelu jste:


5Který divák na který server
Při každém novém připojení master prochází pravidla popořadě a zastaví se u prvního, které dá živý slave:
| Pravidlo | Jak ho nastavit |
|---|---|
| 1. Ručně | Users → pole Balancer uživatele (nebo hromadně pro vybrané). Má vždy přednost, dokud je slave živý |
| 2. Podsíť | IP diváka patří do podsítě nebo IP z pole „země“ balanceru |
| 3. Země | země diváka podle GeoIP je v poli „země“ |
| 4. Master | nic nesedí nebo jsou tyto slave servery mimo provoz: divák zůstává na masteru |
Více slave serverů pro jedno místo
Má-li jedna země nebo síť více živých slave serverů, nový divák jde na nejméně vytížený. Nejde o round robin: zátěž je maximum z procesoru, paměti a sítě, takže server s rychlejší kartou nebo více jádry dostane úměrně více diváků. Při shodě (do 5 bodů) rozhoduje uživatel, takže jeden uživatel končí stále na stejném serveru.
Výpadek slave serveru
Slave, který se masteru neozval déle než 150 s, se přeskakuje. Přesměrování je dočasné (302), takže další připojení diváka jde znovu přes master a skončí na živém serveru. Pokud je master při startu slave serveru nedostupný, slave se spustí s naposledy přijatými daty.
Limit připojení
S klíčem je limit uživatele společný pro všechny servery: 2 povolená připojení znamenají 2 celkem, ne 2 na každý server.
Když něco nefunguje
Zprávy jsou v protokolu panelu a začínají [BAL].
| Zpráva / příznak | Co udělat |
|---|---|
old protocol – set the same bal_key there | master má klíč, slave ne. Zadejte klíč na slave serveru |
bal_key mismatch | klíče se liší nebo se hodiny rozcházejí o více než 10 minut |
unknown slave … set the same Id | Id slave serveru chybí nebo není v seznamu masteru |
IP not allowed | bez klíče se slave musí připojovat z IP své adresy. S klíčem vyplňte Id na slave serveru |
master … – no sync | slave se nedostane k masteru: síť, firewall, port 4300 |
| „offline“ na masteru | slave je zastavený nebo se nedostane k masteru. Jeho diváci jdou na ostatní servery |
| „speed unknown“ | virtuální karta nehlásí rychlost. Nastavte Network speed na slave serveru |
- aktualizujte master i všechny slave servery;
- nastavte klíč (a Id) na slave serverech;
- nakonec na masteru.
Dokud se klíče neshodují, slave servery pracují s naposledy přijatými daty.