Debian 13 : tutoriel / Configurer un site Nginx et diagnostiquer les réponses HTTP 403 et 404
Sur Debian 13, les sites Nginx peuvent stocker les configurations dans sites-available et être activés via des liens symboliques dans sites-enabled. Après avoir vérifié la configuration, appliquez-la avec reload, et vérifiez séparément le port, la valeur de l’en-tête Host, les permissions des fichiers et les réponses HTTP réelles. Ce tutoriel ajoute un site statique sur 127.0.0.1:8080 tout en conservant le site par défaut et compare les causes des réponses 200, 403 et 404.
Vérifiez la portée du laboratoire du site statique et les écouteurs existants
Nginx est un serveur web qui reçoit des requêtes HTTP (Hypertext Transfer Protocol, protocole de transfert hypertexte) et sert des fichiers ou transmet les requêtes à d'autres applications. Ici, nous allons seulement configurer un site statique servant des fichiers HTML directement. Vous avez besoin d'un utilisateur régulier de Debian 13 avec des privilèges sudo et curl, et toutes les vérifications HTTP doivent être exécutées à l'intérieur de la machine virtuelle Debian. L'exemple écoute uniquement sur l’adresse de boucle locale de la machine virtuelle. L'accès depuis un PC hôte nécessiterait un plan séparé pour l'adresse d'écoute et le transfert ; ce laboratoire maintient toutes les requêtes à l'intérieur de la VM.
Lors de l'installation du paquet, le site par défaut peut démarrer. Sur un serveur de production réel, vérifiez d'abord les conflits avec les serveurs web existants sur les ports 80 et 443 et établissez des procédures de maintenance. Vérifiez également que 127.0.0.1:8080 n'est pas utilisé. Si un autre service occupe une adresse et un port nécessaires, arrêtez cette installation et identifiez le conflit au lieu d'arrêter ce service.
ss -ltn
dpkg-query -W nginx nginx-common 2>/dev/null
apt-cache policy nginx
dpkg-query sur des paquets non installés peut renvoyer un statut non nul. Cela seul n'est pas une erreur système. Sur la VM de pratique, Nginx n'était pas installé et seul SSH sur le port 22 était ouvert. Il a été installé depuis le dépôt Debian comme suit.
sudo apt update
sudo apt install nginx curl
nginx -v
systemctl is-active nginx
systemctl is-enabled nginx
sudo nginx -t
Les paquets nginx et nginx-common installés sur cette VM étaient de version 1.26.3-3+deb13u10, et le service était actif et activé. Les numéros de révision des paquets peuvent varier selon le moment du déploiement et les mises à jour de sécurité. Si le service ne démarre pas, vérifiez la cause réelle, par exemple un échec de liaison, avec systemctl status nginx --no-pager et sudo journalctl -u nginx -n 50 --no-pager.
Inspectez les chemins d'inclusion de Debian et sauvegardez les originaux
Le répertoire sites-available est l'endroit où les fichiers de configuration sont stockés, et tous les fichiers qu'il contient ne sont pas appliqués automatiquement. Dans le paquet pratique, /etc/nginx/nginx.conf incluait /etc/nginx/conf.d/*.conf et /etc/nginx/sites-enabled/* dans le contexte http. Procédez après avoir vérifié directement cette règle.
grep -nE 'user |include .*(conf.d|sites-enabled)' /etc/nginx/nginx.conf
ls -l /etc/nginx/sites-enabled
sudo nginx -T | less
nginx -T affiche toutes les configurations incluses ainsi qu'une vérification. Étant donné que des informations d'authentification ou des adresses internes peuvent être incluses, ne publiez pas cette sortie sans l’avoir examinée. Dans less, quittez avec q. Sur cette VM, les processus de traitement des requêtes, appelés workers, utilisaient le compte www-data, et le lien du site par défaut a été conservé.
Ce qui suit est un bloc de préparation pour vérifier que le chemin de pratique n'existe pas et pour préserver l'original. Exécutez dans le même terminal Bash. Si le chemin existe déjà, arrêtez sans supprimer ni écraser. Les sauvegardes des configurations opérationnelles préparées par le lecteur doivent également inclure tous les fichiers d'inclusion et certificats associés.
set -euo pipefail
for p in /srv/lf-web25 /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25 /var/backups/lf-debian13-25; do
if test -e "$p" || test -L "$p"; then
echo "Path already exists: $p" >&2
exit 1
fi
done
sudo install -d -m 700 /var/backups/lf-debian13-25
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/sites-available/default /var/backups/lf-debian13-25/
sudo sha256sum /etc/nginx/nginx.conf /etc/nginx/sites-available/default | sudo tee /var/backups/lf-debian13-25/original.sha256
Créer des fichiers statiques et la configuration complète de l'hôte virtuel
Les fichiers du site de pratique sont placés dans /srv/lf-web25/public. L'administrateur possède les fichiers, et le processus worker Nginx peut seulement les lire. Les répertoires ont besoin de la permission d'exécution pour traverser le chemin, et les fichiers ont besoin de la permission de lecture. Cet exemple s'applique uniquement aux fichiers statiques publics, et les mots de passe ou les documents privés ne sont pas placés dans ce chemin.
sudo install -d -m 755 /srv/lf-web25/public /srv/lf-web25/public/empty
printf '%s
' '<!doctype html><html lang="en"><meta charset="utf-8"><title>Lab 25</title><h1>LF WEB 25</h1></html>' | sudo tee /srv/lf-web25/public/index.html
sudo chmod 644 /srv/lf-web25/public/index.html
Écrire tout le bloc suivant dans le fichier de configuration. Le terminateur heredoc cité CONF préserve $uri en tant que variable Nginx, et non en tant que variable shell. L'encapsuleur shell est un bloc Bash ; le contenu entre les marqueurs CONF est la configuration complète de Nginx.
sudo tee /etc/nginx/sites-available/lf-web25 > /dev/null <<'CONF'
server {
listen 127.0.0.1:8080 default_server;
server_name _;
return 404;
}
server {
listen 127.0.0.1:8080;
server_name lab25.test;
root /srv/lf-web25/public;
index index.html;
access_log /var/log/nginx/lf-web25-access.log;
error_log /var/log/nginx/lf-web25-error.log;
location / {
try_files $uri $uri/ =404;
}
}
CONF
| Paramètres | Rôle de cette pratique |
|---|---|
| listen 127.0.0.1:8080 | Il n'accepte que les connexions provenant de la boucle locale de la VM elle-même. Il ne peut pas être directement accessible depuis Internet. |
| default_server | Spécifie le serveur par défaut pour les requêtes avec des noms non correspondants à cette adresse et ce port. |
| server_name lab25.test | Dirige vers ce site les requêtes dont l’en-tête Host correspond à lab25.test. Il ne crée pas d'enregistrements DNS. |
| root et index | Définit le chemin des fichiers pour trouver l’URI (Uniform Resource Identifier, identifiant de ressource) de la requête et le fichier par défaut pour le répertoire. |
| try_files $uri $uri/ =404 | Vérifie le fichier ou le répertoire et renvoie 404 si non trouvé. |
La valeur _ de server_name n’est pas un joker spécial qui capture tous les noms. Ici, default_server détermine le choix par défaut. Si vous dupliquez cela sur la même adresse et le même port, une erreur peut se produire, alors vérifiez les paramètres existants. La documentation de gestion des requêtes de Nginx explique l'ordre de sélection : d'abord l'adresse et le port, puis la détermination du nom d'hôte et du serveur par défaut.
Créez le lien symbolique d’activation, vérifiez la configuration, puis appliquez-la. Continuez dans la session Bash dédiée. La chaîne && suivante exécute reload uniquement lorsque nginx -t réussit ; une vérification échouée doit être corrigée avant de continuer.
sudo ln -s /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
systemctl is-active nginx
ss -ltn | grep '127.0.0.1:8080'
Reload fait relire la configuration, mais l'acte de sauvegarder le fichier de configuration lui-même n'est pas appliqué au processus en cours. Même si cela réussit le contrôle, cela ne garantit pas les permissions réelles de lecture de fichiers du worker ni la réponse souhaitée de l'hôte, donc la vérification HTTP continue. La portée des options nginx -t et -T peut être vérifiée dans la documentation de la commande nginx de Debian.
Comparer la sélection par Host, les réponses HTTP et le DNS
La commande suivante utilise --noproxy pour exclure les effets des variables d'environnement du proxy. La première requête est faite vers le site réel, la deuxième vers le serveur par défaut avec un nom non correspondant, la troisième vers un fichier inexistant, et la quatrième vers un répertoire sans index.
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: other.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/missing
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/empty/
| Requête | Résultat vérifié | Interprétation |
|---|---|---|
| lab25.test / | 200, LF WEB 25 | Sélectionné le site souhaité et les fichiers statiques. |
| other.test / | 404 | Ceci est la valeur de retour explicite du serveur par défaut. |
| lab25.test /missing | 404 | Impossible de trouver le fichier cible sur le site correspondant. |
| lab25.test /empty/ | 403 | Il y a un répertoire, mais pas d'index, et la liste des répertoires n'est pas autorisée. |
Par défaut, curl ne considère pas la réception d’un HTTP 404 comme une erreur de processus. Pour des vérifications automatisées, utilisez -f pour retourner une erreur en cas de réponse HTTP erronée, ou imprimez le statut avec -w et comparez-le explicitement. Imprimer un statut avec -w seul ne fait pas qu’une erreur HTTP produise un code de sortie curl échoué. Pour écrire le nom du site dans l’URL mais le demander sans changer le DNS public, utilisez la commande suivante. --resolve fournit uniquement le mappage nom, port et adresse pour cette requête curl.
curl --noproxy '*' -fsS --resolve lab25.test:8080:127.0.0.1 http://lab25.test:8080/
Même si la commande réussit, lab25.test n’est pas enregistré dans le DNS de l’internet. Pour rendre un service externe public, vous avez besoin d’un domaine réel, du chemin vers le serveur, d’une adresse d’écoute appropriée, d’un pare-feu et d’HTTPS séparément. Suivre cet exercice ne nécessite pas d’ouvrir le port 8080 vers l’extérieur.
Faire correspondre les échecs de permission de fichier avec les journaux d'erreurs
Même si vous obtenez le même 403, la cause peut différer. Voici une comparaison où nous avons changé un seul fichier appartenant à root créé dans cet exercice en 600, supprimant la permission de lecture du worker www-data, puis avons effectué une requête. Ne l'appliquez pas aux fichiers opérationnels. Vérifiez le statut HTTP et restaurez immédiatement à 644.
sudo chmod 600 /srv/lf-web25/public/index.html
curl --noproxy '*' -sS -o /dev/null -w '%{http_code}
' -H 'Host: lab25.test' http://127.0.0.1:8080/
namei -l /srv/lf-web25/public/index.html
sudo tail -n 10 /var/log/nginx/lf-web25-error.log
sudo chmod 644 /srv/lf-web25/public/index.html
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/
Le résultat réel était 403 avec Permission denied lorsqu'il était défini sur 600, et 200 après restauration. La requête précédente /empty/ produisait en revanche le message directory index is forbidden. Les journaux permettent donc de distinguer ces deux causes de HTTP 403. namei montre les permissions jusqu'aux répertoires intermédiaires. Si vous n'avez pas la permission de traverser les répertoires d'un répertoire parent, le fichier final ne peut pas être lu même s'il est en 644.
Ne le résolvez pas avec chmod -R 777. Vérifiez le chemin, le propriétaire, le compte du travailleur, les listes de contrôle d’accès (ACL, Access Control Lists), et les journaux de refus AppArmor si nécessaire, et accordez uniquement les permissions nécessaires. Même si la vérification de la configuration Nginx réussit en root, ce n'est pas la même chose que le travailleur www-data puisse lire. Le journal d'accès est utilisé pour voir les requêtes et le statut, et le journal d'erreurs est utilisé pour déterminer la raison du refus.
Récupérez la configuration du site et nettoyez le laboratoire
Avant de modifier les paramètres, faites une copie séparée de la version connue pour fonctionner de ce site. Lors du processus de vérification, lorsqu'une configuration avec des directives inconnues est rejetée par nginx -t, les workers existants qui n'ont pas été rechargés ont continué à renvoyer 200. Restaurez le fichier en échec à la version connue pour fonctionner et vérifiez à nouveau. Les lecteurs devraient prendre l'habitude de copier, vérifier et appliquer la version connue pour fonctionner sans créer d'erreurs dans les paramètres de production.
sudo cp -a /etc/nginx/sites-available/lf-web25 /var/backups/lf-debian13-25/good-site
sudo nginx -t && sudo systemctl reload nginx
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/
Pour restaurer ce fichier de laboratoire, comparez-le avec sudo diff -u /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25. Si le fichier enregistré est la version prévue, restaurez-le avec sudo cp -a /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25. Exécutez la commande ci-dessus qui n’exécute reload que si nginx -t réussit et répétez la requête HTTP portant l’en-tête Host du site. Conservez toutes les modifications récentes prévues avant de copier.
S'il y a un problème avec le site modifié, comparez la version connue comme bonne juste enregistrée avec le fichier actuel et restaurez uniquement le fichier de ce site. Ne remplacez pas imprudemment les paramètres communs. Le comportement de remplacement des workers lors du rechargement et la gestion en cas d'échec peuvent être confirmés dans le guide de rechargement de la configuration Nginx.
Pour mettre fin à la pratique, retirez d'abord le lien et arrêtez le serveur dédié sur le port 8080 avec vérification et rechargement. N'arrêtez pas le site par défaut ni le service Nginx entier. Si vous voulez conserver les logs avant d'effectuer les étapes ci-dessous, copiez les deux logs dédiés dans le dossier de sauvegarde.
sudo cp -a /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log /var/backups/lf-debian13-25/
sudo rm -- /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
ss -ltn
sudo sha256sum -c /var/backups/lf-debian13-25/original.sha256
Juste après le rechargement, laissez un peu de temps aux processus workers existants pour terminer les requêtes, puis vérifiez à nouveau. Après avoir confirmé que le service d'écoute 127.0.0.1:8080 a disparu et que le hachage original est correct, nettoyez uniquement les fichiers dédiés. Dans l'environnement de production, vérifiez également que les processus workers encore présents n'accèdent plus aux journaux dédiés.
sudo rm -- /etc/nginx/sites-available/lf-web25 /srv/lf-web25/public/index.html
sudo rmdir /srv/lf-web25/public/empty /srv/lf-web25/public /srv/lf-web25
sudo rm -- /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log
systemctl is-active nginx
Lors de la vérification finale, le service d'écoute et les fichiers dédiés ont été supprimés, les hachages de nginx.conf et du site par défaut ont été conservés, et Nginx lui-même était actif. Les paquets installés ont été conservés. La suppression des paquets sera décidée séparément après vérification de leur utilisation avec d'autres sites et de leur usage futur.




