VS Code et SFTP : modifier son site en ligne

Ce guide suit la page de l'extension sur le Marketplace et son wiki, pages Common Configuration et Commands, relus le 15 octobre 2026. La version en cours est la 1.16.3, la dernière publiée sur son dépôt. Cette extension reprend celle de liximomo, qui n'est plus maintenue : vérifiez l'éditeur, Natizyskunk, avant d'installer.

Avant de commencer

Réglage	Valeur chez Hubspace
Protocole	sftp
Hôte	hub.hubspace.fr
Port	22
Identifiant	l'utilisateur système de votre abonnement, affiché dans Plesk
Dossier distant	celui de httpdocs, le dossier publié du site

L'accès SSH doit être autorisé dans Plesk, rubrique « Accès SSH » : c'est ce réglage qui ouvre SFTP. Où le trouver, et où lire l'identifiant, est expliqué dans Se connecter à son hébergement en SFTP. Le FTP sur le port 21 n'est pas un accès disponible chez nous, même si l'extension sait le parler : restez en sftp.

Sur le serveur, le dossier publié se trouve sous /var/www/vhosts/votre-domaine.fr/httpdocs. Selon le réglage de l'accès SSH, votre logiciel de transfert peut montrer un chemin plus court, comme /httpdocs. Le plus sûr est de vous connecter une fois avec FileZilla ou Cyberduck et de recopier le chemin qu'il affiche.

Installer l'extension

Dans VS Code, ouvrez la vue Extensions (Ctrl+Maj+X, ou Commande+Maj+X sur Mac).
Cherchez « SFTP », et choisissez celle publiée par Natizyskunk.
Cliquez sur Install.

Écrire le fichier de configuration

Ouvrez dans VS Code le dossier de votre site sur votre ordinateur (Fichier, puis Ouvrir le dossier).
Ouvrez la palette de commandes (Ctrl+Maj+P, ou Commande+Maj+P sur Mac).
Lancez « SFTP: Config ». L'extension crée le fichier .vscode/sftp.json.
Remplacez son contenu par ce modèle, adapté à votre abonnement :

{
  "name": "Mon site",
  "protocol": "sftp",
  "host": "hub.hubspace.fr",
  "port": 22,
  "username": "votre-utilisateur-systeme",
  "remotePath": "/var/www/vhosts/votre-domaine.fr/httpdocs",
  "uploadOnSave": false,
  "ignore": [".vscode", ".git", ".DS_Store"]
}

Enregistrez le fichier.

Il n'y a pas de ligne password dans ce modèle, et c'est voulu. Le wiki de l'extension prévient que les mots de passe y sont stockés en clair, et précise que le champ est facultatif : sans lui, l'extension demande le mot de passe au moment de se connecter. Si le dossier de votre site est versionné avec Git, ajoutez aussi .vscode/sftp.json à votre fichier .gitignore.

Envoyer et récupérer des fichiers

Les commandes se lancent depuis la palette de commandes ; celles qui portent sur un dossier visent le dossier sélectionné dans l'explorateur :

Commande	Effet
SFTP: Upload Active File	envoie le fichier ouvert
SFTP: Upload Active Folder	envoie le dossier sélectionné
SFTP: Download Active File	récupère la version du serveur
SFTP: Sync Remote -> Local	recopie le serveur sur votre ordinateur
SFTP: Sync Local -> Remote	recopie votre ordinateur sur le serveur

Pour démarrer depuis le site en ligne, lancez d'abord « SFTP: Sync Remote -> Local » dans un dossier vide : vous travaillez ensuite sur une copie fidèle.

La synchronisation dans le sens local vers serveur remplace ce qui est en ligne. Avant de la lancer sur un site en production, faites une copie : voir Sauvegarder son site WordPress pour un WordPress.

Envoyer à chaque enregistrement

Passez uploadOnSave à true dans sftp.json : chaque fichier enregistré dans VS Code part aussitôt sur le serveur. C'est pratique pour une feuille de style ou un gabarit, mais une erreur enregistrée est en ligne dans la seconde. Sur un site qui reçoit du monde, travaillez plutôt sur une copie de test, puis envoyez quand tout est prêt.

Si la connexion échoue

Symptôme	Cause probable	Que faire
Délai dépassé	hôte faux, ou domaine derrière le proxy de Cloudflare	utilisez hub.hubspace.fr
Connexion refusée	accès SSH non autorisé, ou offre Départ	réglez « Accès SSH » dans Plesk
Authentification refusée	identifiant ou mot de passe faux	vérifiez l'utilisateur système, voir Changer le mot de passe FTP
Fichiers envoyés au mauvais endroit	remotePath faux	recopiez le chemin affiché par votre logiciel de transfert

Plusieurs échecs d'identification de suite bloquent votre adresse IP un moment, par sécurité.

Questions fréquentes

Puis-je utiliser cette méthode sur l'offre Départ ?

Non, SFTP n'est pas ouvert sur Départ. Les fichiers passent alors par le gestionnaire de fichiers de Plesk, dans le navigateur : voir Gestionnaire de fichiers Plesk.

Et l'extension Remote - SSH de Microsoft ?

Elle n'envoie pas des fichiers : d'après sa documentation, elle installe VS Code Server sur la machine distante et y fait tourner les commandes et les extensions. Elle convient à un serveur VPS, où vous avez la main sur le système. Sur un hébergement mutualisé, l'extension SFTP, qui ne fait que transférer des fichiers, est la voie adaptée.

Comment déployer un site versionné avec Git ?

Plutôt que de synchroniser à la main, Plesk peut récupérer votre dépôt et publier ses fichiers à chaque envoi, sur toutes nos offres : voir Déploiement Git : mettre son site en ligne.