Comment ajouter un site Web dans ISPConfig 3.2

ISPConfig est un panneau de contrôle d’hébergement pour serveurs Linux. ISPConfig fournit des fonctions pour gérer des sites Web, des bases de données, des utilisateurs FTP et shell, des comptes de messagerie et DNS. Dans ce guide, nous allons vous 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.

Prérequis

Les prérequis suivants doivent être remplis pour suivre ce guide :

• Serveur avec le panneau de contrôle d’hébergement ISPConfig installé.
  Si vous n’avez pas encore installé ISPConfig, veuillez suivre le guide d’installation d’ISPConfig.
• Un identifiant admin, revendeur ou client ISPConfig. Les identifiants de revendeur ou de client doivent avoir l’autorisation d’ajouter des sites Web activée dans leurs limites de client.
• Un nom de domaine pour le site Web qui pointe vers le serveur avec un enregistrement DNS A déjà configuré.
• Ce tutoriel est compatible avec les serveurs Apache et Nginx.

À des fins de démonstration, le domaine ‘example.com’ est utilisé. Remplacez example.com par votre propre nom de domaine chaque fois qu’il apparaît ci-dessous.

Vidéo

Ce tutoriel est également disponible sous forme de vidéo sur YouTube. Cliquez ici : https://www.youtube.com/watch?v=v8cKGK-YPLU pour ouvrir la vidéo sur YouTube.

Ajouter un site Web dans ISPConfig

Connectez-vous à l’interface Web d’ISPConfig, puis allez dans le module “Sites” en cliquant sur Sites dans le menu supérieur.

Cliquez maintenant sur le bouton vert “Ajouter un nouveau site Web”. Si vous ne voyez pas ce bouton, cliquez sur le mot “Site Web” dans le menu à gauche.

Le formulaire de paramètres du site Web apparaîtra. Il vous permet de configurer les détails du site Web. Je vais expliquer les paramètres requis et recommandés ci-dessous.

Paramètres du site Web. Si vous souhaitez obtenir des explications détaillées sur tous les champs, veuillez consulter le manuel d’ISPConfig. Je vais juste couvrir ce qui est recommandé d’être configuré pour un site Web typique basé sur PHP ici. Une note importante, il n’est pas recommandé d’activer des fonctionnalités qui ne sont pas nécessaires.

• Client : Ce champ n’apparaît que lorsque vous êtes connecté en tant qu’administrateur ou revendeur. Le champ peut être laissé vide. Si vous souhaitez gérer des clients, créez d’abord un client avant de créer le site Web.
• Adresse IPv4 : Choisissez 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élangent pas et IP. Par conséquent, je recommande toujours d’utiliser , ce qui signifie que vous obtenez un hôte virtuel basé sur le nom.
• Domaine : Entrez 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, permettant ainsi à PHP d’écrire des fichiers (fichiers multimédias et mises à jour) comme requis par tout CMS moderne.
• Sous-domaine automatique : Si votre site Web doit être accessible par www.example.com également, et pas seulement example.com, alors définissez le sous-domaine automatique sur www, sinon définissez-le sur aucun.
• SSL : Activez cette case à cocher pour permettre l’accès au site par SSL (HTTPS). Il est fortement recommandé de l’activer.
• SSL Let’s Encrypt : SSL nécessite un certificat SSL dit pour fonctionner. Vous pouvez soit avoir un certificat SSL auto-signé (qui affichera une erreur d’insecure lorsque vous accédez au site dans un navigateur Web), soit vous pouvez acheter un certificat SSL auprès d’une autorité SSL, ou vous pouvez obtenir un certificat SSL gratuit par exemple de Let’s Encrypt. Et c’est à cela que sert cette case à cocher. En activant cette case à cocher, ISPConfig essaie d’obtenir un certificat SSL Let’s Encrypt gratuit pour le site Web. Important : Vous obtiendrez un certificat SSL Let’s Encrypt uniquement lorsque le nom de domaine du site Web pointe déjà vers l’adresse IP de ce serveur Web. Si vous avez des problèmes pour obtenir un certificat SSL Let’s Encrypt (la case à cocher Let’s Encrypt est décochée environ une minute après avoir créé le site), consultez la FAQ sur les erreurs Let’s Encrypt pour une liste de contrôle afin de déboguer le problème.
• PHP : Le mode PHP recommandé est PHP-FPM. Si vous utilisez un serveur Web Nginx, alors ce champ n’apparaîtra pas, les serveurs ISPConfig Nginx utilisent toujours PHP-FPM.
• Version PHP : Ce champ n’apparaît que si vous avez plusieurs versions de PHP installées. Je recommande toujours d’utiliser la version la plus élevée qui est supportée par le CMS ou l’application Web que vous prévoyez d’installer sur ce site Web. Consultez les exigences système pour le CMS afin de choisir la bonne version.
• Actif : Pour activer le site Web.

