Comment ajouter un site Web dans ISPConfig 3.2

ISPConfig est un panneau de contrôle d’hébergement pour les serveurs Linux. ISPConfig propose des fonctions pour gérer les sites Web, les bases de données, les utilisateurs FTP et shell, les comptes de messagerie et les DNS. Dans ce guide, nous allons te montrer étape par étape comment ajouter un site Web, une base de données MySQL/MariaDB, un utilisateur FTP et un utilisateur SSH dans ISPConfig. Les paramètres que nous avons choisis dans ce tutoriel correspondent aux exigences des CMS typiques basés sur PHP comme WordPress, Joomla, Contao, Typo3 etc.

Conditions préalables

Les conditions préalables suivantes doivent être remplies pour suivre ce guide :

  • Serveur avec panneau de contrôle d’hébergement ISPConfig installé.
  • Un login d’administrateur, de revendeur ou de client ISPConfig. Les logins revendeur ou client doivent avoir la permission d’ajouter des sites Web activés dans les limites de leur client.
  • Un nom de domaine pour le site Web qui pointe vers le serveur avec un DNS A-Record déjà.
  • Ce tutoriel est compatible avec les serveurs Apache et Nginx.

À des fins de démonstration, le domaine ‘exemple.com’ est utilisé. Remplace exemple.com par ton propre nom de domaine partout où il apparaît ci-dessous.

Vidéo

Ce tutoriel est aussi disponible en vidéo ici :

Ajouter un site Web dans ISPConfig

Connecte-toi à l’interface web d’ISPConfig, puis va dans le module « Sites » en cliquant sur Sites dans le menu supérieur.

Module de sites ISPConfig

Clique maintenant sur le bouton vert « Ajouter un nouveau site Web ». Si tu ne vois pas ce bouton, clique sur le mot « Site Web » dans le menu à gauche.

Ajouter un site web

Le formulaire des paramètres du site Web s’affichera. Il te permet de configurer les détails du site Web. Je vais t’expliquer ci-dessous les paramètres obligatoires et recommandés.

Paramètres du site Web
Paramètres PHP

Paramètres du site Web. Si tu souhaites obtenir des explications détaillées sur tous les champs, jette un coup d’œil au Manuel ISPConfig. Je vais juste couvrir ici ce qu’il est recommandé de configurer pour un site Web typique basé sur PHP. Une remarque importante, il n’est pas recommandé d’activer des fonctions qui ne sont pas nécessaires.

  • Client: Ce champ n’apparaît que lorsque tu es connecté en tant qu’administrateur ou revendeur. Le champ peut être laissé vide. Si tu veux gérer les clients, crée d’abord un client avant de créer le site Web.
  • Adresse IPv4: Choisis * ici. Ce qui est important, c’est que tous les sites du serveur qui pointent vers la même IP utilisent soit * soit l’adresse IP, mais ne mélange pas * et IP. Je te recommande donc de toujours utiliser *, ce qui signifie que tu obtiendras un hôte virtuel basé sur le nom.
  • Domaine: Saisis le nom de domaine ici.
  • Suexec (serveurs Apache uniquement) : La case à cocher suexec doit toujours être activée, elle garantit que les scripts PHP sont exécutés sous l’utilisateur Web du site Web, ce qui permet à PHP d’écrire des fichiers (fichiers médias et mises à jour) comme l’exige tout cms moderne.
  • Sous-domaine automatique: Si ton site Web doit aussi être accessible par www.example.com, et pas seulement par exemple.com, alors règle le sous-domaine automatique sur www, sinon règle-le sur aucun.
  • SSL: Active cette case à cocher pour permettre l’accès au site par SSL (HTTPS). Il est fortement recommandé de l’activer.
  • Let’s Encrypt SSL: SSL nécessite un certificat SSL pour fonctionner. Tu peux soit avoir un certificat SSL auto-signé (qui affichera une erreur non sécurisée lorsque tu accèderas au site dans un navigateur Web), soit acheter un certificat SSL auprès d’une autorité SSL, soit obtenir un certificat SSL gratuitement, par exemple auprès de Let’s Encrypt. Et c’est pour cela que cette case à cocher est faite. En activant cette case à cocher, ISPConfig essaie d’obtenir un certificat SSL gratuit de Let’s Encrypt pour le site Web. Important : Tu obtiendras un certificat SSL Let’s Encrypt uniquement si le nom de domaine du site Web pointe déjà vers l’adresse IP de ce serveur Web. Si tu as des difficultés à obtenir un certificat SSL Let’s Encrypt (la case Let’s Encrypt est décochée environ une minute après la création du site), consulte la FAQ des erreurs Let’s Encrypt pour obtenir une liste de contrôle permettant de résoudre le problème.
  • PHP: Le mode PHP recommandé est PHP-FPM. Si tu utilises un serveur web Nginx, ce champ n’apparaîtra pas, les serveurs ISPConfig Nginx utilisent toujours PHP-FPM.
  • PHP-Version: Ce champ ne s’affiche que si tu as installé plusieurs versions de PHP. Je te recommande de toujours utiliser la version la plus élevée qui est prise en charge par le CMS ou l’application Web que tu prévois d’installer sur ce site Web. Jette un coup d’œil à la configuration requise pour le CMS afin de choisir la bonne version.
  • Actif: Pour activer le site Web.

