NodeJSPubblicato il 15 dicembre 2025Lettura di 10 min

Pubblicare un'app Node.js (Express) con dominio e HTTPS

Questa guida ti mostra come pubblicare un'app web Node.js (sito, API REST, dashboard…) su un server Node.js di OuiHeberg gestito in OuiPanel. Poi ti mostra come collegarla al tuo dominio in HTTPS con il Proxy Manager. L'esempio usa Express. Ti servono un'app Node.js funzionante e, se vuoi un indirizzo personalizzato, un nome di dominio.

Tipo di applicazioneEsempi
Sito webSito vetrina, blog, portfolio
API RESTBackend di un'app mobile o web
DashboardPannello di amministrazione, interfaccia di gestione
Applicazione webE-commerce, SaaS, strumento online

Preparare i file dell'applicazione

Struttura dei file

La tua applicazione deve avere questa struttura.

MonApp/
├── index.js           ← File principale (o app.js, server.js...)
├── package.json       ← Dipendenze npm
├── .env               ← Variabili d'ambiente (creato sul server)
├── public/            ← (Opzionale) File statici (CSS, JS, immagini)
├── views/             ← (Opzionale) Template (EJS, Pug, Handlebars)
└── routes/            ← (Opzionale) Rotte dell'applicazione

Il file package.json

Crea un file package.json con le tue dipendenze.

{
  "name": "la-mia-applicazione-web",
  "version": "1.0.0",
  "description": "La mia applicazione web Node.js",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "dotenv": "^16.3.1"
  }
}

Adatta "main": "index.js" al nome del tuo file principale (app.js, server.js, ecc.).

Il file principale (index.js)

Ecco un esempio di app Express pronta per OuiPanel. Ascolta sulla porta fornita dal server, SERVER_PORT.

// Carica le variabili d'ambiente da .env
require('dotenv').config();

const express = require('express');
const app = express();

// Porta : utilizza SERVER_PORT (OuiPanel) o PORT (.env) o 3000 per default
const PORT = process.env.SERVER_PORT || process.env.PORT || 3000;

// Middleware per analizzare il JSON
app.use(express.json());
app.use(express.urlencoded({ extended: true }));

// Servire i file statici (CSS, JS, immagini)
app.use(express.static('public'));

// Rotta principale
app.get('/', (req, res) => {
    res.send(`
        <!DOCTYPE html>
        <html lang="it">
        <head>
            <meta charset="UTF-8">
            <meta name="viewport" content="width=device-width, initial-scale=1.0">
            <title>La Mia Applicazione</title>
            <style>
                body { font-family: Arial, sans-serif; max-width: 800px; margin: 50px auto; padding: 20px; }
                h1 { color: #333; }
                .status { background: #d4edda; padding: 15px; border-radius: 5px; color: #155724; }
            </style>
        </head>
        <body>
            <h1>La Mia Applicazione Node.js</h1>
            <div>
                L'applicazione funziona correttamente!
            </div>
            <p>Server avviato sulla porta ${PORT}</p>
        </body>
        </html>
    `);
});

// Rotta API esempio
app.get('/api/status', (req, res) => {
    res.json({
        status: 'online',
        message: 'API funzionante',
        timestamp: new Date().toISOString()
    });
});

// Rotta API con parametro
app.get('/api/hello/:name', (req, res) => {
    res.json({
        message: `Ciao ${req.params.name} !`
    });
});

// Avviare il server su 0.0.0.0 (importante per OuiPanel)
app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server avviato su http://0.0.0.0:${PORT}`);
    console.log(`${new Date().toLocaleString('it-IT')}`);
});

Il server deve ascoltare su 0.0.0.0 (tutte le interfacce), non su localhost né su 127.0.0.1. Altrimenti l'app non è raggiungibile dall'esterno.

Esempio con template EJS

Se usi template EJS, aggiungi ejs alle dipendenze.

package.json:

{
  "name": "la-mia-applicazione-web",
  "version": "1.0.0",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "express": "^4.18.2",
    "ejs": "^3.1.9",
    "dotenv": "^16.3.1"
  }
}

index.js:

require('dotenv').config();

