---
title: "Lab : votre propre serveur web en une seule commande"
domain: cloud-computing
level: foundations
duration: "30 min"
cost: "gratuit"
environment: "votre propre ordinateur (Windows, macOS ou Linux) avec Python 3 et un navigateur web ; ni compte ni Internet nécessaires"
lang: fr
source_hash: bac99256c88f
---

# Lab : votre propre serveur web en une seule commande

## Objectif
Transformer votre propre ordinateur en petit serveur web, ouvrir sa page dans un navigateur et regarder le serveur noter chaque requête qu'il reçoit. Vous verrez de vos propres yeux la requête et la réponse de la leçon.

## Objectifs
- Lancer un petit serveur web sur votre propre ordinateur et l'ouvrir dans un navigateur.
- Lire une ligne de journal d'un serveur et dire ce que signifie chaque partie.
- Expliquer ce qu'est un `404` et en voir un se produire.

## Prérequis
- [La leçon de ce module](lesson.fr.md).
- Vous savez ouvrir un terminal et vous déplacer entre les dossiers ([module 02](../02-terminal-basics/README.fr.md)).
- **Python 3**. Vérifiez en saisissant `python3 --version` (macOS et Linux) ou `python --version` (Windows) dans un terminal. Il doit afficher quelque chose comme `Python 3.12.3` ; toute version 3.x convient.
- Un navigateur web et un éditeur de texte brut (Bloc-notes, TextEdit en mode texte brut, gedit, VS Code…).

> [!WARNING]
> Le serveur que vous lancez n'est accessible que depuis **votre propre ordinateur**, grâce à `--bind 127.0.0.1`. Ne retirez pas cette option, et arrêtez le serveur (Étape 5) quand vous avez terminé. Windows peut vous demander s'il faut autoriser Python à traverser le pare-feu ; avec cette option, vous pouvez choisir en toute sécurité **Annuler** ou **Refuser**.

## Architecture
![Tout se passe sur votre ordinateur. Un navigateur avec l'adresse http://127.0.0.1:8000 envoie une requête, flèche 1, à un serveur web Python lancé avec python3 -m http.server 8000 --bind 127.0.0.1. Le serveur lit index.html dans le dossier ~/my-website et le renvoie comme réponse, flèche 2. Dans le terminal, une ligne de journal apparaît pour chaque requête, par exemple GET barre oblique avec le statut 200 et GET barre oblique x avec le statut 404. Une note précise que 127.0.0.1 signifie cet ordinateur, donc personne d'autre ne peut atteindre le serveur.](../../../assets/diagrams/webserver-lab-architecture.fr.svg)

*Figure 1. Le navigateur est le client, le programme Python est le serveur, et le terminal affiche une ligne pour chaque requête.*

## Étapes

### Étape 1 — Créer un dossier avec une page web (8 min)
Un serveur web a besoin de fichiers à servir. Vous créez un dossier appelé `my-website` et vous y mettez une page.

Dans votre terminal, créez le dossier et placez-vous dedans :

```bash
mkdir ~/my-website
cd ~/my-website
```

Dans Windows PowerShell, les deux mêmes lignes fonctionnent telles quelles.

`mkdir` crée un dossier, `~` est votre dossier personnel et `cd` s'y déplace. Ouvrez maintenant votre éditeur de texte et créez dans ce dossier un fichier nommé **`index.html`** avec exactement ce contenu :

```html
<!DOCTYPE html>
<html>
  <head>
    <meta charset="utf-8">
    <title>Mon premier site web</title>
  </head>
  <body>
    <h1>Bonjour depuis mon propre serveur !</h1>
    <p>Cette page est un fichier sur mon ordinateur.</p>
  </body>
</html>
```

Ceci est du HTML. `<h1>` marque un grand titre et `<p>` un paragraphe. Le texte de `<title>` apparaît dans l'onglet du navigateur. Enregistrez le fichier en vous assurant que le nom est `index.html` et non `index.html.txt` (Windows masque les extensions par défaut ; dans le Bloc-notes, « Type » doit être « Tous les fichiers »).

Vérifiez que le fichier est bien là :

```bash
ls
```

Dans Windows PowerShell, `ls` fonctionne aussi.

Sortie attendue :
```text
index.html
```

Pourquoi `index.html` ? Quand quelqu'un demande `/` à un serveur web, le serveur cherche un fichier portant ce nom. C'est la page d'accueil par défaut.

