NodeJSPubblicato il 15 dicembre 2025Lettura di 9 min

Come ospitare un bot Discord (discord.js) su OuiPanel

Questa guida ti mostra come ospitare un bot Discord scritto con discord.js (JavaScript, Node.js) su un server Node.js di OuiHeberg, gestito in OuiPanel. Il bot gira di continuo sul server, anche quando il tuo computer è spento. Ti servono un bot creato sul Portale sviluppatori di Discord, il suo token e i file del bot (index.js, package.json…).


Creare il bot su Discord

Hai già il tuo bot e il suo token? Passa alla sezione successiva.

Creare l'applicazione

  1. Vai sul Portale sviluppatori di Discord e accedi con il tuo account Discord.

  2. Clicca su New Application.

  3. Dai un nome alla tua applicazione, per esempio «Il mio bot», accetta le condizioni, poi clicca su Create.

Finestra Create an application del Portale sviluppatori di Discord con il campo Name

Creare il bot

Nel menu a sinistra, clicca su Bot. Le applicazioni recenti hanno già il loro bot. Se compare il pulsante Add Bot, cliccaci sopra e conferma con Yes, do it! nella finestra.

Recuperare il token

  1. Nella sezione Bot, clicca su Reset Token.

  2. Conferma, poi copia il token mostrato.

Il token è come una password. Chi lo ottiene può controllare il tuo bot. Non condividerlo mai e non metterlo mai in codice pubblico (GitHub, ecc.).

Attivare gli intent

Sempre nella sezione Bot, scorri fino a Privileged Gateway Intents e attiva gli intent che ti servono.

IntentUtilità
PRESENCE INTENTFacoltativo
SERVER MEMBERS INTENTFacoltativo
MESSAGE CONTENT INTENTObbligatorio per leggere il contenuto dei messaggi

Sezione Privileged Gateway Intents del Portale sviluppatori di Discord con i tre interruttori

Senza MESSAGE CONTENT INTENT il tuo bot non può leggere il contenuto dei messaggi, e un comando come !ping resta senza risposta.

Invitare il bot sul tuo server Discord

  1. Nel menu a sinistra, clicca su OAuth2 › URL Generator.

  2. In Scopes, spunta bot e applications.commands.

  3. In Bot Permissions, spunta i permessi necessari, oppure Administrator per tutti.

  4. Copia l'URL generato in fondo alla pagina, aprilo e invita il bot sul tuo server Discord.

Campo Generated URL della pagina OAuth2 con il link di invito del bot


Preparare i file del bot

Struttura dei file

Il tuo bot deve avere questa struttura.

MonBot/
├── index.js         ← File principale (o bot.js, main.js...)
├── package.json     ← Dipendenze npm
├── .env             ← Token del bot (creato sul server)
├── commands/        ← (Opzionale) Cartella dei comandi
└── events/          ← (Opzionale) Cartella degli eventi

Il file package.json

Crea un file package.json con le dipendenze discord.js e dotenv.

{
  "name": "il-mio-bot-discord",
  "version": "1.0.0",
  "description": "Il mio bot Discord",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "discord.js": "^14.14.1",
    "dotenv": "^16.3.1"
  }
}

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

Il file principale (index.js)

Crea il tuo file principale. Carica il token con dotenv.

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

const { Client, GatewayIntentBits } = require('discord.js');

// Creazione del client Discord
const client = new Client({
    intents: [
        GatewayIntentBits.Guilds,
        GatewayIntentBits.GuildMessages,
        GatewayIntentBits.MessageContent
    ]
});

// Evento : Bot pronto
client.once('ready', () => {
    console.log(`Bot connesso come ${client.user.tag}`);
});

// Evento : Messaggio ricevuto
client.on('messageCreate', message => {
    if (message.author.bot) return;
    
    // Usa il prefisso da .env (opzionale)
    const prefix = process.env.PREFIX || '!';
    
    if (message.content === `${prefix}ping`) {
        message.reply('Pong!');
    }
});

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

client.on('error', error => {
    console.error('Errore Discord:', error);
});

// Connessione con il token da .env
client.login(process.env.DISCORD_TOKEN);

La riga require('dotenv').config(); deve essere la prima del tuo file.


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 (commands/, events/…).

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

Ogni file inviato così è limitato a 100 MB.

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

Non caricare il tuo file .env. Lo creerai direttamente sul server nel passaggio successivo.

Via SFTP

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


Creare il file .env

Non mettere mai il tuo token direttamente nel codice. Crea un file .env sul server.

  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 e incolla il contenuto qui sotto.

  4. Sostituisci il_tuo_token_qui con il tuo token, poi clicca su Salva.

# Token del bot Discord
DISCORD_TOKEN=il_tuo_token_qui

# Prefisso dei comandi (opzionale)
PREFIX=!

Esempio con un token reale:

DISCORD_TOKEN=MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcdEF.abcdefghijklmnopqrstuvwxyz123456
PREFIX=!
  • Nessuno spazio intorno al =.

  • Nessuna virgoletta intorno ai valori.

  • Non condividere mai questo file.

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              ← Contiene DISCORD_TOKEN
├── index.js          ← Il tuo codice
├── package.json      ← Dipendenze
└── 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, controlla la Versione sistema. L'elenco propone Node.js 12, 14 e tutte le versioni dalla 16 alla 26. La 24, versione LTS, va bene per discord.js.

  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
