← évolutif
420-5A4-MT · Module 2 · Semaine 6 · Laboratoire

Installer un serveur Varnish
pour un serveur Apache

La procédure complète : installation, configuration du cache sur le port 80, Apache en arrière-plan, tests, journaux et purge. Deux machines : votre serveur Varnish et votre serveur Apache.

1 · Installation de Varnish

Exécuter sur le serveur Varnish :

$ sudo apt update $ apt search varnish $ sudo apt install varnish $ sudo apt install net-tools
Sortie de la commande apt install varnish
L'installation de Varnish avec apt.

Vérifier que le démon écoute :

$ sudo netstat -tulpn | grep varnishd
Sortie netstat montrant varnishd en écoute
varnishd est en écoute.
Contexte Client Cornucopia

Cornucopia · Application Pratique sur le Terrain

Ce laboratoire technique s'inscrit directement dans l'infrastructure de la ferme maraîchère de Flora et Hazel pour garantir la réactivité et la stabilité de leurs services bio en ligne.
Cas d'Usage Concret

Appliquer les configurations optimisées pour soutenir les pics de consultation des abonnés de la ferme.

2 · Configuration de Varnish

2.1 · Mettre le cache de Varnish sur le port 80

Créer le fichier de configuration dans /etc/systemd/system/varnish.service.d/ :

$ sudo systemctl edit varnish.service

Ajouter dans la partie non commentée (5e ou 6e ligne) :

[Service] ExecStart= ExecStart=/usr/sbin/varnishd -j unix,user=vcache -F -a 202.54.2.50:80 -T localhost:6082 -f /etc/varnish/default.vcl -S /etc/varnish/secret
Remplacer 202.54.2.50 par l'adresse IP de VOTRE serveur Varnish : c'est l'adresse et le port d'écoute du cache.

Recharger les changements :

$ sudo systemctl daemon-reload

2.2 · Donner Apache comme arrière-plan (backend) à Varnish

Éditer le fichier de configuration :

$ sudo nano /etc/varnish/default.vcl

Éditer la section backend default avec l'adresse IP de VOTRE serveur Apache et son port d'écoute (80) :

backend default { .host = "192.168.1.6"; .port = "80"; }

2.3 · Configurer Apache pour écouter sur son adresse IP

Sur le serveur Apache, éditer /etc/apache2/ports.conf :

$ sudo nano /etc/apache2/ports.conf

Retirer la directive Listen 80 et ajouter :

Listen 192.168.1.6:80

Éditer aussi /etc/apache2/sites-enabled/000-default.conf :

$ sudo nano /etc/apache2/sites-enabled/000-default.conf

L'indication de VirtualHost doit être modifiée (192.168.1.6 est l'adresse IP de VOTRE serveur Apache) :

<VirtualHost 192.168.1.6:80>

Redémarrer Apache, puis le cache côté Varnish :

$ sudo systemctl restart apache2.service $ sudo systemctl restart varnish.service

Sur le serveur Varnish, ouvrir le pare-feu :

$ sudo ufw allow 80 $ sudo ufw allow 22 $ sudo ufw enable

3 · Tester le serveur Varnish

À partir de votre navigateur, entrer l'adresse IP du serveur Varnish :

http://adresse-ip-de-votre-varnish/
Page par défaut d'Apache servie à travers Varnish
La page d'Apache, servie à travers le cache.

4 · Journaux et statistiques

Le classement des entrées

$ sudo varnishtop
Sortie de varnishtop
varnishtop : le palmarès des requêtes.

Les journaux

$ cd /var/log/varnish $ sudo tail -f varnish.log $ sudo tail -f varnishncsa.log

Les statistiques du cache

$ sudo varnishstat $ sudo varnishstat -1 $ sudo varnishstat -1 | grep -i cache
Sortie de varnishstat
varnishstat : hits, misses et compagnie.

5 · Purger le contenu du cache

Définir d'abord qui a le droit de purger, avec un ACL dans /etc/varnish/default.vcl :

# Qui a le droit de purger ? acl purge { "localhost"; "127.0.0.1"; "72.14.190.12"; "192.168.1.6"; } sub vcl_recv { # autoriser PURGE depuis localhost et les adresses de l'ACL if (req.method == "PURGE") { if (!client.ip ~ purge) { return(synth(405,"Not allowed.")); } return (purge); } }
72.14.190.12 est l'adresse IP de VOTRE serveur Varnish; 192.168.1.6 est celle d'un autre serveur depuis lequel vous voulez administrer Varnish.

