Connexion via SFTP : FileZilla, Cyberduck et ligne de commande

SFTP (Secure File Transfer Protocol) vous donne un accès direct aux fichiers de votre site sur le serveur. Ce guide couvre tout ce que vous devez savoir pour vous connecter avec succès, de la recherche de vos identifiants à la résolution des erreurs.

Ce qu'est SFTP et quand l'utiliser

Le gestionnaire de fichiers intégré à KPanel est pratique pour les modifications rapides : renommer un fichier, consulter une configuration ou télécharger un élément unique. SFTP est l'outil approprié quand vous avez besoin de plus :

• Télécharger ou télécharger un grand nombre de fichiers à la fois (migrer un site, télécharger en masse des images).
• Transférer de gros fichiers qui expirerait lors d'un téléchargement basé sur navigateur.
• Travailler dans le cadre d'un flux de développement où vous modifiez les fichiers localement et poussez les modifications.
• Utiliser un client GUI qui vous permet de garder un dossier local et distant synchronisés.
• Accéder à des journaux ou des fichiers de configuration qui ne sont pas exposés dans le gestionnaire de fichiers de KPanel.

SFTP chiffre toutes les données en transit, ce qui le rend plus sécurisé que le FTP classique. KapsuleHost n'offre pas de connexions FTP non chiffrées.

Conditions préalables

Avant de pouvoir vous connecter, vous avez besoin de deux choses.

1. Une clé SSH ajoutée à votre site dans KPanel.

SFTP sur KapsuleHost utilise l'authentification par clé SSH. L'authentification par mot de passe est désactivée pour des raisons de sécurité. Si vous n'avez pas encore ajouté votre clé publique SSH, suivez d'abord le guide Ajouter des clés SSH à votre site, puis revenir ici.

2. Votre nom d'utilisateur du site.

Chaque site sur KapsuleHost dispose d'un utilisateur système dédié. Ce n'est pas votre adresse e-mail KPanel. C'est un court nom d'utilisateur lié spécifiquement à ce site.

Pour le trouver :

1. Connectez-vous à KPanel à kpanel.kapsulehost.com.
2. Cliquez sur Websites dans la barre latérale gauche.
3. Cliquez sur le site auquel vous souhaitez vous connecter.
4. Allez à la page SSH / SFTP.
5. Votre nom d'utilisateur du site est affiché en haut de cet onglet. Il ressemble généralement à mysite_com ou myexamplesite_net.

Détails de connexion en un coup d'œil :

---

Connexion avec FileZilla

FileZilla est un client SFTP gratuit et multiplateforme disponible pour Windows, macOS et Linux. Téléchargez-le depuis filezilla-project.org si vous ne l'avez pas déjà.

Configuration étape par étape

1. Ouvrez FileZilla.

2. Allez à File > Site Manager (ou appuyez sur Ctrl+S sur Windows / Cmd+S sur Mac).

3. Cliquez sur Add Website et donnez-lui un nom (par exemple, « Mon site Kapsule »).

4. Dans l'onglet General, configurez les champs suivants :

   Champ	Valeur
   Protocol	SFTP - SSH File Transfer Protocol
   Host	cp1-kapsule.kapsulehost.com
   Port	22
   Logon Type	Key file
   User	Votre nom d'utilisateur du site (par exemple, mysite_com)
   Key file	Cliquez sur Browse et naviguez jusqu'à votre fichier de clé privée

5. Pour le fichier de clé, sélectionnez la clé privée correspondant à la clé publique que vous avez ajoutée dans KPanel. Sur macOS et Linux, les clés privées sont généralement stockées dans ~/.ssh/ (par exemple, ~/.ssh/id_ed25519 ou ~/.ssh/id_rsa). Sur Windows, elles se trouvent souvent dans C:\Users\YourName\.ssh\.

1. Cliquez sur Connect pour tester la connexion, ou cliquez sur OK pour enregistrer et vous connecter ultérieurement.

Enregistrement et reconnexion

Une fois enregistré dans le gestionnaire de sites, vous pouvez vous reconnecter à tout moment en allant à File > Site Manager et en cliquant sur Connect. FileZilla affiche également vos sites enregistrés dans la liste déroulante de la barre d'outils pour un accès rapide.

---

Connexion avec Cyberduck

Cyberduck est un client SFTP gratuit pour macOS et Windows. Téléchargez-le depuis cyberduck.io.

Configuration étape par étape

1. Ouvrez Cyberduck.

2. Cliquez sur Open Connection (l'icône du globe dans la barre d'outils).

3. Dans la liste déroulante du protocole en haut du dialogue, sélectionnez SFTP (SSH File Transfer Protocol).

4. Remplissez les champs de connexion :

   Champ	Valeur
   Server	cp1-kapsule.kapsulehost.com
   Port	22
   Username	Votre nom d'utilisateur du site (par exemple, mysite_com)
   Password	Laisser vide
   SSH Private Key	Cliquez sur Choose et sélectionnez votre fichier de clé privée

5. Cliquez sur Connect.

Lors de la première connexion, Cyberduck vous demandera de vérifier l'empreinte de la clé d'hôte du serveur. Cliquez sur Allow pour continuer. Si vous voyez cette invite lors d'une connexion ultérieure avec une empreinte différente, ne l'acceptez pas et contactez le support, car cela peut indiquer un changement de configuration.

Enregistrement en tant que signet