const express = require('express');
const app = express();
const PORT = process.env.SERVER_PORT || process.env.PORT || 3000;

// Configurazione EJS
app.set('view engine', 'ejs');
app.set('views', './views');

// File statici
app.use(express.static('public'));

// Rotta principale
app.get('/', (req, res) => {
    res.render('index', { 
        title: 'La Mia Applicazione',
        message: 'Benvenuto nel mio sito!'
    });
});

app.listen(PORT, '0.0.0.0', () => {
    console.log(`Server avviato sulla porta ${PORT}`);
});

views/index.ejs:

<!DOCTYPE html>
<html lang="it">
<head>
    <meta charset="UTF-8">
    <title><%= title %></title>
</head>
<body>
    <h1><%= message %></h1>
</body>
</html>

Caricare i file su OuiPanel

La Gestione file non ha un pulsante di caricamento. I file si inviano trascinandoli nella pagina.

  1. Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server Node.js.

  2. Nel menu laterale, clicca su Gestione file.

  3. Elimina i file predefiniti, se ce ne sono.

  4. Dal tuo computer, trascina nella pagina index.js, package.json e le tue cartelle (public/, views/, routes/…).

  5. Quando compare il riquadro «Trascina i tuoi file qui», rilascia.

Ogni file inviato così è limitato a 100 MB. Non caricare la cartella node_modules, la installa il server.

Riquadro Trascina i tuoi file qui mostrato durante il trascinamento nella Gestione file

Non caricare il tuo file .env. Crealo direttamente sul server, è più sicuro.

Via SFTP

Per molti file, o file oltre i 100 MB, usa l'SFTP. Collegati con FileZilla, trascina tutto il contenuto della cartella dell'app, poi verifica che sia arrivato tutto. La guida Come connettersi in SFTP con FileZilla spiega la connessione.


Creare il file .env

Il file .env tiene le tue variabili d'ambiente fuori dal codice.

  1. Nella Gestione file, nella Radice, clicca su Crea un file.

  2. Nella finestra «Crea un nuovo file», scrivi .env in Nome del file, con il punto davanti, poi clicca su Crea il file.

  3. Clicca su .env per aprirlo nell'editor, aggiungi le tue variabili, poi clicca su Salva.

# Configurazione dell'applicazione
PORT=3000
NODE_ENV=production

# Database (se necessario)
DATABASE_URL=mysql://user:password@host:3306/database

# Chiavi API (esempi)
API_KEY=la_tua_chiave_api
SECRET_KEY=la_tua_chiave_segreta

OuiPanel fornisce la variabile SERVER_PORT, la porta assegnata al tuo server. Usala per prima nel tuo codice, come nell'esempio index.js.

Gestione file nella radice di un server Node.js con index.js, package.json e package-lock.json

Ecco la struttura finale sul server.

Radice del server/
├── .env               ← Variabili d'ambiente
├── index.js           ← Il tuo codice
├── package.json       ← Dipendenze
├── public/            ← File statici
├── views/             ← Template
└── node_modules/      ← (creato automaticamente)

Scegliere il file principale e la versione di Node.js

OuiPanel deve sapere quale file avviare all'accensione. Su un server Node.js, questa impostazione è una variabile del server.

  1. Apri Configurazione › Impostazioni del server.

  2. Nella scheda Avvio del server, scegli la Versione sistema. L'elenco propone Node.js 12, 14 e tutte le versioni dalla 16 alla 26. La 24 è la versione LTS consigliata.

  3. Nella scheda Variabili d'ambiente, scrivi il nome del tuo file in File principale (file principale; i nomi delle variabili sono in francese).

  4. Clicca sulla spunta a destra del campo (Salva).

Il tuo file principaleValore di File principale
index.jsindex.js
app.jsapp.js
server.jsserver.js
src/index.jssrc/index.js

Impostazioni di un server Node.js con la versione Nodejs 24 e la variabile File principale

Il nome deve corrispondere esattamente al tuo file, maiuscole comprese.


Avviare e provare l'applicazione

Avviare il server

Nel menu laterale, clicca su Console, poi su Avvia. All'avvio il server installa le dipendenze di package.json con npm install, poi esegue il tuo file.

