Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

VDS

Se connecter à un VDS Linux en SSH : PuTTY, OpenSSH et clés SSH

26 août 2026 15 min de lecture Mis à jour :
Partager cet article

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 ssh est 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 -i avant les étapes 4 et 5 (les commandes qui utilisent la redirection >> ne fonctionnent pas avec le préfixe sudo). Remplacez 203.0.113.10 par votre propre adresse IP.

Étape 1 : établissez la première connexion avec un mot de passe

Avec PuTTY

  1. Téléchargez PuTTY sur le site officiel de PuTTY. Pour Windows 64 bits (x86), le paquet putty-64bit-0.85-installer.msi installe tous les outils, dont PuTTYgen et Pageant ; si vous ne souhaitez pas lancer d'installateur, vous pouvez télécharger séparément les fichiers putty.exe et puttygen.exe.
  2. Sur l'écran Session, saisissez l'adresse IP dans la zone Host Name (nom d'hôte) ; vérifiez que Port vaut 22 et que le type de connexion est SSH.
  3. 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.
  4. 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.
  5. Saisissez root comme 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

  1. Ouvrez PuTTYgen, sélectionnez EdDSA comme type de clé et vérifiez que la taille est Ed25519 (255 bits).
  2. Cliquez sur Generate et déplacez la souris dans la zone vide jusqu'à ce que la barre de progression soit pleine.
  3. Saisissez un commentaire dans la zone Key comment et votre phrase de passe dans les zones Key passphrase et Confirm passphrase.
  4. Cliquez sur Save private key pour enregistrer la clé privée sous forme de fichier .ppk.
  5. 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émentPuTTYOpenSSH (commande ssh)
Fichier de clé privée.ppkid_ed25519
Génération de la cléPuTTYgenssh-keygen
Agent (gardien des clés)Pageantssh-agent et ssh-add
Connexions enregistréesSaved Sessions~/.ssh/config
Conversion vers l'autre format (PuTTYgen)Ouvrez le fichier .ppk avec Load, puis Conversions → Export OpenSSH keyOuvrez 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-password n'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 sur no.
  • ChallengeResponseAuthentication, que vous pouvez rencontrer dans des fichiers plus anciens, est un alias obsolète du réglage KbdInteractiveAuthentication depuis 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.

  1. Ouvrez le nouveau port dans le pare-feu. Sur Ubuntu et Debian, si ufw est actif (vérifiez avec ufw status) :
    ufw allow 2222/tcp
    Sur AlmaLinux, si firewalld tourne (firewall-cmd --state), ouvrez le port et déclarez-le auprès de SELinux (si semanage est absent, installez-le avec dnf 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
  2. Ajoutez deux lignes de port au fichier de réglages (s'il n'y a pas d'Include, écrivez les mêmes lignes dans sshd_config) :
    echo 'Port 22' >> /etc/ssh/sshd_config.d/00-security.conf
    echo 'Port 2222' >> /etc/ssh/sshd_config.d/00-security.conf
  3. Testez et appliquez. Si la commande systemctl is-active ssh.socket affiche active (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
  4. Dans une nouvelle fenêtre, connectez-vous avec ssh -p 2222 [email protected] ou, dans PuTTY, saisissez 2222 dans la zone Port.
  5. Si la connexion fonctionne, supprimez la ligne Port 22 (s'il n'y a pas d'Include, supprimez la ligne de sshd_config), appliquez de nouveau le changement avec les commandes du point 3 et supprimez la règle ouverte pour le port 22 (par exemple ufw delete allow 22/tcp ; avec firewalld, firewall-cmd --remove-service=ssh puis firewall-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églageValeurEffet
PubkeyAuthenticationyesAutorise la connexion par clé (c'est aussi la valeur par défaut).
PasswordAuthenticationnoDésactive la connexion par mot de passe.
KbdInteractiveAuthenticationnoDésactive la méthode interactive au clavier (keyboard-interactive), qui demande un mot de passe.
PermitRootLoginprohibit-passwordroot ne peut se connecter qu'avec une clé.
Port2222Le 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_keys et les permissions chmod de 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 avec restorecon -R ~/.ssh. Pour plus de détails, examinez la sortie de ssh -v [email protected] côté client et de journalctl -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 .ppk dans 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

Pour tous les sujets, consultez la page des guides VDS.

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.