SSH : « Connection refused » ou « timed out » ?
Comprenez la différence entre « Connection refused » et « Connection timed out » avec SSH, puis choisissez le bon test et le bon point de départ pour dépanner.
Ce que signifient « Connection refused » et « Connection timed out » avec SSH
Une connexion SSH refusée et une connexion SSH qui expire sont deux échecs opposés. La solution de l’une ne corrige donc jamais l’autre. Refused signifie qu’un rejet a été renvoyé. En général, le kernel du serveur indique ainsi que rien n’écoute à cette adresse et sur ce port. Il peut aussi s’agir d’un pare-feu sur le chemin, configuré pour rejeter les paquets au lieu de les supprimer. Timed out signifie qu’aucune réponse n’est arrivée avant l’abandon du client. La cause est généralement un pare-feu qui a supprimé le paquet. Plus rarement, le serveur était trop occupé pour accepter une nouvelle connexion. Refused indique généralement un problème de service sur le serveur. Timed out indique généralement un problème sur le chemin réseau en amont.
Lisez la ligne exacte affichée par le client, car sa formulation fournit tout le diagnostic.
ssh: connect to host 203.0.113.10 port 22: Connection refused
ssh: connect to host 203.0.113.10 port 22: Connection timed outLe délai est le deuxième indice. Refused revient immédiatement, à peu près le temps d’un aller-retour réseau. Timed out reste affiché pendant plusieurs secondes, car le client retransmet le paquet avant d’abandonner. macOS affiche Operation timed out pour la même condition. Si le protocole vous est encore inconnu, consultez le fonctionnement de SSH et le rôle de sshd, qui fournit le contexte supposé par ce guide.
Pourquoi « Connection refused » est une bonne nouvelle
Un refus correspond généralement à un reset TCP (Transmission Control Protocol). Votre client envoie un paquet SYN vers le port 22. Il traverse Internet, arrive dans la pile réseau du serveur, puis le kernel ne trouve aucun socket à l’écoute sur ce port et répond avec un paquet RST (reset). Votre client SSH transforme ce RST en Connection refused.
Lorsque le kernel du serveur lui-même l’envoie, ce paquet de retour prouve déjà beaucoup de choses. L’adresse est correcte. L’hôte est sous tension et le routage fonctionne. Aucun équipement sur le chemin ne supprime silencieusement le trafic vers ce port, car quelque chose a répondu depuis l’autre extrémité. Les causes restantes se trouvent donc sur le serveur lui-même, à l’exception d’un firewall placé devant lui et configuré pour rejeter les paquets au lieu de les supprimer. Ce firewall peut produire le même refus sans que le serveur intervienne.
sshdne fonctionne pas, car son démarrage a échoué ou il n’a jamais été activé.sshdécoute sur un autre port, généralement après une modification de hardening.sshdest lié à une seule adresse, par exempleListenAddress 127.0.0.1, de sorte que seul le serveur lui-même peut y accéder.- Un firewall est configuré pour rejeter les paquets au lieu de les supprimer. Il répond donc à la place de l’hôte avec un RST ou un message ICMP indiquant que le port est inaccessible, et votre client affiche
Connection refuseddans les deux cas. L’action ufwrejectet une règle nftables se terminant parreject with tcp resetproduisent toutes deux ce résultat. Il en va de même pour une simple règle iptablesREJECT, qui envoie par défaut un message ICMP indiquant que le port est inaccessible, ou un reset TCP avec--reject-with tcp-reset.
Un autre cas ressemble à ceux-ci, mais il est différent : vous avez saisi une adresse appartenant à un autre hôte actif. Cet hôte répond à votre SYN, n’exécute aucun service SSH sur le port 22 et vous refuse poliment la connexion. Vérifiez l’adresse avant de passer une heure sur le mauvais serveur. Savoir ce qu’est réellement un port à l’écoute sous Linux permet de lire plus rapidement la suite de cette section.
Comment corriger « Connection refused »
Vous ne pouvez pas corriger ce problème via SSH, car SSH est précisément le service défaillant. Ouvrez la console Web ou la console série de votre fournisseur, connectez-vous, puis exécutez les commandes suivantes dans l’ordre.
systemctl status ssh
sudo ss -tlnp
sudo sshd -T | grep -Ei '^(port|listenaddress|addressfamily)'systemctl status ssh utilise le nom de l’unité sur Ubuntu et Debian. Sur RHEL et ses dérivés, comme AlmaLinux, l’unité est sshd. ss -tlnp affiche tous les sockets TCP en écoute ainsi que le processus qui les possède. C’est la source de vérité : si aucune ligne ne mentionne sshd, aucun processus n’est en écoute, quelle que soit la configuration du fichier. sshd -T affiche la configuration effective après fusion de tous les fichiers Include. C’est là qu’un port oublié dans /etc/ssh/sshd_config.d/ apparaît.
Lisez attentivement la colonne des adresses. 0.0.0.0:22 signifie que le service écoute sur toutes les adresses IPv4 de la machine. [::]:22 signifie qu’il écoute sur toutes les adresses IPv6. 127.0.0.1:22 signifie qu’il écoute uniquement sur l’interface loopback. Aucun client distant ne peut donc atteindre sshd, tandis qu’un ssh localhost local fonctionne parfaitement. Ce que voit le client distant dépend du pare-feu situé en amont : si rien ne filtre le port 22, il reçoit Connection refused. En revanche, un pare-feu qui abandonne la tentative, comme ufw avec sa politique par défaut deny (DROP) pour les connexions entrantes et sans règle SSH, transforme la même erreur en expiration du délai d’attente.
Si aucun processus n’est en écoute, démarrez le service et consultez l’erreur lorsqu’il refuse de démarrer.
sudo sshd -t
sudo systemctl enable --now ssh
sudo journalctl -u ssh -n 50 --no-pagersshd -t analyse la configuration et affiche le fichier ainsi que le numéro de ligne de la directive incorrecte, sans modifier le service en cours d’exécution. Exécutez cette commande avant chaque redémarrage, car une configuration rejetée fait quitter sshd au démarrage et votre prochaine connexion est refusée.
Le piège de l’activation par socket sur Ubuntu
Ubuntu 24.04 fournit une unité socket systemd pour OpenSSH. Lorsque cette unité est activée, systemd conserve le port en écoute et démarre sshd à la demande. Un générateur systemd copie Port et ListenAddress depuis sshd_config dans les paramètres du socket. Cependant, systemd n’exécute les générateurs qu’au démarrage et lors du rechargement de sa configuration. Définir Port 2222 puis redémarrer ssh ne suffit donc pas. Le serveur continue de répondre sur l’ancien port. Vérifiez le mode utilisé avant toute modification.
systemctl is-enabled ssh.socket
systemctl status ssh.socketSi le socket est activé, définissez le port dans sshd_config comme d’habitude, puis régénérez les paramètres du socket et redémarrez le socket plutôt que le service.
sudo sshd -t
sudo systemctl daemon-reload
sudo systemctl restart ssh.socketLe daemon-reload est l’étape souvent oubliée, car, sur un système en fonctionnement, c’est elle qui réexécute le générateur. Un redémarrage l’exécute également. Vérifiez avec sudo ss -tlnp que le nouveau port est bien celui conservé par le socket. Changer le port est une étape normale du durcissement de SSH sur un VPS, mais c’est aussi l’étape qui bloque le plus souvent l’accès au serveur.
Pourquoi « Connection timed out » signifie qu’aucune réponse n’est revenue
Un timeout signifie qu’il n’y a eu aucune réponse. Votre client a envoyé un SYN, l’a retransmis plusieurs fois pendant une ou deux minutes, puis a abandonné faute de réponse. Cela ne permet pas, à lui seul, de tirer une conclusion sur le serveur. Le plus souvent, le paquet a été rejeté avant d’atteindre un service capable de répondre. La page de manuel de connect(2) indique également qu’un serveur trop occupé pour accepter de nouvelles connexions peut être à l’origine du problème. Un hôte fortement chargé peut donc aussi provoquer un timeout. Si la ligne affiche plutôt Connection timed out during banner exchange, TCP s’est bien connecté, mais sshd n’a jamais envoyé son message d’accueil. Traitez alors ce cas comme le cas kex_exchange_identification plus bas, et non comme un problème de chemin réseau.
Le silence est exactement ce que produit une règle DROP, et le rejet silencieux est délibéré. Un rejet indique à toute personne qui analyse le réseau que l’hôte existe. C’est pourquoi ufw et la plupart des firewalls réseau des fournisseurs cloud rejettent les paquets indésirables sans rien renvoyer. Votre timeout est généralement dû à un firewall qui fait son travail sur un port que vous vouliez ouvrir.
- L’adresse est incorrecte : un enregistrement DNS pointe encore vers un serveur que vous avez reconstruit, ou une faute de frappe renvoie vers une adresse que personne n’utilise.
- L’hôte n’est pas démarré : il est hors tension ou en cours de redémarrage. Une suspension du fournisseur pour impayé produit le même résultat depuis l’extérieur.
- Le firewall de l’hôte rejette le port 22, le plus souvent parce que
ufw enablea été exécuté avant l’existence de toute règle allow. - Un firewall du fournisseur placé devant l’instance rejette le paquet, et le système d’exploitation ne le voit jamais.
- Votre propre réseau bloque le port 22 sortant, ce qui est courant sur les connexions de bureau et d’hôtel.
- L’hôte est démarré, mais il est trop surchargé pour accepter de nouvelles connexions. C’est le cas le plus rare, et la console du fournisseur l’affiche généralement sous la forme d’une charge très élevée.
Exécutez le test du bon côté de la connexion
Voici l’erreur qui fait perdre le plus de temps. Vous ne pouvez pas diagnostiquer un paquet perdu depuis la machine que les paquets n’atteignent pas. Si vous pouviez vous y connecter pour exécuter la commande, vous n’auriez pas ce problème. Toutes les commandes de cette section s’exécutent sur votre propre machine.
getent hosts vps.example.com
ssh -G vps.example.com | grep -Ei '^(hostname|port|user)'
ssh -vvv -o ConnectTimeout=10 user@vps.example.com
nc -vz -w 5 203.0.113.10 22getent hosts affiche l’adresse que votre machine utilisera réellement. Cela permet de repérer un enregistrement DNS obsolète en quelques secondes. ssh -G affiche les paramètres appliqués par votre client après la lecture de ~/.ssh/config. Cela permet de repérer un ancien bloc Host qui réécrit silencieusement le nom d’hôte, le port ou l’utilisateur. ssh -vvv indique jusqu’où la tentative est allée : une dernière ligne indiquant une connexion à l’adresse, suivie d’une longue pause, signale un timeout. En revanche, une ligne indiquant la version OpenSSH distante signifie que TCP a déjà abouti et que le véritable problème se situe plus loin. Une ligne Unable to negotiate signifie qu’aucun algorithme d’échange de clés ou de clé d’hôte n’est commun aux deux côtés. Dans les autres cas, le problème concerne presque toujours l’authentification. Sous Windows, Test-NetConnection 203.0.113.10 -Port 22 dans PowerShell remplace nc.
Testez le port, pas l’hôte. Un échec de ping ne prouve rien, car de nombreux fournisseurs filtrent l’ICMP (internet control message protocol) à la périphérie de leur réseau. Un ping réussi ne prouve rien non plus, car il ne dit rien sur le port 22.
Modifiez ensuite la seule variable qu’aucune commande ne peut changer à votre place : votre réseau. Recommencez depuis le partage de connexion de votre téléphone. Si la connexion fonctionne avec ce partage, mais pas depuis votre poste, le blocage se situe de votre côté d’Internet, ou l’adresse de votre bureau a été bannie sur le serveur.
Le pare-feu du fournisseur invisible depuis le serveur
La plupart des panneaux de contrôle VPS proposent un pare-feu réseau, parfois appelé groupe de sécurité ou pare-feu cloud, qui s'exécute en amont de votre instance et gère sa propre liste de règles. ufw status sur le serveur ne peut pas le voir, ce qui explique pourquoi la phrase « mais j'ai déjà autorisé le port 22 » est si fréquente. Ouvrez le panneau et lisez cette liste avant de réécrire la moindre règle sur la machine.
Une commande permet de trancher la question, et elle nécessite un accès à la console. Lancez-la sur le serveur, puis essayez de vous connecter depuis votre ordinateur portable pendant qu'elle tourne.
sudo tcpdump -ni any tcp port 22Si rien n'apparaît pendant que votre client tente de se connecter, les paquets sont rejetés avant d'atteindre le système d'exploitation ; la faute incombe donc au pare-feu du fournisseur ou à la route vers l'hôte. Si les paquets SYN arrivent mais qu'aucune réponse ne repart, le rejet est local et provient de ufw ou nftables. Ce test unique divise par deux les causes possibles d'un timeout, ce qui justifie le passage par la console.
Ordre des règles ufw, IPv6 et adresse bannie par erreur
L’erreur d’ordre avec ufw bloque plus d’utilisateurs que tout le reste dans cette section. sudo ufw enable applique immédiatement une stratégie par défaut qui refuse les connexions entrantes. Sans règle SSH, votre session actuelle continue grâce à l’état des connexions établies, tandis que toute nouvelle connexion expire. Autorisez d’abord, puis activez ufw.
sudo ufw allow OpenSSH
sudo ufw status verboseLe profil d’application OpenSSH couvre uniquement le port 22. Si vous prévoyez de déplacer SSH vers 2222, la règle nécessaire est sudo ufw allow 2222/tcp. Ajoutez-la avant de modifier le port, et non après. L’ensemble plus large des règles est présenté dans les bases du pare-feu ufw pour un VPS, et l’ordre sûr est expliqué dans les mesures à prendre pendant les dix premières minutes sur un nouveau VPS.
IPv6 peut produire un timeout qui semble inexplicable. Si le nom d’hôte possède un enregistrement AAAA et que votre connexion IPv6 fonctionne, votre client essaie normalement IPv6 en premier. Un serveur dont les règles IPv6 sont absentes reste alors bloqué, tandis qu’une tentative IPv4 directe fonctionne. Testez séparément les deux protocoles.
ssh -4 user@vps.example.com
ssh -6 user@vps.example.comSi -4 se connecte et que -6 expire alors que votre machine atteint d’autres hôtes IPv6 sans problème, le problème vient du chemin IPv6 vers ce serveur. Ces deux tests ne permettent toutefois pas de localiser précisément le problème sur ce chemin. Commencez par vérifier les règles IPv6 du serveur. Ouvrir le même port pour IPv6 dans ufw présente la procédure. Vérifiez ensuite le côté fournisseur, car le pare-feu ou le security group du fournisseur possède des règles IPv6 distinctes et le réseau doit disposer d’une route IPv6 vers l’instance. AWS indique par exemple une route IPv6 (::/0) vers une internet gateway, une règle de security group autorisant votre adresse IPv6 sur le port 22, ainsi que des règles d’ACL réseau autorisant le trafic IPv6 entrant et sortant. Si -6 échoue immédiatement avec Network is unreachable, la cause habituelle est l’absence de route IPv6 sur votre propre machine. La même erreur peut toutefois apparaître lorsqu’un pare-feu situé sur le chemin vous rejette avec un message ICMPv6 indiquant l’absence de route. Si ssh -6 ou nc -6 atteint d’autres hôtes IPv6 depuis la même machine, examinez ensuite le côté serveur.
Vous pouvez également vous être banni vous-même. fail2ban surveille le journal d’authentification et ajoute une règle de pare-feu contre les adresses qui échouent à répétition. Une clé incorrecte ou un script qui réessaie en arrière-plan peut donc bloquer l’adresse de tout un bureau. Un bannissement qui abandonne les paquets ressemble à un timeout. Un bannissement qui rejette la connexion renvoie Connection refused avec les actions iptables et nftables standard de fail2ban, ou No route to host si l’action rejette la connexion avec un type d’erreur indiquant que l’hôte est inaccessible. Depuis la console :
sudo fail2ban-client status sshd
sudo fail2ban-client set sshd unbanip 198.51.100.24Ajouter votre propre adresse à ignoreip fait partie de une configuration fonctionnelle de fail2ban sur Ubuntu 24.04.
Erreurs qui ne sont ni refusées ni expirées
No route to host signifie qu’un message ICMP d’inaccessibilité est revenu. Soit votre machine n’a aucune route vers ce réseau, soit un équipement sur le chemin a répondu par un rejet administratif, par exemple une règle iptables REJECT configurée avec icmp-host-prohibited ou icmp-admin-prohibited. Une règle REJECT sans type envoie un message port unreachable, que votre client signale plutôt comme Connection refused.
Network is unreachable est généralement envoyé par votre propre machine. Elle n’a aucune route vers cette destination. C’est aussi la réponse habituelle lorsqu’un nom d’hôte se résout uniquement vers une adresse IPv6 sur une connexion IPv4-only. Plus rarement, un firewall sur le chemin l’envoie délibérément, par exemple avec une règle nftables qui rejette la connexion avec icmpv6 type no-route.
kex_exchange_identification: Connection closed by remote host signifie que la connexion TCP a été établie, puis que le serveur a fermé la connexion avant la fin de l’échange de clés. Le port est ouvert et sshd fonctionne. Vérifiez donc la charge du serveur, MaxStartups ou un bannissement appliqué pendant votre tentative de connexion.
Received disconnect: Too many authentication failures peut également apparaître sur une connexion parfaitement fonctionnelle. Cela signifie que votre agent a proposé toutes les clés qu’il contient jusqu’à ce que le serveur cesse d’écouter. La correction consiste donc à limiter la tentative à une seule clé, et non à modifier quoi que ce soit dans ce guide.
Permission denied (publickey) signifie que vous avez atteint l’authentification, mais qu’elle a échoué. Le réseau et le firewall fonctionnent correctement. Rien dans ce guide ne s’applique donc à ce cas. Consultez plutôt la résolution de l’erreur Permission denied (publickey) avec SSH.
Comment reprendre la main et éviter un nouveau blocage
Chaque hébergeur VPS sérieux fournit une console indépendante du réseau de l'invité : une console série ou un écran VNC accessible via le navigateur. Cette console est la voie de secours pour les deux cas de figure de ce guide, car elle reste fonctionnelle même si sshd est arrêté ou si une règle de pare-feu rejette tout le trafic. Trouvez-la dans votre panneau de contrôle, connectez-vous en tant que root ou avec votre utilisateur habituel, puis effectuez les vérifications mentionnées plus haut. Si vous n'avez jamais défini de mot de passe root, la plupart des panneaux permettent d'en réinitialiser un.
Lorsqu'aucune console n'est disponible, le recours est le mode rescue du fournisseur. Il démarre un système de récupération minimal et monte votre disque, ce qui vous permet de modifier /etc/ssh/sshd_config ou de supprimer une règle de pare-feu hors ligne avant de redémarrer.
Deux habitudes permettent d'éviter un prochain blocage. Gardez une seconde session SSH ouverte à chaque fois que vous modifiez sshd ou le pare-feu, car cette session survit grâce à l'état établi pendant que vous testez la nouvelle configuration. Prévoyez également une annulation automatique avant toute modification risquée du pare-feu.
sudo systemd-run --unit=ufw-rollback --on-active=10min /usr/sbin/ufw disable
sudo systemctl stop ufw-rollback.timerLa première ligne programme ufw pour qu'il se désactive dans dix minutes. Appliquez vos nouvelles règles, ouvrez une nouvelle session SSH pour vérifier qu'elles fonctionnent, puis exécutez la seconde ligne pour annuler le retour en arrière. Si vous vous bloquez, attendez dix minutes et le pare-feu se désactivera de lui-même. Le serveur restera sans filtrage jusqu'à ce que vous réactiviez ufw ; utilisez donc cette méthode uniquement lorsque vous êtes devant votre clavier et non comme une solution permanente.
L’ordre des vérifications
- Lisez le texte de l’erreur et notez le délai avant son apparition.
- « Refused » : ouvrez la console et vérifiez dans
sudo ss -tlnpla présence d’un socket en écoute, son port et l’adresse à laquelle il est lié. - « Timed out » : depuis votre propre machine, confirmez l’adresse, puis vérifiez le pare-feu du fournisseur dans le panneau de contrôle, et enfin le pare-feu de l’hôte sur le serveur.
- Si aucune de ces chaînes n’apparaît et qu’il ne s’agit pas d’une erreur de routage, la connexion TCP est déjà établie. Cherchez alors du côté de l’échange de clés, de l’authentification ou de la charge du serveur, et non du réseau.
FAQ
Pourquoi SSH indique-t-il « Connection refused » alors que sshd est en cours d’exécution ?
Parce qu’un refus vient du socket, pas du service, et qu’un sshd en cours d’exécution peut tout de même refuser la connexion. Ouvrez la console du fournisseur et exécutez sudo ss -tlnp. Un socket sur 127.0.0.1:22 ne peut être atteint par aucun client distant, car il est lié uniquement à loopback. Les tentatives distantes sont donc refusées lorsqu’aucun filtre ne bloque le port 22, et expirent lorsqu’un pare-feu les bloque d’abord. Un socket sur un autre port ne laisse rien en écoute sur 22. Les clients qui utilisent encore 22 y sont donc refusés, ou leur tentative expire si un pare-feu bloque le port 22. Si un autre processus écoute encore sur 22, ils s’y connectent à la place. Si l’activation des sockets systemd est utilisée, ssh.socket détient le port et ne prend en compte une modification de Port depuis sshd_config qu’après sudo systemctl daemon-reload et un redémarrage de ssh.socket, ou après un redémarrage du serveur. Vérifiez donc également systemctl is-enabled ssh.socket. Une règle reject de ufw renvoie aussi un refus au nom de l’hôte. Consultez donc sudo ufw status verbose avant de tirer une conclusion.
Pourquoi SSH expire-t-il alors que ufw autorise déjà le port 22 ?
Parce qu’une expiration signifie qu’aucune réponse n’est revenue, et que ufw n’est pas le seul pare-feu sur le chemin. La plupart des panneaux VPS exécutent un pare-feu réseau devant l’instance, et le système d’exploitation ne voit jamais ce que ce pare-feu bloque. Depuis la console, exécutez sudo tcpdump -ni any tcp port 22 et essayez de vous connecter depuis votre ordinateur portable pendant son exécution. Si aucun paquet n’arrive, le blocage se situe en amont, dans le panneau. Si des paquets arrivent sans qu’aucune réponse ne reparte, le blocage est local, dans ufw ou nftables.
Un ping qui échoue signifie-t-il que mon VPS est hors service ?
Non. De nombreux fournisseurs filtrent ICMP à la périphérie du réseau. Un serveur qui traite normalement le trafic peut donc ignorer tous les pings que vous envoyez. Un ping réussi est tout aussi peu probant dans l’autre sens, car il ne dit rien sur l’ouverture du port 22. Testez directement le port avec nc -vz -w 5 203.0.113.10 22 depuis votre propre machine, ou avec Test-NetConnection 203.0.113.10 -Port 22 dans PowerShell sous Windows.
J’ai modifié le port SSH et plus rien ne se connecte. Que s’est-il passé ?
Deux problèmes d’ordre des opérations peuvent en être la cause. Si le pare-feu n’a jamais reçu de règle pour le nouveau port, les tentatives vers ce port expirent tandis que le port 22 refuse les connexions. sudo ufw allow 2222/tcp doit donc être exécuté avant la modification du port, et non après. Si la machine utilise l’activation des sockets systemd pour SSH, Port 2222 dans sshd_config ne prend effet qu’après sudo systemctl daemon-reload et sudo systemctl restart ssh.socket, ou après un redémarrage du serveur. Jusqu’à ce moment, systemd continue de conserver l’ancien port. systemctl is-enabled ssh.socket indique le mode utilisé. Récupérez l’accès via la console du fournisseur, corrigez le problème concerné, puis connectez-vous avec ssh -p 2222 user@203.0.113.10 lorsque sudo ss -tlnp indique le nouveau socket.