Ubuntu 26.04 / Configurare siti Nginx e verificare le risposte per Host
Su Ubuntu puoi gestire i siti Nginx conservando le configurazioni in sites-available e attivandole tramite collegamenti in sites-enabled, dopo aver verificato gli include effettivi. Questo laboratorio configura due siti su 127.0.0.1:8080 e controlla quale risposta riceve ciascun nome nell’intestazione HTTP Host.
Il nuovo listener 8080 è limitato al loopback, cioè all’accesso dallo stesso sistema: non rende locale l’intero server. L’installazione di Nginx può avviare anche il sito predefinito sulla porta 80. Prima di installare prepara accesso amministrativo e filtri UFW, oppure usa una macchina virtuale dedicata e isolata dalle reti esterne. Mantieni disponibile la console di recupero.
Installare e leggere la configurazione esistente
Servono Ubuntu 26.04, privilegi amministrativi e spazio per due directory di prova. Esegui i comandi singolarmente e controllane l’esito; se l’aggiornamento o l’installazione falliscono, risolvi l’errore prima di proseguire.
sudo apt update
sudo apt install nginx curl
sudo nginx -t
sudo nginx -T
sudo ss -lntp
Una porta già occupata richiede di identificare il servizio e la sua funzione; non terminare un altro server per liberarla. nginx -t controlla la configurazione; nginx -T la verifica e ne mostra anche il contenuto. L’output completo può contenere indirizzi o impostazioni di autenticazione: esaminalo localmente senza pubblicarlo.
Individua in /etc/nginx/nginx.conf gli include realmente attivi e confrontali con l’output. Un file in sites-available non diventa attivo per il solo fatto di esistere: deve essere incluso, normalmente tramite il collegamento in sites-enabled. Controlla anche gli altri include, i listen, i server_name e i server predefiniti già presenti. La guida Ubuntu alla configurazione di Nginx descrive document root e gestione dei siti tramite queste directory.
Verificare anche l’esposizione del sito predefinito
sudo ss -lntp
sudo ufw status verbose
ls -l /etc/nginx/sites-enabled
sudo nginx -T
0.0.0.0:80 indica un ascolto su tutti gli indirizzi IPv4 locali; [::]:80 riguarda IPv6. Sono ambiti diversi da 127.0.0.1:8080. Con UFW inattivo o una regola ampia per la porta 80, altri dispositivi potrebbero raggiungere il sito predefinito. Controlla separatamente risposta locale e nuove connessioni dai client consentiti ed esclusi, considerando anche router e filtri esterni.
Solo su una VM nuova e dedicata, se non serve il sito predefinito del pacchetto, il blocco seguente conserva e rimuove esclusivamente il suo collegamento simbolico. Non applicarlo a un sito operativo. Prima di eseguirlo verifica che nessuno stia modificando la configurazione: il controllo iniziale non elimina le condizioni di concorrenza.
(
set -eu
link=/etc/nginx/sites-enabled/default
if [ ! -L "$link" ] || [ "$(readlink -f "$link")" != /etc/nginx/sites-available/default ]; then
printf 'Not the expected package-default symlink; inspect manually.\n' >&2
exit 1
fi
backup_dir=$(sudo mktemp -d /root/nginx-default-link.XXXXXX)
sudo cp -a "$link" "$backup_dir/default"
printf 'Preserved link: %s/default\n' "$backup_dir"
sudo rm -- "$link"
sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp
)
Il blocco si arresta se il collegamento non è quello atteso o se una fase successiva fallisce. Annota il percorso stampato del backup: la variabile della subshell non rimane nella sessione principale. Il file originale sites-available/default resta disponibile. Se la verifica fallisce dopo la rimozione del collegamento, la modifica su disco è già avvenuta anche se il reload non è stato eseguito.
Per ripristinare, confronta il collegamento conservato con la posizione originale, controlla che non siano intervenute altre modifiche e rimetti soltanto quel collegamento nella posizione iniziale; convalida con sudo nginx -t prima del reload. Non sovrascrivere cambiamenti di altri amministratori. Se la porta 80 resta in ascolto, cerca gli altri siti o processi responsabili. La guida Ubuntu all’installazione di Nginx conferma che il pacchetto avvia il server e predispone una pagina iniziale.
Preparare due directory con risposte diverse
Prima verifica che /srv/ubuntu-course-alpha, /srv/ubuntu-course-beta e i nomi di configurazione usati sotto siano liberi, senza file o collegamenti da conservare. Se esistono, fermati e scegli nomi di laboratorio distinti aggiornando coerentemente tutti i riferimenti. I comandi seguenti sono destinati a percorsi nuovi e vuoti: tee sovrascriverebbe un file già presente.
sudo install -d -m 0755 /srv/ubuntu-course-alpha /srv/ubuntu-course-beta
printf '%s\n' 'alpha-site' | sudo tee /srv/ubuntu-course-alpha/index.html
printf '%s\n' 'beta-site' | sudo tee /srv/ubuntu-course-beta/index.html
I contenuti attesi sono alpha-site e beta-site, ciascuno seguito da un ritorno a capo. Nginx deve poter attraversare le directory e leggere i file; non serve rendere il contenuto scrivibile da tutti. Verifica proprietario e permessi effettivi dei nuovi file, che possono dipendere dalla umask, e in caso di errore controlla anche le politiche di accesso del sistema.
Definire due siti locali e una risposta predefinita
Con un editor amministrativo salva l’intero blocco seguente nel nuovo file /etc/nginx/sites-available/ubuntu-course-lab. Per esempio puoi aprirlo con sudo nano /etc/nginx/sites-available/ubuntu-course-lab se nano è disponibile; salva con Ctrl+O, conferma il nome e chiudi con Ctrl+X. Prima controlla che il percorso non esista e non sia un collegamento inatteso. Non incollare questo blocco direttamente nella shell: è configurazione Nginx.
alpha.example.test e beta.example.test sono nomi per documentazione e test locali; non richiedono registrazione DNS e non sono nomi da usare per un certificato pubblico. Mantieni separata l’eventuale configurazione del sito sulla porta 80.
server {
listen 127.0.0.1:8080 default_server;
server_name _;
return 404;
}
server {
listen 127.0.0.1:8080;
server_name alpha.example.test;
root /srv/ubuntu-course-alpha;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
server {
listen 127.0.0.1:8080;
server_name beta.example.test;
root /srv/ubuntu-course-beta;
index index.html;
location / {
try_files $uri $uri/ =404;
}
}
Ogni blocco server definisce un server virtuale. root indica la directory dei documenti, index il file iniziale e try_files verifica i percorsi richiesti, restituendo 404 se non trova una corrispondenza. Il primo blocco gestisce i nomi non riconosciuti sullo stesso indirizzo e porta con una risposta 404.
server_name _ non è una regola speciale di rifiuto: è default_server sul listen a selezionare il ripiego. Non dichiarare due server predefiniti sullo stesso indirizzo e porta. La documentazione Nginx sull’instradamento delle richieste chiarisce che prima si confrontano indirizzo e porta, poi il nome Host. Due nomi diversi possono quindi condividere lo stesso listener.
Attivare, convalidare e ricaricare
(
set -eu
sudo ln -s /etc/nginx/sites-available/ubuntu-course-lab /etc/nginx/sites-enabled/ubuntu-course-lab
sudo nginx -t
sudo systemctl reload nginx
)
Il collegamento rende il file raggiungibile dall’include già verificato. Se esiste, controllane la destinazione anziché forzare una sostituzione. Il blocco usa una subshell con arresto sugli errori: una verifica fallita impedisce il reload, ma può lasciare il nuovo collegamento su disco.
Correggi il file e la riga segnalati o il conflitto sul listener prima di ripetere la verifica. Un esito positivo non dimostra da solo che la risposta HTTP e l’accesso ai file siano corretti. Dopo il reload controlla anche lo stato del servizio e i suoi log. La guida introduttiva Nginx spiega come il reload applica la nuova configurazione ai processi di lavoro.
Provare i due nomi e il ripiego
Esegui queste richieste dalla stessa VM che ospita Nginx. Il loopback del computer ospitante o di un’altra VM identifica quel sistema, non il server del laboratorio.
curl --fail --show-error --resolve alpha.example.test:8080:127.0.0.1 http://alpha.example.test:8080/
curl --fail --show-error --resolve beta.example.test:8080:127.0.0.1 http://beta.example.test:8080/
curl -i -H "Host: unknown.example.test" http://127.0.0.1:8080/
Le prime due richieste devono restituire rispettivamente alpha-site e beta-site. L’ultima deve mostrare uno stato HTTP 404. Controlla codice di uscita, intestazioni e corpo separatamente: curl -i visualizza le intestazioni ma, senza --fail, un 404 non implica necessariamente un codice di uscita non zero.
--resolve assegna l’indirizzo alla specifica coppia nome/porta per questa esecuzione di curl; non modifica il DNS del sistema. Il nome nell’URL continua a determinare l’intestazione Host. Il manuale curl su --resolve descrive questa corrispondenza. Se l’ambiente usa un proxy HTTP, verifica che le richieste del laboratorio raggiungano direttamente il loopback: l’opzione non esclude da sola un proxy.
Se arriva la stessa pagina per entrambi i nomi, confronta include attivi, nomi duplicati, porta, root e log. Per una connessione rifiutata controlla servizio e listener; per un 403 controlla permessi e politiche; per un 404 inatteso controlla Host, percorso richiesto e presenza del file. Per provare un file mancante puoi richiedere un percorso che hai verificato non esista e controllare il 404, senza creare o cancellare contenuti del sito.
Per disattivare il laboratorio, verifica la destinazione del solo collegamento /etc/nginx/sites-enabled/ubuntu-course-lab, rimuovi quel collegamento, poi esegui sudo nginx -t e soltanto se riesce sudo systemctl reload nginx. Conserva il file in sites-available e gli altri siti. Ricontrolla listener e risposte dopo la modifica. Una pubblicazione Internet richiede una preparazione separata di dominio, indirizzi, firewall, HTTPS e rinnovo dei certificati e gestione dei log.