Clique sur le bouton « Enregistrer » pour créer le site Web. Le site Web nouvellement ajouté apparaîtra dans la liste des sites Web.

Liste des sites Web dans ISPConfig

La création du site peut prendre jusqu’à une minute. Elle est terminée lorsque le point rouge disparaît dans le menu supérieur. Le nombre dans le point est le nombre de changements de configuration en attente.

ISPConfig en attente de modifications

Nous avons maintenant un site Web entièrement fonctionnel, mais la plupart des systèmes CMS nécessitent également une base de données MySQL ou MariaDB pour stocker leur contenu. Dans l’étape suivante, nous allons créer une telle base de données et un tel utilisateur de base de données.

Ajouter une base de données MySQL et un utilisateur de base de données dans ISPConfig

Dans cette étape, nous allons ajouter un nouvel utilisateur MySQL et une base de données qui seront utilisés par le système cms de ce site Web. La première étape consiste à ajouter l’utilisateur MySQL.

Clique sur« Utilisateurs de la base de données » dans le menu de gauche :

Utilisateurs de la base de données

Et ensuite sur le bouton vert« Ajouter un nouvel utilisateur » qui apparaît au milieu de la page.

Ajouter un nouvel utilisateur de la base de données

Le formulaire avec les détails de l’utilisateur de la base de données s’affiche.

Détails de l'utilisateur MySQL.

Les champs de saisie de l’utilisateur de la base de données sont expliqués en détail ci-dessous :

  • Client: Il est facultatif de choisir un client ici. Mais si tu as choisi d’attribuer le site Web à un client lors de la création du site, il est important que tu choisisses le même client (ou dans le cas de cet exemple – aucun client) ici.
  • Utilisateur de la base de données: Saisis ici le nom que recevra le nouvel utilisateur de la base de données. Un préfixe sera ajouté au nom, donc dans cet exemple, le nom de l’utilisateur de la base de données résultant sera c0mywebsite. Nous verrons cela plus tard dans la liste des utilisateurs de la base de données également. Voir le chapitre sur les préfixes à la fin du guide.
  • Mot de passe de la base de données et Répétition du mot de passe: Saisis ici deux fois un mot de passe sécurisé pour le nouvel utilisateur de la base de données. Ou utilise le bouton « Générer un mot de passe » pour en générer un. Prends soin de noter le mot de passe car tu en auras besoin plus tard lorsque tu installeras le CMS sur le site Web.

Appuie maintenant sur le bouton « Enregistrer » pour créer l’utilisateur de la base de données, tu seras redirigé vers la liste des utilisateurs de la base de données. Sache que l’utilisateur est créé dans MySQL au moment où nous l’affectons à une base de données à l’étape suivante.

Liste des utilisateurs de la base de données avec le nouvel utilisateur MySQL

Comme tu peux le voir dans la liste maintenant, le nom d’utilisateur de la base de données est « c0mywebsite » et c’est le nom que tu devras utiliser lorsque tu entreras les détails de la base de données en installant le CMS sur le site.

Maintenant, nous allons créer une base de données MySQL. Pour ce faire, clique sur« Bases de données » dans le menu de gauche.

Menu Bases de données

