Comment gérer vos accès FTP et SFTP sous ISPConfig ?

Procédure

Un accès FTP ou SFTP permet de transférer les fichiers d’un site entre votre ordinateur et votre serveur VPS. Vous pouvez notamment l’utiliser pour publier un site, modifier ses fichiers ou donner un accès distinct à un prestataire.

Cette aide explique comment créer un utilisateur FTP ou SFTP, modifier le mot de passe d’un compte FTP et configurer la connexion dans FileZilla.

Avant de commencer

Le site auquel vous souhaitez donner accès doit déjà être créé dans ISPConfig. Vous devez également disposer des droits nécessaires pour gérer ce site.

Pour tester la connexion depuis votre ordinateur, installez un logiciel compatible FTP et SFTP, par exemple FileZilla.

Choisir entre FTP et SFTP

FTP et SFTP permettent tous les deux de transférer des fichiers, mais ils n’utilisent pas le même type de compte dans ISPConfig.

Une connexion FTP peut être chiffrée lorsqu’elle utilise le protocole FTPS, généralement sous la forme d’une connexion FTP explicite sur TLS. Le SFTP utilise quant à lui le protocole SSH : il s’agit donc d’une technologie différente.

Lorsque cela est possible, privilégiez le SFTP. À défaut, utilisez une connexion FTP explicite sur TLS plutôt qu’une connexion FTP non chiffrée.

Créer un utilisateur FTP

1. Dans ISPConfig, ouvrez le menu Sites (1).
2. Dans le menu de gauche, cliquez sur Utilisateur FTP (2).
   
3. Cliquez sur Nouvel utilisateur FTP.
4. Dans le champ Site web, sélectionnez le site auquel cet utilisateur doit pouvoir accéder.
   
5. Saisissez le nom d’utilisateur souhaité.
6. Saisissez un mot de passe suffisamment long et difficile à deviner, puis confirmez-le si ISPConfig affiche un second champ.

7. Cliquez sur Enregistrer.

Le nouvel utilisateur apparaît ensuite dans la liste des utilisateurs FTP.

Paramètres de connexion FTP

Pour vous connecter avec cet utilisateur, utilisez les paramètres suivants :

• Protocole : FTP ;
• Chiffrement : utiliser une connexion FTP explicite sur TLS si disponible ;
• Hôte : adresse IP ou nom d’hôte de votre VPS ;
• Port : 21 ;
• Identifiant : nom complet de l’utilisateur affiché dans ISPConfig ;
• Mot de passe : mot de passe défini lors de la création du compte.

Si votre domaine ne pointe pas encore vers le VPS, utilisez l’adresse IP du serveur comme hôte de connexion.

Pour apprendre à configurer FileZilla, Cyberduck ou WinSCP et transférer les fichiers de votre site, consultez : Comment publier un site par FTP avec FileZilla, Cyberduck ou WinSCP ?

Une fois connecté, les fichiers publics du site se trouvent dans le dossier web.

Modifier le mot de passe d’un utilisateur FTP

Vous pouvez modifier le mot de passe d’un utilisateur FTP si celui-ci a été oublié, communiqué à une autre personne ou enregistré dans un logiciel auquel vous n’avez plus accès.

1. Dans ISPConfig, ouvrez le menu Sites (1).
2. Cliquez sur Utilisateur FTP (2) dans le menu de gauche.
   
3. Dans la liste, cliquez sur l’utilisateur à modifier (3).
4. Saisissez le nouveau mot de passe, puis confirmez-le dans le second champ.
   
5. Cliquez sur Enregistrer.

Créer un utilisateur pour une connexion SFTP

Une connexion SFTP utilise un utilisateur Shell et non un utilisateur FTP.

1. Dans ISPConfig, ouvrez le menu Sites (1).
2. Dans le menu de gauche, cliquez sur Utilisateur Shell (2).
   
3. Cliquez sur Nouvel utilisateur Shell (3).
4. Dans le champ Site web, sélectionnez le site auquel l’utilisateur doit pouvoir accéder.
   
