Dedicated Server: Configura Node.js su Linux
Questa guida è stata creata con i seguenti prodotti:
(I dettagli possono variare con prodotti di fornitori diversi ma i concetti principali rimangono gli stessi)
Introduzione
Node.js è un ambiente di runtime JavaScript open-source e multipiattaforma che esegue codice JavaScript fuori dal browser, ad esempio su server o tramite strumenti da linea di comando. Basato sul motore V8, supporta I/O asincrono e event-driven, rendendolo super efficiente per costruire applicazioni di rete scalabili e in tempo reale.
Il paradigma “JavaScript ovunque” permette agli sviluppatori di usare un unico linguaggio sia per il backend che per il frontend.
Preparazione
Prima di configurare Node.js, devi preparare il tuo sistema. Questo include aggiornare il sistema operativo all’ultima versione e installare tutte le dipendenze necessarie. Questi passaggi garantiscono un ambiente stabile e aiutano a prevenire problemi durante o dopo l’installazione.
Aggiorna il sistema
Per assicurarti che il sistema abbia gli ultimi aggiornamenti software e di sicurezza, esegui sempre prima un aggiornamento completo. Usa questo comando:
sudo apt update && sudo apt upgrade -y
Così il sistema avrà tutte le patch di sicurezza e le versioni software più recenti prima di procedere.
Installa le dipendenze
Una volta completato l’aggiornamento, puoi procedere con l’installazione delle dipendenze. Node.js verrà eseguito sulla tua macchina tramite una serie di container Docker, quindi Docker deve essere installato prima. Per farlo, esegui:
curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh
Una guida completa all’installazione e all’uso di Docker è disponibile nella nostra guida Docker.
Installazione
Ora che hai tutto pronto e le preparazioni sono fatte, puoi procedere con l’installazione dell’app Node.js.
Per usare Node.js in un ambiente isolato, devi prima scaricare l’immagine ufficiale basata su Alpine. Esegui questo comando per prendere l’ultima immagine Node.js 22 sul tuo sistema, pronta per il deployment in container:
docker pull node:22-alpine
Poi puoi avviare un container basato su questa immagine e aprire una shell al suo interno. Usa questo comando per partire con una shell interattiva. L’opzione --rm fa sì che il container venga eliminato automaticamente quando esci, così il tuo host resta pulito.
docker run -it --rm --entrypoint sh node:22-alpine
Dentro il container, verifica la versione di Node.js con node -v che dovrebbe mostrare v22.19.0. Puoi anche controllare la versione di npm con
npm -v e l’output atteso è 10.9.3. Così confermi che l’immagine ha le versioni corrette di Node.js e npm, pronte all’uso.
Configurazione
Dopo aver avviato il container Node.js, è consigliato configurare le impostazioni essenziali direttamente nell’ambiente. Un approccio comune è definire variabili d’ambiente, ad esempio:
export NODE_ENV=production
Questo abilita la modalità produzione, attivando ottimizzazioni di performance e modificando il comportamento dei log. Per lo sviluppo, puoi invece impostare NODE_ENV=development per avere messaggi di errore dettagliati e funzionalità di debug.
Una struttura di progetto ben organizzata parte da un file di configurazione creato con:
npm init -y
Questo genera un file package.json, che definisce dipendenze, script e metadata del progetto. È il file centrale di configurazione per ogni app Node.js.
Le dipendenze si installano con npm install <package>, mentre quelle di sviluppo con npm install <package> --save-dev. La sezione scripts dentro package.json ti permette di definire comandi personalizzati, tipo npm start o npm run build, per semplificare l’esecuzione e la gestione del progetto.
Per setup più avanzati, Node.js si può personalizzare con file .npmrc o .nvmrc, che permettono di configurare registry privati, opzioni di caching o forzare una versione specifica di Node.js. Così le tue app girano sempre uguali su ambienti diversi.
Conclusione e risorse extra
Complimenti! Hai installato e configurato Node.js sul tuo Dedicated Server con successo. Ti consigliamo anche di dare un’occhiata a queste risorse, che possono darti una mano e ulteriori spunti durante la configurazione del server:
- Node.js.com - Sito ufficiale
- https://Node.js.com/help/ - Centro assistenza Node.js (Documentazione)
Hai domande specifiche che non trovi qui? Per qualsiasi dubbio o supporto, non esitare a contattare il nostro team di assistenza, disponibile ogni giorno per aiutarti! 🙂