Rocky Linux 10 : tutoriel / Configurer un site Nginx avec SELinux et firewalld
Pour configurer un site Nginx sur Rocky Linux 10, vous devez séparer la configuration du site et les répertoires de documents, et vérifier la configuration Nginx, les permissions des fichiers, le contexte SELinux et le pare-feu dans l'ordre. Dans ce tutoriel, nous maintiendrons le site par défaut existant sur le port 80 tout en ajoutant un site statique sur le port 18025, et comparerons les réponses localement et depuis d'autres ordinateurs.
Domaine de pratique et vérification des sites existants
Nginx est un serveur web qui reçoit des requêtes et livre des fichiers ou relaie les requêtes à d'autres programmes. Ici, nous ne traitons que les sites statiques qui servent des fichiers directement. L'exécution de PHP, le proxy inverse et les certificats HTTPS nécessitent une configuration séparée.
Effectuez l'exercice sur une machine virtuelle (VM) Rocky Linux 10 séparée avec un utilisateur disposant des privilèges sudo et un accès à la console préparé. L'environnement de laboratoire source était Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux en mode Enforcing. Dans cet environnement, Apache était arrêté et il n'y avait aucun écouteur de port web existant. S'il y a des services actuellement en cours d'exécution, vous devez vérifier les ports et les configurations avant d'installer et de démarrer.
cat /etc/rocky-release
sudo ss -lntp
systemctl is-active nginx httpd
sudo firewall-cmd --get-active-zones
getenforce
sudo dnf install nginx policycoreutils-python-utils
rpm -q nginx
sudo nginx -t
Si un service n'a pas été installé ou a été arrêté dans is-active, le code de sortie peut ne pas être 0. Lisez les résultats de la vérification de l'état pour juger. Si Apache utilise déjà le port 80, il entrera en conflit avec la configuration par défaut de Nginx, donc ne le démarrez pas tel quel.
Dans le fichier /etc/nginx/nginx.conf fourni par le paquet Rocky, include /etc/nginx/conf.d/*.conf; a été inclus dans la section http. Ne supposez pas la structure sites-available de Debian ou Ubuntu ; vérifiez les paramètres réels du paquet. sudo nginx -T affiche tous les paramètres à appliquer, mais ne partagez aucune valeur secrète à l'extérieur.
sudo bash <<'BASH'
set -eu
test ! -e /root/lf-course25-before
install -d -m 0700 /root/lf-course25-before
cp -a /etc/nginx /root/lf-course25-before/nginx
BASH
sudo nginx -t && sudo systemctl start nginx
curl -sS -o /tmp/lf25-default-before.html -w 'HTTP %{http_code}\n' http://127.0.0.1/
Si la première vérification montre qu'un répertoire de sauvegarde existe déjà, arrêtez-vous et vérifiez l'état de l'exercice précédent. La commande ci-dessus est basée sur un nouvel environnement d'exercice avec des ports vides. Le site par défaut dans cet environnement a renvoyé HTTP 200. Au lieu de remplacer entièrement le fichier de configuration par défaut, nous allons ajouter un fichier séparé.
Créer le répertoire des documents et la configuration du site
Le nom à utiliser dans cet exercice est course25.test, et le répertoire des documents est /srv/lf-web25. .test est un nom de test, et l'écriture de ce nom dans server_name ne crée pas d'enregistrement DNS qui relie le nom de domaine à une adresse IP. Tout d'abord, testez en spécifiant le nom du site en utilisant l'en-tête Host de curl.
sudo bash <<'BASH'
set -eu
test ! -e /srv/lf-web25
test ! -e /etc/nginx/conf.d/lf-course25.conf
LISTENERS=$(ss -H -lnt 'sport = :18025')
test -z "$LISTENERS"
install -d -m 0755 /srv/lf-web25
printf 'LF25 nginx site works\n' > /srv/lf-web25/index.html
chmod 0644 /srv/lf-web25/index.html
cat > /etc/nginx/conf.d/lf-course25.conf <<'EOF'
server {
listen 18025;
server_name course25.test;
root /srv/lf-web25;
index index.html;
access_log /var/log/nginx/lf-course25-access.log;
error_log /var/log/nginx/lf-course25-error.log;
location / {
try_files $uri $uri/ =404;
}
}
EOF
BASH
S'il existe déjà un chemin ou si le port 18025 est utilisé par un autre programme, n’écrasez pas les éléments existants avec cet exemple. Le répertoire 0755 accorde la permission de traverser le chemin et de lire la liste du répertoire, tandis que le fichier 0644 permet de lire le contenu. Il n'est pas nécessaire de changer le propriétaire des fichiers statiques que Nginx lit uniquement au compte du serveur web ni de les ouvrir avec 0777. Les chemins de niveau supérieur doivent également disposer des permissions de traversée.
| Paramètres | Rôles et points à vérifier |
|---|---|
listen 18025 |
Ceci est le port TCP qui reçoit les requêtes. Comme une adresse IPv4 n'a pas été spécifiée, cet exercice reçoit également des requêtes provenant d'interfaces externes. La plage publique externe est limitée par le pare-feu et le réseau de la VM. |
server_name |
Ceci est la condition pour sélectionner le bloc serveur qui correspond au nom des requêtes arrivant à la même adresse et au même port. Ce n'est pas une fonctionnalité d'enregistrement DNS ou d'authentification d'accès. |
root et index |
Définit le chemin racine des fichiers et le document par défaut pour les requêtes de répertoire. Ici, les requêtes / sont traitées comme index.html. |
try_files |
Trouve le fichier ou le répertoire correspondant à l'URI de la requête et renvoie 404 si non trouvé. $uri est une variable Nginx, pas une variable shell, donc elle est stockée telle quelle dans un heredoc avec des guillemets. |
| Journaux spécifiques au site | Sépare les fichiers de journal d'accès et d'erreur pour éviter de mélanger les requêtes provenant de différents sites. |
Le guide d’introduction officiel de Nginx explique les blocs de configuration et la distribution des fichiers statiques. La documentation de la directive try_files décrit la recherche de fichiers et la dernière étape de traitement.
Contextes de chemin et autorisations de port SELinux
Même si les permissions générales des fichiers sont correctes, SELinux doit autoriser l'accès. SELinux compare les contextes de sécurité attachés aux processus et aux fichiers avec ses politiques. Le processus Nginx dans cet environnement s'exécutait dans le domaine httpd_t, et le nouveau document /srv a été initialement var_t.
ls -Zd /srv/lf-web25 /srv/lf-web25/index.html
sudo semanage fcontext -l -C
sudo semanage port -l | grep http_port_t
sudo semanage fcontext -a -t httpd_sys_content_t '/srv/lf-web25(/.*)?'
sudo restorecon -Rv /srv/lf-web25
sudo semanage port -a -t http_port_t -p tcp 18025
sudo nginx -t && sudo systemctl reload nginx
sudo ss -lntp 'sport = :18025'
semanage fcontext enregistre des règles permanentes à appliquer aux chemins, et restorecon applique ces règles aux fichiers réels. L'enregistrement des règles ne change pas immédiatement le contexte des fichiers existants. httpd_sys_content_t est utilisé pour les documents à lire sur ce site statique, les distinguant des chemins nécessitant des permissions d'écriture pour des actions comme les téléversements. Pour des principes détaillés, référez-vous à documentation SELinux de Rocky Linux .
Le port 18025 a été nouvellement enregistré car il n'était pas inclus dans les ports HTTP autorisés au début de la pratique. Si le port est déjà enregistré pour un autre type, ne le modifiez pas automatiquement en -m après avoir reçu une erreur. Vérifiez d'abord les services existants, puis choisissez un port disponible ou examinez la portée de la politique nécessaire. L'autorisation des ports SELinux est distincte de l'autorisation des paquets réseau dans firewalld.
Dans la comparaison de sources, lorsque seul le port avait été autorisé initialement et que le document était var_t, l'erreur HTTP 403 s'est produite et le journal d'audit a enregistré un refus AVC (Access Vector Cache) où httpd_t ne pouvait pas accéder au fichier var_t. Après l'application des règles de chemin et de restorecon, cela est passé à 200. SELinux n'a pas été désactivé, et le service entier n'a pas été mis en mode permissif.
Comparaison de la réponse locale avec la réponse d'un autre ordinateur
curl -sS -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/
curl -sS -o /dev/null -H 'Host: course25.test' -w 'HTTP %{http_code}\n' http://127.0.0.1:18025/missing
Pour la première requête, LF25 nginx site works et 200 sont attendus, et un chemin inexistant devrait retourner 404. Ne vous contentez pas de regarder le chiffre 200 ; vérifiez également si le contenu du site correspond à ce qui est attendu. Le succès local est la preuve que Nginx et l'accès au document sont possibles, mais cela ne signifie pas que le chemin réseau externe a réussi.
Vérifiez la zone à laquelle appartient l'interface externe et n'autorisez que les ports de pratique pour cette zone. Le public ci-dessous est la valeur vérifiée sur cette VM, donc changez-la pour la valeur réelle dans d'autres environnements. Ne modifiez pas les règles d'autorisation SSH existantes.
sudo firewall-cmd --get-active-zones
sudo firewall-cmd --zone=public --add-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp
Sur un autre ordinateur du même réseau, effectuez la requête en utilisant l'adresse IPv4 du serveur réelle. L'IP suivante est un exemple, donc ne l'utilisez pas telle quelle. Sous Windows, vous pouvez utiliser curl.exe pour la distinguer des alias PowerShell.
curl --max-time 5 -sS -H 'Host: course25.test' http://192.0.2.10:18025/
L'environnement NAT (Network Address Translation) de VirtualBox ne permet pas d'accéder directement à l'adresse de l'invité depuis l'hôte. En ajoutant une règle pratique dans les paramètres de la VM : Réseau → Adaptateur 1 → Avancé → Redirection de ports avec TCP, IP de l'hôte 127.0.0.1, Port de l'hôte 18025, et Port de l'invité 18025, vous pouvez vérifier http://127.0.0.1:18025/ depuis l'hôte. Si vous laissez l'IP de l'hôte vide, la plage d'exposition pourrait augmenter, donc elle est spécifiée pour la pratique locale. L'autorisation du pare-feu de l'invité reste toujours nécessaire.
Dans la pratique source, des requêtes étaient faites à la VM via le transfert NAT localhost depuis curl sous Windows. Avant d'autoriser le pare-feu, cela expirait sans réponse pendant 4 secondes, et après avoir autorisé le port d'exécution, le même contenu et 200 ont été confirmés. Cela ne teste pas l'accès public à Internet ni le succès réel des requêtes DNS.
sudo firewall-cmd --permanent --zone=public --add-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --query-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp
Les deux requêtes doivent être yes pour refléter les paramètres actuels et enregistrés. Vous n'avez pas besoin de recharger tout le pare-feu pour ajouter séparément l'autorisation actuelle et l'autorisation permanente. À ce stade, le test de persistance après redémarrage n'a pas été effectué. La distinction entre les deux paramètres est également expliquée dans la documentation officielle de firewalld sur l’ouverture des ports. La définition de service http du HTTP standard signifie généralement le port 80, donc ne la confondez pas avec cette autorisation de port non standard.
Diagnostiquer en distinguant entre les erreurs 403, 404 et les erreurs de configuration
Si la connexion est refusée ou expire, vérifiez d'abord le listener, l'adresse et le réseau de la VM, ainsi que la zone réelle. Si une réponse HTTP arrive, vérifiez le site qui a traité cette requête et les journaux. Ne concluez pas qu'il s'agit d'un problème SELinux uniquement sur la base d'un 403.
sudo nginx -t
sudo systemctl status nginx --no-pager
sudo journalctl -u nginx -b -n 30 --no-pager
sudo tail -n 20 /var/log/nginx/lf-course25-access.log
sudo tail -n 20 /var/log/nginx/lf-course25-error.log
namei -l /srv/lf-web25/index.html
ls -Z /srv/lf-web25/index.html
sudo ausearch --input-logs -m AVC -c nginx -ts recent -i
En pratique, même si le contexte SELinux correct est maintenu, changer le fichier pour qu'il soit possédé par root avec les permissions 0600 a résulté en un 403, et le rétablir en 0644 a renvoyé un 200. Le Permission denied dans le journal d'erreurs peut apparaître à la fois à partir de permissions régulières et de SELinux, donc corrélez les événements AVC au moment de la requête échouée avec les permissions des chemins. Ne déterminez pas une cause spécifique uniquement sur le fait qu'il n'y ait pas de journal. Un 404 pour un chemin inexistant est le résultat prévu de ce try_files.
Après avoir modifié les paramètres, connectez la vérification réussie et l'application comme dans sudo nginx -t && sudo systemctl reload nginx. En pratique, lorsqu'une directive inexistante a été ajoutée à un fichier, la vérification de la configuration a échoué avec le code de sortie 1, mais le processus Nginx existant qui ne l'avait pas encore appliquée a continué à renvoyer 200 avec le même PID. Le laboratoire a immédiatement rétabli le contenu original du fichier et répété la vérification. Ne jugez pas la configuration stockée comme normale simplement parce qu'elle renvoie la réponse précédente.
De plus, pour cette instance 18025, il n'y avait qu'un seul bloc serveur, donc même lors de la requête via Host: another.test, le même site renvoyait 200. Cela s'explique par le fait que s'il n'y a pas de nom correspondant, le serveur par défaut pour cette adresse et ce port peut être sélectionné. server_name n'est pas un dispositif de restriction d'accès, et si vous souhaitez rejeter les noms inconnus, vous devez concevoir un serveur par défaut séparé et une politique de réponse explicite. Pour les règles détaillées sur la sélection des noms, consultez la documentation de Nginx sur les noms de serveur.
Vérifiez le site existant et supprimez la configuration du laboratoire
Après la mise en place du nouveau site, vérifiez également le site par défaut original sur le port 80. Lors de la comparaison avec la réponse initialement enregistrée, le corps doit être identique pour conclure que la page par défaut statique actuelle n'a pas été modifiée. Étant donné que les réponses dynamiques des sites en fonctionnement réel peuvent varier dans le temps, les fonctions principales, le statut et le contenu doivent être comparés séparément.
curl -sS -o /tmp/lf25-default-after.html -w 'HTTP %{http_code}\n' http://127.0.0.1/
cmp /tmp/lf25-default-before.html /tmp/lf25-default-after.html
sudo diff -u /root/lf-course25-before/nginx/nginx.conf /etc/nginx/nginx.conf
Dans les trois comparaisons de sources enregistrées, le site par défaut a renvoyé 200 à chaque fois et les corps des réponses étaient identiques. Les fichiers de configuration existants, y compris nginx.conf, ont été conservés. Si ce serveur continuera à être utilisé, conservez uniquement les sites nécessaires, et lorsque le démarrage automatique après redémarrage est requis, sélectionnez sudo systemctl enable nginx puis vérifiez séparément le redémarrage.
Lors de la suppression de la pratique, déplacez d'abord les fichiers du site que vous avez ajoutés vers un emplacement de sauvegarde, puis vérifiez et rechargez. Les commandes suivantes s'appliquent uniquement aux fichiers et règles nouvellement créés dans ce cours. Ne supprimez aucune règle de chemin ou de port existante que vous avez réutilisée.
sudo mv /etc/nginx/conf.d/lf-course25.conf /root/lf-course25-before/site.conf
sudo nginx -t && sudo systemctl reload nginx
sudo firewall-cmd --zone=public --remove-port=18025/tcp
sudo firewall-cmd --permanent --zone=public --remove-port=18025/tcp
sudo semanage fcontext -d '/srv/lf-web25(/.*)?'
sudo semanage port -d -p tcp 18025
sudo rm -- /srv/lf-web25/index.html
sudo rmdir /srv/lf-web25
Après l'application des paramètres, vérifiez que le listener 18025 a disparu et supprimez les règles de transfert de port ajoutées à la VM. Sauvegardez les journaux de la pratique si nécessaire. Dans la VM source, de nouveaux journaux ont été stockés, et les fichiers du site, documents, politiques, règles de pare-feu et NAT ont été nettoyés avant l'arrêt de Nginx. Les paramètres et le pare-feu existants ont été comparés à l'état initial, tandis que SSH, le statut actif de firewalld et SELinux en mode Enforcing ont été maintenus. Le paquet Nginx a été laissé pour les pratiques suivantes.




