Passer au contenu principal
Un nœud est une machine qui fait tourner des serveurs de jeu : Linux (x86_64 ou arm64) et systemd. Docker est installé par le script s’il manque. Le nœud peut être la machine de l’API (Tout sur une seule machine).

1. Créer le nœud dans Kuro

Dans le panel : Infrastructure › Nœuds › Ajouter un nœud. Donnez-lui un nom technique (a-z, 0-9, -), inscrit dans son certificat et donc non modifiable, et un libellé si vous voulez. Kuro affiche, une seule fois :
  • un jeton d’enrôlement, à usage unique et valable quelques minutes ;
  • l’empreinte de l’autorité de certification (sha256:…) ;
  • la commande à lancer sur le nœud, empreinte et adresse de l’API comprises.
Vous ne créez ni le jeton ni l’empreinte : Kuro les fournit. L’empreinte permet au nœud de vérifier qu’il parle bien à votre API avant de lui envoyer le jeton (pourquoi).
Jeton expiré ou perdu : sur la fiche du nœud, Enrôlement › Émettre un jeton (les précédents ne valent plus rien). Même chose pour réenrôler un nœud révoqué.
En ligne de commande, sur la machine de l’API :

2. Installer le daemon

Sur le nœud, collez la commande affichée par le panel.
Le jeton passe par une variable d’environnement ou un fichier, jamais en argument : il finirait dans l’historique du shell. La ligne read l’attend : collez-le, puis Entrée.
Le daemon génère sa clé privée sur la machine (elle ne la quitte jamais), obtient son certificat, puis ouvre sa connexion vers l’API. Le nœud passe en ligne dans le panel. Avec --full (serveur vierge, Debian 12-13 ou Ubuntu 22.04-24.04), le script prépare d’abord la machine : mises à jour, fail2ban, SSH par clé si une clé est déjà autorisée, Docker, et un pare-feu ufw qui n’ouvre que SSH et la plage --ports (TCP et UDP). Le nœud n’a besoin d’aucun autre port : c’est lui qui se connecte à l’API. --plan montre tout sans rien changer.

3. Donner des ports au nœud

Dans la fiche du nœud, Ports : ajoutez la même plage (par exemple 25565-25600). Chaque serveur reçoit un port de cette plage. Ces ports doivent être joignables par les joueurs. Sans --full, ouvrez-les dans le pare-feu du nœud ; si le nœud est chez vous, redirigez-les aussi depuis la box (voir Fonctionnement).