Invalider un URL complet

$ varnishadm -T 127.0.0.1:6082 -S /etc/varnish/secret ban "req.http.host == www.example.com && req.url == /faq/bash-for-loop/"

Invalider tous les .html

$ varnishadm -T 127.0.0.1:6082 -S /etc/varnish/secret "ban req.http.host ~ www.example.com && req.url ~ .html"

Tout invalider

Redémarrer simplement le cache :

$ sudo systemctl restart varnish.service

6 · Informer WordPress de son URL d'accès

Dans les réglages de WordPress, mettre l'adresse IP de Varnish (ou le nom de domaine qui pointe sur Varnish). Si votre WordPress est dans /var/www/html/wordpress, l'URL doit être http://192.168.56.40/wordpress :

Réglages WordPress : adresse web du site pointant vers Varnish
Les réglages d'adresse dans WordPress.
Sans ce réglage, WordPress génère ses liens avec la mauvaise adresse et les visiteurs contournent le cache.

7 · L'exception : l'inventaire et l'admin passent tout droit

Au laboratoire Séparation, Cornucopia reçoit une page d'inventaire publique : les sachets de graines et les paniers qu'il reste, comptés dans une table à part à chaque visite. Un stock servi depuis la cache vendrait un sachet qu'on n'a plus : Varnish doit la laisser passer, comme l'admin de WordPress. C'est aussi la page que le test de charge BRUTAL vise : sans cache devant, la mesure montre le travail d'Apache, de PHP et de MySQL, donc l'effet de la séparation des serveurs. Adresses de référence : varnish30 (192.168.56.30), http20 (192.168.56.20), mysql10 (192.168.56.10) ; remplacez-les par les vôtres.

7.1 · Poser la page inventaire à côté de WordPress

Sur le serveur Apache (http20), à côté du WordPress de /var/www/html :

$ sudo mkdir -p /var/www/html/inventaire $ sudo wget -q https://evolutif.projet.autos/laboratoire/horizontal/separation/page-inventaire.php.txt -O /var/www/html/inventaire/index.php $ sudo chown -R www-data:www-data /var/www/html/inventaire

La page lit les accès à la base dans wp-config.php, crée la table inventaire au premier passage (1250 sachets de graines, 48 paniers) et affiche les quantités. Vérifier depuis le serveur Apache lui-même, sans passer par Varnish :

$ curl -s http://192.168.56.20/inventaire/ | grep -c 'Sachets de graines' 1
Aucun cookie n'est posé par cette page : sans l'exception de 7.2, Varnish la garderait en mémoire comme n'importe quelle page.

Pour la lire ou la modifier, voici son code complet :

