Problèmes de connexion
Dépannez les problèmes de connexion des serveurs dans Servor — agent hors service, pare-feu, accès sortant, échecs d'amorçage SSH — avec une solution claire.
La plupart des problèmes de connexion dans Servor entrent dans trois catégories : l'agent est hors service, le réseau bloque le trafic, ou l'installation SSH initiale a échoué. Cette page passe en revue chaque symptôme et sa solution, pour ramener un serveur à un statut connecté vert.
La solution la plus rapide d'abord
Si un serveur qui fonctionnait est désormais injoignable, la solution la plus rapide est presque toujours de réparer l'agent : la réinstallation est sans risque et règle généralement le problème en moins d'une minute. Revenez ici si cela ne tient pas.
Le serveur affiche « injoignable »
Injoignable signifie que Servor ne parvient pas à joindre l'agent sur la machine — pas que la machine est en panne. Le travail quotidien (terminal, commandes, métriques) transite par l'agent : s'il s'arrête, le serveur devient injoignable même si SSH fonctionne encore.
Solutions, dans l'ordre :
- Réparez l'agent. Utilisez l'invite de réparation dans la barre supérieure ou les paramètres du serveur (ouvrir vos serveurs), et relancez la commande d'installation sur la machine. Voir Réparer l'agent.
- Vérifiez le service de l'agent. Si la machine a redémarré, assurez-vous que le service de l'agent est bien remonté et activé au démarrage.
- Confirmez l'accès sortant (section suivante).
Pare-feu et accès sortant
L'agent se connecte en sortie vers Servor — vous n'avez aucun port entrant à ouvrir. Mais si la machine ne peut pas atteindre Internet, l'agent ne peut pas se connecter.
Vérifiez que le serveur dispose d'un accès sortant :
# La machine atteint-elle l'extérieur ?
curl -fsSL https://get.servor.app/ -o /dev/null && echo "sortie OK"Blocages courants :
- Pare-feu de sortie / groupe de sécurité — les fournisseurs cloud restreignent souvent le trafic sortant par défaut. Autorisez le HTTPS sortant (port 443).
- Proxy d'entreprise — une machine qui n'atteint Internet qu'à travers un proxy peut nécessiter la configuration de ce proxy pour le trafic de l'agent.
- DNS — si la machine ne peut pas résoudre les noms d'hôtes, elle ne peut pas
joindre Servor. Testez avec
nslookup get.servor.app.
Aucun port entrant nécessaire
Vous n'avez jamais besoin d'exposer le serveur sur Internet ni d'ouvrir de ports entrants pour Servor. Si l'on vous suggère une redirection de port pour que ça marche, ce n'est pas ainsi que l'agent se connecte — concentrez-vous sur l'accès sortant.
Échecs d'amorçage SSH lors de l'installation
SSH n'est utilisé que lors de l'installation initiale — pour sonder la connexion, découvrir la machine et installer l'agent automatiquement. Si l'ajout d'un serveur échoue à cette étape, c'est un problème SSH, pas un problème d'agent.
Causes courantes et solutions :
| Symptôme | Cause probable | Solution |
|---|---|---|
| Connexion refusée / expiration | SSH non lancé, mauvais port, ou pare-feu | Confirmez que sshd tourne et est joignable sur le port attendu |
| Échec d'authentification | Mauvais utilisateur ou clé/mot de passe | Revérifiez les identifiants fournis |
| Hôte injoignable | Mauvaise adresse/IP, ou pas de route | Vérifiez l'adresse et que la machine est en ligne |
| Permission refusée à l'installation | L'utilisateur ne peut pas installer un service | Utilisez un compte avec les privilèges suffisants pour installer l'agent |
Vous pouvez éviter SSH complètement
Si l'amorçage SSH vous résiste, vous pouvez lancer vous-même la commande d'installation en une ligne directement sur la machine (via une console cloud ou un shell existant). Une fois l'agent connecté, SSH n'est plus utilisé.
Le serveur se connecte, puis retombe
Si un serveur oscille entre connecté et injoignable :
- Redémarrages fréquents — assurez-vous que le service de l'agent est activé au démarrage.
- Réseau instable — une connectivité sortante intermittente se traduit par une connectivité de l'agent intermittente. Vérifiez la stabilité réseau de la machine.
- Épuisement des ressources — une machine bloquée à 100 % de CPU ou à court de mémoire peut affamer l'agent. Consultez les métriques de ressources et envisagez d'ajuster les seuils de surveillance et les alertes pour le détecter tôt.
Toujours bloqué ?
- Relancez la commande d'installation — elle est idempotente et peut être répétée sans risque.
- Vérifiez que l'horloge de la machine est à peu près correcte (une horloge fortement décalée peut casser les connexions sécurisées).
- Consultez la FAQ et le dépannage général.