Accès SSH (incl. Transfert de fichiers)

Chaque GPU Server Blib exécute une instance entièrement isolée de Ubuntu 22.04 LTS avec tous les droits contrôle au niveau rootVous pouvez accéder directement à votre serveur via SSH en utilisant les identifiants fournis dans l'interface de gestion.

Attention : Le port SSH est spécifique à chaque machine, assurez-vous donc d'utiliser le bon port SSH. Ce n'est pas le port 22, il se situe généralement entre 10000 et 59999.

ATTENTION UFW 🚨 Vous n'avez pas besoin d'un pare-feu (UFW) activé sur votre Blib serveur GPU ! Lisez plus ici : Ai-je besoin d'un pare-feu sur le serveur GPU ? Les agents d'IA peuvent vous suggérer de sécuriser le serveur avec des outils généralement utilisés dans des scénarios de serveurs web. Ne le faites pas. Un UFW actif bloquera votre accès au serveur.


1. Récupération des identifiants SSH

Pour accéder à votre serveur, ouvrez l' Interface de gestion Trooper.AI et accédez à votre instance Blib active.

Cliquez sur le “Actions” bouton pour afficher les détails de connexion SSH :

Use Actions button to reveal SSH credentials
Utilisez le bouton Actions pour afficher les informations d'identification SSH

Vous verrez les informations suivantes :

  • Nom d'hôte (e.g. connect01.trooper.ai)
  • Port SSH
  • Nom d'utilisateur
  • Mot de passe (cliquez sur icône d'œil pour afficher)

SSH Credentials revealed
Identifiants SSH révélés

Vous pouvez utiliser boutons de copie pour coller les valeurs directement dans votre terminal.


2. Établissement de la connexion SSH

Utilisez une commande SSH standard pour vous connecter à votre serveur :

bash
ssh USERNAME@HOSTNAME -p PORT

Remplacez USERNAME, HOSTNAME, et PORT avec les valeurs du tableau de bord.

Exemple :

bash
ssh trooperai@connect01.trooper.ai -p 15012

Si c'est votre première connexion, votre terminal peut vous demander de confirmer l'empreinte du serveur :

Code
The authenticity of host 'connect01.trooper.ai (IP)' can't be established.
Are you sure you want to continue connecting (yes/no)? 

Type yes et appuyez sur Entrer pour continuer.


3. Confirmation de connexion

Après une connexion réussie, vous devriez voir une invite de commande standard :

Terminal connection example
Exemple de connexion terminal

Cela indique que vous êtes maintenant connecté à votre Blib serveur GPU.


4. Utilisation des privilèges root

Bien que vous soyez connecté en tant qu'utilisateur non-root pour des raisons de sécurité, votre compte dispose de tous les privilèges. Vous pouvez exécuter des tâches administratives en utilisant sudo.

Exemples :

bash
sudo apt update
sudo fdisk -l

La première fois que vous l'utilisez sudoon vous demandera d'entrer le mot de passe fourni.


5. Remarques

  • Votre connexion SSH est sécurisée et isolée.
  • Tous les modèles installés (par exemple, Jupyter, ComfyUI) restent actifs en parallèle et accessibles via les ports publics attribués.
  • Pour un provisionnement ou une automatisation avancés, vous pouvez intégrer cet accès avec rsync, scp, ou des outils de configuration tels que Ansible.

6. Transfert de fichiers avec SFTP

Le transfert sécurisé de fichiers vers et depuis votre GPU Server Blib est facilement réalisable en utilisant SFTP (Secure File Transfer Protocol). SFTP fournit une connexion chiffrée via SSH, garantissant la confidentialité et l'intégrité de vos données pendant le transit. C'est la méthode recommandée pour transférer des ensembles de données, des modèles, des scripts ou tout autre fichier requis pour vos projets.

Pour vous connecter en utilisant SFTP, vous aurez besoin d'un client SFTP. Parmi les options populaires, on trouve FileZilla, Cyberduck (notre préféré), et WinSCP. Ces clients fonctionnent de manière similaire aux explorateurs de fichiers traditionnels, vous permettant de parcourir et de gérer les fichiers à la fois sur votre machine locale et sur le serveur distant.

Configuration :

  1. Hôte : Entrez le nom d'hôte de votre Blib serveur GPU (trouvé dans l'interface de gestion Trooper.AI).
  2. Port : Utilisez le numéro de port SSH fourni dans l'interface de gestion (il s'agit d'un nombre à 5 chiffres!).
  3. Nom d'utilisateur : Entrez le nom d'utilisateur SSH fourni dans l'interface de gestion (la partie avant le signe @ dans la commande de connexion SSH).
  4. Mot de passe : Entrez le mot de passe SSH associé à votre compte.

Une fois connecté, vous pouvez télécharger et transférer des fichiers de manière transparente entre votre machine locale et le Blib. L'interface SFTP présentera le système de fichiers de votre serveur comme un emplacement distant, vous permettant de naviguer et de gérer les fichiers comme vous le feriez sur votre ordinateur local.

