Guides
Maître et esclaves : installation et configuration
Comment répartir les spectateurs sur plusieurs serveurs. Le serveur principal (maître) garde la base de données et décide où va chaque client. Les serveurs supplémentaires (esclaves) diffusent les chaînes à sa place.
Fonctionnement
- Le client se connecte au maître comme avant. Les adresses des playlists ne changent pas.
- Le maître choisit un serveur et y redirige le client. Les playlists (Xtream, M3U, Stalker, NICE, TVIP) contiennent directement l’adresse de l’esclave choisi.
- L’esclave vérifie l’abonné avec sa propre copie des données et lance le flux. Les films et séries (VOD) sont lus depuis le maître.
- Toutes les 15 secondes, l’esclave demande les changements au maître et ne télécharge que ce qui a changé, logos des chaînes compris. Avec une clé, il envoie aussi un rapport de charge.
Un esclave exécute le même programme que le maître. Seul un réglage diffère : Configuration → BALANCER.
Avant de commencer
- Même version (5.5+) sur le maître et tous les esclaves.
- Esclave → maître : l’esclave atteint le port du panneau du maître (par défaut
4300). - Maître → esclave : le maître atteint le port du panneau de l’esclave (liste des connexions et « kick »).
- Clients → esclave : les clients atteignent les ports de diffusion de l’esclave :
3000MPEGTS,4000Xtream,4001Stalker,4002NICE API,4003TVIP,9888HLS (ou les vôtres si vous les avez changés — l’esclave les reprend du maître). - Horloge exacte sur tous les serveurs (NTP). Un écart jusqu’à 10 minutes est toléré, sinon les requêtes protégées sont refusées.
- Pour l’installation par SSH : accès root au nouveau serveur.
1Faire du serveur le maître
Sur le serveur principal, ouvrez Configuration → onglet BALANCER.

- Balancer type → Master.
- Balancer key — le secret partagé entre le maître et ses esclaves. Tout ce qui circule entre eux, mots de passe des abonnés compris, est chiffré et signé avec cette clé.
- Generate crée une clé aléatoire. Vous pouvez aussi saisir la vôtre : 16 à 128 caractères, lettres, chiffres,
-et_. Copiez la clé — chaque esclave en a besoin. - Save.
L’ancien protocole est alors utilisé : son chiffrement est identique pour toutes les installations et l’esclave n’est reconnu que par son IP. Le rapport de charge et la limite de connexions commune ne fonctionnent pas non plus. Nous recommandons de toujours définir une clé.
2Ajouter l’esclave sur le maître
Sur le maître : Channels → Balancers. Renseignez le nouveau serveur dans la ligne Add.

- Id — le numéro de l’esclave. Un numéro libre est proposé. Notez-le : le même numéro se saisit sur l’esclave.
- Nom — par ex.
DE-1. C’est par ce nom qu’on affecte un abonné à l’esclave. - IP address or host name — l’adresse pour les clients :
203.0.113.21oude1.example.com. Les spectateurs y sont redirigés et elle figure dans les playlists. - Pays et réseaux — qui l’esclave dessert : codes pays (
DE,AT), sous-réseaux (10.20.0.0/16) ou IP isolées, séparés par des virgules. Laissez vide si l’esclave ne sert que des abonnés affectés manuellement. - Panel language de l’esclave — anglais ou bulgare.
- Stream workers — auto (recommandé) ou un nombre fixe. Voir « Réglages de l’esclave depuis le maître » plus bas.
- Source read, ms —
20par défaut. - Add balancer.
Si vous installez par SSH (option A à l’étape suivante), vous pouvez sauter cette ligne : l’installation ajoute l’esclave elle-même.
3Installer et configurer l’esclave
Option A — installation SSH
Sur le maître : Channels → Balancers → SSH installation (en haut à droite).

- Adresse IP du nouveau serveur.
- Port SSH (généralement
22). L’utilisateur estroot. - Mot de passe root. Utilisé uniquement pour cette installation.
- Nom de l’esclave, par ex.
DE-1. - Pays et réseaux — comme à l’étape 2.
- Panel language de l’esclave.
- Stream workers — laissez auto : le maître lit le nombre de cœurs du nouveau serveur pendant l’installation.
- Source read, ms —
20. - Start install. La progression s’affiche dans le cadre noir.
Le maître installe le panneau, en fait un esclave pointant vers lui, y inscrit l’Id et la clé, active Admin login from master, puis l’ajoute à la liste. On se connecte au panneau de l’esclave avec le même utilisateur et le même mot de passe admin que sur le maître (après la première synchronisation, jusqu’à 60 s après le démarrage). Après quelques minutes, l’esclave apparaît online — voir l’étape 4.
Option B — à la main
1. Installez le panneau sur le nouveau serveur comme d’habitude (en root) :
curl -s https://nice-panel.com/install3.sh | bash -s 5.52. Connectez-vous au panneau de l’esclave → Configuration → BALANCER :

