Appairer une machine · Docs

Reliez une machine à votre compte fournisseur avec l'agent Node Lodge, sur Linux ou Windows : téléchargez-le, vérifiez-le, appairez-le, gardez-le actif.

L’appairage relie une machine à votre organisation. L’agent transmet ensuite le matériel de la machine et un signal de présence toutes les 30 secondes, et la machine apparaît dans votre console sous Machines. Environ 5 minutes.

Avant de commencer

Un compte fournisseur avec une adresse courriel vérifiée.
Node.js 22.12 ou plus récent sur la machine.
Un terminal sur la machine en utilisateur standard : ni root, ni administrateur.
Pour héberger des sessions Community : une machine conforme aux exigences pour les fournisseurs.

Windows et les autres systèmes Linux s’appairent et transmettent leur matériel. Les offres Community exigent une machine Ubuntu Server 24.04 conforme aux exigences pour les fournisseurs; les étapes de l’appairage à la mise en catalogue sont dans Fournisseurs.

1. Générer un code d’appairage

Dans la console, ouvrez Setup, puis Install.
Nommez la machine. Les locataires voient ce nom : évitez toute information personnelle.
Sélectionnez Generate pairing code. Le code ne sert qu’une fois et expire après 15 minutes.

La console affiche ensuite les commandes pour votre machine. Choisissez Linux ou Windows au-dessus de la première.

2. Télécharger l’agent

La première commande crée un dossier ComputeHost dans votre répertoire personnel, télécharge l’agent et sa signature, puis vérifie la signature avec les clés de publication de Node Lodge. Si la vérification échoue, les deux fichiers sont supprimés et rien ne s’exécute.

Linux : collez-la dans un terminal (bash).
Windows : collez-la dans PowerShell, sans droits d’administrateur.

3. Appairer

node compute-host.mjs enroll --api <console address> --code <your code>

La console remplit les deux valeurs. L’agent génère une paire de clés sur la machine et n’envoie que la moitié publique. La clé privée ne quitte jamais la machine.

4. Garder l’agent actif

node compute-host.mjs run

Les signaux de présence partent toutes les 30 secondes en HTTPS. La machine n’ouvre aucun port. Laissez la commande tourner : dans un terminal qui reste ouvert, ou sous un gestionnaire de services (systemd sous Linux, Planificateur de tâches sous Windows) avec le même utilisateur standard.

Dès l’appairage, la console ouvre la page de la machine avec le premier signal de présence.

Ce que l’agent transmet

Transmet	Ne transmet jamais
Modèle de CPU, cœurs et threads	Nom d’hôte ou noms d’utilisateur
Taille de la mémoire	Adresses IP ou MAC
Modèle de GPU, nombre, VRAM, pilote, version de CUDA, lien PCIe, température et limite de puissance	Numéros de série
Type, modèle, taille et espace libre des disques	Noms ou contenus de fichiers
Fabricant et modèle de la carte mère	Noms des interfaces réseau
Débit et type du lien réseau	Rien de ce que vous tapez ou exécutez
Débit Internet, mesuré chaque semaine quand la machine est inactive
Système, distribution et version de l’agent

Chaque GPU est identifié par une empreinte à sens unique de son identifiant : une carte appairée deux fois est détectée.

Test de débit Internet

À l’appairage, puis une fois par semaine, quand aucune session ne tourne ni ne démarre dans les 15 minutes, l’agent mesure le débit Internet de la machine avec speedtest.nodelodge.com : environ 8 secondes dans chaque sens sur des connexions parallèles, jusqu’à quelques Go à haut débit. Le serveur de test tourne sur le réseau de Cloudflare, au point le plus proche de la machine : Cloudflare voit donc l’adresse IP publique de la machine, comme pour toute connexion. La console ne reçoit que les débits, la latence et l’heure du test. Le test ne tourne jamais pendant une location.

Lancez-le vous-même à tout moment, rien n’est envoyé à la console :

node compute-host.mjs speedtest

Pour désactiver le test hebdomadaire, démarrez l’agent avec node compute-host.mjs run --no-speedtest.

5. Vérifier la machine

node compute-host.mjs doctor

Un autotest en lecture seule : version de Node, privilèges, matériel, lien avec la console et horloge. Il affiche pass, warn ou fail pour chaque vérification, ainsi que l’état de l’appairage. Ajoutez --community sous Linux pour les vérifications de session listées dans Exigences pour les fournisseurs.

Après l’appairage

Vérification. L’équipe Node Lodge compare le matériel transmis aux exigences et contrôle les signaux de présence de la machine. La page de la machine affiche awaiting review, puis approved ou rejected.
Prix. Fixez votre tarif horaire sur la page de la machine. Vous pouvez le préparer pendant la vérification.
Mise en catalogue. Une fois la machine approuvée, publiez l’offre au catalogue. Retirez-la à tout moment.

Dépannage

Vous voyez	Faites ceci
`Signature check failed`	Relancez la commande de téléchargement. Si elle échoue deux fois, contactez le support.
`node` n’est pas reconnu	Installez Node.js 22.12 ou plus récent, ouvrez un nouveau terminal, relancez la commande.
Code expiré	Générez un nouveau code dans Setup. Chaque code sert une fois, pendant 15 minutes.
Appairée, puis hors ligne	`run` s’est arrêté. Relancez-le sur la machine.
`privileges: fail`	Fermez le terminal administrateur ou root et utilisez un utilisateur standard.

Désappairer une machine

Sur la page de la machine, ouvrez Settings et sélectionnez Revoke key. La machine ne peut plus se connecter et son offre est retirée du catalogue. Sur la machine, node compute-host.mjs forget supprime l’identité locale. Pour réutiliser la machine, appairez-la avec un nouveau code.