Installazione NodeBB · 9 min read · Oct 19, 2025
Come installare il forum NodeBB con Nginx e SSL Let's Encrypt su Ubuntu 20.04 LTS
NodeBB è un software per forum moderno alimentato da Node.js che utilizza MongoDB/Redis come piattaforme di database. Utilizza i web socket per interazioni istantanee e notifiche in tempo reale.
In questo tutorial, impareremo come installare il forum NodeBB su un server basato su Ubuntu 20.04.
Prerequisiti
- Un server basato su Ubuntu 20.04 con un utente non root che abbia privilegi sudo.
- Minimo 2GB di RAM. Se il tuo server ha solo 1GB di RAM, è meglio abilitare una partizione di swap.
- Assicurati che tutto sia aggiornato.
shell $ sudo apt update && sudo apt upgrade - Alcuni pacchetti essenziali. Alcuni di questi saranno già presenti sul tuo server.
shell $ sudo apt install curl wget nano ca-certificates gnupg2 lsb-release
Passo 1 - Configurare il Firewall
Il primo passo è configurare il firewall. Ubuntu viene fornito di default con ufw (Uncomplicated Firewall).
Controlla se il firewall è attivo.
$ sudo ufw status
Dovresti ottenere il seguente output.
Status: inactive
Consenti la porta SSH in modo che il firewall non interrompa la connessione attuale quando viene abilitato.
$ sudo ufw allow OpenSSH
Consenti la porta 27017 per il server MongoDB e la porta 4567 per eseguire il forum NodeBB. Consenti anche le porte HTTP e HTTPS.
$ sudo ufw allow 27017
$ sudo ufw allow 4567
$ sudo ufw allow 80
$ sudo ufw allow 443
Abilita il Firewall.
$ sudo ufw enable
Il comando potrebbe interrompere le connessioni ssh esistenti. Procedere con l'operazione (y|n)? y
Il firewall è attivo e abilitato all'avvio del sistema
Controlla di nuovo lo stato del firewall.
$ sudo ufw status
Dovresti vedere un output simile.
Status: active
To Action From
-- ------ ----
OpenSSH ALLOW Anywhere
27017 ALLOW Anywhere
4567 ALLOW Anywhere
80 ALLOW Anywhere
443 ALLOW Anywhere
OpenSSH (v6) ALLOW Anywhere (v6)
27017 (v6) ALLOW Anywhere (v6)
4567 (v6) ALLOW Anywhere (v6)
80 (v6) ALLOW Anywhere (v6)
443 (v6) ALLOW Anywhere (v6)
Passo 2 - Installare Node.js
Installeremo qui la versione LTS di Node.js. Esegui i seguenti comandi per installare Node.js.
$ curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
$ sudo apt install nodejs
Controlla se Node è installato correttamente.
$ node --version
Dovresti vedere un output simile.
v12.18.3
Controlla anche npm.
$ npm --version
6.14.6
Passo 3 - Installare MongoDB
MongoDB è il database predefinito per NodeBB. Puoi anche usare Redis invece di MongoDB. Tratteremo entrambi i database nel nostro tutorial.
Il repository di MongoDB per Ubuntu 20.04 non è ancora pronto e Ubuntu stesso porta una versione molto vecchia. Per i nostri scopi, utilizzeremo il repository di MongoDB per 18.04 che funziona perfettamente. Puoi aggiornare l’elenco dei pacchetti con l’ultimo repository una volta che il supporto ufficiale è disponibile.
Importa la chiave pubblica per MongoDB.
$ wget -qO - https://www.mongodb.org/static/pgp/server-4.2.asc | sudo apt-key add -
Aggiungi il repository di MongoDB.
$ echo "deb [ arch=amd64 ] https://repo.mongodb.org/apt/ubuntu bionic/mongodb-org/4.2 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.2.list
Aggiorna il database locale dei pacchetti.
$ sudo apt update
Installa MongoDB.
$ sudo apt install mongodb-org
Verifica l’installazione di MongoDB.
$ mongod --version
db version v4.2.8
...
Avvia il servizio MongoDB.
$ sudo systemctl start mongod
Abilita il servizio MongoDB.
$ sudo systemctl enable mongod
Controlla lo stato del servizio MongoDB.
$ sudo systemctl status mongod
Passo 4 - Configurare MongoDB
L’amministrazione di Mongo avviene tramite la shell di MongoDB. L’installazione predefinita di MongoDB ascolta sulla porta 27017.
Accedi alla shell di MongoDB.
$ mongo
Passa al database integrato admin.
> use admin
Crea un utente amministrativo. Questo non è lo stesso dell’utente amministratore di NodeBB.
> db.createUser( { user: "admin", pwd: "yourpassword", roles: [ { role: "root", db: "admin" } ] } )
Cambia il segnaposto “yourpassword” con la tua password.
Aggiungi un nuovo database per NodeBB.
> use nodebb
Successivamente, crea l’utente nodebb per gestire il database nodebb.
> db.createUser( { user: "nodebb", pwd: "yourpassword", roles: [ { role: "readWrite", db: "nodebb" }, { role: "clusterMonitor", db: "admin" } ] } )
Il permesso readwrite consente a NodeBB di memorizzare e recuperare dati dal database nodebb. Il permesso clustermonitor consente a NodeBB l’accesso in sola lettura alle statistiche del database che sono visibili tramite il suo pannello di amministrazione.
Esci dalla shell di Mongo.
> quit()
Apri il file di configurazione di MongoDB per la modifica.
$ sudo nano /etc/mongod.conf
Aggiungi la seguente riga alla fine del file.
security:
authorization: enabled
Riavvia MongoDB e verifica l’utente amministrativo creato in precedenza.
$ sudo systemctl restart mongod
$ mongo -u admin -p yourpassword --authenticationDatabase=admin
Dovresti vedere il prompt di Mongo se tutto è stato configurato correttamente.
Passo 5 - Installare Git
Prima di procedere con l’installazione di NodeBB, dobbiamo installare Git.
Esegui il seguente comando per installare Git.
$ sudo apt install git
Esegui i seguenti comandi per eseguire la configurazione iniziale di Git.
$ git config --global user.name "Your Name"
$ git config --global user.email "[email protected]"
Passo 6 - Installare NodeBB
Non è consigliabile eseguire NodeBB come utente root.
Crea un utente non privilegiato.
$ sudo adduser nodebb
Imposta una password a tua scelta e salta le altre opzioni.
Crea la directory in cui vivrà il tuo forum NodeBB.
$ sudo mkdir /var/www/nodebb
Cambia la proprietà della cartella all’utente appena creato.
$ sudo chown -R nodebb:nodebb /var/www/nodebb
Accedi all’utente appena creato.
$ su nodebb
Passa alla directory di installazione di NodeBB.
$ cd /var/www/nodebb
Per installare NodeBB, prima dobbiamo clonare il suo repository Github.
Clona NodeBB nella directory /var/www/nodebb. Il punto alla fine del comando si riferisce alla directory corrente.
$ git clone -b v1.14.2 https://github.com/NodeBB/NodeBB.git .
Qui abbiamo clonato la v1.14.2 di NodeBB che era l’ultima versione stabile al momento della scrittura del tutorial. Puoi trovare il ramo stabile più recente dalla pagina Ultime Release di NodeBB.
NodeBB viene fornito con un’utilità da riga di comando. Usa il seguente comando per installare NodeBB.
$ ./nodebb setup
Puoi premere invio per scegliere il valore predefinito.
Per il valore di URL utilizzato per accedere a questo NodeBB scegli l’URL finale, a cui vuoi accedere al forum. Se accederai al forum tramite l’IP del tuo server, inserisci quello o inserisci il dominio completo del forum. Qui inseriremo http://forum.example.com.
Continua a scegliere valori predefiniti fino a quando non ti viene chiesto il nome utente MongoDB in cui inserisci nodebb e la password che hai scelto in precedenza per quel nome utente durante la configurazione di MongoDB. Il tuo database nodebb dovrebbe essere scelto. Ti verrà anche chiesto di creare un utente amministratore e i suoi dettagli.
Una volta completata la configurazione, esegui il seguente comando per avviare NodeBB.
$ ./nodebb start
Il tuo forum è ora in esecuzione. Dovresti essere in grado di accedervi tramite http://.
Potresti vedere un messaggio di errore che dice Sembra che la tua connessione a NodeBB sia stata persa, attendi mentre cerchiamo di riconnetterci. Questo appare perché abbiamo scelto l’URL predefinito per NodeBB http://forum.example.com e non http://
Esci dall’utente NodeBB.
$ exit
Passo 7 - Installare Nginx
Ubuntu 20.04 di default porta l’ultima versione stabile di Nginx. Installeremo quella.
$ sudo apt install nginx
Controlla se è installato correttamente.
$ nginx -v
nginx version: nginx/1.18.0 (Ubuntu)
Avvia e abilita Nginx.
$ sudo systemctl start nginx
$ sudo systemctl enable nginx
Apri l’indirizzo IP del tuo server nel tuo browser web. Dovresti vedere la seguente pagina che significa che il tuo server è attivo e funzionante.
Passo 8 - Configurare Nginx
Esegui il seguente comando per aggiungere un file di configurazione per il tuo sito.
$ sudo nano /etc/nginx/sites-available/nodebb.conf
Incolla il seguente codice nell’editor.
server {
listen 80;
server_name forum.example.com;
access_log /var/log/nginx/forum.example.com.access.log;
error_log /var/log/nginx/forum.example.com.error.log;
location / {
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 Host $http_host;
proxy_set_header X-NginX-Proxy true;
proxy_pass http://127.0.0.1:4567;
proxy_redirect off;
# Supporto Socket.IO
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}
Premi Ctrl + X per uscire dall’editor e inserisci Y quando richiesto.
Una volta terminato, verifica che la configurazione di Nginx sia corretta.
$ sudo nginx -t
Ricarica il servizio Nginx per abilitare la configurazione.
$ sudo systemctl reload nginx
Visita http://forum.example.com nel tuo browser per aprire il forum NodeBB.
Passo 9 - Eseguire NodeBB come servizio di sistema
Il servizio NodeBB non verrà eseguito dopo un riavvio del sistema. Per evitare di avviare NodeBB ogni volta, dobbiamo installarlo come servizio di sistema.
Ferma prima il servizio NodeBB.
$ ./nodebb stop
Esegui il seguente comando per creare e modificare il file di configurazione dell’unità systemd nodebb.service.
$ sudo nano /etc/systemd/system/nodebb.service
Incolla il seguente codice nell’editor.
[Unit]
Description=NodeBB
Documentation=https://docs.nodebb.org
After=system.slice multi-user.target mongod.service
[Service]
Type=forking
User=nodebb
StandardOutput=syslog
StandardError=syslog
SyslogIdentifier=nodebb
Environment=NODE_ENV=production
WorkingDirectory=/var/www/nodebb
PIDFile=/var/www/nodebb/pidfile
ExecStart=/usr/bin/env node loader.js
Restart=always
[Install]
WantedBy=multi-user.target
Qui abbiamo scelto il nome utente come nodebb che abbiamo creato nel Passo 6 e il percorso che abbiamo scelto per installare NodeBB.
Abilita il servizio NodeBB.
$ sudo systemctl enable nodebb
Avvia il servizio NodeBB.
$ sudo systemctl start nodebb
Controlla lo stato del servizio.
$ sudo systemctl status nodebb
Passo 10 - Ottenere un certificato SSL di Let’s Encrypt
Mettere in sicurezza il tuo forum NodeBB con HTTPS è un passo necessario per proteggere il traffico del tuo sito. Per questo tutorial, utilizzeremo il client Certbot per installare l’SSL.
Per fare ciò, prima installa lo strumento Certbot.
$ sudo apt install certbot python3-certbot-nginx
Genera i certificati.
$ sudo certbot --nginx -d forum.example.com
Se è la prima volta che esegui Certbot sul tuo sistema, ti verrà chiesto un indirizzo email e di accettare i termini di servizio. Ti verrà anche chiesto se accetti di condividere dati con la fondazione EFF, a cui puoi rispondere di no. Dopo aver fatto ciò, Certbot comunicherà con i server di Let’s Encrypt e eseguirà una sfida per verificare i tuoi domini.
Se ciò ha successo, ti verrà chiesto come gestire i reindirizzamenti HTTPS.
Si prega di scegliere se l'accesso HTTPS è richiesto o facoltativo.
-------------------------------------------------------------------------------
1: Facile - Consenti accesso sia HTTP che HTTPS a questi siti
2: Sicuro - Fai reindirizzare tutte le richieste all'accesso HTTPS sicuro
-------------------------------------------------------------------------------
Seleziona il numero appropriato [1-2] quindi [invio] (premi 'c' per annullare):
Seleziona l’opzione Sicuro e premi invio. Questo garantirà che tutte le richieste al dominio http vengano correttamente reindirizzate alla versione https. I tuoi certificati verranno quindi creati e i tuoi file di configurazione Nginx verranno aggiornati con le impostazioni SSL.
I tuoi certificati sono pronti e puoi aprire il tuo sito ora andando su https://forum.example.com
Passo 11 - Verificare il rinnovo automatico dell’SSL
Questo è l’ultimo passo prima di concludere questo tutorial.
Controlla il processo di rinnovo eseguendo un tentativo di rinnovo.
$ sudo certbot renew --dry-run
Se non ricevi errori, significa che sei a posto. Certbot rinnoverà automaticamente i tuoi certificati per te. Ti verrà inviato un’email di avviso riguardo la scadenza del certificato.
Conclusione
Questo è tutto per questo tutorial. La tua configurazione del forum NodeBB è completa. Se hai domande, postale nei commenti qui sotto.
Ricevi i nuovi post nella tua casella di posta.
Nessuno spam. Disiscriviti in qualsiasi momento.