### Étape 2 — Démarrer le serveur (5 min)
Toujours dans `~/my-website`, exécutez :

```bash
python3 -m http.server 8000 --bind 127.0.0.1
```

Sous Windows, utilisez `python` au lieu de `python3` (ou `py` si `python` est introuvable).

Sortie attendue :
```text
Serving HTTP on 127.0.0.1 port 8000 (http://127.0.0.1:8000/) ...
```

Ligne par ligne, la commande signifie :

- `python3 -m http.server` lance un petit serveur web fourni avec Python. Il sert les fichiers du dossier où vous vous trouvez.
- `8000` est le **port**, le numéro de porte (la leçon a expliqué les ports).
- `--bind 127.0.0.1` le fait écouter uniquement sur `127.0.0.1`, l'adresse qui signifie toujours « cet ordinateur ».

Le terminal semble maintenant « bloqué » : aucune nouvelle invite n'apparaît. C'est normal. Le serveur tourne et attend des requêtes, et cette fenêtre de terminal est l'endroit où il fait son rapport. Laissez-la ouverte.

> [!NOTE]
> Si vous voyez `OSError: [Errno 98] Address already in use` (sous Windows, un message indiquant que l'adresse est déjà utilisée), un autre programme utilise déjà le port 8000. Choisissez un autre port, par exemple `8001`, et utilisez-le partout où ce lab indique 8000.

### Étape 3 — Visiter la page et lire le journal (8 min)
Ouvrez votre navigateur web et saisissez cette adresse dans la barre d'adresse :

```text
http://127.0.0.1:8000
```

Vous devriez voir une page avec le grand titre « Bonjour depuis mon propre serveur ! » et l'onglet intitulé « Mon premier site web ». Vous venez d'utiliser votre ordinateur à la fois comme client (le navigateur) et comme serveur (Python).

Regardez maintenant le terminal. De nouvelles lignes sont apparues. La date et l'heure affichées seront différentes, et votre navigateur peut aussi montrer une deuxième ligne pour `/favicon.ico`, la petite icône d'onglet qu'il demande toujours :

```text
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET / HTTP/1.1" 200 -
```

Lisez-la de gauche à droite :

| Partie | Signification |
|---|---|
| `127.0.0.1` | Qui a demandé : l'adresse du client. Ici, c'est votre propre ordinateur. |
| `- -` | Deux champs que les serveurs peuvent remplir avec des informations de connexion. Ici, ils sont inutilisés. |
| `[07/Nov/2026 21:48:34]` | Le moment où la requête est arrivée. La vôtre affichera la date et l'heure actuelles. |
| `"GET / HTTP/1.1"` | La requête : la méthode `GET` (« envoie-moi ceci »), le chemin `/` (la page d'accueil) et la version de HTTP. |
| `200` | Le code d'état : OK, le serveur a trouvé le fichier et l'a envoyé. |
| `-` | La taille de la réponse, que ce serveur simple laisse vide. |

Réfléchissez-y avant d'ouvrir la réponse : vous n'avez jamais saisi `index.html` dans l'adresse ; pourquoi le serveur l'a-t-il envoyé ?

<details>
<summary>Afficher la réponse</summary>

Le chemin dans la requête n'était que `/`. Un serveur web répond à `/` par la page par défaut du dossier, qui s'appelle `index.html`. Vous pourriez aussi saisir `http://127.0.0.1:8000/index.html` et obtenir la même page. Rechargez cette adresse et regardez le journal : une nouvelle ligne `GET /index.html` apparaît.

</details>

### Étape 4 — Modifier la page, puis demander une page qui n'existe pas (6 min)
Le serveur ne garde pas la page en mémoire : il lit le fichier à chaque fois. Vous pouvez donc modifier la page sans rien redémarrer.

Ouvrez `index.html` dans votre éditeur, remplacez le texte entre `<p>…</p>` par quelque chose de nouveau, par exemple `Je viens de modifier cette page !`, et enregistrez. Retournez dans le navigateur et **rechargez-le** (F5, ou Cmd+R sur un Mac). Le nouveau texte apparaît. Une nouvelle ligne `GET / ... 200` est apparue dans le terminal.

Demandez maintenant un fichier qui n'existe pas. Dans la barre d'adresse, saisissez :

```text
http://127.0.0.1:8000/about.html
```

Le navigateur affiche une page d'erreur, « Error response: Error code: 404, Message: File not found ». Regardez le terminal :

```text
127.0.0.1 - - [07/Nov/2026 21:48:34] code 404, message File not found
127.0.0.1 - - [07/Nov/2026 21:48:34] "GET /about.html HTTP/1.1" 404 -
```

Qu'est-ce qui a changé par rapport à la première ligne de journal, et un 404 signifie-t-il que le serveur est cassé ?

<details>
<summary>Afficher la réponse</summary>

Le chemin est maintenant `/about.html` et le code d'état est `404` au lieu de `200`. Un 404 ne signifie **pas** que le serveur est cassé : le serveur fonctionne très bien et a répondu en disant « je n'ai aucun fichier à ce chemin ». Ici, le fichier n'existe pas dans `~/my-website`. Pour relever le défi, vous pouvez créer `about.html` et recharger ; le 404 devient un 200.

</details>

### Étape 5 — Arrêter le serveur (3 min)
Allez dans le terminal où tourne le serveur et appuyez sur **Ctrl+C** (maintenez la touche Ctrl enfoncée et appuyez sur C).

Sortie attendue :
```text

Keyboard interrupt received, exiting.
```

L'invite revient. Allez maintenant dans le navigateur et rechargez la page : il affiche une erreur du genre « Impossible de se connecter » ou « Impossible d'accéder à ce site ». Plus personne n'écoute sur le port 8000, donc la requête ne reçoit aucune réponse. C'est différent d'un 404, où le serveur répond.

## Vérification
Vous avez terminé le lab si :

- Le navigateur a affiché votre page « Bonjour depuis mon propre serveur ! » à l'adresse `http://127.0.0.1:8000` pendant que le serveur tournait.
- Le terminal a affiché une ligne de journal se terminant par `200` pour elle et une ligne se terminant par `404` pour la page manquante.
- Après Ctrl+C, le navigateur n'a plus pu se connecter.

## Dépannage
| Symptôme | Cause probable | Solution |
|---|---|---|
| `python3: command not found` | Python n'est pas installé, ou sous Windows il s'appelle `python` | Installez Python 3 depuis python.org et, sous Windows, saisissez `python` ou `py` au lieu de `python3` |
| `Address already in use` | Un autre programme utilise le port 8000, ou le serveur tourne déjà dans un autre terminal | Arrêtez l'autre, ou utilisez un autre port tel que `8001` dans la commande et dans l'adresse |
| Le navigateur affiche « Directory listing for / » ou un 404 pour `/` | Vous avez lancé le serveur dans le mauvais dossier, ou le fichier ne s'appelle pas `index.html` | Appuyez sur Ctrl+C, exécutez `cd ~/my-website`, vérifiez avec `ls` que `index.html` est listé, puis relancez |
| Les modifications n'apparaissent pas | La page est en cache ou le fichier n'a pas été enregistré | Enregistrez le fichier, puis forcez le rechargement (Ctrl+F5, ou Cmd+Maj+R sur un Mac) |
| `index.html.txt` dans la liste | L'éditeur a ajouté `.txt` | Enregistrez à nouveau en « Tous les fichiers » avec le nom `index.html` |

## Défi (facultatif)
1. Ajoutez une deuxième page, `about.html`, avec votre nom dans un titre, et faites-y un lien depuis `index.html` avec `<a href="about.html">À propos</a>`. Cliquez sur le lien et retrouvez la ligne correspondante dans le journal.
2. Arrêtez le serveur et relancez-le sur le port 9000. Quelle adresse devez-vous maintenant saisir dans le navigateur ?

## Nettoyage
Le lab a créé un dossier et rien d'autre. Assurez-vous que le serveur est arrêté (Ctrl+C), puis supprimez le dossier.

Sous macOS ou Linux :

```bash
cd ~
rm -r ~/my-website
```

Dans Windows PowerShell :

```text
cd ~
Remove-Item -Recurse ~/my-website
```

## Ce que vous avez appris
- N'importe quel ordinateur devient un serveur quand il exécute un programme qui répond à des requêtes ; le vôtre l'a fait avec une seule commande.
- Une requête comporte une méthode et un chemin, et la réponse d'un serveur commence par un code d'état : `200` pour le succès, `404` pour « rien ici ».
- Le serveur lit des fichiers dans un dossier, et `index.html` est la page par défaut d'un dossier.
- Lier le serveur à `127.0.0.1` garde un serveur de test privé pour votre propre ordinateur, et Ctrl+C l'arrête.
