Accéder à son serveur en SFTP

Le gestionnaire de fichiers du panel suffit pour éditer un fichier de configuration. Pour envoyer un monde de 4 Go, un dossier de ressources ou plusieurs centaines de mods, il faut un client SFTP. Cette page s’adresse à tout client qui transfère des volumes importants vers son serveur de jeu, ou dont le navigateur abandonne en cours d’envoi.

SFTP est le FTP chiffré. Les identifiants viennent du panel panel.cloudfive.xyz et vous donnent accès au dossier de votre serveur, et à lui seul.

Récupérer ses identifiants SFTP

Les informations de connexion sont affichées par le panel, dans la rubrique des réglages de votre serveur. Ne les devinez pas : copiez-les.

Connectez-vous à panel.cloudfive.xyz et ouvrez votre serveur.
Ouvrez la rubrique qui regroupe les paramètres du serveur et les informations de connexion SFTP.
Relevez l’adresse du serveur SFTP et le port. Ce port n’est ni le port 22 habituel, ni le port de jeu de vos joueurs : c’est une valeur propre au panel, et elle doit être saisie telle quelle.
Copiez l’identifiant SFTP entier. Ce n’est pas votre adresse email : il est propre à ce serveur et contient en général votre nom d’utilisateur suivi d’un point et d’un identifiant de serveur.
Préparez le mot de passe de votre compte du panel — c’est celui qui sera demandé. Ce n’est pas le mot de passe de l’espace client.

Configurer FileZilla

FileZilla est gratuit et disponible sur Windows, macOS et Linux. Téléchargez-le depuis son site officiel, filezilla-project.org, et refusez les logiciels additionnels proposés par l’installateur.

Ouvrez le Gestionnaire de Sites (menu Fichier), puis créez un nouveau site.
Choisissez le protocole SFTP - SSH File Transfer Protocol. C’est le réglage le plus souvent oublié : le protocole FTP simple ne fonctionnera pas.
Renseignez l’hôte et le port relevés dans le panel.
Laissez le type d’authentification sur Normale, puis saisissez l’identifiant SFTP et le mot de passe du panel.
Dans les réglages de transfert de ce site, limitez le nombre de connexions simultanées à 1 ou 2. Au-delà, le serveur refuse les connexions excédentaires.
Cliquez sur Connexion, puis acceptez l’empreinte de la clé du serveur la première fois.
Vérifiez que vous voyez bien les fichiers de votre serveur de jeu dans le panneau de droite.

Configurer WinSCP

WinSCP n’existe que sur Windows, mais son interface à deux panneaux et sa fonction de synchronisation sont très pratiques. Le site officiel est winscp.net.

À l’ouverture, créez un nouveau site.
Réglez le protocole de fichier sur SFTP.
Saisissez le nom d’hôte et le numéro de port donnés par le panel.
Saisissez l’identifiant SFTP, puis le mot de passe du panel.
Enregistrez le site pour ne pas tout retaper la prochaine fois, puis connectez-vous.
Acceptez la clé du serveur lors de la première connexion.

Transférer de gros volumes efficacement

Le débit n’est pas le problème ; le nombre de fichiers l’est. Mille petits fichiers prennent bien plus de temps qu’un seul fichier de même poids total, parce que chaque transfert coûte un aller-retour.

Ce qui change vraiment les choses :

Envoyez une archive, décompressez sur place. Faites un .zip de votre dossier, transférez-le, puis décompressez-le depuis le gestionnaire de fichiers. C’est souvent dix fois plus rapide qu’un envoi fichier par fichier.
Arrêtez le serveur avant de remplacer des fichiers en cours d’utilisation : un monde, un dossier de ressources, un plugin. Voir Démarrer, arrêter et redémarrer.
N’envoyez pas les dossiers de cache ni les logs. Ils se régénèrent et ne font que gonfler le transfert.
Surveillez l’espace disque. Une archive de 3 Go occupe 3 Go pendant l’envoi, puis le double une fois décompressée tant que vous n’avez pas supprimé l’archive. L’espace de votre offre est affiché dans le panel.
Laissez la fenêtre ouverte. Un transfert interrompu laisse des fichiers incomplets, que le jeu refusera de charger.

Résoudre les erreurs de connexion

« Authentication failed » / l’accès est refusé. Dans l’ordre de fréquence : vous avez saisi le mot de passe de l’espace client au lieu de celui du panel ; vous avez saisi votre email au lieu de l’identifiant SFTP affiché ; l’identifiant a été copié tronqué. Copiez-collez les deux valeurs depuis le panel sans les retaper.

« Connection refused » ou délai dépassé. Le port utilisé n’est pas le bon dans neuf cas sur dix — le port 22 par défaut de votre client ne convient pas. Vérifiez ensuite que votre réseau n’interdit pas les connexions sortantes : les réseaux d’entreprise, d’école et certains partages de connexion mobile bloquent tout ce qui n’est pas du web. Essayez depuis une autre connexion pour trancher.

« Too many connections ». Votre client ouvre plusieurs canaux en parallèle. Ramenez la limite à 1 connexion simultanée, puis attendez une minute avant de réessayer.

« Permission denied » à l’écriture. Vous essayez d’écrire en dehors du dossier de votre serveur, ou le disque est plein. Replacez-vous dans le dossier du serveur et vérifiez l’espace restant.

La connexion s’établit mais le dossier est vide. Vous êtes connecté à la racine de votre espace : descendez dans le dossier du serveur. Si vous administrez plusieurs serveurs, vérifiez que l’identifiant SFTP correspond bien à celui que vous voulez — chaque serveur a le sien.

Tout est correct et rien ne passe. Regardez status.cloudfive.xyz, puis ouvrez un ticket de support avec le journal de connexion de votre client SFTP : il contient la raison exacte du refus. Notez que le service doit être actif — un service suspendu coupe aussi l’accès SFTP, voir Gérer un service.