Le gestionnaire de fichiers du panel est parfait pour éditer serverconfig.json. Mais pour envoyer un modpack de 40 mods ou un monde de 3 Go, rien ne vaut le SFTP. Ce guide vous montre comment vous connecter à votre serveur Vintage Story avec FileZilla ou WinSCP en deux minutes.
Pourquoi utiliser le SFTP ?
| Usage | Gestionnaire de fichiers (navigateur) | SFTP |
|---|---|---|
Éditer serverconfig.json | ✅ Idéal | ✅ |
| Envoyer 1 ou 2 mods | ✅ | ✅ |
| Envoyer un modpack complet | ⚠️ Lent | ✅ Glisser-déposer du dossier |
| Importer / télécharger un monde de plusieurs Go | ❌ Risque d’échec | ✅ Reprise en cas de coupure |
| Récupérer toutes les sauvegardes | ⚠️ | ✅ |
Étape 1 : récupérer vos identifiants
Dans le panel manage.hebergtonserv.com, ouvrez votre serveur puis Système → Details SFTP. Vous y trouvez :
| Information | Exemple | Remarque |
|---|---|---|
| Adresse de connexion | sftp://game2.hebergtonserv.com:2022 | Hôte + port |
| Nom d’utilisateur | [email protected] | À copier en entier |
| Mot de passe | — | Le même que celui du panel |
⚠️ SFTP, pas FTP
Le serveur utilise le protocole SFTP sur le port 2022. Le FTP classique (port 21) et le FTPS ne fonctionnent pas : ce sont des protocoles différents.
Le bouton Lancer SFTP du panel ouvre directement votre client SFTP par défaut, s’il en existe un sur votre ordinateur.
Étape 2 : se connecter avec FileZilla
- Téléchargez FileZilla Client sur le site officiel (filezilla-project.org) et installez-le
- Ouvrez Fichier → Gestionnaire de sites → Nouveau site
- Remplissez :
| Champ | Valeur |
|---|---|
| Protocole | SFTP - SSH File Transfer Protocol |
| Hôte | game2.hebergtonserv.com (celui de votre panel) |
| Port | 2022 |
| Type d’authentification | Normale |
| Identifiant | Votre nom d’utilisateur SFTP complet |
| Mot de passe | Votre mot de passe du panel |
- Cliquez sur Connexion
- À la première connexion, FileZilla affiche la clé du serveur : cochez Toujours faire confiance puis validez
Les fichiers de votre serveur apparaissent dans le panneau de droite, ceux de votre PC à gauche.
Alternative : WinSCP (Windows)
- Installez WinSCP (winscp.net)
- Dans la fenêtre de connexion, choisissez Protocole de fichier : SFTP
- Nom d’hôte : l’hôte du panel, Numéro de port :
2022 - Nom d’utilisateur et Mot de passe : comme ci-dessus
- Sauver puis Connexion
Étape 3 : ce que vous trouverez sur le serveur
| Élément | Contenu |
|---|---|
serverconfig.json | Configuration du serveur (guide) |
Mods/ | Vos mods en .zip (guide) |
ModConfig/ | Réglages des mods |
Saves/ | Le monde, default.vcdbs |
Backups/ | Sauvegardes créées avec /genbackup |
Logs/ | Journaux du serveur, utiles en cas de crash |
L’emplacement exact peut varier selon l’installation : repérez le dossier qui contient serverconfig.json, c’est la racine des données.
Cas pratiques
Envoyer un modpack
- Arrêtez le serveur depuis la console du panel (bouton Arrêter)
- Glissez tous vos
.zipdepuis votre PC vers le dossierMods/ - Attendez la fin de la file de transfert (en bas de FileZilla)
- Redémarrez et vérifiez la console
Importer un monde solo
- Arrêtez le serveur
- Envoyez votre fichier
.vcdbsdansSaves/ - Renommez-le en
default.vcdbs(clic droit → Renommer) après avoir renommé ou supprimé l’ancien - Redémarrez
Détails dans sauvegarder et importer un monde.
Récupérer ses sauvegardes en local
Faites un /genbackup dans la console, puis téléchargez le fichier depuis Backups/ vers votre PC. Une sauvegarde hors du serveur est la meilleure assurance contre les imprévus.
🚨 Serveur arrêté pour toute modification
Modifier serverconfig.json, le monde ou les mods pendant que le serveur tourne peut écraser vos changements ou corrompre le monde. Arrêter → transférer → démarrer. Et utilisez le bouton Arrêter, pas Tuer, qui coupe le serveur sans sauvegarder.
Dépannage
« Connection refused » / délai dépassé
- Le port est-il bien
2022? - Le protocole est-il SFTP (et pas FTP) ?
« Authentication failed »
- Le nom d’utilisateur doit être copié en entier, y compris la partie après le dernier point
- Le mot de passe est celui du panel. Si vous l’avez changé récemment, utilisez le nouveau
- Si vous êtes sous-utilisateur, vérifiez que le propriétaire du serveur vous a donné l’accès aux fichiers
Transfert qui échoue sur un gros fichier Relancez le transfert : FileZilla propose de reprendre là où il s’était arrêté.
Questions fréquentes
Quels identifiants utiliser pour le SFTP ?
Ceux affichés dans Système → Details SFTP du panel. Le mot de passe est celui de votre compte du panel.
Pourquoi FileZilla n’arrive pas à se connecter ?
Protocole SFTP (pas FTP), port 2022, nom d’utilisateur complet, mot de passe du panel.
Faut-il arrêter le serveur avant d’envoyer des fichiers ?
Oui pour la configuration, le monde et les mods. Télécharger des logs ou des sauvegardes peut se faire serveur allumé.
Accès SFTP, gestionnaire de fichiers et sauvegardes inclus : découvrez comment choisir votre hébergeur Vintage Story.
Équipe HebergTonServ
Administrateurs serveurs de jeux
