SFTP (Secure File Transfer Protocol) vous permet de vous connecter à votre serveur de jeu et de transférer des fichiers directement depuis votre ordinateur — y compris les fichiers volumineux, les dossiers de mods complets et les sauvegardes. Si vous devez transférer quelque chose que le gestionnaire de fichiers de GPanel ne peut pas gérer (comme des répertoires entiers ou des fichiers dépassant la limite de taille du navigateur), SFTP est l'outil qu'il vous faut.
Quand utiliser SFTP : Utilisez SFTP lorsque vous devez transférer des dossiers, des fichiers volumineux (par ex., sauvegardes de monde, packs de mods, backups), ou plusieurs fichiers à la fois. Pour des modifications rapides de fichiers individuels, le gestionnaire de fichiers de GPanel peut suffire.
Détails de connexion
Votre connexion SFTP utilise l'adresse IP de votre serveur et les identifiants de GPanel.
Vos détails de connexion SFTP
| Hôte / Adresse | L'adresse IP de votre serveur (affichée sur le tableau de bord GPanel ou l'onglet Console) |
|---|---|
| Port | 2022 |
| Protocole | SFTP (SSH File Transfer Protocol) |
| Nom d'utilisateur | Votre nom d'utilisateur GPanel |
| Mot de passe | Disponible dans l'onglet Settings sur GPanel |
Important : Utilisez toujours le port 2022, pas le port SFTP par défaut 22. Les connexions sur le port 22 ne fonctionneront pas.
Option 1 — FileZilla (Recommandé)
FileZilla est un client FTP/SFTP gratuit et multiplateforme disponible pour Windows, macOS et Linux.
Étape 1 — Télécharger et installer FileZilla
- Rendez-vous sur filezilla-project.org et téléchargez le FileZilla Client (pas FileZilla Server).
- Lancez l'installateur et suivez les instructions à l'écran.
Étape 2 — Ouvrir le gestionnaire de sites
- Lancez FileZilla.
- Cliquez sur File → Site Manager (ou appuyez sur Ctrl+S).
- Cliquez sur New Site et donnez-lui un nom tel que Legion Hosting.
Étape 3 — Entrer les paramètres de connexion
- Définissez Protocol sur
SFTP - SSH File Transfer Protocol. - Définissez Host sur l'adresse IP de votre serveur (disponible sur le tableau de bord GPanel).
- Définissez Port sur
2022. - Définissez Logon Type sur
Normal. - Entrez votre nom d'utilisateur et mot de passe GPanel (le mot de passe se trouve dans l'onglet Settings sur GPanel).
- Cliquez sur Connect.
Étape 4 — Accepter la clé d'hôte
- Lors de la première connexion, FileZilla affichera une boîte de dialogue Unknown host key.
- Cochez Always trust this host et cliquez sur OK.
Étape 5 — Transférer des fichiers
- Le panneau gauche affiche votre ordinateur local. Naviguez vers les fichiers ou dossiers que vous souhaitez transférer.
- Le panneau droit affiche le système de fichiers de votre serveur. Naviguez vers le dossier de destination (par ex.,
/home/container/mods/). - Glissez-déposez les fichiers ou dossiers du panneau gauche vers le panneau droit, ou faites un clic droit sur un fichier et choisissez Upload.
- Suivez la progression du transfert dans le panneau de file d'attente en bas.
Option 2 — WinSCP (Windows uniquement)
WinSCP est un client SFTP gratuit et populaire pour Windows avec une interface familière d'explorateur de fichiers à deux panneaux.
Étape 1 — Télécharger et installer WinSCP
- Rendez-vous sur winscp.net et téléchargez l'installateur.
- Lancez l'installateur. Lorsqu'on vous demande un style d'interface, choisissez Commander pour une vue à double panneau, ou Explorer si vous préférez une vue à panneau unique.
Étape 2 — Créer une nouvelle session
- Lancez WinSCP. La boîte de dialogue Login s'ouvre automatiquement.
- Définissez File protocol sur
SFTP. - Entrez l'adresse IP de votre serveur dans le champ Host name (disponible sur le tableau de bord GPanel).
- Définissez Port number sur
2022. - Entrez votre nom d'utilisateur et mot de passe GPanel (le mot de passe se trouve dans l'onglet Settings sur GPanel).
- Cliquez sur Login.
Étape 3 — Accepter la clé d'hôte et transférer
- Acceptez l'avertissement de clé d'hôte du serveur lors de la première connexion.
- Vos fichiers locaux apparaissent à gauche ; les fichiers du serveur à droite.
- Naviguez vers votre dossier cible sur le serveur, puis glissez les fichiers du panneau gauche vers le droit, ou utilisez F5 pour copier les fichiers sélectionnés.
Tâches de transfert courantes
Transférer un fichier de configuration
Les fichiers de configuration (par ex., servertest.ini, server.properties) sont généralement situés dans un sous-dossier spécifique du répertoire principal de votre serveur. Chemins courants :
- Project Zomboid :
/home/container/.cache/server/ - ARK: Survival Ascended :
/home/container/ShooterGame/Saved/Config/WindowsServer/ - Minecraft :
/home/container/
Naviguez vers le chemin correct dans votre client SFTP, puis glissez votre fichier de configuration modifié sur le panneau du serveur pour remplacer le fichier existant.
Arrêtez le serveur d'abord avant de remplacer les fichiers de configuration actifs. Transférer une configuration pendant que le serveur est en cours d'exécution peut amener le serveur à écraser votre fichier lors de l'arrêt.
Transférer des mods
- Arrêtez votre serveur depuis GPanel.
- Connectez-vous via SFTP et naviguez vers le dossier de mods de votre jeu (par ex.,
/home/container/mods/ou le chemin spécifique au jeu). - Glissez le dossier du mod entier ou le fichier
.jar/.pakdepuis votre machine locale vers le répertoire de mods du serveur. - Démarrez le serveur depuis GPanel une fois le transfert terminé.
Transférer une sauvegarde de monde ou un backup
- Arrêtez votre serveur depuis GPanel.
- Connectez-vous via SFTP et naviguez vers le répertoire de sauvegardes de votre jeu.
- Transférez le dossier de sauvegarde entier (glissez le dossier lui-même, pas seulement son contenu, sauf si vous fusionnez dans une sauvegarde existante).
- Confirmez que la structure des dossiers correspond à ce qui était là auparavant.
- Démarrez le serveur depuis GPanel.
Conseil : Avant d'écraser une sauvegarde, renommez d'abord le dossier existant côté serveur (par ex., ajoutez
_backup à la fin) pour pouvoir le restaurer en cas de problème.
Dépannage
- Vérifiez que le port est bien défini sur 2022, pas 22.
- Vérifiez que l'adresse IP correspond à celle affichée sur votre tableau de bord GPanel.
- Assurez-vous que votre serveur est en cours d'exécution — l'accès SFTP peut nécessiter que le processus du serveur de jeu soit actif sur certains plans.
- Vérifiez que votre pare-feu ou antivirus ne bloque pas les connexions sortantes sur le port 2022.
- Utilisez le même nom d'utilisateur et mot de passe que vous utilisez pour vous connecter à gpanel.legionhosting.net.
- Les noms d'utilisateur sont sensibles à la casse. Copiez le nom d'utilisateur directement depuis GPanel en cas de doute.
- Si vous avez récemment changé votre mot de passe GPanel, mettez-le à jour dans la session enregistrée de votre client SFTP.
- Réinitialisez votre mot de passe GPanel depuis l'espace client si vous l'avez oublié.
- Les packs de mods ou sauvegardes de monde volumineux peuvent prendre plusieurs minutes. Laissez le transfert se terminer.
- Dans FileZilla, vous pouvez augmenter le nombre de transferts simultanés : allez dans Edit → Settings → Transfers et définissez le maximum de transferts simultanés à 3.
- Si la connexion est interrompue en cours de transfert, FileZilla peut reprendre : faites un clic droit sur le fichier échoué dans la file d'attente et choisissez Reset and requeue failed transfers.
- Votre répertoire personnel est
/home/container/. Si le client vous place dans un répertoire différent, tapez manuellement ce chemin dans la barre de chemin distant. - Assurez-vous d'être connecté avec le bon nom d'utilisateur — chaque compte GPanel n'a accès qu'aux fichiers de son propre serveur.
Besoin d'aide ? Ouvrez un ticket de support et incluez l'adresse IP de votre serveur, le client SFTP que vous utilisez et une description de l'erreur.