bot.jsbot.js
main.jsmain.js
src/index.jssrc/index.js
app.jsapp.js

La stessa scheda offre Pacchetti Node aggiuntivi e Pacchetti Node da disinstallare, per aggiungere o togliere pacchetti npm (nomi separati da spazi). Il campo Argomenti aggiuntivi passa opzioni a Node.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 il bot

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 45 packages in 3s

> node index.js
Bot connesso come MonBot#1234

Verificare su Discord

La console deve mostrare questa riga.

Bot connesso come MonBot#1234
  1. Apri Discord. Il tuo bot appare online, con un pallino verde.

  2. Prova il comando !ping. Il bot risponde «Pong!».


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 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

Per un repository privato è consigliata la chiave di distribuzione. Il pannello genera una chiave propria del server, da aggiungere al repository in sola lettura.


Avviare più bot con una sola offerta

Un server Node.js avvia un solo file all'accensione. Per far girare più bot con la stessa offerta, quel file può essere uno script di avvio che lancia ogni bot in un processo separato. Se un bot va in crash, gli altri continuano a funzionare. Tutti condividono la memoria e il processore dell'offerta.

  1. Carica i file dei tuoi bot nella radice del server, per esempio bot1.js e bot2.js.

  2. Riunisci le dipendenze di tutti i bot nel package.json della radice.

  3. Nel file .env, dai un nome diverso al token di ogni bot, come DISCORD_TOKEN_1 e DISCORD_TOKEN_2. Fai leggere a ogni bot il suo, per esempio con client.login(process.env.DISCORD_TOKEN_1).

  4. Nella radice, crea un file launcher.js con il contenuto qui sotto, poi adatta l'elenco bots.

  5. In Configurazione › Impostazioni del server, scrivi launcher.js in Fichier principal (file principale), poi clicca sulla spunta (Salva).

  6. Nella Console, clicca su Riavvia.

// Avvia ogni bot in un processo separato
const { spawn } = require('child_process');
const readline = require('readline');

// I file dei tuoi bot, nella radice del server
const bots = ['bot1.js', 'bot2.js'];

for (const file of bots) {
  const child = spawn(process.execPath, [file]);

  // Mostra ogni riga del bot nella console, preceduta dal suo nome
  readline.createInterface({ input: child.stdout })
    .on('line', (line) => console.log(`[${file}] ${line}`));
  readline.createInterface({ input: child.stderr })
    .on('line', (line) => console.error(`[${file}] ${line}`));

  child.on('exit', (code) => console.log(`[${file}] arrestato (codice ${code})`));
}

Nella console, ogni riga inizia con il nome del bot che la scrive, per esempio [bot1.js] Bot connesso come MonBot#1234. Quando un bot si ferma, lo script di avvio mostra il suo codice di uscita.

Lo script di avvio non riavvia un bot che si ferma. Per rilanciarlo, riavvia il server.


Risolvere un problema

Il bot non si avvia

ErroreSoluzione
Cannot find module 'discord.js'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.
ENOENT: no such file or directoryIl file indicato non esiste.

Errore di token

ErroreSoluzione
An invalid token was providedControlla il token in .env.
TOKEN_INVALIDRigenera il token sul Portale sviluppatori di Discord.
Used disallowed intentsAttiva gli intent sul Portale sviluppatori di Discord.

Il bot non legge i messaggi

CausaSoluzione
MESSAGE CONTENT INTENT disattivatoAttivalo sul Portale sviluppatori di Discord.
Intent sbagliati nel codiceAggiungi GatewayIntentBits.MessageContent.

Il file .env non viene letto

CausaSoluzione
dotenv mancanteVerifica che sia in package.json.
require nel posto sbagliatorequire('dotenv').config(); deve essere la prima riga.
Nome del file sbagliatoIl file deve chiamarsi esattamente .env.

npm install non riesce

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

Buone pratiche

Proteggere il file .env

Da fareDa evitare
Tenere il .env solo sul serverCondividere il .env
Creare il .env direttamente in OuiPanelCaricare il .env dal tuo computer
Aggiungere .env al .gitignorePubblicare il .env su GitHub

File .gitignore consigliato nel tuo progetto:

# Variabili d'ambiente
.env

# Moduli Node
node_modules/

Sicurezza e prestazioni

  • Non condividere mai il tuo token e rigeneralo se trapela.

  • Crea il .env direttamente sul server.

  • Attiva solo gli intent necessari.

  • Gestisci gli errori con try/catch e aggiungi log per il debug.

Organizzare un bot più grande

Per un bot più ordinato, separa comandi ed eventi.

MonBot/
├── index.js              ← Punto d'ingresso
├── package.json
├── .env                  ← Creato sul server
├── commands/
│   ├── ping.js
│   ├── help.js
│   └── info.js
├── events/
│   ├── ready.js
│   └── messageCreate.js
└── config.json           ← Configurazione non sensibile

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?

420 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