PuTTY : se connecter en SSH depuis Windows

Cette procédure suit la documentation officielle de PuTTY, version 0.85, relue le 14 octobre 2026. Les libellés sont en anglais : PuTTY n'existe pas en français.

Faut-il encore PuTTY ?

Windows 10 (version 1809 et suivantes) et Windows 11 livrent le client OpenSSH : la commande ssh fonctionne dans PowerShell, comme sur Mac et Linux, avec une clé au format OpenSSH. C'est la voie la plus simple, décrite dans Se connecter en SSH à un serveur Linux.

PuTTY garde ses partisans : des sessions enregistrées avec leur nom, une fenêtre à part, et Pageant, son agent qui garde la clé déverrouillée. Il emploie en revanche son propre format de clé privée, le .ppk.

Créer une clé avec PuTTYgen

Si vous avez déjà une clé OpenSSH, passez à la section suivante pour la convertir.

Ouvrez PuTTYgen, installé avec PuTTY.
Choisissez le type de clé en bas de la fenêtre. EdDSA en 255 bits (Ed25519) est le choix courant ; le manuel indique que RSA en 2048 bits suffit pour la plupart des usages.
Cliquez sur « Generate », puis déplacez la souris dans la zone vide jusqu'à ce que la barre se remplisse : PuTTYgen s'en sert pour produire du hasard.
Saisissez une phrase de passe dans « Key passphrase » et « Confirm passphrase ». Elle protège la clé si votre ordinateur est perdu ou volé.
Cliquez sur « Save private key » et rangez le fichier .ppk dans votre dossier personnel. Il ne s'envoie jamais à personne.
Copiez tout le contenu du cadre « Public key for pasting into OpenSSH authorized_keys file ». C'est la clé publique, sur une seule ligne, celle que le serveur doit connaître.

Le détail de chaque réglage est au chapitre 8 du manuel.

Convertir une clé OpenSSH existante

Dans PuTTYgen, ouvrez le menu « Conversions », puis « Import », et choisissez votre clé privée OpenSSH, par exemple id_ed25519.
Saisissez sa phrase de passe si elle en a une.
Cliquez sur « Save private key » pour obtenir le .ppk. La phrase de passe reste la même, sauf si vous la changez avant d'enregistrer.

La clé publique ne change pas : le serveur qui la connaît déjà vous acceptera avec le .ppk.

Donner la clé publique au serveur

Le serveur doit connaître votre clé publique avant la première connexion. Selon le cas, vous la collez dans le formulaire de votre hébergeur à la commande, ou vous ajoutez sa ligne au fichier ~/.ssh/authorized_keys du compte, depuis une session déjà ouverte. Cette seconde voie est décrite dans Ajouter une clé SSH sur son VPS.

Se connecter

Ouvrez PuTTY. Dans le panneau « Session », saisissez l'adresse IP du serveur dans « Host Name (or IP address) ». Laissez le port à 22 et le type de connexion sur SSH.
Dans l'arborescence de gauche, ouvrez « Connection », puis « Data », et saisissez le compte dans « Auto-login username », par exemple admin. Laissé vide, PuTTY le demande à chaque connexion.
Ouvrez « Connection », « SSH », « Auth », puis « Credentials ». Dans « Private key file for authentication », choisissez votre fichier .ppk.
Revenez au panneau « Session », saisissez un nom dans « Saved Sessions » et cliquez sur « Save ». La session apparaît dans la liste.
Cliquez sur « Open ». À la première connexion, PuTTY affiche l'empreinte de la clé du serveur et demande si vous lui faites confiance : acceptez si elle correspond à celle que vous attendez.
Saisissez la phrase de passe de la clé quand PuTTY la demande. Le terminal s'ouvre sur le serveur.

La prochaine fois, un double-clic sur le nom de la session suffit.

Ne pas retaper la phrase de passe

Pageant, l'agent de PuTTY, garde la clé déverrouillée pendant votre session Windows. Ouvrez-le, ajoutez votre .ppk avec « Add Key » et saisissez la phrase de passe une fois : PuTTY s'en sert ensuite pour toutes ses connexions, sans écrire la clé déverrouillée sur le disque.

Sur un VPS Hubspace

Le compte à saisir est admin, avec la clé publique donnée à la commande. Aucun mot de passe n'est accepté : PuTTY doit présenter la clé, faute de quoi le serveur répond « No supported authentication methods available ». Le compte root est réservé à notre équipe. Après cinq échecs en dix minutes, fail2ban bloque votre adresse pendant une heure. Si vous avez perdu votre clé, voyez J'ai perdu l'accès à mon VPS.

Questions fréquentes

PuTTY refuse ma clé id_ed25519, pourquoi ?

PuTTY ne lit que le format .ppk dans le champ « Private key file for authentication ». Ouvrez la clé dans PuTTYgen par « Conversions », « Import », puis enregistrez-la en .ppk. La clé publique reste la même.

« Server refused our key » : que faire ?

Le serveur ne connaît pas la clé présentée. Vérifiez que le .ppk choisi correspond bien à la clé publique déposée sur le serveur, et que le compte saisi dans « Auto-login username » est le bon. Sur nos VPS, c'est admin, jamais root.

Puis-je copier des fichiers avec PuTTY ?

PuTTY ouvre un terminal, il ne transfère pas de fichiers. Sa suite comprend pscp et psftp en ligne de commande. Un client graphique comme FileZilla ou WinSCP, en SFTP avec la même clé, est souvent plus simple.