La liste (vide) des bases de données s’affichera. Là, tu cliques sur le bouton vert« Ajouter une nouvelle base de données« .

Ajoute une nouvelle base de données dans ISPConfig

Remplis les détails de la base de données comme indiqué ci-dessous :

Configuration de la base de données

Les paramètres de la base de données en détail :

  • Site: tu dois choisir ici le site Web auquel la base de données doit appartenir. Dans notre cas, le site Web « exemple.com ». Il est important de choisir le bon site car ce paramètre définit par exemple dans quelle sauvegarde la base de données sera placée et quelles autorisations sont définies pour l’accès à la base de données.
  • Nom de la base de données: tu saisis ici le nom que recevra la nouvelle base de données. J’utiliserai ici le nom « mywebsite ». Comme pour l’utilisateur MySQL, un préfixe est ajouté au nom de la base de données, le nom de la base de données qui en résulte sera donc « c0mywebsite ». Voir le chapitre sur les préfixes à la fin du guide.
  • Utilisateur de la base de données: Tu sélectionnes ici le nom de l’utilisateur de la base de données que nous avons créé plus tôt.
  • Actif: Doit être activé pour activer la base de données.

Appuie maintenant sur le bouton Enregistrer. Cela créera la base de données et aussi l’utilisateur de la base de données dans MySQL. Tu seras renvoyé à la liste des bases de données et notre nouvelle base de données y apparaîtra.

Base de données MySQL pour un site Web dans ISPConfig

Tu peux maintenant y accéder, par exemple via phpmyadmin, en cliquant sur le bouton phpMyAdmin dans la liste :

Bouton pour accéder à phpmyadmin

Remarque : Si tu obtiens une erreur indiquant que phpMyAdmin n’est pas trouvé, c’est que l’URL de phpMyAdmin n’a pas encore été configurée après l’installation d’ISPConfig sous Système > Interface > Configuration principale. L’URL est généralement https://server1.example.com/phpmyadmin sur les systèmes Apache et https://server1.example.com:8081/phpmyadmin sur les systèmes nginx, où server1.example.com est le nom d’hôte du serveur d’hébergement.

Accéder aux fichiers du site Web

Nous avons déjà créé un site Web et une base de données MySQL, mais pour installer un système CMS, tu dois pouvoir accéder au dossier du site Web par FTP ou SSH. Dans ce chapitre, je vais te montrer comment accorder un accès FTP (FTPS) et SSH (SFTP) au site Web.

Ajouter un utilisateur FTP dans ISPConfig

Clique sur Accès Web > Comptes FTP dans le menu sur le côté gauche pour aller à la liste des utilisateurs FTP.

Accéder au site Web par FTP dans ISPConfig

Sur la page qui s’affiche, clique sur le bouton« Ajouter un nouvel utilisateur FTP« .

FTP User list

Le formulaire des détails de l’utilisateur FTP s’affiche :

Utilisateur FTP dans ISPConfig

Les détails sur ce qu’il faut saisir dans les différents champs sont les suivants :

  • Site Web: Sélectionne ici le site Web auquel l’utilisateur FTP doit appartenir. Dans notre exemple, le site Web s’appelle « exemple.com ».
  • Nom d’utilisateur: Saisis ici un nom d’utilisateur pour l’utilisateur FTP. Un préfixe sera automatiquement ajouté au nom d’utilisateur.
  • Mot de passe et Répétition du mot de passe: Saisis ici deux fois un mot de passe sécurisé, ou utilise le bouton « Générer un mot de passe ».
  • Actif: Cette case doit être cochée pour activer l’accès FTP.

Appuie maintenant sur« Enregistrer » pour créer l’utilisateur FTP. Tu seras dirigé vers la liste des utilisateurs FTP, qui indique aussi le nom d’utilisateur FTP, préfixe compris.

Utilisateur FTP

Nous avons créé avec succès un utilisateur FTP dans ISPConfig. Cela nous permet d’accéder au site Web via n’importe quel client FTP. Les protocoles pris en charge sont FTP et FTPS (FTP over TLS). Sache que SFTP (même si le nom est similaire) est un accès aux fichiers SSH et non FTP, il faut donc un utilisateur SSH pour utiliser ce protocole (que nous créons dans le chapitre suivant).