> npm install
added 62 packages in 4s

> node index.js
Server avviato su http://0.0.0.0:25639
15/12/2025 14:30:00

Aprire l'app nel browser

  1. Annota la porta mostrata nella console, per esempio 25639.

  2. Leggi l'indirizzo IP del tuo server in Vista Globale, alla riga Indirizzo principale.

  3. Apri http://IP:PORTA nel browser, per esempio http://203.0.113.10:25639.

Per un indirizzo più semplice, con nome di dominio e HTTPS, passa alla sezione successiva.


Collegare un dominio con il Proxy Manager

Il Proxy Manager rende l'app raggiungibile a un indirizzo come https://miaapp.it. Ti servono un dominio tuo e l'accesso alla sua zona DNS.

Creare il record DNS

  1. Nel menu laterale, clicca su Proxy Manager.

  2. La scheda La destinazione DNS di questo server indica il record da creare: Tipo A, Nome @ e l'indirizzo IP del proxy come Valore.

  3. Presso il tuo registrar (OVH, Cloudflare, ecc.), crea questo record nella zona DNS del dominio.

TipoNomeValore
A@ o appL'indirizzo IP del proxy

Pagina Proxy Manager con la scheda La destinazione DNS di questo server

Su Cloudflare, lascia il proxy disattivato (icona grigia, DNS only). Altrimenti il certificato HTTPS non può essere emesso.

Collegare il dominio

  1. Nel Proxy Manager, clicca su Aggiungi un dominio. Si apre il modulo Nuovo collegamento.

  2. In Nome di dominio, scrivi miaapp.it o app.esempio.com.

  3. In Porta, scegli dall'elenco la porta su cui ascolta la tua app.

  4. Lascia HTTPS su Certificato richiesto.

  5. Clicca su Verifica il DNS. Quando il pannello mostra «Il DNS punta qui», clicca su Crea il reindirizzamento.

Modulo Nuovo collegamento con il nome di dominio, la porta e HTTPS

Il dominio compare in Domini collegati. La tua app risponde su https://miaapp.it, con un certificato Let's Encrypt rinnovato automaticamente. La guida Collegare un dominio al tuo server con il Proxy Manager descrive ogni passaggio e i messaggi di errore.


Distribuire da un repository Git

Il tuo codice è su GitHub, GitLab, Bitbucket o Codeberg? La pagina Distribuzione scarica il repository e installa le dipendenze al posto tuo, senza caricare i file a mano.

  1. Nel menu laterale, clicca su Distribuzione.

  2. Nel blocco Collegare un repository, compila Indirizzo del repository e Ramo.

  3. In Accesso al repository, scegli Repository pubblico oppure una delle due opzioni per repository privati (chiave di distribuzione o token di accesso).

  4. Spunta Distribuire a ogni push sul ramo se vuoi aggiornamenti automatici, poi clicca su Salva.

  5. Clicca su Distribuisci ora.

Ogni distribuzione riavvia il server, che resta fermo mentre vengono installate le dipendenze. Se l'installazione o la build non riesce, riparte la versione precedente. I file non tracciati da Git, come il tuo .env, restano al loro posto. Prima della prima distribuzione, il pannello fa un backup del server.

Pagina Distribuzione Git con Collegare un repository, Indirizzo del repository, Ramo e Accesso al repository

Un'app Next.js o Nuxt va compilata prima dell'avvio. In Opzioni avanzate, compila il Comando di build (facoltativo), per esempio npm run build.


Risolvere un problema

L'app non si avvia

ErroreSoluzione
Cannot find module 'express'Controlla package.json e riavvia.
Cannot find module 'dotenv'Aggiungi dotenv in package.json.
Error: Cannot find module './index.js'Valore sbagliato nella variabile File principale.
SyntaxErrorErrore nel tuo codice JavaScript.

L'app si avvia ma non è raggiungibile

CausaSoluzione
Ascolta su localhostPassa a 0.0.0.0.
Porta sbagliataUsa process.env.SERVER_PORT.
FirewallLa porta deve essere quella assegnata da OuiPanel.

Controlla il tuo codice:

