Installazione di Nginx e configurazione dei server block
Spieghiamo come installare Nginx su Ubuntu, creare un server block per il vostro dominio, configurare un reverse proxy per un’app Node.js e risolvere gli errori comuni.

Per l’installazione di Nginx, eseguite sudo apt update e sudo apt install nginx e consentite il profilo Nginx Full nel firewall. Poi create un server block per il vostro dominio in /etc/nginx/sites-available, collegatelo nella cartella sites-enabled, verificate con sudo nginx -t e applicate la modifica con sudo systemctl reload nginx.
Cos’è Nginx e a cosa serve?
Nginx è un web server e reverse proxy open source in grado di gestire un elevato numero di connessioni simultanee con poca memoria. Serve i file statici molto velocemente; si pone davanti alle applicazioni Node.js, Python o PHP e inoltra loro le richieste, termina l’SSL e funge da livello di cache.
La differenza principale rispetto ad Apache è lo stile di configurazione: Nginx non ha un file .htaccess a livello di directory; tutte le regole sono mantenute nella configurazione centrale. Questo migliora le prestazioni, ma chi proviene da Apache deve riscrivere le proprie regole. Se siete curiosi degli equivalenti Apache, consultate il nostro articolo sui redirect htaccess.
Questa guida fa riferimento a Ubuntu e Debian; l’ambiente di sviluppo per macOS e Windows si trova sotto un titolo separato.
Prerequisiti
Se sul server è installato anche Apache, i due servizi cercano di rimanere in ascolto sulla stessa porta 80 e Nginx non si avvia. Arrestate e disabilitate Apache, oppure fatelo ascoltare su un’altra porta.
- Un server con Ubuntu o Debian e un utente con privilegi sudo
- Il record A del vostro dominio che punta all’IP del server
- Nessun altro servizio (ad es. Apache) che usi le porte 80 e 443
- Se configurerete un reverse proxy, un’applicazione in esecuzione sul server (ad es. Node.js sulla porta 3000)
Passaggi di installazione di Nginx su Ubuntu
Il pacchetto Nginx nel repository di Ubuntu riceve regolarmente aggiornamenti di sicurezza ed è sufficiente per la maggior parte dei progetti. Se vi serve una versione mainline più recente, potete aggiungere il repository ufficiale dei pacchetti su nginx.org.
sudo apt update sudo apt install nginx sudo systemctl enable --now nginx sudo systemctl status nginx # Firewall (se usate UFW) sudo ufw allow OpenSSH sudo ufw allow 'Nginx Full' sudo ufw enable # Verifica nginx -v curl -I http://localhostFile e cartelle importanti
- /etc/nginx/nginx.conf: il file di configurazione principale
- /etc/nginx/sites-available/: i server block definiti
- /etc/nginx/sites-enabled/: i link ai blocchi attivi
- /var/www/: la cartella radice comune per i file dei siti
- /var/log/nginx/access.log e error.log: log delle richieste e degli errori
Come creare un server block
Un server block è l’equivalente di un virtual host in Apache e permette di ospitare più domini su un solo server. Creare un file separato per ogni sito semplifica la gestione.
Create prima la cartella del sito e impostatene la proprietà, poi scrivete il file di configurazione. Aggiungete alla riga server_name sia il dominio senza prefisso sia la versione con www; strumenti come Certbot leggono questa riga per ottenere un certificato.
sudo mkdir -p /var/www/ornek.com/html sudo chown -R $USER:$USER /var/www/ornek.com/html echo '<h1>ornek.com is working</h1>' > /var/www/ornek.com/html/index.html sudo nano /etc/nginx/sites-available/ornek.comserver { listen 80; listen [::]:80; server_name ornek.com www.ornek.com; root /var/www/ornek.com/html; index index.html; location / { try_files $uri $uri/ =404; } access_log /var/log/nginx/ornek.com.access.log; error_log /var/log/nginx/ornek.com.error.log; }sudo ln -s /etc/nginx/sites-available/ornek.com /etc/nginx/sites-enabled/ # Per disattivare la pagina di benvenuto predefinita sudo rm /etc/nginx/sites-enabled/default sudo nginx -t sudo systemctl reload nginxConfigurazione del reverse proxy Nginx
Invece di esporre direttamente a internet un’applicazione Node.js, Python o di altro tipo, porre Nginx davanti a essa è una configurazione diffusa e sicura. Nginx ascolta sulle porte 80 e 443 e inoltra le richieste all’applicazione in esecuzione in locale; la porta dell’applicazione resta chiusa verso l’esterno.
Nell’esempio seguente l’applicazione gira sulla porta 3000. Per passare all’applicazione l’IP reale del client e il protocollo, si aggiungono gli header del proxy; le applicazioni che usano WebSocket richiedono anche gli header Upgrade.
Se eseguite più applicazioni sullo stesso server, assegnare a ciascuna un proprio sottodominio e un proprio server block è l’approccio più ordinato. Ad esempio, il pannello di amministrazione può essere servito su panel.ornek.com e l’API su api.ornek.com; quando ogni blocco ha un proprio file di log, diventa anche più facile capire da quale applicazione provenga un problema. Per leggere l’IP reale del client nell’applicazione, non dimenticate di abilitare l’impostazione trust proxy del framework che usate.
server { listen 80; server_name app.ornek.com; location / { proxy_pass http://127.0.0.1:3000; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade"; } client_max_body_size 20m; }HTTPS, compressione e caching
Quando il server block funziona, il passo successivo è passare a HTTPS con un certificato gratuito. Il plugin Nginx di Certbot ottiene il certificato e aggiunge per voi il blocco 443 e il redirect; abbiamo descritto i passaggi nella guida all’installazione del certificato SSL.
Sul fronte della velocità, la compressione gzip e gli header di cache a lunga durata per i file statici fanno una grande differenza. Mettere il dominio dietro una CDN come Cloudflare serve inoltre i contenuti statici da punti vicini al visitatore; trovate la configurazione nel nostro articolo sulla configurazione di Cloudflare.
- Se usate impronte di versione nei nomi dei file (ad es. app.3f9a.css), potete estendere ulteriormente la durata della cache.
- Non mettete in cache a lungo i file HTML; altrimenti gli aggiornamenti raggiungono i visitatori in ritardo.
gzip on; gzip_types text/css application/javascript application/json image/svg+xml; location ~* \.(css|js|webp|avif|png|jpg|svg|woff2)$ { expires 30d; add_header Cache-Control "public"; }Impostazioni di sicurezza di base
L’installazione predefinita funziona, ma prima di andare online poche semplici impostazioni riducono sensibilmente la superficie di attacco. Nessuna richiede software aggiuntivo; basta aggiungere alcune righe alla configurazione.
Il primo passo è disattivare server_tokens, così il numero di versione di Nginx non compare nelle pagine di errore e negli header. Poi aggiungete un blocco predefinito che gestisca le richieste in arrivo con nomi di dominio non definiti. Questo blocco impedisce ai bot che raggiungono direttamente l’indirizzo IP del server di vedere il vostro primo sito.
È importante anche bloccare l’accesso ai file nascosti. Una cartella .git o un file .env lasciati per errore nella radice possono esporre a chiunque il codice sorgente o le password del database. Queste fughe di dati di solito non nascono da cattive intenzioni, ma da un caricamento fatto di fretta.
Infine, aggiornate regolarmente i pacchetti del server e tenete aperte solo le porte di cui avete davvero bisogno. Quando si avvia un progetto di web design o una piattaforma e-commerce, applicare ogni volta questa checklist fin dall’inizio riduce molto le sorprese in seguito.
# Nel blocco http di /etc/nginx/nginx.conf server_tokens off; # Blocco predefinito che rifiuta i domini non definiti server { listen 80 default_server; listen [::]:80 default_server; server_name _; return 444; } # Nel blocco del sito: blocca i file nascosti location ~ /\.(?!well-known) { deny all; }Ambiente di sviluppo su macOS e Windows
Anche se il server di produzione è per lo più Linux, provare la configurazione in locale velocizza il lavoro. Nginx installato con Homebrew su macOS ascolta per impostazione predefinita sulla porta 8080 e il file di configurazione si trova nella cartella etc/nginx sotto il prefisso di Homebrew.
Sebbene per Windows esista una build su nginx.org, la documentazione ufficiale segnala che questa versione ha dei limiti. Su Windows il modo più pratico è eseguire la versione Linux in Docker o WSL; così si testa nello stesso ambiente del server di produzione.
macOS (Homebrew)
brew install nginx brew services start nginx nginx -t # Cartella di configurazione ls $(brew --prefix)/etc/nginx curl -I http://localhost:8080Windows (Docker)
docker run -d --name web -p 8080:80 nginx curl.exe -I http://localhost:8080Errori comuni e soluzioni
Per il debug, il primo passo è sempre verificare la sintassi con sudo nginx -t e poi il file error.log. La maggior parte dei problemi si risolve con il messaggio di una riga che trovate lì.
| Sintomo | Causa probabile e soluzione |
|---|---|
| 502 Bad Gateway | L’applicazione a monte non è in esecuzione o la porta è sbagliata; controllate l’applicazione e l’indirizzo proxy_pass. |
| 403 Forbidden | I permessi della cartella sono insufficienti oppure manca il file index; controllate la proprietà e la riga index. |
| Address already in use | Un altro servizio sta usando la porta 80; individuatelo con ss -tlnp e arrestatelo. |
| conflicting server name | Lo stesso server_name è definito in due blocchi; rimuovete il duplicato. |
| 413 Request Entity Too Large | Il file caricato supera il limite; aumentate il valore di client_max_body_size. |
sudo nginx -t sudo tail -n 50 /var/log/nginx/error.log sudo ss -tlnp | grep -E ':80|:443'Domande frequenti
01Meglio Nginx o Apache?
Entrambi sono server maturi e affidabili. Nginx si distingue con un alto traffico simultaneo e come reverse proxy, mentre Apache offre flessibilità sugli hosting condivisi grazie al supporto di .htaccess. Molte infrastrutture li usano insieme.
02Qual è la differenza tra restart e reload?
reload carica la nuova configurazione senza interrompere le connessioni in corso; è da preferire per le modifiche di ogni giorno. restart arresta completamente il servizio e lo riavvia, e può causare una breve interruzione.
03Quanti siti posso ospitare su un server?
Il limite dipende dalle risorse del server, non da Nginx. Aprendo un server block separato per ogni dominio, potete far girare molti siti sulla stessa macchina; con la crescita del traffico bisogna monitorare l’uso di memoria, CPU e disco.
04Si può fare il load balancing con Nginx?
Sì. Se definite più server applicativi in un blocco upstream e instradate verso quel gruppo con proxy_pass, Nginx distribuisce le richieste tra i server. Il metodo predefinito è il round robin; potete cambiare il comportamento con metodi come least_conn o ip_hash.
Un Nginx configurato correttamente offre fondamenta veloci e sicure in grado di sostenere più applicazioni. Se volete affrontare insieme impostazioni del server, caching e obiettivi dei Core Web Vitals, scoprite il nostro servizio di ottimizzazione di velocità e prestazioni. Per un sistema su misura che giri sul vostro server, o per soluzioni Aurora già pronte come il software alberghiero, potete raggiungerci dalla pagina contatti.