Alors quels sont les détails qui doivent être utilisés dans un client FTP maintenant ?

  • Leserveur: Le nom du serveur FTP est le nom d’hôte du serveur car c’est le nom pour lequel le certificat SSL du serveur FTP est généralement émis. Mon serveur a le nom d’hôte « server1.example.com », je vais donc entrer « server1.example.com » lorsque le client FTP demande le nom du serveur FTP.
  • Nom d’utilisateur FTP: Le nom d’utilisateur FTP est le nom d’utilisateur complet, y compris le préfixe. Dans le cas de cet exemple, le préfixe est « default » et le nom d’utilisateur est « mywebsite ». Le nom d’utilisateur FTP à saisir dans le client FTP est donc « defaultmywebsite ». Btw. Si tu n’aimes pas les préfixes, consulte le chapitre à la fin du guide qui explique pourquoi les préfixes sont nécessaires sur la plupart des systèmes et où les désactiver et les modifier (si tu es l’administrateur du serveur).
  • Mot de passe FTP: le mot de passe que tu as défini pour cet utilisateur FTP dans le formulaire d’utilisateur FTP ci-dessus.

Alors, où télécharger les fichiers maintenant ? La racine du site Web est le dossier portant le nom« web« , dans lequel tu télécharges le fichier de ton CMS. Le dossier « web » est celui auquel tu accèdes par le navigateur Web lorsque tu entres le nom de domaine du site dans la barre d’adresse du navigateur. Si tu veux stocker des fichiers sur le site Web qui ne seront pas accessibles par un navigateur Web, tu peux les télécharger dans le dossier portant le nom« privé« .

Ajouter un utilisateur SSH / SFTP / Shell dans ISPConfig

L’ajout d’un utilisateur Shell, qui permet d’accéder au site Web par SSH et SFTP, est très similaire à l’ajout d’un utilisateur FTP. La première étape consiste à cliquer sur Ligne de commande > Shell-User dans le menu sur le côté gauche.

Utilisateur Shell dans le menu ISPConfig

La page avec les utilisateurs shell s’affiche dans la section du milieu. Là, tu cliques sur le bouton vert« Ajouter un nouvel utilisateur Shell« .

Ajouter un nouvel utilisateur SSH / SFTP dans ISPConfig

Le formulaire avec les détails de l’utilisateur shell s’affiche.

Utilisateur SSH d'ISPConfig

Les champs suivants doivent être remplis.

  • Site: tu sélectionnes ici le site Web auquel cet utilisateur SSH doit donner accès. Dans notre exemple, le site Web s’appelle exemple.com.
  • Nom d’utilisateur: Saisis ici le nom d’utilisateur souhaité. Un préfixe sera appliqué, le même que celui décrit pour l’utilisateur FTP.
  • Mot de passe et répétition du mot de passe: Saisis ici un mot de passe sécurisé pour le nouvel utilisateur SSH.
  • Chroot Shell: Si tu choisis jailkit ici, alors l’utilisateur SSH est enfermé dans la racine du site Web. C’est recommandé et cela ajoute une couche de sécurité supplémentaire, mais l’utilisateur ne peut accéder qu’aux programmes et aux fichiers qui sont installés dans sa prison. Ce champ est visible uniquement par les administrateurs, pour les clients et les revendeurs, la valeur de ce champ peut être prédéfinie par les limites du client.
  • Clé publique SSH-RSA: Si tu aimes utiliser l’authentification par clé publique pour l’accès SSH à la place ou en plus d’un mot de passe, alors tu peux entrer ta clé publique ici.

Clique maintenant sur enregistrer et l’utilisateur SSH sera créé. Cela peut prendre jusqu’à une minute, tu peux voir l’indicateur rouge clignotant dans la barre de navigation supérieure jusqu’à ce que les modifications aient été écrites sur le disque.

Shell SSH SFTP User