Pour enregistrer la connexion pour une utilisation future :

1. Après vous être connecté avec succès, allez à Bookmark > New Bookmark (ou appuyez sur Cmd+Shift+B sur Mac).
2. Donnez un nom au signet et fermez le dialogue. Le signet apparaît dans votre liste de signets Cyberduck.

---

Connexion à partir du terminal (Mac, Linux ou WSL)

Si vous préférez la ligne de commande, la commande sftp est disponible sur macOS, Linux et Windows Subsystem for Linux (WSL).

Connexion de base

sftp mysite_com@cp1-kapsule.kapsulehost.com

Remplacez mysite_com par votre vrai nom d'utilisateur du site. Si votre clé privée ne se trouve pas à l'emplacement par défaut (~/.ssh/id_rsa ou ~/.ssh/id_ed25519), spécifiez-la avec le drapeau -i :

sftp -i ~/.ssh/your_private_key mysite_com@cp1-kapsule.kapsulehost.com

Lors de la première connexion, vous serez invité à confirmer l'empreinte d'hôte du serveur. Tapez yes et appuyez sur Entrée. Ceci ne se produit qu'une seule fois par clé par appareil.

Commandes SFTP utiles

Une fois connecté, vous verrez une invite sftp>. Utilisez ces commandes pour naviguer et transférer des fichiers :

Exemple : télécharger un fichier

sftp> cd htdocs/wp-content/themes
sftp> get my-theme.zip

Exemple : télécharger un fichier

sftp> lcd ~/Desktop
sftp> cd htdocs/wp-content/uploads
sftp> put my-image.jpg

---

Où se trouvent vos fichiers

Après la connexion, vous arriverez dans le répertoire personnel de votre utilisateur du site : /home/[siteuser]/.

La structure du répertoire ressemble à ceci :

/home/mysite_com/
├── htdocs/              ← Your web root (main location for site files)
│   ├── index.php
│   ├── wp-config.php
│   ├── wp-content/
│   │   ├── themes/
│   │   ├── plugins/
│   │   └── uploads/
│   └── ...
├── logs/                ← PHP and access logs
└── tmp/                 ← Temporary files

La racine web où vit votre WordPress (ou autre application) est htdocs/. C'est le répertoire où vous passerez la plupart de votre temps. Sur certaines configurations de site, il peut s'appeler public_html/ à la place. Si vous vous connectez et voyez public_html/ plutôt que htdocs/, utilisez celui-ci.

---

Résolution des problèmes de connexion

« Connexion refusée »

La connexion a été activement rejetée avant d'être établie.

Vérifiez : Confirmez que vous utilisez l'hôte cp1-kapsule.kapsulehost.com et le port 22. Une erreur courante est de saisir le port 21 (qui est FTP, pas SFTP) ou une faute de frappe dans le nom d'hôte.

« Permission denied (publickey) »

Le serveur a accepté la tentative de connexion mais a rejeté votre authentification.

Vérifiez chacun des éléments suivants :

• Votre clé publique SSH est ajoutée dans KPanel > Websites > [site] > SSH / SFTP. Si elle n'y est pas listée, le serveur n'en a aucun enregistrement.
• Vous avez sélectionné la clé privée correcte dans FileZilla/Cyberduck, spécifiquement la clé privée qui s'apparie avec la clé publique que vous avez ajoutée à KPanel.
• Si votre clé a une phrase de passe, assurez-vous que vous la saisissez correctement.
• Si vous avez plusieurs clés, confirmez que vous ne sélectionnez pas accidentellement la mauvaise.

« Host key verification failed »

Votre client SFTP a vu une clé d'hôte différente pour ce nom d'hôte auparavant et vous avertit d'une non-concordance.

Lors de la première connexion : Vous serez invité à accepter l'empreinte. C'est normal. Cliquez sur Accept ou tapez yes.

Lors d'une connexion ultérieure avec une nouvelle empreinte : Cela peut indiquer un changement de configuration sur le serveur. Contactez le support à support@kapsulehost.com avant d'accepter, et mentionnez ce que vous avez vu.

Pour effacer une ancienne clé d'hôte dans le terminal, modifiez ~/.ssh/known_hosts et supprimez la ligne pour cp1-kapsule.kapsulehost.com.

« Could not read from remote repository » ou Mauvais répertoire

Vous avez peut-être utilisé votre adresse e-mail KPanel comme nom d'utilisateur au lieu de votre nom d'utilisateur du site.

Vérifiez : Le nom d'utilisateur doit être votre nom d'utilisateur du site (par exemple, mysite_com), pas votre adresse e-mail. Trouvez le nom d'utilisateur correct dans KPanel > Websites > [site] > SSH / SFTP.

La connexion expire

La tentative de connexion se suspend et expire sans aucune erreur.

Causes possibles :

• Votre adresse IP peut être temporairement bloquée par le pare-feu de Kapsule en raison de tentatives de connexion échouées répétées. Contactez le support à support@kapsulehost.com et demandez-leur de vérifier le journal du pare-feu.
• Un pare-feu local ou un VPN sur votre réseau peut bloquer les connexions sortantes sur le port 22. Essayez à partir d'un réseau différent (par exemple, partage de connexion mobile) pour l'exclure.

---

Articles associés

• Ajouter des clés SSH à votre site
• Utilisation du gestionnaire de fichiers dans KPanel
• Connexion à votre base de données via tunnel SSH