Clé SSH : comment la créer et vous connecter à votre serveur

Une clé SSH, c’est une paire de fichiers sur votre ordinateur. Vous collez la partie publique (le fichier .pub) dans le tableau de bord, et le serveur vous laisse entrer sans mot de passe. Vous la créez une seule fois, et elle fonctionne pour tous vos serveurs. Si vous n’avez pas besoin de SSH, vous pouvez vous passer de clé : Jupyter et les applications prêtes à l’emploi s’ouvrent d’un clic depuis le tableau de bord.

1. Vérifiez si vous avez une clé

Ouvrez un terminal : Terminal sur Mac, PowerShell sous Windows, n’importe quel terminal sous Linux. Lancez :

Mac et Linux

Windows (PowerShell)

Ce que signifie le résultat :

• La liste contient id_ed25519.pub : vous avez déjà une clé, passez à l’étape 3.
• Pas de id_ed25519.pub, mais un id_rsa.pub ou un id_ecdsa.pub : cela fonctionne aussi. À l’étape 3, utilisez ce nom de fichier à la place de id_ed25519.pub.
• Beaucoup de fichiers aux noms différents (work.pub, github.pub, etc.) : ce sont des clés pour d’autres services, n’y touchez pas. Il vous faut seulement id_ed25519.pub ou id_rsa.pub, car le terminal les utilise automatiquement. Si aucun des deux n’est là, créez une clé à l’étape 2 : vos autres clés ne seront pas touchées.
• « No such file », « Cannot find path » ou « Impossible de trouver le chemin d’accès » : vous n’avez pas encore de clé, créez-en une à l’étape 2.

2. Créez une clé (si vous n’en avez pas)

La même commande fonctionne sur Mac, Windows et Linux :

Le terminal pose trois questions : appuyez simplement sur Entrée à chaque fois. Gardez l’emplacement de fichier par défaut ; la phrase de passe est facultative.

S’il demande « already exists. Overwrite (y/n)? », répondez n. Vous avez déjà une clé, inutile de l’écraser : passez à l’étape 3.

3. Copiez la clé publique

Mac : cette commande copie directement la clé dans le presse-papiers :

Windows (PowerShell)

Linux : affichez la clé et copiez toute la ligne :

Une clé correcte tient sur une seule ligne qui commence par ssh-ed25519. Le fichier sans .pub est votre clé privée : ne la collez nulle part et ne l’envoyez à personne.

4. Collez la clé dans le tableau de bord

Tableau de bord → Paramètres → Accès aux serveurs → Clé SSH publique → collez la ligne → Enregistrer la clé. La clé est ajoutée aux serveurs déjà en cours et à chaque nouveau serveur.

5. Connectez-vous

Dans Mes serveurs, copiez la commande SSH. Elle ressemble à ceci (chaque serveur a son propre port) :

Collez-la dans votre terminal. À la première connexion, vous verrez Are you sure you want to continue connecting (yes/no)? : tapez yes et appuyez sur Entrée. C’est tout, vous êtes sur le serveur. Vérifiez le GPU avec nvidia-smi.

Erreurs fréquentes

« id_ed25519 already exists. Overwrite (y/n)? »

Vous avez déjà une clé. Répondez n : ne l’écrasez pas, sinon l’ancienne clé cessera de fonctionner partout où elle est ajoutée. Affichez et copiez simplement la clé existante (étape 3).

« Permission denied (publickey) »

Le serveur n’a pas reconnu votre clé. Dans le tableau de bord (Paramètres), vérifiez que la clé collée est bien votre clé publique : la ligne qu’affiche cat ~/.ssh/id_ed25519.pub. Si vous avez plusieurs clés, indiquez explicitement la bonne : ssh -i ~/.ssh/id_ed25519 -p … root@vramfarm.com.

« Connection refused » ou « Connection closed »

Le serveur est encore en train de démarrer, ou il est déjà arrêté. Attendez le statut En cours dans Mes serveurs et réessayez. Si le serveur tourne et que l’erreur dure plus d’une ou deux minutes, écrivez au support dans le chat.

« REMOTE HOST IDENTIFICATION HAS CHANGED »

Un autre serveur utilisait ce port auparavant, et votre ordinateur s’en souvient. Supprimez l’ancienne entrée (avec votre propre port) : ssh-keygen -R "[vramfarm.com]:31001", puis reconnectez-vous.

« UNPROTECTED PRIVATE KEY FILE » ou « bad permissions »

D’autres utilisateurs de votre ordinateur peuvent lire la clé, donc SSH la refuse. Sur Mac et Linux : chmod 600 ~/.ssh/id_ed25519.

« ssh n’est pas reconnu en tant que commande interne ou externe » ou « ssh is not recognized… » (Windows)

Le client OpenSSH n’est pas installé. Ouvrez Paramètres → Applications → Fonctionnalités facultatives → Ajouter une fonctionnalité → Client OpenSSH, puis rouvrez PowerShell.

Le tableau de bord affiche « Ce n’est pas une clé SSH publique »

Vous avez très probablement copié la clé privée (elle commence par -----BEGIN OPENSSH PRIVATE KEY-----). Ne l’envoyez jamais à personne. Il vous faut le fichier qui se termine par .pub : une ligne qui commence par ssh-ed25519.

Le terminal demande un mot de passe

Les serveurs n’ont pas de mot de passe : on ne s’y connecte qu’avec une clé. C’est donc que la clé ne correspond pas : voir « Permission denied » ci-dessus. Si vous avez défini une phrase de passe en créant la clé, le terminal peut vous la demander : c’est le mot de passe de votre clé, pas celui du serveur.

Toujours bloqué ?

Écrivez-nous dans le chat du support, en bas à droite, et joignez une capture d’écran de votre terminal (vous pouvez la coller dans le chat avec Ctrl+V). Pendant que nous regardons, vous pouvez travailler via Jupyter : Ouvrir Jupyter → File → New → Terminal. C’est le même terminal sur le serveur, sans clé.