Avec cet utilisateur SSH, tu peux accéder au site Web avec un client SFTP (SSH File Transfer) ou tu peux utiliser la commande ssh ou un client SSH comme Putty pour obtenir un accès au terminal. Les détails à utiliser dans un client SSH ou SFTP sont les suivants :

  • Serveur: Utilise le nom d’hôte du serveur ici. Dans mon cas, le nom d’hôte est server1.example.com.
  • Nom d’utilisateur SSH: Le nom d’utilisateur SSH est le nom d’utilisateur complet, y compris le préfixe. Dans le cas de cet exemple, le préfixe est « default » et le nom d’utilisateur est « mywebsite », le nom d’utilisateur résultant est donc « defaultmywebsite ».
  • Mot de passe SSH: Le mot de passe que tu as saisi ci-dessus ou tu peux utiliser la clé SSH, au cas où tu l’aurais utilisée.

Comment accéder au dossier du site Web en tant qu’utilisateur SSH ?

La commande pour passer à un autre dossier dans le shell Linux est « cd ». Lorsque tu es connecté au site Web en tant qu’utilisateur SSH, tu atterris alors dans le dossier d’accueil de ton utilisateur SSH (qui est vide lorsque tu commences à l’utiliser). Pour aller dans le dossier Web (qui contient les fichiers du site Web), tu utilises la commande cd comme ceci :

cd ../../web/

La commande ci-dessus fonctionne pour les utilisateurs SSH emprisonnés et non emprisonnés. Pour les utilisateurs en prison, tu peux utiliser l’alternative eas :

cd /web

car le dossier racine d’un utilisateur SSH emprisonné est la racine du site Web et la racine http ou httpdocs comme on l’appelle parfois (le dossier qui contient les fichiers du site Web) est le dossier nommé ‘web’.

Préfixes des noms d’utilisateur dans ISPConfig

Pourquoi utilise-t-on des préfixes de nom d’utilisateur ? La plupart des services sous Linux qui utilisent des noms d’utilisateur et des mots de passe pour l’authentification exigent que le nom d’utilisateur soit unique sur ce serveur. ISPConfig est un panneau de contrôle d’hébergement qui peut être utilisé par plusieurs clients où chaque client ne voit que ses propres utilisateurs de cause. Maintenant, le problème suivant peut survenir : Le Client A crée un utilisateur FTP/SSH/Base de données nommé « tom ». Maintenant, le Client B se connecte à ISPConfig et essaie de créer un nouvel utilisateur FTP, nommé « tom » également. Il ne peut pas voir qu’il y a déjà un utilisateur avec le nom tom, car cet utilisateur appartient au client A. Il recevrait alors une erreur indiquant que l’utilisateur tom existe déjà, mais comme il ne peut pas voir cet utilisateur, il penserait probablement qu’il doit y avoir une panne dans le logiciel et appellerait le support de son FAI. C’est ici qu’entrent en jeu les préfixes des noms d’utilisateur, ISPConfig les configure par défaut, par exemple un « c + ID du client » ajouté devant un utilisateur de base de données ou un utilisateur de base de données ou le nom d’utilisateur du client (en cas d’absence de client, le mot par défaut) est ajouté devant un utilisateur SSH ou FTP. Cela permet à chaque client d’avoir un utilisateur ‘tom’, avec l’inconvénient que le préfixe fait partie du nom d’utilisateur pour le rendre unique. Mais tous les serveurs ISPConfig ne sont pas utilisés comme systèmes d’hébergement, tu peux par exemple utiliser ISPConfig comme panneau pour ton serveur personnel ou le serveur interne de ton entreprise, tu n’as donc pas besoin de préfixes de nom d’utilisateur et tu trouves ennuyeux qu’ISPconfig les ajoute. Mais cela peut être résolu facilement car les préfixes de nom d’utilisateur sont librement configurables dans ISPConfig. Pour les supprimer, va dans Système > Interface > Configuration principale (en étant connecté en tant qu’utilisateur admin) :

Préfixes des noms d'utilisateur

Vide tous les champs de préfixe et appuie sur le bouton d’enregistrement :

Désactiver le préfixe du nom d'utilisateur

Les préfixes de nom d’utilisateur et de nom de base de données sont maintenant désactivés. Sache que ce changement ne s’applique qu’aux utilisateurs nouvellement créés, le préfixe des utilisateurs existants n’est pas supprimé. Les noms d’utilisateur existants ne seront donc pas modifiés et leur connexion ne sera pas interrompue si tu modifies ces paramètres.

Liens

Voici quelques liens pour approfondir la lecture et obtenir de l’aide si tu as des problèmes.

Vous aimerez aussi...