- Balancer type → Slave.
- Master — l’adresse du maître avec le port du panneau :
IP:4300. - Balancer Id — le même que dans la liste du maître (étape 2). Avec une clé, le maître reconnaît l’esclave grâce à lui, quelle que soit son IP (IP dynamique, NAT, autre adresse sortante).
- Balancer key — la même clé que sur le maître.
- Network speed (Mbps) —
0= lu sur la carte réseau. Saisissez une valeur (1000,10000) sur un serveur virtuel ou si le port/l’offre est plus lent que la carte. - Admin login from master — No : l’esclave garde son propre utilisateur admin et son mot de passe. Yes : il les reprend du maître.
3. Save. L’esclave télécharge tout depuis le maître : chaînes, abonnés, EPG, VOD, réglages et logos. Si le maître utilise d’autres ports, l’esclave les reprend et redémarre de lui-même.
4. Si ce n’est pas déjà fait, ajoutez l’esclave dans la liste du maître (étape 2).
Réglages de l’esclave depuis le maître
La page Configuration d’un esclave est limitée — la plupart des réglages viennent du maître. Trois réglages sont propres à chaque esclave et se font sur le maître, dans sa ligne de Balancers (Add, modification ✎ ou SSH installation) :
| Réglage | Rôle |
|---|---|
| Panel language | la langue du panneau de l’esclave. Appliquée tout de suite, sans redémarrage |
| Stream workers | les processus qui envoient les chaînes aux spectateurs, sur plusieurs cœurs. Auto selon les cœurs de l’esclave : jusqu’à 4 cœurs → 2, jusqu’à 8 → 4, plus de 8 → 8 (au-delà de 8, aucun gain). Ou un nombre fixe (off, 1–16) |
| Source read, ms | à quelle fréquence l’esclave lit les sources des chaînes. 20 par défaut ; 0 = désactivé. Appliqué tout de suite |
Le nombre de processus prend effet après un redémarrage : l’esclave redémarre donc tout seul — uniquement si la valeur change vraiment. Ses spectateurs sont coupés quelques secondes. Avec l’installation SSH, le bon nombre est écrit dès l’installation : pas de redémarrage. Un esclave installé à la main le reçoit à son premier contact avec le maître — un redémarrage.
4Vérifier l’état
Sur le maître : Channels → Balancers. L’état de chaque esclave est actualisé toutes les 5 secondes.

| Affiché | Signification |
|---|---|
| ● online / offline | si l’esclave a interrogé le maître au cours des 150 dernières secondes. Le numéro passe au vert ou au rouge |
| protected / unprotected | avec clé / ancien protocole sans clé |
| from <IP> | l’esclave se connecte depuis une autre IP que son adresse (NAT, nom d’hôte) — à titre d’information |
| N clients | nombre de spectateurs servis par l’esclave |
| EN / BG | la langue du panneau choisie pour l’esclave |
| CPU · RAM · Mbps | utilisation du processeur (cœurs), de la mémoire et du réseau (trafic / débit de la carte) |
| workers N (auto) · read N ms | les stream workers et le source read réels de l’esclave. Un → N orange signifie qu’une nouvelle valeur attend le redémarrage |
| load % | la plus chargée des trois ressources. L’esclave est choisi d’après elle ; au-delà de 90 %, elle est mise en évidence |
| sync | quand l’esclave a confirmé les données pour la dernière fois |
| changes waiting (N) | combien de types de données il n’a pas encore téléchargés. Normal peu après une modification ou un redémarrage |
Chaque panneau affiche aussi son rôle sous le logo, sur toutes les pages — vous savez toujours dans quel panneau vous êtes :


5Quel spectateur vers quel serveur
À chaque nouvelle connexion, le maître vérifie les règles dans l’ordre et s’arrête à la première qui donne un esclave actif :
| Règle | Comment la définir |
|---|---|
| 1. Manuelle | Users → champ Balancer de l’abonné (ou en masse pour la sélection). Toujours prioritaire tant que cet esclave est actif |
| 2. Sous-réseau | l’IP du spectateur fait partie d’un sous-réseau ou d’une IP du champ « pays » d’un répartiteur |
| 3. Pays | le pays GeoIP du spectateur figure dans le champ « pays » |
| 4. Maître | rien ne correspond ou ces esclaves sont hors service : le spectateur reste sur le maître |
Plusieurs esclaves pour un même lieu
Si un pays ou un réseau a plusieurs esclaves actifs, le nouveau spectateur va vers le moins chargé. Ce n’est pas du round robin : la charge est le maximum du processeur, de la mémoire et du réseau, si bien qu’un serveur avec une carte plus rapide ou plus de cœurs reçoit proportionnellement plus de spectateurs. En cas d’égalité (à 5 points près), c’est l’abonné qui décide : un même abonné retombe toujours sur le même serveur.
Un esclave tombe
Un esclave qui n’a pas interrogé le maître depuis plus de 150 s est ignoré. La redirection est temporaire (302) : la connexion suivante du spectateur repasse par le maître et arrive sur un serveur actif. Si le maître est injoignable au démarrage d’un esclave, celui-ci démarre avec les dernières données reçues.
Limite de connexions
Avec une clé, la limite de l’abonné est commune à tous les serveurs : 2 connexions autorisées, c’est 2 au total, pas 2 par serveur.
Si quelque chose ne fonctionne pas
Les messages se trouvent dans le journal du panneau et commencent par [BAL].
| Message / symptôme | Que faire |
|---|---|
old protocol – set the same bal_key there | le maître a une clé, pas l’esclave. Saisissez la clé sur l’esclave |
bal_key mismatch | les clés diffèrent ou les horloges ont plus de 10 minutes d’écart |
unknown slave … set the same Id | l’Id de l’esclave manque ou n’est pas dans la liste du maître |
IP not allowed | sans clé, l’esclave doit se connecter depuis l’IP de son adresse. Avec une clé, renseignez l’Id de l’esclave |
master … – no sync | l’esclave n’atteint pas le maître : réseau, pare-feu, port 4300 |
| « offline » sur le maître | l’esclave est arrêté ou n’atteint pas le maître. Ses spectateurs vont vers les autres serveurs |
| « speed unknown » | la carte virtuelle n’indique pas son débit. Renseignez Network speed sur l’esclave |
- mettez à jour le maître et tous les esclaves ;
- définissez la clé (et l’Id) sur les esclaves ;
- en dernier, sur le maître.
Tant que les clés ne correspondent pas, les esclaves continuent avec les dernières données reçues.