Cliquez sur le bouton ‘Enregistrer’ pour créer le site Web. Le site Web nouvellement ajouté apparaîtra dans la liste des sites Web.

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 modifications de configuration en attente.

Maintenant, nous avons 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 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 à utiliser par le système CMS de ce site Web. La première étape consiste à ajouter l’utilisateur MySQL.

Cliquez sur “ Utilisateurs de base de données “ dans le menu à gauche :

Et ensuite sur le bouton vert “ Ajouter un nouvel utilisateur “ qui apparaît dans la section médiane de la page.

Le formulaire avec les détails de l’utilisateur de base de données apparaît.

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

• Client : Il est optionnel de choisir un client ici. Mais si vous avez choisi d’assigner le site Web à un client lors de la création du site, alors il est important que vous choisissiez le même client (ou dans le cas de cet exemple - aucun client) ici.
• Utilisateur de base de données : Entrez le nom que le nouvel utilisateur de base de données doit recevoir ici. Un préfixe sera ajouté au nom, donc dans cet exemple, le nom d’utilisateur de base de données résultant sera c0mywebsite. Nous le verrons plus tard dans la liste des utilisateurs de base de données aussi. Consultez le chapitre à la fin du guide sur les préfixes.
• Mot de passe de la base de données et Répéter le mot de passe : Entrez un mot de passe sécurisé pour le nouvel utilisateur de base de données ici deux fois. Ou utilisez le bouton “Générer un mot de passe” pour en générer un. Prenez soin de noter le mot de passe car vous en aurez besoin plus tard lors de l’installation du CMS sur le site Web.

Maintenant, appuyez sur enregistrer pour créer l’utilisateur de base de données, vous serez redirigé vers la liste des utilisateurs de base de données. Veuillez noter que l’utilisateur est créé dans MySQL au moment où nous l’assignons à une base de données dans l’étape suivante.

Comme vous pouvez le voir dans la liste maintenant, le nom d’utilisateur de la base de données est “c0mywebsite” et c’est le nom que vous devrez utiliser lors de la saisie des détails de la base de données lors de l’installation du CMS sur le site.

Maintenant, nous allons créer une base de données MySQL. Pour ce faire, cliquez sur “ Bases de données “ dans le menu à gauche.

La liste (vide) des bases de données apparaîtra. Là, cliquez sur le bouton vert “ Ajouter une nouvelle base de données “.

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

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

• Site : ici, vous devez choisir le site Web auquel la base de données doit appartenir. Dans notre cas, le site Web est “example.com”. Choisir le bon site Web est important car ce paramètre définit par exemple dans quelle sauvegarde la base de données finira et quels droits sont définis pour l’accès à la base de données.
• Nom de la base de données : ici, vous entrez le nom que la nouvelle base de données doit recevoir. J’utiliserai le nom “mywebsite” ici. De même que pour l’utilisateur MySQL, un préfixe est ajouté au nom de la base de données, donc le nom de base de données résultant sera “c0mywebsite”. Consultez le chapitre à la fin du guide sur les préfixes.
• Utilisateur de base de données : Ici, vous sélectionnez le nom de l’utilisateur de base de données que nous avons créé précédemment.
• Actif : Doit être activé pour activer la base de données.

