Rocky Linux 10: guida / Configurare un sito statico Nginx e diagnosticare 403 e 404

Per configurare un sito Nginx su Rocky Linux 10, è necessario separare la configurazione del sito e le directory dei documenti, e controllare la configurazione di Nginx, i permessi dei file, il contesto SELinux e il firewall in sequenza. In questo tutorial, manterremo il sito predefinito esistente sulla porta 80 mentre aggiungiamo un sito statico sulla porta 18025, e confronteremo le risposte localmente e da altri computer.

Ambito della pratica e controllo dei siti esistenti

Nginx è un server web che riceve richieste e consegna file oppure inoltra richieste ad altri programmi. Qui, gestiamo solo siti statici che servono file direttamente. L'esecuzione di PHP, il reverse proxy e i certificati HTTPS richiedono una configurazione separata.

Esegui l'esercizio su una macchina virtuale (VM) separata Rocky Linux 10 con un utente che possiede privilegi sudo e accesso alla console preparato. L'ambiente di laboratorio di origine era Rocky Linux 10.2, Nginx 1.26.3-6.el10_2.7, SELinux Enforcing. In questo ambiente, Apache era fermo e non c'era alcun listener sulla porta web esistente. Se ci sono servizi attualmente in esecuzione, dovresti controllare le porte e le configurazioni prima di installare e avviare.

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

Se un servizio non è stato installato o è stato arrestato in is-active, il codice di uscita potrebbe non essere 0. Leggere i risultati del controllo dello stato per fare un giudizio. Se Apache sta già usando la porta 80, entrerà in conflitto con la configurazione predefinita di Nginx, quindi non avviarlo così com'è.

