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 applicazione | Esempi |
|---|---|
| Sito web | Sito vetrina, blog, portfolio |
| API REST | Backend di un'app mobile o web |
| Dashboard | Pannello di amministrazione, interfaccia di gestione |
| Applicazione web | E-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 sulocalhostné su127.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.
Accedi a OuiPanel su dash.ouipanel.com e apri il tuo server Node.js.
Nel menu laterale, clicca su Gestione file.
Elimina i file predefiniti, se ce ne sono.
Dal tuo computer, trascina nella pagina
index.js,package.jsone le tue cartelle (public/,views/,routes/…).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.

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.
Nella Gestione file, nella Radice, clicca su Crea un file.
Nella finestra «Crea un nuovo file», scrivi
.envin Nome del file, con il punto davanti, poi clicca su Crea il file.Clicca su
.envper 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'esempioindex.js.

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.
Apri Configurazione › Impostazioni del server.
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.
Nella scheda Variabili d'ambiente, scrivi il nome del tuo file in File principale (file principale; i nomi delle variabili sono in francese).
Clicca sulla spunta a destra del campo (Salva).
| Il tuo file principale | Valore di File principale |
|---|---|
index.js | index.js |
app.js | app.js |
server.js | server.js |
src/index.js | src/index.js |

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
Annota la porta mostrata nella console, per esempio
25639.Leggi l'indirizzo IP del tuo server in Vista Globale, alla riga Indirizzo principale.
Apri
http://IP:PORTAnel browser, per esempiohttp://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
Nel menu laterale, clicca su Proxy Manager.
La scheda La destinazione DNS di questo server indica il record da creare: Tipo
A, Nome@e l'indirizzo IP del proxy come Valore.Presso il tuo registrar (OVH, Cloudflare, ecc.), crea questo record nella zona DNS del dominio.
| Tipo | Nome | Valore |
|---|---|---|
A | @ o app | L'indirizzo IP del proxy |

Su Cloudflare, lascia il proxy disattivato (icona grigia, DNS only). Altrimenti il certificato HTTPS non può essere emesso.
Collegare il dominio
Nel Proxy Manager, clicca su Aggiungi un dominio. Si apre il modulo Nuovo collegamento.
In Nome di dominio, scrivi
miaapp.itoapp.esempio.com.In Porta, scegli dall'elenco la porta su cui ascolta la tua app.
Lascia HTTPS su Certificato richiesto.
Clicca su Verifica il DNS. Quando il pannello mostra «Il DNS punta qui», clicca su Crea il reindirizzamento.

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.
Nel menu laterale, clicca su Distribuzione.
Nel blocco Collegare un repository, compila Indirizzo del repository e Ramo.
In Accesso al repository, scegli Repository pubblico oppure una delle due opzioni per repository privati (chiave di distribuzione o token di accesso).
Spunta Distribuire a ogni push sul ramo se vuoi aggiornamenti automatici, poi clicca su Salva.
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.

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
| Errore | Soluzione |
|---|---|
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. |
SyntaxError | Errore nel tuo codice JavaScript. |
L'app si avvia ma non è raggiungibile
| Causa | Soluzione |
|---|---|
Ascolta su localhost | Passa a 0.0.0.0. |
| Porta sbagliata | Usa process.env.SERVER_PORT. |
| Firewall | La 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)
| Causa | Soluzione |
|---|---|
| App non avviata | Avvia il server in OuiPanel. |
| Porta sbagliata nel Proxy Manager | Controlla la porta del dominio collegato. |
| App andata in crash | Consulta la Console. |
L'app va in crash all'avvio
| Causa | Soluzione |
|---|---|
| Variabile d'ambiente mancante | Controlla il file .env. |
| Errore di sintassi | Correggi il codice. |
| Pacchetto mancante | Controlla 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
| Errore | Soluzione |
|---|---|
package.json not found | Verifica che il file sia nella radice. |
ERESOLVE unable to resolve | Aggiorna le versioni in package.json. |
Sicurezza e buone pratiche
Proteggere il file .env
| Da fare | Da evitare |
|---|---|
Creare il .env sul server | Caricare il .env dal tuo computer |
Aggiungere .env al .gitignore | Pubblicare il .env su GitHub |
| Passare i segreti tramite variabili | Scrivere 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=productionin 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.
| Framework | Descrizione |
|---|---|
| Express.js | Framework minimalista, usato in questa guida |
| Fastify | Alternativa veloce a Express |
| Koa | Framework leggero del team di Express |
| NestJS | Framework TypeScript strutturato |
| Next.js | Framework React con rendering lato server |
| Nuxt.js | Framework 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.
Distribuisci le tue applicazioni Node.js con il nostro hosting ottimizzato e supporto dedicato.
Vedi le offerte →