Maintenant, appuyez sur le bouton enregistrer. Cela créera la base de données et également l’utilisateur de base de données dans MySQL. Vous serez renvoyé à la liste des bases de données et notre nouvelle base de données y apparaîtra.

Vous pouvez maintenant accéder au site Web par exemple via phpMyAdmin en cliquant sur le bouton phpMyAdmin dans la liste :

Remarque : Si vous obtenez une erreur indiquant que phpMyAdmin n’est pas trouvé, alors l’URL vers 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, vous devez pouvoir accéder au dossier du site Web soit par FTP soit par SSH. Dans ce chapitre, je vais vous montrer comment accorder un accès FTP (FTPS) et SSH (SFTP) au site Web.

Ajouter un utilisateur FTP dans ISPConfig

Cliquez sur Accès Web > Comptes FTP dans le menu à gauche pour accéder à la liste des utilisateurs FTP.

Sur la page qui apparaît, cliquez sur le bouton vert “ Ajouter un nouvel utilisateur FTP “.

Le formulaire de détails de l’utilisateur FTP apparaît :

Les détails sur ce qu’il faut entrer dans chacun des champs sont :

• Site Web : Sélectionnez le site Web auquel l’utilisateur FTP doit appartenir ici. Dans notre exemple, le site Web est nommé “example.com”.
• Nom d’utilisateur : Entrez un nom d’utilisateur pour l’utilisateur FTP ici. Un préfixe sera automatiquement ajouté au nom d’utilisateur.
• Mot de passe et Répéter le mot de passe : Entrez un mot de passe sécurisé ici deux fois, ou utilisez le bouton “Générer un mot de passe”.
• Actif : Cette case à cocher doit être cochée pour activer l’accès FTP.

Maintenant, appuyez sur “ Enregistrer “ pour créer l’utilisateur FTP. Vous serez redirigé vers la liste des utilisateurs FTP, qui montre également le nom d’utilisateur FTP avec le préfixe.

Nous avons réussi à créer 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 sur TLS). Veuillez noter que SFTP (même si le nom est similaire) est un accès de fichiers SSH et non FTP, donc il nécessite un utilisateur SSH pour utiliser ce protocole (que nous créerons dans le chapitre suivant).

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

• Serveur : 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”, donc je vais 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 avec le préfixe. Donc dans le cas de cet exemple, le préfixe est “default” et le nom d’utilisateur est “mywebsite”, donc le nom d’utilisateur FTP résultant à entrer dans le client FTP est “defaultmywebsite”. Au fait, si vous n’aimez pas les préfixes, consultez le chapitre à la fin du guide sur pourquoi les préfixes sont nécessaires dans la plupart des systèmes et où les désactiver et les changer (si vous êtes l’administrateur du serveur).
• Mot de passe FTP : le mot de passe que vous avez défini pour cet utilisateur FTP dans le formulaire d’utilisateur FTP ci-dessus.

Alors où télécharger des fichiers maintenant ? La racine du site Web est le dossier avec le nom “ web “, dans lequel vous téléchargez les fichiers de votre CMS. Le dossier “web” est celui que vous accédez par navigateur Web lorsque vous entrez le nom de domaine du site dans la barre d’adresse du navigateur. Si vous souhaitez stocker des fichiers sur le site Web qui ne doivent pas être accessibles par un navigateur Web, vous pouvez les télécharger dans le dossier avec le nom “ privé “.

Ajouter un utilisateur SSH / SFTP / Shell dans ISPConfig

Ajouter un utilisateur Shell, qui fournit un accès par SSH et SFTP au site Web, est très similaire à l’ajout d’un utilisateur FTP. La première étape consiste à cliquer sur Ligne de commande > Utilisateur Shell dans le menu à gauche.

La page avec les utilisateurs shell apparaît dans la section centrale. Là, cliquez sur le bouton vert “ Ajouter un nouvel utilisateur Shell “.

Le formulaire avec les détails de l’utilisateur shell apparaît.

Les champs suivants doivent être remplis.

