Premier site avec Apache
Votre serveur tourne, mais personne ne peut y voir une page. Installons Apache, le programme qui sert les sites web, et publions une première page à votre nom de domaine.
- Parcours
- Tutoriel 17 sur 35
- Durée
- 30 min de lecture
- Vérifié avec
- Commandes : essais sous Debian 13.7 (Apache 2.4.69)
Ce que vous saurez faire
- Installer Apache et voir sa page par défaut.
- Ouvrir le port 80 dans ufw pour que le monde entier puisse frapper.
- Publier une page à vous dans /var/www/exemple avec un VirtualHost.
- Vérifier la configuration avant de la recharger, et lire les journaux.
Avant de commencer : Pare-feu avec ufw, Mises à jour et paquets.
Sommaire
Comment installer Apache sur Debian et publier un premier site ? Votre serveur est installé, mis à jour et protégé, mais il ne répond encore à aucun navigateur. En une demi-heure, nous allons installer Apache, ouvrir la bonne porte, y poser une page à vous et lire ce qu'Apache raconte. Au bout, une adresse comme exemple.fr affichera votre texte.
Ce qu'est un serveur web
Un serveur web est un programme qui attend qu'un navigateur lui demande une page, puis la renvoie. Pensez à un libraire : vous demandez un livre, il le sort de ses rayons et vous le tend. La demande voyage dans un langage appelé HTTP. Elle frappe à la porte numérotée 80 du serveur, celle des sites web (voir Le vocabulaire : IP, DNS, domaine, port, pare-feu).
Il existe plusieurs serveurs web. Nous prenons Apache, l'un des plus répandus : il s'installe en une commande, il est très documenté, et ses réglages tiennent dans des fichiers lisibles. Installons-le et voyons s'il répond.
1Installer Apache
Apache est un paquet Debian comme les autres (voir Mises à jour et paquets), nommé apache2, et il démarre tout seul.
sudo apt install -y apache2L'installation défile quelques secondes. Voyons si Apache répond, avec curl, un petit navigateur sans fenêtre qui affiche la réponse dans le terminal. L'adresse localhost désigne la machine elle-même : ici, le serveur se parle à lui-même.
curl -sI http://localhost/ | head -1HTTP/1.1 200 OKLe code 200 veut dire « tout va bien, voici la page ». Lisons aussi le titre de cette page, que Debian a préparée pour vous.
curl -s http://localhost/ | grep -o "<title>[^<]*</title>"<title>Apache2 Debian Default Page: It works</title>« It works » : Apache sert bien la page par défaut de Debian. Mais seul le serveur la voit pour l'instant, car le pare-feu garde la porte 80 fermée.
2Ouvrir le port 80
Pour que le reste du monde atteigne Apache, demandez à ufw de laisser passer le port 80, en TCP. C'est la même règle que pour SSH dans Pare-feu avec ufw, avec un autre numéro.
sudo ufw allow 80/tcpRule added
Rule added (v6)Les deux lignes sont la version IPv4 et la version IPv6 de la même règle. Essayons maintenant depuis votre ordinateur, avec l'adresse IP du serveur, le numéro qui l'identifie sur le réseau.
curl -sI http://203.0.113.10/ | head -1HTTP/1.1 200 OKVous pouvez aussi taper cette adresse dans votre navigateur : la page « Apache2 Debian Default Page » doit s'afficher. Le serveur est joignable. Mais le port 80 n'est pas chiffré : ne mettez aucun mot de passe sur ce site avant l'article sur HTTPS. Il manque encore une page à vous, et un dossier où la ranger.
3Écrire votre première page
Chaque site a son propre dossier. Par habitude, ils vivent sous /var/www, et le nôtre s'appellera /var/www/exemple. C'est la « racine du site » : Apache y cherche les fichiers à envoyer.
sudo mkdir -p /var/www/exempleÉcrivons-y le fichier index.html, le nom que tout serveur web cherche en premier quand on demande un dossier. Une page web est du texte entouré de balises : h1 marque un grand titre, title le nom de l'onglet. La commande tee copie tout ce qui suit dans le fichier, jusqu'à la ligne EOF, qui marque la fin du texte.
sudo tee /var/www/exemple/index.html > /dev/null <<EOF
<!DOCTYPE html>
<html lang="fr">
<head>
<meta charset="UTF-8">
<title>Bonjour</title>
</head>
<body>
<h1>Bonjour depuis exemple.fr</h1>
</body>
</html>
EOFLa commande ne répond rien, c'est bon signe. Vérifions que le fichier est là, avec ses droits. Apache tourne sous un compte nommé www-data et doit pouvoir lire le fichier (voir Utilisateurs, sudo et droits).
ls -l /var/www/exempletotal 4
-rw-r--r-- 1 root root 158 Nov 5 01:43 index.htmlLes r de -rw-r--r-- disent que tout le monde peut lire le fichier, www-data compris. La date et la taille seront les vôtres. Apache ignore pourtant encore ce dossier : présentons-lui votre site.
4Créer un VirtualHost pour exemple.fr
Un VirtualHost est le bloc de réglages d'un site : son nom, son dossier, ses journaux. Un seul Apache peut en porter autant que vous voulez, et il choisit le bon d'après le nom de domaine que le navigateur demande. Imaginez un immeuble avec une boîte aux lettres par locataire.
Les VirtualHost vivent dans /etc/apache2/sites-available/, un fichier par site. Voici le nôtre, réglage par réglage :
ServerName: le nom de domaine du site.ServerAliasen ajoute un second, ici avecwww.DocumentRoot: le dossier du site, celui de l'étape 3.ErrorLogetCustomLog: les deux journaux du site, l'un pour les erreurs, l'autre pour chaque visite. La variable${APACHE_LOG_DIR}vaut/var/log/apache2.
sudo tee /etc/apache2/sites-available/exemple.fr.conf > /dev/null <<'EOF'
<VirtualHost *:80>
ServerName exemple.fr
ServerAlias www.exemple.fr
DocumentRoot /var/www/exemple
ErrorLog ${APACHE_LOG_DIR}/exemple-error.log
CustomLog ${APACHE_LOG_DIR}/exemple-access.log combined
</VirtualHost>
EOFLe *:80 du début veut dire « sur toutes les adresses du serveur, port 80 ». Le fichier est dans sites-available (« sites disponibles »), mais Apache ne lit que sites-enabled (« sites activés »). La commande a2ensite (« apache2 enable site ») relie l'un à l'autre.
sudo a2ensite exemple.fr.confEnabling site exemple.fr.La réponse vous rappelle ensuite de recharger la configuration d'Apache. Vérifions-la d'abord : une faute de frappe rechargée à chaud peut mettre tous vos sites à l'arrêt, alors qu'un test ne coûte rien.
sudo apache2ctl configtestSyntax OKSi une ligne AH00558 parle de « fully qualified domain name » (nom de domaine complet), ce n'est qu'un avertissement sans conséquence : seul Syntax OK compte. Rechargeons maintenant. Cela applique la configuration sans couper les visiteurs en cours.
sudo systemctl reload apache2Pour tester, demandons la page en précisant le nom du site avec -H, comme le ferait un navigateur qui visite exemple.fr.
curl -s -H "Host: exemple.fr" http://203.0.113.10/ | grep h1 <h1>Bonjour depuis exemple.fr</h1>C'est votre page. Sans le nom du site, Apache sert encore la page par défaut : il a besoin du nom pour choisir le locataire. Dans un navigateur, http://exemple.fr marchera dès que ce nom pointera vers l'adresse du serveur, ce qui est le sujet de Nom de domaine et DNS. Ces visites, Apache les a notées quelque part : allons voir où.
5Lire les journaux
Apache tient deux journaux, rangés dans /var/log/apache2/ : le journal d'accès note chaque visite, le journal d'erreurs note ce qui s'est mal passé. Ce sont les deux fichiers nommés dans le VirtualHost. Regardons les trois dernières visites.
sudo tail -n 3 /var/log/apache2/exemple-access.log127.0.0.1 - - [05/Nov/2026:01:45:44 +0000] "GET / HTTP/1.1" 200 409 "-" "curl/8.14.1"
127.0.0.1 - - [05/Nov/2026:01:45:44 +0000] "GET /absent.html HTTP/1.1" 404 473 "-" "curl/8.14.1"
127.0.0.1 - - [05/Nov/2026:01:45:44 +0000] "GET / HTTP/1.1" 403 476 "-" "curl/8.14.1"Les adresses, dates et programmes seront les vôtres. Chaque ligne se lit dans cet ordre :
- l'adresse du visiteur (ici
127.0.0.1, la machine elle-même) puis la date ; - la demande entre guillemets :
GET /signifie « donnez-moi la page d'accueil » ; - le code de réponse juste après : 200 réussi, 404 page introuvable, 403 accès refusé ;
- la taille de la réponse en octets, puis le navigateur du visiteur.
Pour suivre un journal en direct pendant vos tests, ajoutez -f à tail et quittez avec Ctrl+C. La troisième ligne montre ce qui arrive quand Apache ne peut plus lire le fichier : un refus 403, dont le journal d'erreurs donne la raison.
sudo tail -n 1 /var/log/apache2/exemple-error.log[Thu Nov 05 01:45:44.961002 2026] [core:error] [pid 5529:tid 5533] (13)Permission denied: [client 127.0.0.1:43624] AH00132: file permissions deny server access: /var/www/exemple/index.htmlLa fin de la ligne donne la raison : « les droits du fichier refusent l'accès au serveur ». Ce cas, et deux autres, ont leur remède juste en dessous.
Si ça échoue
Trois situations reviennent le plus souvent, avec leur cause :
- Une erreur 403 (
Forbidden, « interdit »). Apache a trouvé le site mais n'a pas le droit de lire. Si le journal d'erreurs ditAH00132: file permissions deny server access, vérifiez avecls -l. Quand lesrmanquent pour tout le monde, donnez la lecture à tous avecsudo chmod 644 /var/www/exemple/index.html. Avecsearch permissions are missing on a component of the path, c'est un dossier qui bloque :sudo chmod 755 /var/www/exemple. - Une erreur 404 (
Not Found, « introuvable »). L'adresse demandée n'existe pas dans le dossier du site : vérifiez l'orthographe du fichier, majuscules comprises. Le journal d'accès la note, le journal d'erreurs reste muet. - La page « Apache2 Debian Default Page » au lieu de la vôtre. Apache n'a pas reconnu le nom du site : l'adresse a été tapée sans nom de domaine, ou ne correspond ni à
ServerNameni àServerAlias. Vérifiez quesudo a2query -slisteexemple.fret que vous avez rechargé.
Deux cas plus rares
- Un 403 avec
AH01630: client denied by server configuration. Le dossier du site est hors de/var/www, où Apache refuse tout par défaut. Gardez vos sites sous/var/www. - Une page « Index of / ». Le dossier du site n'a pas de fichier
index.html, alors Apache affiche la liste de son contenu. Créez le fichier à l'étape 3.
Et si configtest refuse ? Il nomme le fichier et la ligne. Par exemple, <VirtualHost> was not closed signale un </VirtualHost> oublié. Corrigez, puis relancez configtest jusqu'à Syntax OK.
La suite
Votre page est en ligne, mais elle voyage en clair : n'importe qui sur le chemin peut la lire ou la modifier, et les navigateurs affichent « Non sécurisé ». Le certificat qui chiffre la connexion et ajoute le cadenas est gratuit. L'article suivant, HTTPS avec Let's Encrypt, l'installe sur ce même site.