Accès SFTP au serveur de jeu – Gérer les fichiers

SFTP est la méthode pratique pour gérer les fichiers de ton serveur de jeu en dehors du panel : modifier des configurations, envoyer des plugins ou des mods, sauvegarder des logs et télécharger des mondes. Il te faut seulement un client adapté, les identifiants du dashboard et un peu de prudence lorsque tu écrases des fichiers importants.

Ce que permet SFTP pour un serveur de jeu

SFTP signifie SSH File Transfer Protocol et transfère les fichiers via une connexion chiffrée. Pour les serveurs de jeu, c’est particulièrement utile, car tu n’as pas à effectuer chaque modification via un gestionnaire de fichiers dans le navigateur. Les gros dossiers, de nombreux fichiers de plugins ou les sauvegardes locales sont généralement plus faciles à gérer avec un client desktop.

La distinction est importante : SFTP n’est pas la même chose que le FTP classique. Si ton client propose plusieurs protocoles, choisis explicitement SFTP. FileZilla cite SFTP comme protocole pris en charge dans sa documentation officielle ; WinSCP se décrit officiellement comme un client de transfert de fichiers, notamment via SFTP. Utilise donc les téléchargements officiels et évite les installateurs non officiels de sites tiers.

Prérequis

Tu as besoin d’un serveur de jeu actif, d’un accès à ton dashboard game-serverhosting et d’un client SFTP sur ton ordinateur. Avant les modifications risquées, tu devrais aussi créer une sauvegarde ou au moins télécharger localement les fichiers concernés. Cela vaut particulièrement pour les mondes, bases de données, configurations serveur et dossiers de plugins.

Si tu viens d’un autre fournisseur, le guide Déménager un serveur de jeu : de n’importe quel hébergeur vers game-serverhosting t’aide pour l’ordre entre sauvegarde, upload et vérification. Pour les extensions spécifiques à Minecraft, le guide Installer et gérer des plugins Minecraft – Spigot/Paper dans le panel complète les étapes SFTP avec les détails des plugins.

Installer un client SFTP

Sous Windows, WinSCP est souvent agréable, car l’interface, l’intégration de l’éditeur et la synchronisation sont clairement séparées. FileZilla est multiplateforme et fonctionne bien si tu veux travailler de manière similaire sous Windows, macOS ou Linux. Cyberduck est aussi une option si tu préfères une interface simple.

Établir la connexion

Ouvre ton client SFTP et crée une nouvelle connexion. Les valeurs se trouvent dans le dashboard de ton serveur. Ne les transmets pas à des tiers par capture d’écran et n’enregistre les mots de passe que sur des appareils auxquels tu fais confiance.

Clique ensuite sur Connexion. Lors de la première connexion, ton client peut demander une clé d’hôte. Vérifie que tu te connectes au bon hôte et confirme la clé uniquement si les données serveur sont correctes. Ensuite, le client affiche généralement deux zones : à gauche tes fichiers locaux, à droite les fichiers sur le serveur de jeu.

Structure de dossiers typique

La structure exacte dépend du jeu et du type de serveur utilisé. Beaucoup de setups s’orientent toutefois autour d’un répertoire de conteneur comme celui-ci :

/home/container/
├── server.properties     # Config serveur
├── plugins/              # Plugins (Paper/Spigot)
├── mods/                 # Mods (Forge/Fabric)
├── world/                # Monde de jeu
├── logs/                 # Logs serveur
└── backups/              # Sauvegardes

Modifie les fichiers de manière aussi ciblée que possible. Télécharge d’abord un fichier de configuration, modifie-le localement dans un éditeur adapté, puis renvoie-le. Fais attention à ne pas changer les extensions de fichiers. Par exemple, server.properties ne doit pas devenir accidentellement server.properties.txt.

Tâches fréquentes

• Modifier la config : télécharger le fichier → modifier → uploader
• Installer des plugins : uploader le JAR dans /plugins/
• Télécharger des sauvegardes : télécharger le dossier /world/
• Vérifier les logs : télécharger latest.log

Pour les plugins ou mods, tu devrais vérifier la version du serveur, le loader et les dépendances avant d’envoyer des fichiers. Un plugin Paper va généralement dans /plugins/, un mod Forge ou Fabric dans /mods/. Après l’upload, un redémarrage est le plus souvent nécessaire pour que le serveur charge le nouveau fichier.

Pour les sauvegardes de monde, un déroulé clair est recommandé : arrêter le serveur, télécharger le dossier du monde, nommer utilement la copie locale, puis seulement ensuite effectuer de plus grosses modifications. Si le serveur écrit activement pendant la copie, une sauvegarde peut être incomplète ou incohérente.

Vérifier le résultat

