Transfert de fichiers via SFTP
Comment envoyer et télécharger des fichiers depuis un serveur via WinSCP, FileZilla, le client sftp intégré et le Finder de macOS, sans confondre SFTP avec le FTP classique.
Mis à jour le 23 août 2026
SFTP est un transfert de fichiers sur la même connexion SSH. Vous n'avez pas besoin de configurer un serveur séparé : si ssh fonctionne, SFTP fonctionne aussi.
Connexion dans un client graphique
Les paramètres sont identiques pour WinSCP, FileZilla et Cyberduck :
| Champ | Valeur |
|---|---|
| Protocole | SFTP (pas FTP et pas FTPS) |
| Hôte | l'adresse de la machine depuis l'onglet « Aperçu » |
| Port | 22 |
| Utilisateur | root ou votre propre utilisateur |
| Mot de passe | le mot de passe root depuis l'onglet « Accès » |
| Clé | chemin vers la clé privée, si la connexion par mot de passe est désactivée |
WinSCP n'accepte que les clés au format .ppk — la conversion est décrite dans l'article sur PuTTY. FileZilla lit aussi une clé OpenSSH classique.
Le port 21 et le « FTP simple » ne fonctionnent pas sur la machine et vous n'avez pas besoin de les configurer : FTP envoie le mot de passe en clair. Choisissez toujours SFTP.
Client en ligne de commande
Intégré à Windows, macOS et Linux :
sftp root@203.0.113.10
Des commandes simples sont disponibles à l'intérieur :
ls
cd /var/www
lcd C:\work
put index.html
put -r ./site
get /var/log/nginx/error.log
bye
put envoie vers la machine, get récupère les fichiers sur votre ordinateur, et les commandes commençant par l (lcd, lls) agissent sur votre propre ordinateur.
Si vous avez configuré le fichier ~/.ssh/config, sftp vds suffit.
macOS et Linux dans un gestionnaire de fichiers
Dans Finder : Aller → Se connecter au serveur → sftp://root@203.0.113.10. Dans GNOME Files, saisissez l'adresse dans le champ « Autres emplacements ». Le répertoire de la machine s'ouvre comme un dossier réseau.
Pour un travail régulier, il est plus pratique de monter le répertoire comme un dossier local :
sshfs root@203.0.113.10:/var/www /mnt/vds
Où placer les fichiers
| Quoi | Où |
|---|---|
| Site web | /var/www/<domain> |
| Application ou bot | /opt/<name> |
| Fichiers personnels | le répertoire personnel de l'utilisateur |
| Temporaire | /tmp (effacé au redémarrage) |
Après le téléversement, vous devez souvent définir le propriétaire, sinon le serveur web recevra un 403 :
chown -R www-data:www-data /var/www/example.com
chmod -R 755 /var/www/example.com
Erreurs courantes
| Symptôme | Cause |
|---|---|
Permission denied à l'écriture | Le répertoire appartient à un autre utilisateur et vous ne vous êtes pas connecté en root |
| Le client ne se connecte pas, mais SSH fonctionne | FTP est sélectionné dans les paramètres au lieu de SFTP, ou le port est 21 |
| Le téléversement a réussi, mais le site ne voit pas les fichiers | Mauvais répertoire, ou le propriétaire n'est pas défini |
| Coupures sur les gros fichiers | Activez le keepalive dans le client ; pour les gros téléversements, utilisez rsync — il peut reprendre |
| Les noms de fichiers russes s'affichent mal | Réglez l'encodage UTF-8 dans les paramètres du client |
Quand SFTP n'est pas le meilleur choix
Pour des centaines de petits fichiers et des déploiements répétés, rsync est plus rapide : il ne transfère que les changements. Pour un seul fichier, scp est plus simple. Les deux commandes sont traitées dans l'article scp et rsync.