Première connexion SSH à son VPS avec une clé

VPS · 4 min de lecture · Mis à jour le 16 octobre 2026

Une clé SSH remplace le mot de passe par une paire de fichiers : une clé privée, qui reste sur votre ordinateur, et une clé publique, que vous déposez sur le serveur. C'est plus sûr (rien à deviner, rien qui transite) et plus pratique (plus de mot de passe à taper).

Ce qu'il vous faut

Votre VPS en service et son nom, choisi à la commande.
Un terminal : PowerShell sous Windows 10 et 11 (OpenSSH y est inclus), Terminal sous macOS ou Linux.

La commande de connexion à un VPS HebergHub est :

ssh -p 2222 [email protected]

où nom est le nom de votre VPS. Il n'y a pas d'adresse IP à retenir : le nom d'utilisateur indique à quel VPS vous connecter, et vous arrivez en root sur votre serveur.

1. Créer la clé

La même commande fonctionne sous Windows (PowerShell), macOS et Linux :

ssh-keygen -t ed25519 -C "prenom@ordinateur"

Acceptez l'emplacement proposé (~/.ssh/id_ed25519, soit C:\Users\vous\.ssh\id_ed25519 sous Windows).
Choisissez une phrase de passe. Elle protège la clé si quelqu'un copie le fichier. L'agent SSH la retient pour la session, vous ne la tapez pas à chaque connexion.

Deux fichiers sont créés :

Fichier	Rôle	À partager ?
`id_ed25519`	Clé privée	Jamais.
`id_ed25519.pub`	Clé publique	Oui, c'est elle que vous déposez.

Affichez la clé publique pour la copier :

cat ~/.ssh/id_ed25519.pub

Sous PowerShell : Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub. Elle tient sur une ligne qui commence par ssh-ed25519.

2. Déposer la clé publique

Le plus simple est de la coller à la commande, dans le champ prévu pour la clé SSH. Vous pouvez aussi l'ajouter ou la changer plus tard depuis la page Accès de votre VPS, dans l'espace client ; la modification prend effet immédiatement.

3. Se connecter

ssh -p 2222 [email protected]

À la première connexion, SSH affiche l'empreinte du serveur et demande confirmation. Répondez yes : l'empreinte est enregistrée dans ~/.ssh/known_hosts, et SSH vous avertira si elle change un jour.

Si vous n'avez pas encore de clé, la connexion fonctionne avec le mot de passe root initial, affiché sur la page Accès. Changez-le dès la première connexion :

passwd

4. Un raccourci : ~/.ssh/config

Pour ne plus taper le port et le nom à chaque fois, ajoutez dans ~/.ssh/config (C:\Users\vous\.ssh\config sous Windows) :

Host monvps
    HostName ssh.vps.heberghub.fr
    Port 2222
    User nom
    IdentityFile ~/.ssh/id_ed25519

Vous vous connectez ensuite avec ssh monvps. Le raccourci fonctionne aussi pour copier des fichiers :

scp fichier.tar.gz monvps:/root/

Vérifié en connexion directe sur un VPS conteneur et sur un VPS machine virtuelle (Debian 13, OpenSSH 10.0) : scp et sftp fonctionnent dans les deux sens avec la clé, sans paquet à installer côté VPS.

scp monvps:/root/fichier.tar.gz .
sftp monvps

Dans sftp, put fichier envoie, get fichier télécharge, ls liste, bye quitte.

5. Et si la connexion échoue ?

Message	Piste
`Permission denied (publickey)`	La clé publique déposée ne correspond pas à la clé privée utilisée. Vérifiez la page Accès et l'option `IdentityFile`. Ajoutez `-v` à la commande pour voir quelle clé est proposée.
`Connection refused` ou délai dépassé	Port oublié (`-p 2222`) ou réseau qui bloque les ports sortants inhabituels (certains réseaux d'entreprise ou d'école).
`REMOTE HOST IDENTIFICATION HAS CHANGED`	Ne forcez pas : ouvrez un ticket pour vérifier avant de supprimer l'ancienne ligne de `known_hosts`.
Plus d'accès après une modification de configuration SSH	Utilisez la console de l'espace client, qui ne passe pas par SSH, pour corriger.

La console dans le navigateur, accessible depuis la fiche du VPS, reste votre accès de secours en toutes circonstances.

À savoir

Ne désactivez pas la connexion root dans la configuration SSH du VPS et ne changez pas son port d'écoute : vous couperiez l'accès par ssh.vps.heberghub.fr. Le guide Sécuriser un VPS Debian détaille ce qui peut être durci sans risque.
Une clé par ordinateur : si un appareil est perdu, vous retirez sa clé sans toucher aux autres.

Besoin d'aide ?

Ouvrez un ticket depuis votre espace client avec le nom du VPS et le message d'erreur complet. N'envoyez jamais votre clé privée : seule la clé publique (.pub) peut être partagée.