Documentation du Dr FRAPPE

Ce wiki regroupe les résultats de mes expériences en informatique accumulés au cours de mes recherches sur le net.

Dans la mesure du possible, j'ai cité mes sources ; il en manque certainement…

Différences

Ci-dessous, les différences entre deux révisions de la page.

--- tutoriel:reseau:http:serveur:apache:vhost:start [2024/09/21 10:12] – supprimée - modification externe (Unknown date) 127.0.0.1
+++ tutoriel:reseau:http:serveur:apache:vhost:start [2024/09/21 10:12] (Version actuelle) – ↷ Liens modifiés en raison d'un déplacement. admin
@@ Ligne 1: / Ligne 1: @@
+{{tag>tutoriel}}
+====== Configuration des hôtes virtuels Apache sous Ubuntu (20.04) ======
+La configuration du serveur Apache se fait par une approche modulaire qui permet d'ajouter et de modifier de nouveaux fichiers selon les besoins, et non dans un seul fichier monolithique. Cette conception modulaire permet de créer un site ou un domaine individuel appelé hôte virtuel.
+Les hôtes virtuels permettent à une même instance d'Apache de servir plusieurs sites web. Chaque domaine ou site individuel configuré avec Apache renvoie le visiteur vers un répertoire contenant les données du site en question. Le visiteur n'est pas averti que le même serveur sert aussi d'autres sites. Ce schéma n'a aucune limite tant que le serveur peut supporter la charge.
+Ce guide explique comment configurer des hôtes virtuels Apache sur un serveur Ubuntu 20.04. Vous apprendrez comment servir des contenus différents à des visiteurs différents selon les domaines demandés en créant deux hôtes virtuels.
+----
+Nous supposons que :
+  * **nous possédons les domaines exemple.org et test.org** (noms de domaine pour l'accès en production)
+  * **mais pas exemple.loc ni test.loc** (noms de domaine pour l'accès en local)
+Nous allons créer un hôte virtuel pour example.com et un autre pour test.com. Il y sera fait référence tout au long du guide, mais vous devrez y substituer vos propres domaines ou valeurs tout en suivant le guide.
+Nous allons créer un hôte virtuel avec le nom de domaine monsite.loc, qui pointera sur le site web en local.
+===== Pré-requis =====
+  * Un serveur Ubuntu 20.04 doté d'un utilisateur non root avec les privilèges sudo. Vous pouvez utiliser notre guide **[[tutoriel:reseau:http:serveur:apache:vhost:serveurcfg:start]]** pour configurer ce serveur.
+  * **Apache ou un environnement LAMP** (Linux/Apache/MySQL/PHP) ou équivalent installé sur le serveur
+===== Première étape : Création de la structure des répertoires =====
+Chacun des répertoires (nommés ici exemple.org et test.org) contiendra les fichiers du site web.
+<subnumberlist>
+  - **créez les répertoires des sites web et attribuez les permissions** : La racine (root) de chaque site (le répertoire qu’Apache consulte pour trouver le contenu à servir) sera placée dans des sous-répertoires du répertoire /var/www/html :<cli prompt='$ '>USER@MACHINE:~$ sudo mkdir -p /var/www/html/{exemple,test}.org
+USER@MACHINE:~$ sudo chown -R www-data:www-data /var/www/html
+USER@MACHINE:~$ sudo chmod -R 2755 /var/www/html</cli><a2s>
+/var/www/html
+|
++--exemple.org
++--test.org
+</a2s><WRAP center round tip 60%>
+Les dossiers des sites se nomment **exemple.org** et **test.org** (noms de domaine pour l'accès en production) et non pas exemple.loc et test.loc (noms de domaine pour l'accès en local).
+Pour faciliter le nommage du dossier projet et des fichiers de configuration, c'est le nom de domaine de production qui est utilisé.
+Cette pratique de nommage n'est pas une obligation, mais reste toutefois une bonne pratique.
+</WRAP>
+  -
+</subnumberlist>
+==== En modifiant le fichier /etc/hosts ====
+**Éditez avec les droits d'administration le fichier /etc/hosts**
+<WRAP center round info 60%>
+Chaque ligne définit l'association entre une adresse IP et un nom de domaine, plusieurs noms de domaine peuvent avoir la même adresse IP. Par exemple :<code - /etc/hosts>
+# site web local exemple
+.0.0.1 exemple.loc
+# Autres sites web locaux
+.0.0.1 mon-projet-personnel.loc
+.0.0.1 un-autre-site-web-local.loc
+.0.0.1 test.loc
+</code>
+</WRAP>
+==== Avec un serveur DNS ====
+===== Autres étapes =====
+<subnumberlist>
+  - **Créez des pages HTML pour chaque hôte virtuel** informant les visiteurs du site auquel ils sont connectés :
+    - **exemple.org** : <cli prompt='$ '>USER@MACHINE:~$ echo "Bienvenue sur exemple.org !" | sudo tee /var/www/html/exemple.org/index.html</cli>
+    - **test.org** : <cli prompt='$ '>USER@MACHINE:~$ echo "Bienvenue sur test.org !" | sudo tee /var/www/html/test.org/index.html</cli>
+    - **Rétablissez les droits** :<cli prompt='$ '>USER@MACHINE:~$ sudo chown -R www-data:www-data /var/www/html ; sudo chmod -R 2755 /var/www/html</cli>
+  - **Créez les fichiers d'hôtes virtuels** : Les fichiers d'hôtes virtuels spécifient la configuration des hôtes virtuels et indiquent comment le serveur web Apache répondra aux différentes requêtes.\\ Apache est livré avec un fichier d'hôte virtuel par défaut nommé /etc/apache2/sites-available/000-default.conf. Copiez ce fichier pour créer des fichiers d'hôtes virtuels pour chacun de vos domaines.
+    - **exemple.org** :
+      - **Copiez la configuration par défaut** :<cli prompt='$ '>USER@MACHINE:~$ sudo cp /etc/apache2/sites-available/000-default.conf /etc/apache2/sites-available/exemple.org.conf</cli><WRAP center round tip 60%>
+Notez que le nom de domaine de production **exemple.org** est repris aussi bien pour le répertoire du site que pour le nom du fichier de configuration et que l'extension du fichier de configuration est **.conf**
+</WRAP>
+      - **Éditez avec les droits d'administration le fichier /etc/apache2/sites-available/exemple.org.conf** pour le personnaliser et ajouter quelques directives supplémentaires :
+        * **ServerAdmin** : admin@exemple.org (adresse électronique de l’administrateur du site)
+        * **ServerName** : exemple.org (domaine de base pour cet hôte virtuel)
+        * **ServerAlias** : www.exemple.org (autres noms qui doivent correspondre comme s’ils étaient le nom de base ; utile pour faire correspondre les hôtes que vous avez définis, comme www)
+        * **DocumentRoot** : /var/www/html/exemple.org (emplacement de la racine -- root)<code - /etc/apache2/sites-available/exemple.org.conf>
+<VirtualHost *:80>
+    # e-mail de l'administrateur
+    ServerAdmin admin@exemple.org
+    # Associer le nom de domaine au dossier du projet
+    ServerName exemple.loc
+    ServerAlias www.exemple.loc
+    DocumentRoot /var/www/html/exemple.org
+    # fichiers journaux
+    ErrorLog ${APACHE_LOG_DIR}/error.log
+    CustomLog ${APACHE_LOG_DIR}/access.log combined
+    <directory /var/www/html/exemple.org>
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+</code>Cette section d’hôte virtuel correspond à toutes les requêtes qui sont faites sur le port 80, le port HTTP par défaut. Ici, nous nous limitons au protocole http et non https.
+    - **test.org** :
+      - **copiez l'hôte virtuel exemple.org** :<cli prompt='$ '>USER@MACHINE:~$ sudo cp /etc/apache2/sites-available/exemple.org.conf /etc/apache2/sites-available/test.org.conf</cli>
+      - **Éditez avec les droits d'administration le fichier /etc/apache2/sites-available/test.org.conf** pour le personnaliser :<code - /etc/apache2/sites-available/test.org.conf>
+<VirtualHost *:80>
+    # e-mail de l'administrateur
+    ServerAdmin admin@test.org
+    # Associer le nom de domaine au dossier du projet
+    ServerName test.loc
+    ServerAlias www.test.loc
+    DocumentRoot /var/www/html/test.org
+    # fichiers journaux
+    ErrorLog ${APACHE_LOG_DIR}/error.log
+    CustomLog ${APACHE_LOG_DIR}/access.log combined
+    <directory /var/www/html/test.org>
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+</code>
+  - **Activez les nouveaux hôtes virtuels** :<cli prompt='$ '>
+USER@MACHINE:~$ sudo a2ensite /etc/apache2/sites-available/exemple.org.conf
+Enabling site exemple.org.
+To activate the new configuration, you need to run:
+  systemctl reload apache2
+USER@MACHINE:~$ sudo a2ensite /etc/apache2/sites-available/test.org.conf
+Enabling site test.org.
+To activate the new configuration, you need to run:
+  systemctl reload apache2</cli><WRAP center round info 60%>
+si vous avez besoin de les désactiver, c'est :<cli prompt='$ '>
+USER@MACHINE:~$ sudo a2dissite /etc/apache2/sites-available/exemple.org.conf
+USER@MACHINE:~$ sudo a2dissite /etc/apache2/sites-available/test.org.conf
+</cli>
+</WRAP>
+  - **Vérifiez qu'il n'y a pas d'erreurs de configuration** :<cli prompt='$ '>USER@MACHINE:~$ sudo apache2ctl configtest
+. . .
+Syntax OK</cli>
+  - **Redémarrez Apache et vérifiez le succès du redémarrage** :<cli prompt='$ '>USER@MACHINE:~$ sudo systemctl restart apache2
+USER@MACHINE:~$ sudo systemctl status apache2</cli>Le serveur est maintenant configuré pour servir deux sites web.
+  - **(Facultatif) Modification du fichier local /etc/hosts** : Si vous ne possédez pas de noms de domaine réels pour vos serveurs, et que vous avez utilisé des domaines fictifs, vous pouvez tester la configuration pour votre ordinateur personnel en modifiant le fichier /etc/hosts sur votre ordinateur local. Cela interceptera les requêtes pour les domaines configurés et les dirigera vers votre serveur local, comme le ferait le système DNS si vous utilisiez des domaines enregistrés. Le contenu ne sera accessible que localement : les autres visiteurs ne pourront pas accéder au site depuis l'extérieur via le nom de domaine fictif.
+    - Éditez le fichier **/etc/hosts** pour y ajouter deux lignes :<code - /etc/hosts>
+...
+.0.0.1 exemple.org
+.0.0.1 test.org
+</code>Cela dirigera toute demande de exemple.org et test.org sur votre ordinateur en l'envoyant au serveur local. C’est ce que nous voulons si nous ne sommes pas réellement les propriétaires de ces domaines afin de tester nos hôtes virtuels.
+  - **Testez vos résultats** :
+    - **Ouvrez [[http://exemple.org]]** -> Bienvenue sur exemple.org !
+    - **Ouvrez [[http://test.org]]** -> Bienvenue sur test.org !
+  - Il ne reste plus qu'à installer les sites dans leurs emplacements.
+</subnumberlist>
+<WRAP center round tip 60%>
+Si vous avez modifié le fichier hosts de votre ordinateur local, vous pouvez supprimer les lignes ajoutées une fois vérifiée la configuration.
+Vous éviterez ainsi de surcharger votre fichier hosts avec des entrées devenues inutiles.
+</WRAP>
+===== Conclusion =====
+Désormais, un seul serveur gère deux noms de domaine distincts.
+Pour étendre ce processus, il suffit de suivre les mêmes étapes pour ajouter d'autres hôtes virtuels.
+Il n'y a pas de limite au nombre de noms de domaine gérables par Apache, alors n'hésitez pas à créer autant d'hôtes virtuels que le serveur peut en supporter.
+===== Problèmes connus =====
+===== Voir aussi =====
+  * **(en)** [[https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-20-04|How To Set Up Apache Virtual Hosts on Ubuntu 20.04]]
+  * **(fr)** [[https://sysreseau.net/apache-virtual-host/|Apache : Apprendre à créer des virtual Hosts]]
+----
+//Basé sur << [[https://www.digitalocean.com/community/tutorials/how-to-set-up-apache-virtual-hosts-on-ubuntu-20-04|How To Set Up Apache Virtual Hosts on Ubuntu 20.04]] >> par Kong Yang et Lisa Tagliaferri.//

Piste :

Documentation du Dr FRAPPE

Différences

Recherche

Navigation

Imprimer/exporter

Outils

QR Code