Après une modification, vérifie d’abord si l’upload s’est terminé complètement. Beaucoup de clients SFTP affichent les transferts échoués dans une file d’attente ou un onglet d’erreurs. Ensuite, redémarre le serveur de jeu si nécessaire et contrôle les logs. Pour Minecraft, latest.log est souvent le premier point à consulter ; pour d’autres jeux, il existe des fichiers de log propres dans le répertoire serveur correspondant.

Teste ensuite dans le jeu ou dans le panel si la modification est réellement active. Un fichier uploadé ne signifie pas encore qu’il a été lu par le serveur. Ce qui compte, c’est que le démarrage se déroule sans erreur et que la fonction souhaitée soit visible.

Conseils pour travailler proprement

• Drag & Drop : transférer simplement les fichiers par Drag & Drop
• Double-clic : ouvrir les fichiers directement dans l’éditeur
• Synchroniser : certains clients proposent la synchronisation de dossiers
• Auth par clé : utiliser des clés SSH au lieu d’un mot de passe pour plus de sécurité

Travaille quand même de façon contrôlée : la synchronisation peut rapidement transférer des erreurs locales vers le serveur. Si tu remplaces beaucoup de fichiers, vérifie au préalable le dossier cible et le sens de synchronisation. Pour les fichiers de configuration, une copie locale avant chaque modification est utile.

Dépannage

Si la connexion échoue, vérifie d’abord le protocole, l’hôte, le port, le nom d’utilisateur et le mot de passe. Une erreur fréquente consiste à choisir FTP au lieu de SFTP par inadvertance ou à saisir le mauvais port. Le port standard utilisé dans de nombreux setups Pterodactyl est 2022 ; toutefois, les valeurs de ton dashboard font toujours foi.

Si l’upload s’interrompt, la connexion locale peut être instable ou le dossier cible peut manquer. Répète le transfert et vérifie si ton client n’a uploadé le fichier que partiellement. En cas de doute, supprime le fichier cible incomplet et renvoie-le.

Si le serveur ne démarre pas après une modification, remets le dernier fichier fonctionnel ou supprime le dernier plugin ou mod uploadé. Vérifie ensuite les logs. Pour le travail de base en terminal autour des fichiers serveur, le guide Commandes Linux pour serveurs de jeu – Les commandes terminal les plus importantes t’aide aussi.

Vérification, limites et retour arrière sûr

Le guide « Accès SFTP au serveur de jeu – Gérer les fichiers » vaut pour le type de serveur décrit dans l’article et pour l’état de version visible au moment de la vérification. Les noms de menus, versions disponibles, compatibilités de mods ou plugins et ressources nécessaires peuvent changer après des mises à jour. Ne transfère donc aucune valeur sans vérification vers une autre version de jeu, de loader ou de serveur.

Avant de modifier un monde, une sauvegarde de jeu, une configuration ou des extensions, crée une sauvegarde des fichiers concernés. Modifie ensuite une seule étape cohérente à la fois et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer plus tard.

Un test individuel réussi ne garantit ni les performances ni la disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le trajet réseau et la charge simultanée peuvent modifier le résultat. Documente la version, la modification et le résultat du test afin de comprendre les écarts ultérieurs.

FAQ

SFTP est-il plus sûr que FTP ?

Oui, SFTP transfère les fichiers via une connexion chiffrée. Il reste toutefois important de protéger tes identifiants, d’utiliser uniquement des clients fiables et de ne pas stocker de mots de passe enregistrés sur des appareils partagés.

Quel client SFTP devrais-je utiliser ?

Prends le client avec lequel tu peux travailler de manière fiable. FileZilla est multiplateforme, WinSCP est très populaire sous Windows, Cyberduck fonctionne sur macOS et Windows. Télécharge le client directement depuis le site officiel.

Dois-je arrêter le serveur de jeu avant chaque upload ?

Pas pour chaque fichier. Pour les logs ou les simples téléchargements, ce n’est généralement pas nécessaire. Pour les dossiers de monde, bases de données, mods, plugins ou configurations centrales, un arrêt ou un redémarrage est utile selon la modification, afin qu’aucun fichier ne soit écrit en même temps.

Pourquoi ma modification uploadée n’apparaît-elle pas dans le jeu ?

Les raisons possibles sont un redémarrage manquant, un mauvais dossier cible, une version de plugin ou de mod incompatible, ou une erreur dans la configuration. Vérifie d’abord l’upload, puis les logs serveur, puis l’indication exacte du chemin.

Puis-je télécharger des sauvegardes complètes via SFTP ?

Oui, tu peux télécharger des dossiers comme /world/ ou des répertoires de sauvegarde existants. Pour des sauvegardes cohérentes de mondes de jeu, tu devrais arrêter le serveur au préalable ou utiliser la fonction de sauvegarde de ton panel si elle est disponible pour ton serveur.