• Site : ici, vous sélectionnez le site Web auquel cet utilisateur SSH doit donner accès. Dans notre exemple, le site Web est nommé example.com.
• Nom d’utilisateur : Entrez le nom d’utilisateur souhaité ici. Un préfixe sera appliqué, de la même manière que décrit pour l’utilisateur FTP.
• Mot de passe et Répéter le mot de passe : Entrez un mot de passe sécurisé pour le nouvel utilisateur SSH ici.
• Chroot Shell : Si vous choisissez jailkit ici, alors l’utilisateur SSH est enfermé dans la racine du site Web. Cela est recommandé et ajoute une couche de sécurité supplémentaire, mais l’utilisateur ne peut accéder qu’aux programmes et fichiers qui sont installés dans sa prison. Ce champ est visible uniquement pour 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 vous souhaitez utiliser l’authentification par clé publique pour l’accès SSH au lieu ou en plus d’un mot de passe, vous pouvez entrer votre clé publique ici.

Maintenant, cliquez sur enregistrer et l’utilisateur SSH est créé. Cela peut prendre jusqu’à une minute, vous pouvez voir l’indicateur rouge clignotant dans la barre de navigation supérieure jusqu’à ce que les modifications aient été écrites sur le disque.

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

• Serveur : Utilisez 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 avec le préfixe. Donc dans le cas de cet exemple, le préfixe est “default” et le nom d’utilisateur est “mywebsite”, donc le nom d’utilisateur résultant est “defaultmywebsite”.
• Mot de passe SSH : Le mot de passe que vous avez saisi ci-dessus ou vous pouvez utiliser la clé SSH, au cas où vous l’auriez utilisée.

Comment naviguer vers le dossier du site Web en tant qu’utilisateur SSH ?

La commande pour changer de dossier dans le shell Linux est “cd”. Lorsque vous êtes connecté au site Web en tant qu’utilisateur SSH, vous atterrissez dans le dossier personnel de votre utilisateur SSH (qui est vide lorsque vous commencez à l’utiliser). Pour aller au dossier web (qui contient les fichiers du site Web), vous utilisez la commande cd comme ceci :

cd ../../web/

La commande ci-dessus fonctionne pour les utilisateurs SSH enfermés et non enfermés. Pour les utilisateurs enfermés, vous pouvez utiliser une alternative :

cd /web

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

Préfixes de nom d’utilisateur dans ISPConfig

Pourquoi les préfixes de nom d’utilisateur sont-ils utilisés ? 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 bien sûr. 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 erreur dans le logiciel et appeler le support de son FAI. Voici où les préfixes de nom d’utilisateur entrent en jeu, ISPConfig les configure par défaut, par exemple, un “c + ID du client” est ajouté devant un utilisateur de base de données ou le nom d’utilisateur du client (dans le cas de pas 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, vous pourriez par exemple utiliser ISPConfig comme panneau pour votre serveur domestique ou serveur d’entreprise interne, donc vous n’avez pas besoin de préfixes de nom d’utilisateur et trouvez ennuyeux qu’ISPConfig les ajoute. Mais cela peut être facilement résolu car les préfixes de nom d’utilisateur sont librement configurables dans ISPConfig. Pour les supprimer, allez dans Système > Interface > Configuration principale (en étant connecté en tant qu’utilisateur admin) :

Videz tous les champs de préfixe et appuyez sur le bouton enregistrer :

Maintenant, les préfixes de nom d’utilisateur et de nom de base de données sont désactivés. Veuillez noter que le changement s’applique uniquement aux nouveaux utilisateurs créés, le préfixe des utilisateurs existants ne sera pas supprimé, donc les noms d’utilisateur existants ne seront pas modifiés et leur connexion ne sera pas rompue lorsque vous modifiez ces paramètres.

Liens

Voici quelques liens pour des lectures supplémentaires et pour obtenir de l’aide si vous avez des problèmes.

• Page d’accueil d’ISPConfig
• Une description détaillée des options dans ISPConfig
• Instructions d’installation d’ISPConfig pour tous les systèmes d’exploitation pris en charge
• Obtenez de l’aide si quelque chose ne fonctionne pas par la communauté ISPConfig
• Obtenez un support commercial par e-mail ou connexion à distance