<?php // Sous-projet S7 du fil rouge : la page d'inventaire de Cornucopia, celle que Varnish ne doit // jamais garder en mémoire : un stock servi depuis la cache vendrait un sachet qu'on n'a plus. // Une seule page PHP posée à côté du WordPress, sur le modèle de guide-des-semis/ : elle lit les // accès à la base dans wp-config.php (sans l'exécuter), crée et remplit sa table inventaire au // premier passage, puis affiche ce qu'il reste de sachets de graines et de paniers. // Chaque visite coûte une requête à MySQL (MariaDB) et une page assemblée par PHP : c'est la page // que le test de charge BRUTAL vise, à travers l'exception Varnish (return (pass) dans vcl_recv), // pour que la mesure montre le travail d'Apache, de PHP et de MySQL, donc l'effet de la séparation. // Aucun cookie n'est posé : sans l'exception, Varnish la garderait comme n'importe quelle page. // Le pied de page affiche l'heure de cuisson et le serveur qui a cuisiné : si l'heure ne bouge // pas d'un rechargement à l'autre, c'est la cache qui a servi la page, pas PHP. // Créé le 2026-10-05 (laboratoire B du module 2, séparation des serveurs). declare(strict_types=1); date_default_timezone_set('America/Toronto'); // l'heure du Québec pour « Page cuisinée à » const INVENTAIRE_DEPART = [ ['sachets-de-graines', 'Sachets de graines', '🌱', 1250, 'sachet'], ['paniers', 'Paniers de légumes de la semaine', '🧺', 48, 'panier'], ]; function lireConfigurationWordpress(string $cheminConfiguration): array { $contenu = @file_get_contents($cheminConfiguration); if ($contenu === false) { return []; } $configuration = []; foreach (['DB_NAME', 'DB_USER', 'DB_PASSWORD', 'DB_HOST'] as $clef) { if (preg_match('/define\(\s*[\'"]' . $clef . '[\'"]\s*,\s*[\'"]([^\'"]*)[\'"]/', $contenu, $captures)) { $configuration[$clef] = $captures[1]; } } return $configuration; } function ouvrirBaseDeDonnees(): PDO { $configuration = lireConfigurationWordpress(dirname(__DIR__) . '/wp-config.php'); if (count($configuration) < 4) { throw new RuntimeException('wp-config.php introuvable ou incomplet à côté du répertoire inventaire/.'); } $sourceDeDonnees = 'mysql:host=' . $configuration['DB_HOST'] . ';dbname=' . $configuration['DB_NAME'] . ';charset=utf8mb4'; $baseDeDonnees = new PDO($sourceDeDonnees, $configuration['DB_USER'], $configuration['DB_PASSWORD'], [ PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, ]); $baseDeDonnees->exec('CREATE TABLE IF NOT EXISTS inventaire ( identifiant INT UNSIGNED NOT NULL AUTO_INCREMENT, adresse VARCHAR(40) NOT NULL, produit VARCHAR(80) NOT NULL, emoji VARCHAR(16) NOT NULL, quantite INT UNSIGNED NOT NULL, unite VARCHAR(20) NOT NULL, PRIMARY KEY (identifiant), UNIQUE KEY adresse_unique (adresse) ) DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci'); if ((int)$baseDeDonnees->query('SELECT COUNT(*) FROM inventaire')->fetchColumn() === 0) { $insertion = $baseDeDonnees->prepare('INSERT IGNORE INTO inventaire (adresse, produit, emoji, quantite, unite) VALUES (?, ?, ?, ?, ?)'); foreach (INVENTAIRE_DEPART as $ligne) { $insertion->execute($ligne); } } return $baseDeDonnees; } function proteger(string $texte): string { return htmlspecialchars($texte, ENT_QUOTES, 'UTF-8'); } $lignesInventaire = []; $messagePanne = null; try { $baseDeDonnees = ouvrirBaseDeDonnees(); $lignesInventaire = $baseDeDonnees->query('SELECT produit, emoji, quantite, unite FROM inventaire ORDER BY identifiant')->fetchAll(PDO::FETCH_ASSOC); } catch (Throwable $exceptionGenerale) { http_response_code(503); $messagePanne = $exceptionGenerale->getMessage(); } $heureCuisson = date('H:i:s'); $serveurCuisinier = gethostname() ?: 'serveur inconnu'; ?> <!DOCTYPE html> <html lang="fr"> <head> <meta charset="utf-8"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>L'inventaire en direct - Cornucopia</title> <link rel="icon" href="../favicon.ico"> <link href="https://fonts.googleapis.com/css2?family=Lilita+One&family=Nunito:wght@400;700;800&display=swap" rel="stylesheet"> <style> :root { --ciel: #6EC9F5; --ciel-haut: #4FB3EE; --prairie: #58C127; --prairie-sombre: #2F7A12; --soleil: #FFD23F; --tomate: #FF3B30; --bois: #8B5A2B; --bois-fonce: #5C3A18; --creme: #FFFDF5; --encre: #223018; } * { box-sizing: border-box; } html { background: linear-gradient(180deg, var(--ciel-haut) 0%, var(--ciel) 55%, #A8E063 100%) fixed; min-height: 100vh; } body { margin: 0; min-height: 100vh; font-family: 'Nunito', sans-serif; font-weight: 700; color: var(--encre); } #scene { max-width: 760px; margin: 0 auto; padding: 26px 18px 60px; } #panneau-titre { background: linear-gradient(180deg, var(--bois) 0%, var(--bois-fonce) 100%); border: 5px solid var(--bois-fonce); border-radius: 22px; box-shadow: 0 10px 0 rgba(44, 26, 8, 0.55), 0 16px 26px rgba(0, 0, 0, 0.25); color: var(--creme); text-align: center; padding: 26px 22px 22px; } #panneau-titre h1 { font-family: 'Lilita One', cursive; font-size: clamp(1.7rem, 5vw, 2.6rem); margin: 0 0 6px; text-shadow: 2px 2px 0 var(--bois-fonce), 4px 4px 0 rgba(0, 0, 0, 0.25); } #panneau-titre p { margin: 0; opacity: 0.95; } #retour-ferme { display: inline-block; margin-top: 12px; color: var(--soleil); font-weight: 800; text-decoration: none; } #retour-ferme:hover { text-decoration: underline; } #inventaire { display: grid; grid-template-columns: repeat(auto-fit, minmax(240px, 1fr)); gap: 18px; margin-top: 26px; } .produit { background: var(--creme); border: 4px solid var(--bois-fonce); border-radius: 18px; box-shadow: 0 8px 0 rgba(44, 26, 8, 0.45); padding: 22px 18px; text-align: center; } .produit-emoji { font-size: 3rem; line-height: 1; } .produit-quantite { font-family: 'Lilita One', cursive; font-size: 3.2rem; color: var(--prairie-sombre); margin: 8px 0 2px; } .produit-quantite.epuise { color: var(--tomate); } .produit-nom { font-weight: 800; } .produit-unite { font-weight: 400; opacity: 0.8; } #boite-panne { background: var(--creme); border: 4px solid var(--tomate); border-radius: 18px; padding: 18px; margin-top: 26px; } #pied-cuisson { margin-top: 30px; text-align: center; background: rgba(255, 253, 245, 0.85); border-radius: 14px; padding: 12px 16px; font-weight: 400; } #pied-cuisson strong { font-weight: 800; } </style> </head> <body> <div id="scene"> <header id="panneau-titre"> <h1>L'inventaire en direct</h1> <p>Ce qu'il reste à la ferme de Flora et Hazel, compté à chaque visite.</p> <a id="retour-ferme" href="../">Retour à la ferme</a> </header> <?php if ($messagePanne !== null): ?> <div id="boite-panne"> <p>L'inventaire est indisponible : la base de données ne répond pas.</p> <p class="produit-unite"><?= proteger($messagePanne) ?></p> </div> <?php else: ?> <div id="inventaire"> <?php foreach ($lignesInventaire as $ligne): ?> <div class="produit"> <div class="produit-emoji"><?= proteger($ligne['emoji']) ?></div> <div class="produit-quantite<?= (int)$ligne['quantite'] === 0 ? ' epuise' : '' ?>"><?= (int)$ligne['quantite'] ?></div> <div class="produit-nom"><?= proteger($ligne['produit']) ?></div> <div class="produit-unite"><?= (int)$ligne['quantite'] === 0 ? 'épuisé' : proteger($ligne['unite']) . ((int)$ligne['quantite'] > 1 ? 's' : '') . ' en stock' ?></div> </div> <?php endforeach; ?> </div> <?php endif; ?> <footer id="pied-cuisson"> Page cuisinée à <strong><?= $heureCuisson ?></strong> par <strong><?= proteger($serveurCuisinier) ?></strong>. Si l'heure ne bouge pas quand vous rechargez, c'est la cache qui vous a servi. </footer> </div> </body> </html>