5. Saisissez le nom de l’utilisateur.

Comme pour un utilisateur FTP, ISPConfig peut ajouter automatiquement un préfixe au nom choisi. Utilisez toujours le nom complet affiché dans le panel.

6. Saisissez le mot de passe, puis confirmez-le.
7. Cliquez sur Enregistrer.

Le compte apparaît ensuite dans la liste des utilisateurs Shell.

Paramètres de connexion SFTP

Pour vous connecter avec cet utilisateur, utilisez les paramètres suivants :

• Protocole : SFTP – SSH File Transfer Protocol ;
• Hôte : adresse IP de votre VPS ;
• Port :
  • VPS non infogéré : 22 par défaut, sauf si vous avez modifié le port SSH ;
  • VPS infogéré ancien : 5804 ;
  • VPS infogéré récent : 22 ou 5804 ;
• Type d’authentification : normale ou par mot de passe ;
• Identifiant : nom complet de l’utilisateur Shell affiché dans ISPConfig ;
• Mot de passe : mot de passe défini lors de la création du compte.

Vous pouvez utiliser FileZilla ou un autre logiciel compatible SFTP. Le principe de navigation et de transfert des fichiers est similaire à celui présenté dans l’aide suivante : Comment publier un site par FTP avec FileZilla, Cyberduck ou WinSCP ?

Lors de la première connexion SFTP, le logiciel peut afficher la clé d’identification du serveur. Vérifiez que vous vous connectez à l’adresse IP de votre VPS avant de l’accepter.

Vérifier que l’accès fonctionne

L’accès est correctement configuré lorsque votre logiciel affiche les dossiers du site sans erreur d’authentification.

Avec un compte FTP, ouvrez le dossier web pour retrouver les fichiers publics du site.

Vous pouvez également transférer un petit fichier de test, vérifier qu’il apparaît sur le serveur, puis le supprimer.

Problèmes fréquents

Je reçois une erreur d’identifiant ou de mot de passe

Vérifiez que vous utilisez le nom complet affiché dans ISPConfig. Celui-ci peut contenir un préfixe ajouté automatiquement par le panel.

Retapez manuellement le mot de passe afin d’éviter les espaces ajoutés lors d’un copier-coller.

Assurez-vous également d’utiliser le compte adapté au protocole choisi :

• un Utilisateur FTP pour une connexion FTP ou FTPS ;
• un Utilisateur Shell pour une connexion SFTP.

La connexion ne fonctionne plus après le changement du mot de passe

Votre logiciel utilise probablement encore l’ancien mot de passe enregistré.

Ouvrez les paramètres de la connexion concernée et remplacez l’ancien mot de passe. Vous pouvez également supprimer le mot de passe enregistré afin que le logiciel vous le demande lors de la prochaine connexion.

La connexion est refusée

Vérifiez que le protocole et le port correspondent au type de compte utilisé :

• FTP ou FTPS : port 21 ;
• SFTP sur un VPS non infogéré : port 22 par défaut, ou le port SSH personnalisé ;
• SFTP sur un VPS infogéré ancien : port 5804 ;
• SFTP sur un VPS infogéré récent : port 22 ou 5804.

Vérifiez également que vous utilisez le bon type de compte : un utilisateur FTP pour FTP ou FTPS, et un utilisateur Shell pour SFTP.

Contrôlez également que l’adresse IP ou le nom d’hôte correspond au VPS sur lequel le compte a été créé.

Je suis connecté, mais je ne vois pas les fichiers de mon site

Avec un compte FTP, ouvrez le dossier web.

Si les fichiers attendus ne sont pas présents, vérifiez dans ISPConfig que l’utilisateur a été associé au bon site web.

Je ne vois pas le menu Utilisateur Shell

Le compte utilisé pour accéder à ISPConfig ne dispose peut-être pas des droits nécessaires pour créer un utilisateur Shell.

Reconnectez-vous avec un compte autorisé à administrer le site ou demandez à l’administrateur du VPS de créer l’accès SFTP.