Nel pacchetto Rocky /etc/nginx/nginx.conf, include /etc/nginx/conf.d/*.conf; era incluso nella sezione http. Non assumere la struttura sites-available di Debian o Ubuntu; controlla le impostazioni effettive del pacchetto. sudo nginx -T restituisce tutte le impostazioni da applicare, ma non condividere valori segreti all'esterno.

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/

Se il primo controllo mostra che una directory di backup esiste già, fermati e verifica lo stato dell'esercizio precedente. Il comando sopra è basato su un nuovo ambiente di esercizio con porte vuote. Il sito predefinito in questo ambiente ha restituito HTTP 200. Invece di sostituire completamente il file di configurazione predefinito, aggiungeremo un file separato.

Crea la directory dei documenti e la configurazione del sito

Il nome da utilizzare in questo esercizio è course25.test, e la directory dei documenti è /srv/lf-web25. .test è un nome di test, e scrivere questo nome in server_name non crea un record DNS che collega il nome di dominio a un indirizzo IP. Per prima cosa, testa specificando il nome del sito usando l'header Host di 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

Se esiste già un percorso o la porta 18025 è utilizzata da un altro programma, non sovrascrivere questo esempio così com'è. La directory 0755 concede il permesso di attraversare il percorso e leggere l'elenco della directory, mentre il file 0644 consente di leggere i contenuti. Non è necessario cambiare il proprietario dei file statici che Nginx legge solo per l'account del server web o aprirli con 0777. Anche i percorsi di livello superiore devono avere i permessi di attraversamento.

Impostazioni Ruoli e Punti da Controllare
listen 18025 Questa è la porta TCP che riceve le richieste. Poiché non è stato specificato un indirizzo IPv4, questo esercizio riceve richieste anche dalle interfacce esterne. L'intervallo pubblico esterno è limitato dal firewall e dalla rete della VM.
server_name Questa è la condizione per selezionare il blocco server che corrisponde al nome richiesto tra le connessioni ricevute sullo stesso indirizzo e porta del server. Non è una registrazione DNS né una funzionalità di autenticazione dell'accesso.
root e index Imposta il percorso della radice dei file e il documento predefinito per le richieste di directory. Qui, le richieste / sono gestite come index.html.
try_files Trova il file o la directory corrispondente all'URI della richiesta e restituisce 404 se non trovato. $uri è una variabile di Nginx, non una variabile della shell, quindi viene memorizzata così com'è in un heredoc con virgolette.
Log specifici del sito Separa i file di log degli accessi e degli errori per evitare di mescolare le richieste provenienti da siti diversi.

Il documento introduttivo ufficiale di Nginx spiega i blocchi di configurazione e come servire file statici. La documentazione della direttiva try_files descrive la ricerca dei file e l’azione finale di elaborazione.

Contesti di percorso e autorizzazioni di porta di SELinux

Anche se le autorizzazioni generali dei file sono corrette, SELinux deve consentire l'accesso. SELinux confronta i contesti di sicurezza associati ai processi e ai file con le proprie politiche. Il processo Nginx in questo ambiente è stato eseguito nel dominio httpd_t , e il nuovo documento /srv era inizialmente 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 registra regole permanenti da applicare ai percorsi, e restorecon applica tali regole ai file effettivi. La semplice registrazione delle regole non modifica immediatamente il contesto dei file esistenti. httpd_sys_content_t è utilizzato per i documenti da leggere su questo sito statico, distinguendoli dai percorsi che richiedono permessi di scrittura per azioni come caricamenti. Per principi dettagliati, fare riferimento a documentazione SELinux di Rocky Linux .

La porta 18025 è stata registrata di recente perché non era inclusa nelle porte HTTP consentite all'inizio della pratica. Se la porta è già registrata per un altro tipo, non cambiarla automaticamente in -m dopo aver ricevuto un errore. Controlla prima i servizi esistenti, quindi scegli una porta disponibile o rivedi l'ambito della politica necessario. L'autorizzazione della porta in SELinux è separata dal consentire pacchetti di rete in firewalld.

Nella comparazione delle sorgenti, quando inizialmente era consentita solo la porta e il documento era var_t, si è verificato l'HTTP 403 e il registro di audit ha registrato un rifiuto AVC (Access Vector Cache) in cui httpd_t non poteva accedere al file var_t. Dopo aver applicato le regole del percorso e restorecon, è cambiato in 200. SELinux non è stato disattivato, né l'intero servizio impostato su permissive.

Confronto della risposta locale con la risposta di un altro computer

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

Per la prima richiesta, ci si aspetta LF25 nginx site works e 200, e un percorso inesistente dovrebbe restituire 404. Non guardare solo il numero 200; verifica anche se il contenuto del sito è quello previsto. Il successo locale è una prova che Nginx e l'accesso ai documenti sono possibili, ma non significa che il percorso di rete esterno sia riuscito.

Controlla la zona a cui appartiene l'interfaccia esterna e consenti solo le porte di pratica per quella zona. Lo public qui sotto è il valore controllato su questa VM, quindi cambialo con il valore effettivo in altri ambienti. Non modificare le regole di autorizzazione SSH esistenti.

sudo firewall-cmd --get-active-zones
sudo firewall-cmd --zone=public --add-port=18025/tcp
sudo firewall-cmd --zone=public --query-port=18025/tcp

Su un altro computer nella stessa rete, effettua la richiesta utilizzando l'indirizzo IPv4 reale del server. Il seguente IP è un esempio, quindi non utilizzarlo così com'è. Su Windows, puoi usare curl.exe per distinguerlo dagli alias di PowerShell.

curl --max-time 5 -sS -H 'Host: course25.test' http://192.0.2.10:18025/

L'ambiente NAT (Network Address Translation) di VirtualBox non consente l'accesso diretto all'indirizzo del guest dall'host. Aggiungendo una regola pratica nelle impostazioni della VM: Rete → Scheda 1 → Avanzate → Inoltro Porte con TCP, Host IP 127.0.0.1, Porta Host 18025 e Porta Guest 18025, puoi verificare http://127.0.0.1:18025/ dall'host. Se lasci l'IP dell'host vuoto, l'ambito di esposizione può aumentare, quindi è specificato per la pratica locale. È ancora necessaria l'autorizzazione del firewall del guest.

Nella pratica di origine, le richieste venivano effettuate alla VM tramite il forwarding NAT di localhost da curl su Windows. Prima di consentire il firewall, scadeva senza risposta per 4 secondi, e dopo aver consentito la porta del runtime, è stato confermato lo stesso contenuto e 200. Questo non testa l'accesso pubblico a Internet né il successo effettivo della query 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

Entrambe le query devono essere yes per riflettere le impostazioni attuali e salvate. Non è necessario ricaricare l'intero firewall per aggiungere separatamente l'autorizzazione corrente e l'autorizzazione permanente. A questo stadio, il test di persistenza dopo il riavvio non è stato eseguito. La distinzione tra le due impostazioni è inoltre spiegata nella documentazione ufficiale firewalld sull’autorizzazione delle porte. La definizione del servizio http per l'HTTP standard generalmente significa la porta 80, quindi non confonderla con questa autorizzazione di porta non standard.

Diagnosticare distinguendo tra errori 403, 404 e errori di configurazione

Se la connessione viene rifiutata o scade, controlla prima il listener, l'indirizzo e la rete VM, e la vera zona. Se arriva una risposta HTTP, controlla il sito che ha gestito quella richiesta e i log. Non concludere che sia un problema di SELinux basandoti solo su 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

In pratica, anche se il contesto SELinux corretto viene mantenuto, cambiare il file in 0600 di proprietà root ha prodotto un 403, e ripristinarlo a 0644 ha restituito un 200. Lo Permission denied nel registro degli errori può comparire sia per permessi regolari sia per SELinux, quindi corrispondi gli eventi AVC al momento della richiesta fallita con i permessi del percorso. Non determinare una causa specifica basandoti solo sul fatto che non ci sia un log. Un 404 per un percorso inesistente è il risultato previsto di questo try_files.

Dopo aver modificato le impostazioni, collegare il successo della verifica e l'applicazione come in sudo nginx -t && sudo systemctl reload nginx. In pratica, quando è stata aggiunta una direttiva inesistente a un file, il controllo della configurazione è fallito con codice di uscita 1, ma il processo Nginx esistente che non l'aveva ancora applicata ha continuato a restituire 200 con lo stesso PID. Ripristinare immediatamente il file non corretto al suo contenuto originale e ricontrollare. Non giudicare la configurazione memorizzata come normale solo perché restituisce la risposta precedente.

Inoltre, per questa istanza 18025, c'era solo un blocco server, quindi anche quando si effettuava la richiesta tramite Host: another.test, lo stesso sito restituiva 200. Questo perché se non c'è un nome corrispondente, potrebbe essere selezionato il server predefinito per quell'indirizzo e porta. server_name non è un dispositivo di restrizione dell'accesso e, se si desidera rifiutare nomi sconosciuti, è necessario progettare un server predefinito separato e una politica di risposta esplicita. Per le regole dettagliate sulla selezione dei nomi, fare riferimento al documento Nginx sui nomi dei server.

Verificare il sito esistente e rimuovere la configurazione del laboratorio

Dopo aver configurato il nuovo sito, controllare anche il sito predefinito originale sulla porta 80. Confrontandolo con la risposta salvata inizialmente, il corpo dovrebbe essere lo stesso per concludere che la pagina predefinita statica attuale non è stata modificata. Poiché le risposte dinamiche dei siti effettivamente in funzione possono variare nel tempo, le funzioni principali, lo stato e il contenuto devono essere confrontati separatamente.

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

Nei tre confronti delle fonti registrate, il sito predefinito ha sempre restituito 200 e i corpi delle risposte erano gli stessi. I file di configurazione esistenti, incluso nginx.conf, sono stati mantenuti. Se questo server continuerà a essere utilizzato, mantenere solo i siti necessari e, quando è richiesto l'avvio automatico dopo il riavvio, selezionare sudo systemctl enable nginx e poi verificare separatamente il riavvio.

Quando si rimuove la pratica, prima spostare i file del sito aggiunti in una posizione di backup, quindi controllare e ricaricare. I seguenti comandi si applicano solo ai file e alle regole creati ex novo in questo corso. Non eliminare alcuna regola esistente di percorso o porta riutilizzata.

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

Dopo che le impostazioni sono state applicate, verificare che il listener 18025 sia scomparso ed eliminare le regole di port forwarding aggiunte alla VM. Eseguire il backup dei log della pratica se necessario. Nella VM sorgente sono stati memorizzati nuovi log e i file del sito, i documenti, le policy, le regole del firewall e del NAT sono stati puliti prima di fermare Nginx. Le impostazioni esistenti e il firewall sono stati confrontati con lo stato originale, mentre SSH, lo stato attivo di firewalld e SELinux Enforcing sono stati mantenuti. Il pacchetto Nginx è stato lasciato per le pratiche successive.