---
title: "Comment se connecter en SFTP à son serveur gaming ?"
description: "Connectez-vous en SFTP à votre serveur gaming Winheberg avec FileZilla ou WinSCP pour transférer des fichiers volumineux au-delà de la limite du panel."
category: autres
subcategory: panel-gaming
icon: tabler:file-text
date: 2026-07-24
author: Winheberg
slug: "connexion-sftp-serveur-gaming"
order: 28
image: /statics/images/docs/fr/panel-gaming/connexion-sftp-serveur-gaming.webp
tags: [sftp, filezilla, winscp, transfert de fichiers]
keywords: [sftp serveur gaming, filezilla winheberg, winscp connexion serveur, transférer fichiers volumineux, panel gaming winheberg]
link_en: "/en/docs/panel-gaming/sftp-gaming-server"
---

## 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)

> [!TIP]
> 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

1. Rendez-vous sur [filezilla-project.org](https://filezilla-project.org/)
2. Téléchargez la version **FileZilla Client** (pas le serveur)
3. Lancez l'installeur et suivez les étapes par défaut
4. Au moment de choisir, **décochez les logiciels additionnels** proposés (toolbars, antivirus, etc.) qui ne sont pas utiles

### Option B. WinSCP

1. Rendez-vous sur [winscp.net](https://winscp.net/)
2. Téléchargez la dernière version
3. Lancez l'installeur et suivez les étapes par défaut
4. Choisissez l'**interface Commander** (recommandée) ou **Explorer** selon votre préférence

> [!WARNING]
> 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.

1. Connectez-vous à votre **panel gaming Winheberg**
2. Sélectionnez votre **serveur**
3. Dans le menu latéral, cliquez sur **Settings**
4. 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) |

> [!IMPORTANT]
> 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.

1. Ouvrez **FileZilla**
2. 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 |

3. 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**.

1. Cliquez sur **Fichier → Gestionnaire de sites** (ou raccourci `Ctrl+S`)
2. Cliquez sur **Nouveau site** et donnez-lui un nom (par exemple `Winheberg - Mon serveur FiveM`)
3. 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 |

4. Cliquez sur **Connexion**

## 4. Se connecter avec WinSCP

### Première connexion

1. Lancez **WinSCP**
2. La fenêtre **Connexion** s'ouvre automatiquement
3. 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) |

4. Cliquez sur **Enregistrer** pour mémoriser la session (recommandé)
5. 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/` |

> [!NOTE]
> 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.

1. Dans le volet de gauche, naviguez jusqu'au dossier contenant votre fichier
2. Dans le volet de droite, naviguez jusqu'à l'emplacement de destination sur le serveur
3. **Glissez-déposez** le fichier (ou le dossier) du volet de gauche vers le volet de droite
4. 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.

1. Dans le volet de droite, sélectionnez le fichier à récupérer
2. **Glissez-déposez** vers le volet de gauche
3. Le téléchargement démarre

> [!TIP]
> 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 🚀