7.2 · Dire à Varnish de laisser passer

Sur le serveur Varnish, dans /etc/varnish/default.vcl, au début de la sous-routine vcl_recv (celle de l'étape 5, ou une nouvelle : Varnish les enchaîne) :

$ sudo nano /etc/varnish/default.vcl
sub vcl_recv { # l'inventaire et l'admin ne passent jamais par la cache if (req.url ~ "^/inventaire" || req.url ~ "^/wp-admin" || req.url ~ "^/wp-login.php") { return (pass); } }

Recharger la configuration sans vider la cache :

$ sudo systemctl reload varnish.service
return (pass) : Varnish transmet la requête à Apache et renvoie la réponse sans la garder. Tout le reste du site continue d'être servi depuis la cache.

7.3 · La preuve, puis le test de charge

$ curl -sI http://192.168.56.30/inventaire/ | grep -i '^age' Age: 0 $ curl -sI http://192.168.56.30/inventaire/ | grep -i '^age' Age: 0 $ curl -sI http://192.168.56.30/ | grep -i '^age' Age: 37

L'inventaire répond Age: 0 à chaque appel et son pied de page « Page cuisinée à » change à chaque rechargement ; l'accueil, lui, vieillit dans la cache. Le test de charge BRUTAL de JMeter vise http://192.168.56.30/inventaire/ : chaque requête traverse Varnish sans s'y arrêter, fait travailler http20 puis mysql10, et les captures de top montrent où la charge atterrit.