SERVORdocs
en

Ajouter un serveur

Connectez un serveur Linux, macOS ou Windows à Servor en une ligne en installant l'agent léger — sans configuration SSH manuelle, connecté en quelques secondes.

Ajouter un serveur à Servor tient en une commande. Vous copiez une commande d'installation en une ligne, vous l'exécutez une fois sur la machine, et le serveur apparaît comme connecté — prêt pour le terminal web, les commandes, la surveillance et le copilote IA.

Servor installe un agent léger sur le serveur. Cet agent maintient la connexion, si bien que vous n'avez plus à gérer de clés SSH ni de ports pour le travail quotidien.

Déverrouillez d'abord votre coffre

Exécuter des commandes, ouvrir le terminal et utiliser le copilote nécessitent un coffre déverrouillé. Si ce n'est pas encore fait, commencez par là : Déverrouiller votre coffre. L'ajout du serveur fonctionne dans tous les cas, mais vous devrez le déverrouiller pour utiliser réellement le serveur.

Ajouter un serveur

Ouvrez la fenêtre Ajouter un serveur

Dans le tableau de bord, allez dans Serveurs puis cliquez sur Ajouter un serveur — ou allez-y directement : Ajouter un serveur dans Servor. Donnez au serveur un nom que vous reconnaîtrez (vous pourrez le modifier plus tard dans les paramètres du serveur).

Copiez la commande d'installation

Servor génère une commande d'installation en une ligne, propre à ce serveur. Cliquez pour la copier. Elle ressemble à ceci :

curl -fsSL https://get.servor.app/install.sh | sh -s -- --token <votre-token>

Laissez la fenêtre ouverte — elle attend la connexion de l'agent.

Exécutez-la sur le serveur

Collez la commande dans un shell de la machine à ajouter (via SSH, une console cloud, ou directement sur la machine) et exécutez-la. L'installeur télécharge la bonne version de l'agent pour le système d'exploitation et l'architecture, l'installe en tant que service, puis le démarre.

Regardez-le se connecter

En quelques secondes, la fenêtre passe à connecté et le serveur apparaît dans votre liste avec un statut vert. C'est terminé — l'agent se maintiendra désormais à jour tout seul.

Quel utilisateur indiquer : root, de préférence

Le champ Utilisateur est celui sous lequel l'agent exécutera vos commandes, et il vaut mieux le laisser sur root.

L'installeur, lui, demande root dans tous les cas — la commande passe par sudo et le service tourne en root. Mais chaque commande, chaque check et chaque terminal redescend ensuite vers le compte indiqué ici. Avec ubuntu, debian ou tout autre compte, les actions d'administration intégrées — pare-feu, mises à jour de paquets, ajout de clés SSH, extinction — reviendront en erreur de permission.

Ce n'est pas un oubli : Servor n'ajoute jamais sudo à une commande. Le navigateur signe le texte exact de ce qui va s'exécuter, et rien en aval, pas même Servor, ne peut y greffer quoi que ce soit — c'est ce qui rend la signature vérifiable par l'agent. Un compte non-root reste tout à fait utilisable si vous préférez taper sudo … vous-même dans le terminal.

Importer tout un parc d'un coup

Qui gère quarante machines ne les saisit pas une par une. Depuis la liste des serveurs, Importer un fichier SSH ouvre un écran où vous collez votre ~/.ssh/config : Servor en extrait les machines qu'il y trouve — alias, adresse, utilisateur, port — et les affiche pour que vous décochiez celles à laisser de côté.

Les serveurs importés arrivent en mode agent, sans aucun identifiant. C'est délibéré : un fichier de configuration SSH ne contient pas de clés, seulement des chemins vers des clés, et Servor n'a aucun usage ni de l'un ni de l'autre. Rien de sensible n'est lu ni transmis. Vous installez ensuite l'agent sur chaque machine par le flux habituel.

Les entrées qui ne désignent pas une machine — Host * et les motifs du même genre, qui servent à configurer et non à nommer — sont ignorées.

Systèmes d'exploitation pris en charge

L'installeur détecte votre plateforme et récupère la version d'agent correspondante. Servor fournit 7 cibles OS/architecture couvrant les cas courants :

  • Linux — x86-64 et ARM64 (VPS, instances cloud, Raspberry Pi, conteneurs)
  • macOS — Intel et Apple Silicon
  • Windows — x86-64

Si votre plateforme n'est pas détectée automatiquement, vérifiez que vous exécutez la commande dans un vrai shell disposant de curl (ou PowerShell sous Windows).

Une seule exécution suffit

L'agent se met à jour en arrière-plan : inutile de relancer la commande d'installation à chaque version. Vous ne la relancerez que pour réinstaller un agent défaillant — voir Réparer l'agent.

À quoi sert SSH

Servor n'utilise SSH que pendant cette configuration initiale — pour tester la connexion, découvrir la machine et installer l'agent automatiquement. Ensuite, tout (terminal, commandes, métriques) passe par l'agent, pas par SSH. C'est pourquoi un serveur apparaît injoignable si l'agent tombe plus tard, même si SSH fonctionne toujours. Dans ce cas, réparez l'agent plutôt que de repasser par SSH.

Serveur derrière un bastion

Une machine que Servor ne peut pas joindre directement — un réseau privé, un parc derrière un jump host — s'ajoute quand même. Dans Options avancées de l'écran d'ajout, activez Passer par un bastion et renseignez son hôte, son port, son utilisateur et son authentification. Servor installe alors l'agent à travers lui, exactement comme le fait ProxyJump de SSH.

Le bastion a ses propres identifiants, saisis à part et chiffrés séparément de ceux de la cible. Il ne les voit jamais : la session vers le serveur est négociée de bout en bout sur un canal que le bastion se contente de transporter. Un bastion dont la clé ouvrirait aussi tous les hôtes derrière lui est exactement l'arrangement qu'un bastion existe pour éviter.

C'est du bootstrap uniquement. Une fois l'agent lancé, son tunnel est sortant : le terminal, les commandes et les métriques ne repassent plus par le bastion. Vous pouvez l'ajouter ou le retirer plus tard depuis Modifier le serveur ; laisser le champ d'authentification vide y conserve celle déjà enregistrée.

Si le serveur ne se connecte pas

  • Vérifiez que la machine a un accès internet sortant (l'agent se connecte vers Servor ; vous n'avez aucun port entrant à ouvrir).
  • Relancez la commande d'installation — elle peut être exécutée à nouveau sans risque.
  • Toujours bloqué ? Consultez Problèmes de connexion pour le pare-feu et le dépannage du bootstrap.

Étapes suivantes