Configure with SSH username, password and port
Configurer avec le nom d'utilisateur SSH, le mot de passe et le port

Work with your files like any other network location
Travaillez avec vos fichiers comme n'importe quel autre emplacement réseau

SFTP est une méthode sécurisée et fiable pour gérer les fichiers sur votre Blib serveur GPU Trooper.AI, permettant un transfert de données efficace et le développement de projets.


7. Dépannage SSH

Problèmes d'accès après le redémarrage

Si vous rencontrez des problèmes d'accès après un redémarrage, vérifiez d'abord votre configuration SSH et vos paramètres de pare-feu dans le Jupyter Notebook Terminal. Un pare-feu local (UFW) n'est généralement pas requis et peut interférer avec l'accès. Lisez-en plus ici : Ai-je besoin d'un pare-feu sur le serveur GPU ? Si le problème persiste, veuillez désactiver le pare-feu de votre serveur ou contacter notre équipe de support pour obtenir de l’aide : Contacts Support

Accès SSH par mot de passe

Si vous utilisez une distribution Linux récente sur votre machine locale (par exemple, Ubuntu 24.04+), votre client SSH peut par défaut utiliser l'authentification par clé publique, même si vous essayez d'utiliser un mot de passe.

Si votre mot de passe semble être immédiatement rejeté, essayez de forcer explicitement l'authentification par mot de passe :

bash
ssh -o PreferredAuthentications=password -o PubkeyAuthentication=no USERNAME@HOSTNAME -p PORT

Remplacez USERNAME, HOSTNAME, et PORT avec vos valeurs fournies.

Cela indique à SSH de ignorer la recherche de clés et utilisez directement la méthode du mot de passe.

Problèmes d'identification de l'hôte après un état figé ou une migration

Après la restauration d’une instance figée ou la migration d’un Blib, vous pourriez rencontrer une WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! Erreur lors de la tentative de connexion via SSH. Cela se produit car la clé SSH du serveur a changé et que votre machine locale mémorise l'ancienne clé.

Pour résoudre ce problème :

  1. Supprimez l’ancienne clé de votre known_hosts fichier :

    Le known_hosts Ce fichier stocke les clés SSH des serveurs auxquels vous vous êtes précédemment connecté. Vous devez supprimer l'entrée pour le serveur Trooper.AI. Le fichier est généralement situé à ~/.ssh/known_hosts sur Linux/macOS et %USERPROFILE%\.ssh\known_hosts sous Windows.

    • Linux/macOS : Ouvrez le fichier dans un éditeur de texte et recherchez la ligne commençant par le nom d'hôte ou l'adresse IP de votre serveur Trooper.AI. Supprimez toute cette ligne.
    • Windows : Ouvrez le fichier dans un éditeur de texte (tel que Notepad) et suivez les mêmes instructions que pour Linux/macOS.
  2. Utilisez également ssh-keygen -R:

    Vous pouvez utiliser le ssh-keygen commande pour supprimer la clé directement :

    bash
    ssh-keygen -R HOSTNAME
    

    Remplacez HOSTNAME avec le nom d'hôte de votre serveur Trooper.AI (par exemple, connect01.trooper.ai).

  3. Reconnecter :

    Après avoir supprimé l’ancienne clé, essayez de vous connecter à nouveau au serveur via SSH. Il vous sera demandé de vérifier la nouvelle clé. Tapez yes et appuyez sur Entrée.

Cela mettra à jour votre known_hosts fichier avec la nouvelle clé, et vous devriez pouvoir vous connecter sans avertissement supplémentaire.

Empêcher les déconnexions SSH

Rencontrez-vous des déconnexions SSH fréquentes, notamment sous Windows ? Maintenez votre connexion active avec cette commande :

bash
ssh -o ServerAliveInterval=30 -o ServerAliveCountMax=4 USERNAME@PUBLIC_HOST -p PORT

Cela envoie un paquet de maintien en vie toutes les 30 secondes et retentera jusqu'à 4 fois si aucune réponse n'est reçue. Dites adieu aux déconnexions frustrantes ! 🚀

Situations de réseau instable : Les connexions SSH peuvent être fragiles sur les réseaux instables. Nous recommandons vivement une connexion Wifi privée stable ou Ethernet. Les connexions mobiles 📱, VPN, Wifi public (comme dans un Airbnb, un café ou une université) ou Skylink peuvent entraîner des problèmes de connectivité intermittents. Si vous utilisez ces connexions, assurez-vous que votre réseau prend en charge les tentatives de reconnexion.

Lisez également davantage sur Accès HTTP(S) et À propos des certificats SSL.

Aide pour la première connexion

Pour tout problème d’accès, veuillez contacter support@trooper.ai ou plus rapidement sur WhatsApp : +4961269289991.