Contexte
Vous gérez un serveur gaming chez Winheberg (FiveM, BeamMP, Minecraft, ou autre) et vous voulez transférer des fichiers volumineux que le panel ne permet pas d'uploader directement ? Que ce soit une carte BeamMP de plusieurs centaines de Mo, un framework FiveM complet, ou un dossier de ressources entier à uploader d'un coup, le SFTP est la solution incontournable.
Le panel Winheberg impose une limite de 100 Mo par upload via l'interface web. Au-delà, ou pour gérer un grand nombre de fichiers à la fois, vous devez passer par un client SFTP comme FileZilla ou WinSCP, qui s'installent gratuitement sur votre PC.
Qu'est-ce que le SFTP et pourquoi l'utiliser ?
SFTP (SSH File Transfer Protocol) est un protocole sécurisé qui vous permet de gérer les fichiers de votre serveur distant comme s'ils étaient sur votre PC, avec un simple glisser-déposer. C'est l'équivalent du FTP mais chiffré, donc vos identifiants et vos fichiers ne transitent pas en clair sur le réseau.
Voici quelques cas d'usage typiques.
- Uploader une carte BeamMP moddée de plus de 100 Mo
- Migrer un serveur FiveM complet depuis un autre hébergeur
- Téléverser plusieurs ressources d'un coup sans devoir cliquer sur chaque fichier
- Télécharger une sauvegarde complète de votre serveur sur votre PC
- Modifier des fichiers de config plus rapidement qu'avec l'éditeur web du panel
Prérequis
Avant de commencer, assurez-vous d'avoir les éléments suivants.
- Un serveur gaming actif sur votre panel Winheberg (FiveM, BeamMP, etc.)
- FileZilla ou WinSCP installé sur votre PC (les deux sont gratuits et open-source)
- Le mot de passe de votre compte panel Winheberg (c'est le même qui sera utilisé pour le SFTP)
Si vous hésitez entre les deux clients, FileZilla est multiplateforme (Windows, Mac, Linux) et a une interface très intuitive pour les débutants. WinSCP est exclusif à Windows mais propose plus d'options avancées (synchronisation automatique, scripts, éditeur de texte intégré). Vous pouvez très bien commencer avec l'un puis basculer sur l'autre.
1. Télécharger et installer un client SFTP
Option A. FileZilla
- Rendez-vous sur filezilla-project.org
- Téléchargez la version FileZilla Client (pas le serveur)
- Lancez l'installeur et suivez les étapes par défaut
- Au moment de choisir, décochez les logiciels additionnels proposés (toolbars, antivirus, etc.) qui ne sont pas utiles
Option B. WinSCP
- Rendez-vous sur winscp.net
- Téléchargez la dernière version
- Lancez l'installeur et suivez les étapes par défaut
- Choisissez l'interface Commander (recommandée) ou Explorer selon votre préférence
Téléchargez uniquement depuis les sites officiels des deux éditeurs. Évitez les sites de téléchargement tiers qui peuvent ajouter des malwares ou des barres d'outils indésirables dans l'installeur.
2. Récupérer vos identifiants SFTP dans le panel
Tous vos identifiants SFTP sont disponibles directement dans le panel Winheberg.
- Connectez-vous à votre panel gaming Winheberg
- Sélectionnez votre serveur
- Dans le menu latéral, cliquez sur Settings
- Repérez la section SFTP Details (ou équivalent)
Vous y trouverez les 3 informations clés.
| Champ | Description |
|---|---|
| SFTP Address | L'adresse du serveur SFTP (au format hostname ou sftp://hostname:port) |
| Port | Le port à utiliser (différent du port standard 22) |
| Username | Votre nom d'utilisateur SFTP (généralement votre identifiant suivi du numéro de serveur) |
Le mot de passe SFTP n'est pas affiché dans cette section. C'est normal, il est identique au mot de passe de votre compte panel Winheberg. Si vous l'avez oublié, vous pouvez le réinitialiser depuis la section Account du panel.
3. Se connecter avec FileZilla
Connexion rapide (Quick Connect)
Pour une connexion ponctuelle, la barre de connexion rapide en haut de FileZilla suffit.
- Ouvrez FileZilla
- Dans la barre du haut, remplissez les champs comme indiqué dans le tableau ci-dessous.
| Champ FileZilla | Valeur à saisir |
|---|---|
| Hôte | Recopiez l'adresse SFTP affichée dans votre panel |
| Identifiant | Votre username SFTP |
| Mot de passe | Votre mot de passe panel Winheberg |
| Port | Le port SFTP fourni dans votre panel |
- Cliquez sur Connexion rapide
À la première connexion, FileZilla vous demande de valider la clé SSH du serveur. Cochez la case Toujours faire confiance à cet hôte et cliquez sur OK.
Connexion persistante (Gestionnaire de sites)
Pour ne pas avoir à retaper les infos à chaque fois, enregistrez votre serveur dans le Gestionnaire de sites.
- Cliquez sur Fichier → Gestionnaire de sites (ou raccourci
Ctrl+S) - Cliquez sur Nouveau site et donnez-lui un nom (par exemple
Winheberg - Mon serveur FiveM) - Dans l'onglet Général, configurez les champs comme indiqué ci-dessous.
| Champ FileZilla | Valeur à saisir |
|---|---|
| Protocole | SFTP - SSH File Transfer Protocol |
| Hôte | Votre SFTP Address |
| Port | Votre port SFTP |
| Type d'authentification | Demander le mot de passe (ou Normale si vous voulez le sauvegarder) |
| Identifiant | Votre username SFTP |
- Cliquez sur Connexion
4. Se connecter avec WinSCP
Première connexion
- Lancez WinSCP
- La fenêtre Connexion s'ouvre automatiquement
- Remplissez les champs comme indiqué dans le tableau ci-dessous.
| Champ WinSCP | Valeur à saisir |
|---|---|
| Protocole de fichier | SFTP |
| Nom d'hôte | Votre SFTP Address |
| Numéro de port | Votre port SFTP |
| Nom d'utilisateur | Votre username SFTP |
| Mot de passe | Votre mot de passe panel (ou laissez vide pour qu'il vous le demande à chaque connexion) |
- Cliquez sur Enregistrer pour mémoriser la session (recommandé)
- Cliquez sur Se connecter
À la première connexion, WinSCP vous demande de valider la clé SSH du serveur. Cliquez sur Oui pour l'accepter.
Reconnexion rapide
Lors des prochaines utilisations, vous retrouverez votre session enregistrée dans la liste de gauche au lancement de WinSCP. Un double-clic dessus suffit pour vous reconnecter.
5. Naviguer dans les fichiers du serveur
Une fois connecté, vous voyez deux volets côte à côte.
- Le volet de gauche affiche vos fichiers locaux (votre PC)
- Le volet de droite affiche les fichiers de votre serveur Winheberg
La racine de votre serveur se trouve dans le dossier /home/container/. C'est là que vous trouverez les fichiers essentiels selon votre type de serveur.
| Type de serveur | Fichiers typiques |
|---|---|
| FiveM | server.cfg, dossier resources/ |
| BeamMP | ServerConfig.toml, dossier Resources/Client/ et Resources/Server/ |
| Minecraft | server.properties, dossier plugins/, mods/, ou world/ |
Certains dossiers comme txData/ (pour FiveM) ou les binaires du serveur sont gérés automatiquement par Winheberg. Ne les modifiez pas sauf si vous savez exactement ce que vous faites.
6. Transférer des fichiers
Upload (vers le serveur)
Pour envoyer un fichier de votre PC vers votre serveur.
- Dans le volet de gauche, naviguez jusqu'au dossier contenant votre fichier
- Dans le volet de droite, naviguez jusqu'à l'emplacement de destination sur le serveur
- Glissez-déposez le fichier (ou le dossier) du volet de gauche vers le volet de droite
- Le transfert démarre, vous voyez la progression en bas de l'écran
Download (depuis le serveur)
Pour télécharger un fichier du serveur vers votre PC, c'est l'inverse.
- Dans le volet de droite, sélectionnez le fichier à récupérer
- Glissez-déposez vers le volet de gauche
- Le téléchargement démarre
Pour les gros transferts (plusieurs Go ou des milliers de fichiers), les deux clients gèrent une file d'attente qui reprend automatiquement en cas de coupure de connexion. Vous pouvez lancer un gros upload et laisser tourner pendant que vous faites autre chose.
En cas de problème
Voici les erreurs les plus fréquentes lors d'une connexion SFTP.
❌ Authentication failed / Mot de passe incorrect
Si votre mot de passe est refusé.
- Vérifiez que vous utilisez bien le mot de passe de votre compte panel (pas un mot de passe MySQL ou autre)
- Vérifiez que vous n'avez pas d'espace accidentel avant ou après le mot de passe
- Si vous avez changé récemment votre mot de passe panel, le mot de passe SFTP a changé en même temps
- Réinitialisez votre mot de passe panel et réessayez
❌ Connection refused / Connection timed out
Si la connexion ne s'établit pas du tout.
- Vérifiez que vous utilisez le bon port (pas le 22 par défaut, mais celui fourni par le panel)
- Vérifiez l'adresse SFTP recopiée depuis le panel (pas de faute de frappe)
- Vérifiez que votre serveur est bien actif dans le panel
- Vérifiez que votre firewall local ou votre VPN ne bloque pas la connexion sortante
❌ Host key has changed / Clé SSH différente
Si vous voyez un avertissement sur la clé SSH après une mise à jour.
- C'est normal après certaines maintenances côté Winheberg
- Validez la nouvelle clé en cliquant sur Oui ou Accepter
- Si le message persiste sans raison, supprimez l'ancienne clé dans les paramètres du client (FileZilla, menu Édition → Paramètres → Connexion → SFTP)
❌ Le transfert est très lent
Si vos uploads ou downloads sont anormalement lents.
- Vérifiez votre propre connexion Internet (test sur fast.com ou speedtest.net)
- Évitez les transferts à plusieurs fichiers en parallèle qui peuvent saturer votre bande passante
- Pour les gros fichiers, désactivez temporairement votre antivirus qui peut scanner chaque paquet (à réactiver après)
❌ Permission denied lors d'un upload
Si vous obtenez un refus d'accès en écriture.
- Vérifiez que vous tentez d'écrire dans
/home/container/ou ses sous-dossiers - Certains dossiers système ne sont pas modifiables par le client
- Si le problème persiste, contactez notre support
Bonnes pratiques
Quelques recommandations pour utiliser le SFTP sereinement.
- Sauvegardez votre serveur avant d'écraser des fichiers importants via SFTP
- Ne supprimez jamais des fichiers dont vous ne connaissez pas la fonction (en cas de doute, contactez notre support)
- Ne modifiez pas les fichiers des binaires du serveur (artifacts FiveM, BeamMP-Server, etc.), Winheberg les gère automatiquement
- Utilisez le Gestionnaire de sites pour enregistrer vos serveurs et gagner du temps
- Ne partagez jamais vos identifiants SFTP, ils donnent un accès complet à vos fichiers serveur
- Activez la 2FA sur votre compte panel pour ajouter une couche de sécurité
Besoin d'aide ?
Si vous n'arrivez pas à vous connecter en SFTP malgré ces étapes, ou si vous avez un doute sur les fichiers à modifier, notre équipe est là. Ouvrez un ticket dans le département Technique depuis votre espace client et renseignez le champ Produit lié avec le serveur concerné.
Votre serveur est maintenant accessible en SFTP, prêt pour vos transferts de fichiers volumineux 🚀
