SSH, ou Secure Shell, est un protocole permettant de se connecter à divers services, tels que des serveurs Web. Il vous permet notamment de vous connecter à nos serveurs et de gérer votre site Web WordPress.com via des outils de ligne de commande comme WP-CLI.
Cette fonctionnalité est disponible pour les sites avec un plan WordPress.com Business ou eCommerce.
Dans ce guide
Si vous accédez au service SSH pour la première fois, vous devez créer des identifiants de connexion et activer l’accès SSH comme suit :
- Depuis votre tableau de bord WordPress.com, sélectionnez Réglages → Configuration de l’hébergement pour accéder aux options SSH de votre site.
- Si vous y êtes invité, cliquez sur Créer vos identifiants. Cette action n’est requise qu’une seule fois, pour générer l’identifiant et le mot de passe SSH pour votre site. Vous devrez les utiliser pour les connexions SFTP et SSH.
- Conservez votre mot de passe en lieu sûr. En cas de perte ou d’oubli, vous pourrez utiliser le bouton Réinitialiser le mot de passe pour en générer un nouveau.
- Sous Accès SSH, sélectionnez l’option Activer l’accès SSH pour ce site.
- Une fois l’accès SSH activé, une commande de connexion apparaît à l’écran, que vous pouvez copier/coller dans une application de terminal. Reportez-vous à la section Se connecter au service SSH pour savoir comment accéder à votre site via le service SSH.
En cas de perte ou d’oubli, vous pouvez réinitialiser votre mot de passe SFTP/SSH sous Réglages → Configuration de l’hébergement.
Dans la section Identifiants de connexion SFTP/SSH, cliquez sur Réinitialiser le mot de passe.
Pour accéder à votre site via le service SSH, vous aurez besoin de votre identifiant SSH, de votre mot de passe et d’un programme de terminal. Suivez les instructions ci-dessous pour vous connecter via les programmes les plus couramment utilisés.
- Démarrez votre application de terminal.
- Pour MacOS, sélectionnez Applications → Utilitaires pour accéder à l’application Terminal.
- Pour Linux, reportez-vous à la documentation connexe pour savoir comment ouvrir une fenêtre de terminal. Selon les versions, il est fait référence au programme de terminal sous le nom de shell, de console ou d’invite de commandes.
- Depuis votre tableau de bord WordPress.com, sélectionnez Réglages → Configuration de l’hébergement pour accéder aux options SSH de votre site.
- Dans l’écran Configuration de l’hébergement, vérifiez que l’accès SSH est activé, puis copiez la commande
ssh
fournie pour votre site. Par exemple,ssh example.wordpress.com@sftp.wp.com
.
- Copiez ou saisissez la commande
ssh
dans l’application de terminal, puis appuyez sur Entrée.- Si vous vous connectez pour la première fois, il est possible que le terminal vous indique qu’il lui est impossible d’établir l’authenticité de l’hôte. Saisissez « yes », puis appuyez sur Entrée.
- Vous devriez à présent être invité à entrer votre mot de passe. Copiez ou saisissez le mot de passe SSH obtenu lors de la création de vos identifiants SSH, puis appuyez sur Entrée.
- Notez que lors de la saisie du mot de passe, les caractères sont masqués. C’est tout à fait normal.
- En cas de perte ou d’oubli, vous pouvez toujours réinitialiser votre mot de passe SSH.
- Si l’opération réussit, vous devriez à présent être connecté au service SSH et être en mesure d’exécuter des commandes Shell et WP-CLI.
Les dernières versions de Windows, à partir de la version 10, incluent une assistance SSH via le sous-système Windows pour Linux, ainsi que le client OpenSSH. Reportez-vous à la documentation Microsoft officielle pour en savoir plus.
Notez qu’il existe une autre option, valable pour toutes les versions de Windows, qui est d’utiliser le client PuTTY.
- Téléchargez et installez le client PuTTY, disponible gratuitement.
- Lancez le client PuTTY, configurez le nom d’hôte et le port, puis cliquez sur Ouvrir.
- Nom d’hôte :
sftp.wp.com
- Port :
22
- Nom d’hôte :
- Si vous vous connectez pour la première fois, il est possible que vous soyez invité à faire confiance à l’hôte et à l’empreinte RSA II. Cliquez sur Oui.
- Un écran de terminal s’affiche alors. Saisissez votre identifiant SSH, puis appuyez sur Entrée.
- Saisissez ensuite votre mot de passe SSH.
- Si l’opération réussit, vous devriez à présent être connecté au service SSH et être en mesure d’exécuter des commandes shell et WP-CLI.
Les instructions ci-après vous permettront d’associer une clé SSH à votre compte WordPress.com. Tout simplement parce que cela est indispensable pour pouvoir ensuite l’associer à un site. Si vous n’avez pas de clé SSH sur votre ordinateur, vous pouvez tout aussi bien vous connecter au service SSH via l’authentification par mot de passe.
Pour pouvoir associer une clé SSH à votre compte WordPress.com, vous devez commencer par la copier dans le presse-papiers. Il y a plusieurs façons de le faire, à l’aide du terminal :
Mac
pbcopy < ~/.ssh/id_rsa.pub
Windows
clip < ~/.ssh/id_rsa.pub
Linux
cat ~/.ssh/id_rsa.pub
Si votre fichier de clé SSH publique utilise un nom différent de celui mentionné ci-avant, modifiez le code avec le nom de fichier approprié.
Une fois la clé SSH publique copiée dans le presse-papiers, procédez comme suit pour l’associer à votre compte :
- Depuis votre tableau de bord WordPress.com, accédez à Mon profil.
- Dans l’écran Mon profil, cliquez sur Sécurité.
- Sous Liste des mesures de sécurité, sélectionnez Clé SSH.
- Collez la clé SSH dans la zone Clé SSH publique.
- Cliquez sur le bouton Sauvegarder clé SSH.
Une fois la clé SSH associée à votre compte WordPress.com, vous pouvez l’associer à n’importe quel site.
Une fois la clé SSH associée à votre compte, vous pouvez l’associer à un site afin d’y accéder via le service SSH. Procédez comme suit pour associer la clé SSH à un site :
- Depuis votre tableau de bord WordPress.com, sélectionnez Réglages → Configuration de l’hébergement.
- Dans la section Accès SSH, sélectionnez la clé appropriée dans la liste déroulante Clés SSH.
- Cliquez sur le bouton Ajouter clé SSH au site.
Une fois la clé SSH associée au site, vous pouvez l’utiliser à des fins d’authentification via le service SSH.
Si vous ne souhaitez plus utiliser une clé SSH pour accéder à un site, vous pouvez la dissocier de ce site, comme suit :
- Depuis votre tableau de bord WordPress.com, sélectionnez Réglages → Configuration de l’hébergement.
- Dans la section Accès SSH, recherchez la clé SSH concernée.
- Cliquez sur le bouton Détacher pour dissocier la clé du site.
La clé SSH restera associée à votre compte WordPress.com jusqu’à ce que vous la supprimiez, le cas échéant.
Procédez comme suit pour mettre à jour une clé SSH publique :
- Depuis votre tableau de bord WordPress.com, accédez à Mon profil.
- Dans l’écran Mon profil, cliquez sur Sécurité.
- Sous Liste des mesures de sécurité, sélectionnez Clé SSH.
- Cliquez sur le bouton Mettre à jour clé SSH en regard de la clé concernée.
- Collez la clé SSH mise à jour dans la zone Nouvelle clé SSH publique.
- Cliquez sur le bouton Mettre à jour clé SSH pour enregistrer les modifications.
Si vous supprimez une clé SSH de votre compte WordPress.com, celle-ci sera automatiquement dissociée des sites pour lesquels elle est utilisée. Procédez comme suit pour supprimer une clé SSH de votre compte WordPress.com :
- Depuis votre tableau de bord WordPress.com, accédez à Mon profil.
- Dans l’écran Mon profil, cliquez sur Sécurité.
- Sous Liste des mesures de sécurité, sélectionnez Clé SSH.
- Cliquez sur le bouton Supprimer clé SSH en regard de la clé concernée.
- Un message de confirmation s’affiche alors. Cliquez sur OK pour confirmer la suppression.
⚠️
Il convient d’être extrêmement prudent afin de prévenir toute perte de données et de ne pas endommager votre site. Il est important de n’exécuter des commandes que si vous en connaissez exactement les effets.
Il existe un certain nombre de ressources relatives à la ligne de commande Linux. Voici quelques sources tierces parmi les plus populaires :
- Didacticiel pour débutants relatif à la ligne de commande Ubuntu
- Guide des commandes Linux sur freeCodeCamp
- LinuxCommand.org
- Cours relatif au shell Microsoft
Voici quelques-unes des commandes les plus courantes.
Commande | Description |
---|---|
ls | Afficher la liste des contenus du répertoire actuel |
cd | Changer de répertoire |
mkdir | Créer un nouveau dossier/répertoire |
touch | Créer un fichier |
rm | Supprimer un fichier |
cat | Afficher le contenu d’un fichier |
cp | Copier |
mv | Déplacer |
pwd | Afficher le répertoire actuel |
grep | Rechercher une expression spécifique dans un fichier/des lignes |
find | Rechercher dans les fichiers et répertoires |
nano | Accéder à l’éditeur de texte |
history | Afficher les 50 dernières commandes utilisées |
clear | Effacer l’écran de terminal |
du | Afficher la taille du fichier |
rsync | Copier des fichiers depuis et vers le serveur |
WP-CLI est pré-installé sur WordPress.com et étend le Shell afin de fournir des outils de ligne de commande spécifiques à WordPress. Pour pouvoir exécuter des commandes WP-CLI, vous devez toutefois d’abord suivre les instructions de la section Se connecter au service SSH.
Il existe un grand nombre de commandes et de sous-commandes que vous pouvez utiliser pour la gestion et le dépannage de votre site. Pour en savoir plus sur les commandes disponibles et comment les utiliser, reportez-vous à notre Guide WP-CLI ou à la documentation WordPress.org pour WP-CLI.
WP-CLI permet notamment de gérer les extensions et thèmes, et de résoudre les problèmes qui y sont associés.
Commande WP-CLI | Description |
---|---|
wp plugin list | Afficher la liste des extensions installées avec leur état et leur version |
wp theme list | Afficher la liste des thèmes installés |
wp plugin deactivate plugin-name | Désactiver une extension. Remplacez plugin-name par un nom d’extension tel qu’identifié via wp plugin list . Vous pouvez indiquer plusieurs noms afin de désactiver plusieurs extensions. |
wp plugin activate plugin-name | Activer une extension. Remplacez plugin-name par un nom d’extension tel qu’identifié via wp plugin list . Vous pouvez indiquer plusieurs noms afin d’activer plusieurs extensions. |
wp theme activate theme-name | Activer un thème. Remplacez theme-name par un nom de thème tel qu’identifié via wp theme list . |
wp php-errors | Afficher la liste des erreurs PHP récemment consignées. Cela peut être utile pour identifier les extensions et thèmes problématiques devant être mis à jour ou désactivés. |
Si votre site rencontre des erreurs et que vous ne pouvez pas exécuter de commandes, il peut être nécessaire d’ignorer le code d’extension et de thème. Pour ce faire, vous devez simplement ajouter --skip-themes
et --skip-plugins
à une commande WP-CLI.
Commande WP-CLI | Description |
---|---|
wp --skip-plugins --skip-themes plugin deactivate plugin-name | Ignorer le code d’extension et de thème, puis désactiver une extension. Remplacez plugin-name par un nom d’extension tel qu’identifié via wp plugin list . |
wp --skip-plugins --skip-themes theme activate theme-name | Ignorer le code d’extension et de thème, puis activer un thème. Remplacez theme-name par un nom de thème tel qu’identifié via wp theme list . |
wp --skip-plugins --skip-themes php-errors | Ignorer le code d’extension et de thème, puis afficher la liste des erreurs PHP récemment consignées. Cela peut être utile pour identifier les extensions et thèmes problématiques devant être mis à jour ou désactivés. |
- Comment utiliser WP-CLI
- Documentation WP-CLI sur WordPress.org
- Documentation WP-CLI sur WooCommerce
- WP-CLI.org
Si vous rencontrez un problème après avoir effectué des modifications via le service SSH, vous pouvez rétablir votre site à partir d’une sauvegarde Jetpack.
Si vous exécutez une commande et qu’un événement imprévu se produit, nous pouvons vous aider à rétablir votre site à une date antérieure (avant l’exécution de la commande). Toutefois, nous ne serons pas en mesure de vous aider à débugger votre commande pour la faire fonctionner correctement.
En raison de la complexité inhérente à SSH et WP-CLI, nous ne sommes pas en mesure de fournir une assistance avancée quant à l’utilisation de ces outils. L’équipe Happiness Engineers pourra vous aider avec la connexion au service SSH mais pas avec les commandes à proprement parler.
Afin de proposer un environnement sûr et performant, WordPress.com peut restreindre ou désactiver certaines commandes Shell et WP-CLI.
L’identifiant et le mot de passe sont générés automatiquement par le système. Ils sont propres à chaque site. Si vous possédez plusieurs sites, vous devrez utiliser un identifiant et un mot de passe différents pour chacun d’eux.