Se connecter à un VDS Linux en SSH : PuTTY, OpenSSH et clés SSH
Dans ce guide, vous apprendrez à vous connecter à votre VDS Linux depuis Windows avec PuTTY ou la commande intégrée ssh, et depuis Linux et macOS avec le terminal. Après une première connexion par mot de passe, vous créerez une clé Ed25519 et passerez à la connexion par clé, désactiverez la connexion par mot de passe, changerez éventuellement le port SSH et corrigerez les erreurs de connexion les plus fréquentes. Les mesures générales comme le pare-feu, fail2ban et les mises à jour sont traitées dans le guide Comment configurer la sécurité initiale d'un nouveau VDS (Windows et Linux).
Avant de commencer
- Informations du serveur : l'adresse IP et le mot de passe root initial figurent sur la page du service VDS, sous Mes services dans l'Espace client, ainsi que dans l'e-mail d'activation. Pour plus de détails, consultez le guide Où trouver l'adresse IP et le mot de passe de votre serveur VDS HanHosting ?
- Modèle Linux : un modèle Linux comme Ubuntu, Debian ou AlmaLinux doit être installé sur le serveur, et celui-ci doit être en marche. Par défaut, on se connecte à un VDS Linux en SSH sur le port TCP 22. Si vous n'avez pas encore de serveur, vous pouvez parcourir les offres VDS.
- Client : sous Windows, PuTTY (ce guide a été rédigé pour la version 0.85) ou le client OpenSSH, disponible sous Windows 10 (1809 et versions ultérieures), Windows 11 et Windows Server 2019 et versions ultérieures. Sous Linux et macOS, la commande
sshest disponible d'emblée dans le terminal. - Accès de secours : si vous vous bloquez l'accès en modifiant des réglages, la console VNC de l'Espace client vous permet d'atteindre l'écran du serveur depuis votre navigateur, même lorsque SSH ne fonctionne pas.
- Les commandes partent du principe que vous êtes connecté en root ; si vous vous êtes connecté avec un autre utilisateur, passez en root avec
sudo -iavant les étapes 4 et 5 (les commandes qui utilisent la redirection>>ne fonctionnent pas avec le préfixesudo). Remplacez203.0.113.10par votre propre adresse IP.
Étape 1 : établissez la première connexion avec un mot de passe
Avec PuTTY
- Téléchargez PuTTY sur le site officiel de PuTTY. Pour Windows 64 bits (x86), le paquet
putty-64bit-0.85-installer.msiinstalle tous les outils, dont PuTTYgen et Pageant ; si vous ne souhaitez pas lancer d'installateur, vous pouvez télécharger séparément les fichiersputty.exeetputtygen.exe. - Sur l'écran Session, saisissez l'adresse IP dans la zone Host Name (nom d'hôte) ; vérifiez que Port vaut
22et que le type de connexion est SSH. - Pour ne pas ressaisir les informations à chaque fois, saisissez un nom (par exemple
hanvds) dans la zone Saved Sessions (sessions enregistrées) et cliquez sur Save, puis connectez-vous avec Open. - Lors de la première connexion, PuTTY signale que la clé d'hôte du serveur (la clé qui prouve l'identité du serveur) ne figure pas dans son cache. Le bouton Accept enregistre la clé et poursuit la connexion ; la même question ne vous sera plus posée la fois suivante.
- Saisissez
rootcomme nom d'utilisateur, puis tapez le mot de passe. Aucun caractère ne s'affiche à l'écran pendant la saisie du mot de passe et le curseur ne bouge pas ; c'est normal. Dans la fenêtre PuTTY, un clic droit colle le texte du presse-papiers.
Avec OpenSSH sous Windows, Linux et macOS
Sous Windows, ouvrez PowerShell et vérifiez que le client est installé :
ssh -V
Si la commande est introuvable, ouvrez PowerShell en tant qu'administrateur, vérifiez l'état et installez le client :
Get-WindowsCapability -Online | Where-Object Name -like 'OpenSSH*'
Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0
La commande de connexion est la même sous Windows, Linux et macOS :
ssh [email protected]
Lorsque vous répondez yes à la question sur l'empreinte, le serveur est ajouté au fichier known_hosts, puis le mot de passe vous est demandé. Tapez exit pour fermer la session.
Étape 2 : créez une paire de clés SSH
La connexion par clé utilise une clé privée, qui reste sur votre ordinateur, et une clé publique, que vous placez sur le serveur. Ne communiquez jamais la clé privée à qui que ce soit et protégez-la par une phrase de passe ; même si le fichier est volé, il est inutilisable sans elle.
Avec ssh-keygen (PowerShell sous Windows, Linux, macOS)
ssh-keygen -t ed25519 -C "home-pc"
Lorsqu'on vous demande où enregistrer la clé, appuyez sur Entrée pour accepter l'emplacement par défaut, puis saisissez deux fois la phrase de passe. Sous Linux et macOS, les fichiers sont écrits sous les noms ~/.ssh/id_ed25519 (privée) et ~/.ssh/id_ed25519.pub (publique) ; sous Windows, ils sont placés dans le dossier C:\Users\<user>\.ssh\. Le commentaire défini avec -C indique sur le serveur à quel appareil appartient la clé.
Avec PuTTYgen
- Ouvrez PuTTYgen, sélectionnez EdDSA comme type de clé et vérifiez que la taille est Ed25519 (255 bits).
- Cliquez sur Generate et déplacez la souris dans la zone vide jusqu'à ce que la barre de progression soit pleine.
- Saisissez un commentaire dans la zone Key comment et votre phrase de passe dans les zones Key passphrase et Confirm passphrase.
- Cliquez sur Save private key pour enregistrer la clé privée sous forme de fichier
.ppk. - Copiez la ligne de texte unique de la zone Public key for pasting into OpenSSH authorized_keys file. Le bouton Save public key enregistre la clé dans un autre format (RFC 4716) : ne collez donc pas le contenu de ce fichier sur le serveur.
| Élément | PuTTY | OpenSSH (commande ssh) |
|---|---|---|
| Fichier de clé privée | .ppk | id_ed25519 |
| Génération de la clé | PuTTYgen | ssh-keygen |
| Agent (gardien des clés) | Pageant | ssh-agent et ssh-add |
| Connexions enregistrées | Saved Sessions | ~/.ssh/config |
| Conversion vers l'autre format (PuTTYgen) | Ouvrez le fichier .ppk avec Load, puis Conversions → Export OpenSSH key | Ouvrez le fichier id_ed25519 avec Conversions → Import key, puis Save private key |
Étape 3 : ajoutez la clé publique sur le serveur
Sous Linux et macOS, le plus simple est la commande ssh-copy-id ; elle ajoute la clé au fichier ~/.ssh/authorized_keys du serveur et crée le fichier et le dossier s'ils n'existent pas :
ssh-copy-id -i ~/.ssh/id_ed25519.pub [email protected]
Windows ne dispose pas de cette commande ; affichez la clé publique à l'écran et copiez-la (dans PuTTYgen, copiez le texte de la zone) :
Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
Exécutez ensuite les commandes suivantes dans la session SSH ouverte avec votre mot de passe. Collez la ligne copiée en entier entre les apostrophes, sans la couper :
mkdir -p ~/.ssh
chmod 700 ~/.ssh
echo 'ssh-ed25519 AAAA...rest-of-the-key home-pc' >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys
Chaque ligne du fichier authorized_keys correspond à une clé. Si le répertoire personnel, le dossier .ssh ou ce fichier est accessible en écriture à d'autres utilisateurs, sshd n'utilise pas le fichier ; les lignes chmod l'évitent pour le dossier et pour le fichier.
Testez la connexion par clé. Sans fermer votre session actuelle, ouvrez une nouvelle fenêtre. OpenSSH essaie automatiquement le fichier par défaut id_ed25519 ; si ssh [email protected] demande la phrase de passe de la clé au lieu du mot de passe, ou vous connecte directement, c'est réussi. Dans PuTTY, sélectionnez la session enregistrée et cliquez sur Load, puis allez dans Connection → SSH → Auth → Credentials et, dans le champ Private key file for authentication, sélectionnez votre fichier .ppk. Vous pouvez aussi saisir root dans Connection → Data → Auto-login username ; revenez ensuite à l'écran Session et cliquez sur Save.
Étape 4 : désactivez la connexion par mot de passe
N'effectuez cette étape qu'une fois la connexion par clé fonctionnelle, et ne fermez pas votre session ouverte tant que les réglages ne sont pas vérifiés. Sauvegardez d'abord la configuration et vérifiez si le fichier principal lit des fichiers supplémentaires :
cp /etc/ssh/sshd_config /etc/ssh/sshd_config.original
grep -n '^Include' /etc/ssh/sshd_config
Si la sortie contient la ligne Include /etc/ssh/sshd_config.d/*.conf (sur Ubuntu, elle se trouve tout en haut du fichier), écrivez vos réglages dans un fichier séparé. sshd utilise la première valeur qu'il lit pour chaque réglage et lit ce dossier dans l'ordre alphabétique des noms ; un fichier dont le nom commence par 00- passe avant des fichiers comme 50-cloud-init.conf, qui peut contenir PasswordAuthentication yes :
cat >> /etc/ssh/sshd_config.d/00-security.conf <<'EOF'
PubkeyAuthentication yes
PasswordAuthentication no
KbdInteractiveAuthentication no
PermitRootLogin prohibit-password
EOF
>> conserve le contenu existant du fichier s'il reste d'un autre guide ; si un même réglage est écrit deux fois, c'est la première ligne qui l'emporte. S'il n'y a pas de ligne Include, modifiez ces quatre réglages dans /etc/ssh/sshd_config ; supprimez le # éventuel en début de ligne. Avant d'appliquer les changements, testez la syntaxe et vérifiez les valeurs réellement en vigueur :
sshd -t
sshd -T | grep -Ei '^(pubkeyauthentication|passwordauthentication|kbdinteractiveauthentication|permitrootlogin)'
Si sshd -t n'affiche rien, la configuration est valide. Dans la seconde sortie, vous devez voir passwordauthentication no ; la ligne permitrootlogin peut afficher prohibit-password sous son ancien nom, without-password. Redémarrez ensuite le service :
# Ubuntu and Debian
systemctl restart ssh
# AlmaLinux, CentOS and CloudLinux
systemctl restart sshd
PermitRootLogin prohibit-passwordn'autorise root à se connecter qu'avec une clé. Si vous vous connectez par clé avec un utilisateur distinct disposant des droits sudo, vous pouvez régler cette valeur surno.ChallengeResponseAuthentication, que vous pouvez rencontrer dans des fichiers plus anciens, est un alias obsolète du réglageKbdInteractiveAuthenticationdepuis OpenSSH 8.7 ; les versions plus anciennes reconnaissent aussi la ligne ci-dessus.- Même avec la connexion par mot de passe désactivée pour SSH, le mot de passe root permet toujours de se connecter sur la console VNC ; vous pouvez le changer depuis l'Espace client.
Étape 5 : changez le port SSH (facultatif)
Changer de port réduit les tentatives automatisées qui scannent le port 22 et l'encombrement des journaux qui en résulte ; cela ne sécurise pas le serveur à lui seul, car la vraie protection vient de la connexion par clé. Choisissez un port qui n'entre pas en conflit avec ceux de vos serveurs de jeu (par exemple FiveM 30120, Minecraft 25565) ; les exemples utilisent 2222. Pour ne pas vous bloquer l'accès, gardez les deux ports ouverts pendant la transition.
- Ouvrez le nouveau port dans le pare-feu. Sur Ubuntu et Debian, si ufw est actif (vérifiez avec
ufw status) :
Sur AlmaLinux, si firewalld tourne (ufw allow 2222/tcpfirewall-cmd --state), ouvrez le port et déclarez-le auprès de SELinux (sisemanageest absent, installez-le avecdnf install policycoreutils-python-utils) :firewall-cmd --add-port=2222/tcp firewall-cmd --runtime-to-permanent semanage port -a -t ssh_port_t -p tcp 2222 - Ajoutez deux lignes de port au fichier de réglages (s'il n'y a pas d'
Include, écrivez les mêmes lignes danssshd_config) :echo 'Port 22' >> /etc/ssh/sshd_config.d/00-security.conf echo 'Port 2222' >> /etc/ssh/sshd_config.d/00-security.conf - Testez et appliquez. Si la commande
systemctl is-active ssh.socketafficheactive(versions avec activation par socket, comme Ubuntu 24.04), le port est ouvert par l'unité socket :sshd -t # if ssh.socket is active systemctl daemon-reload systemctl restart ssh.socket # otherwise systemctl restart ssh # on AlmaLinux: systemctl restart sshd - Dans une nouvelle fenêtre, connectez-vous avec
ssh -p 2222 [email protected]ou, dans PuTTY, saisissez2222dans la zone Port. - Si la connexion fonctionne, supprimez la ligne
Port 22(s'il n'y a pas d'Include, supprimez la ligne desshd_config), appliquez de nouveau le changement avec les commandes du point 3 et supprimez la règle ouverte pour le port 22 (par exempleufw delete allow 22/tcp; avec firewalld,firewall-cmd --remove-service=sshpuisfirewall-cmd --runtime-to-permanent) :sed -i '/^Port 22$/d' /etc/ssh/sshd_config.d/00-security.conf
Pour les règles de pare-feu, consultez le guide Comment gérer le pare-feu d'un VDS : règles, fail2ban et journaux.
Étape 6 : saisissez la phrase de passe une seule fois grâce à un agent SSH
Pour ne pas taper la phrase de passe de la clé à chaque connexion, utilisez un agent (gardien des clés) ; l'agent conserve en mémoire la clé déchiffrée.
OpenSSH sous Windows : le service ssh-agent est désactivé par défaut. Exécutez ce qui suit dans un PowerShell administrateur (détails dans la documentation de Microsoft sur la gestion des clés) :
Get-Service ssh-agent | Set-Service -StartupType Automatic
Start-Service ssh-agent
ssh-add $env:USERPROFILE\.ssh\id_ed25519
Linux et macOS :
eval `ssh-agent -s`
ssh-add ~/.ssh/id_ed25519
ssh-add -l
PuTTY : lancez Pageant ; une icône représentant un ordinateur coiffé d'un chapeau apparaît dans la zone de notification. Faites un clic droit sur l'icône, choisissez Add Key, sélectionnez le fichier .ppk et saisissez la phrase de passe. Tant que Pageant tourne, PuTTY utilise automatiquement la clé.
N'utilisez le transfert d'agent (ssh -A) qu'avec des serveurs de confiance ; toute personne disposant des droits d'administration sur ce serveur peut utiliser votre agent tant que vous êtes connecté.
Exemple de configuration
Voici les réglages en vigueur côté serveur à la fin de ce guide (toutes les options sont décrites dans le manuel de sshd_config) :
| Réglage | Valeur | Effet |
|---|---|---|
PubkeyAuthentication | yes | Autorise la connexion par clé (c'est aussi la valeur par défaut). |
PasswordAuthentication | no | Désactive la connexion par mot de passe. |
KbdInteractiveAuthentication | no | Désactive la méthode interactive au clavier (keyboard-interactive), qui demande un mot de passe. |
PermitRootLogin | prohibit-password | root ne peut se connecter qu'avec une clé. |
Port | 2222 | Le port sur lequel écoute le service SSH (22 par défaut). |
Côté client, si vous ajoutez l'entrée suivante au fichier ~/.ssh/config (sous Windows, C:\Users\<user>\.ssh\config), vous pouvez vous connecter en tapant simplement ssh hanvds :
Host hanvds
HostName 203.0.113.10
User root
Port 2222
IdentityFile ~/.ssh/id_ed25519
AddKeysToAgent yes
ServerAliveInterval 60
La ligne Port n'est nécessaire que si vous avez appliqué l'étape 5. AddKeysToAgent ajoute la clé à l'agent lors de sa première utilisation. ServerAliveInterval envoie une requête de maintien de connexion (keepalive) lorsqu'aucune donnée n'est arrivée depuis 60 secondes, ce qui évite la coupure d'une connexion inactive ; dans PuTTY, l'équivalent est le champ Seconds between keepalives du panneau Connection.
Erreurs fréquentes
- REMOTE HOST IDENTIFICATION HAS CHANGED (OpenSSH) / WARNING - POTENTIAL SECURITY BREACH ! (PuTTY) : la clé d'hôte du serveur diffère de celle qui a été enregistrée. C'est attendu si vous avez réinstallé le serveur depuis l'Espace client ; dans le cas contraire, ne vous connectez pas et ouvrez un ticket d'assistance. Dans le client OpenSSH, supprimez l'ancienne entrée (pour un port personnalisé, utilisez la forme entre crochets) ; dans PuTTY, n'acceptez la nouvelle clé que si vous êtes sûr de la réinstallation.
ssh-keygen -R 203.0.113.10 ssh-keygen -R "[203.0.113.10]:2222" - Permission denied (publickey) / Server refused our key : le serveur n'a pas accepté la clé. Vérifiez le nom d'utilisateur, que la clé tient sur une seule ligne dans
authorized_keyset les permissionschmodde l'étape 3. Dans PuTTY, le fichier sélectionné doit être un fichier.ppk. Sur AlmaLinux, si vous avez copié le fichier depuis un autre emplacement, corrigez les étiquettes SELinux avecrestorecon -R ~/.ssh. Pour plus de détails, examinez la sortie dessh -v [email protected]côté client et dejournalctl -u ssh(sur AlmaLinux,journalctl -u sshd) côté serveur. - No supported authentication methods available : la connexion par mot de passe est désactivée sur le serveur et PuTTY n'a aucune clé à proposer. Sélectionnez le fichier
.ppkdans la section Credentials ou ajoutez la clé à Pageant. - Connection refused : le serveur a répondu mais a refusé la connexion ; le port est peut-être erroné, sshd s'est peut-être arrêté ou le pare-feu rejette peut-être la connexion. Les étapes de dépannage figurent dans le guide sur l'erreur Connection refused.
- Connection timed out : aucune réponse ne revient. Vérifiez dans l'Espace client que le serveur est en marche et que le nouveau port est ouvert dans le pare-feu ; depuis la console VNC, vous pouvez voir sur quel port sshd écoute avec
ss -tlnp.
Questions fréquentes
Faut-il utiliser PuTTY ou la commande ssh de Windows ?
Les deux parlent le même protocole SSH. PuTTY offre une interface graphique et des sessions enregistrées ; la commande ssh est exactement la même que sous Linux et macOS et s'accompagne d'outils comme scp et sftp. Les formats de clé peuvent être convertis comme indiqué dans le tableau.
Comment accéder au serveur si je perds ma clé privée ?
Connectez-vous avec le mot de passe root sur la console VNC de l'Espace client ; si vous ne vous souvenez pas du mot de passe, changez le mot de passe administrateur depuis l'Espace client (8 à 14 caractères ; lettres, chiffres et ! @ _ - . autorisés). Ajoutez ensuite votre nouvelle clé publique au fichier authorized_keys et supprimez la ligne de la clé perdue.
Puis-je me connecter depuis plusieurs ordinateurs ?
Oui. Générez une clé distincte pour chaque appareil et ajoutez chaque clé publique au fichier authorized_keys, sur sa propre ligne. Si vous perdez un appareil, vous ne supprimez que sa ligne (reconnaissable au commentaire -C).
Ces réglages survivent-ils à une réinstallation du serveur ?
Non. Une réinstallation depuis l'Espace client efface le disque : authorized_keys et les réglages de sshd disparaissent aussi. Connectez-vous avec le mot de passe root affiché sur la page du service et refaites les étapes 3 à 5 ; il est normal de voir un avertissement de clé d'hôte lors de la première connexion. Avant la réinstallation, déplacez les fichiers importants hors du serveur, par exemple en SFTP vers votre espace de sauvegarde cloud ; la sauvegarde de votre VDS relève de votre responsabilité.
Guides associés
- Comment configurer la sécurité initiale d'un nouveau VDS (Windows et Linux)
- Erreur « Connection refused » sur les serveurs VDS Linux et solution
- Qu'est-ce que VNC (console web) et comment l'utiliser en cas d'oubli du mot de passe ?
- Comment gérer le pare-feu d'un VDS : règles, fail2ban et journaux
- Où trouver l'adresse IP et le mot de passe de votre serveur VDS HanHosting ?
Pour tous les sujets, consultez la page des guides VDS.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.