// ERRATO - ascolta solo in locale
app.listen(3000, 'localhost', () => {});
app.listen(3000, '127.0.0.1', () => {});

// CORRETTO - ascolta su tutte le interfacce
app.listen(PORT, '0.0.0.0', () => {});

Errore 502 Bad Gateway (Proxy Manager)

CausaSoluzione
App non avviataAvvia il server in OuiPanel.
Porta sbagliata nel Proxy ManagerControlla la porta del dominio collegato.
App andata in crashConsulta la Console.

L'app va in crash all'avvio

CausaSoluzione
Variabile d'ambiente mancanteControlla il file .env.
Errore di sintassiCorreggi il codice.
Pacchetto mancanteControlla package.json.

Aggiungi una gestione degli errori:

// Gestione degli errori non catturati
process.on('uncaughtException', (error) => {
    console.error('Errore non catturato:', error);
});

process.on('unhandledRejection', (error) => {
    console.error('Promessa rifiutata:', error);
});

npm install non riesce

ErroreSoluzione
package.json not foundVerifica che il file sia nella radice.
ERESOLVE unable to resolveAggiorna le versioni in package.json.

Sicurezza e buone pratiche

Proteggere il file .env

Da fareDa evitare
Creare il .env sul serverCaricare il .env dal tuo computer
Aggiungere .env al .gitignorePubblicare il .env su GitHub
Passare i segreti tramite variabiliScrivere le chiavi API nel codice

File .gitignore consigliato nel tuo progetto:

# Variabili d'ambiente
.env
.env.local
.env.production

# Moduli Node
node_modules/

Proteggere le intestazioni e limitare le richieste

I pacchetti helmet ed express-rate-limit proteggono le intestazioni HTTP e limitano il numero di richieste per indirizzo IP.

const helmet = require('helmet');  // Sicurezza HTTP
const rateLimit = require('express-rate-limit');  // Anti-DDoS

// Aggiungere in package.json : "helmet": "^7.1.0", "express-rate-limit": "^7.1.5"

app.use(helmet());

const limiter = rateLimit({
    windowMs: 15 * 60 * 1000, // 15 minuti
    max: 100 // 100 richieste max per IP
});
app.use(limiter);

Prestazioni

  • Usa NODE_ENV=production in produzione.

  • Attiva la compressione con il pacchetto compression.

  • Metti in cache i file statici.

const compression = require('compression');
app.use(compression());

// Cache dei file statici (1 giorno)
app.use(express.static('public', { maxAge: '1d' }));

Struttura avanzata

Per un'applicazione più complessa:

MonApp/
├── index.js              ← Punto d'ingresso
├── package.json
├── .env
├── config/
│   └── database.js       ← Configurazione BDD
├── routes/
│   ├── index.js          ← Rotte principali
│   ├── api.js            ← Rotte API
│   └── auth.js           ← Rotte autenticazione
├── controllers/
│   └── userController.js
├── models/
│   └── User.js
├── middleware/
│   └── auth.js
├── public/
│   ├── css/
│   ├── js/
│   └── images/
└── views/
    ├── index.ejs
    └── layout.ejs

Altri framework

Lo stesso principio vale per gli altri framework Node.js: ascoltare su 0.0.0.0, sulla porta fornita da OuiPanel.

FrameworkDescrizione
Express.jsFramework minimalista, usato in questa guida
FastifyAlternativa veloce a Express
KoaFramework leggero del team di Express
NestJSFramework TypeScript strutturato
Next.jsFramework React con rendering lato server
Nuxt.jsFramework Vue.js con rendering lato server

Hai bisogno di aiuto?

Apri un ticket da Ticket › Aprire un ticket, oppure dal riquadro Contatta il supporto in fondo alla scheda del tuo server nell'area clienti. Puoi anche fare la tua domanda sul Discord di OuiHeberg.

Questo articolo ti è stato utile?

265 visualizzazioni
Condividi questo articolo
Node.js
Hai bisogno di un hosting Node.js?

Distribuisci le tue applicazioni Node.js con il nostro hosting ottimizzato e supporto dedicato.

Vedi le offerte →

Articoli correlati