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
Vai sul Portale sviluppatori di Discord e accedi con il tuo account Discord.
Clicca su New Application.
Dai un nome alla tua applicazione, per esempio «Il mio bot», accetta le condizioni, poi clicca su Create.

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
Nella sezione Bot, clicca su Reset Token.
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.
| Intent | Utilità |
|---|---|
| PRESENCE INTENT | Facoltativo |
| SERVER MEMBERS INTENT | Facoltativo |
| MESSAGE CONTENT INTENT | Obbligatorio per leggere il contenuto dei messaggi |

Senza MESSAGE CONTENT INTENT il tuo bot non può leggere il contenuto dei messaggi, e un comando come
!pingresta senza risposta.
Invitare il bot sul tuo server Discord
Nel menu a sinistra, clicca su OAuth2 › URL Generator.
In Scopes, spunta bot e applications.commands.
In Bot Permissions, spunta i permessi necessari, oppure Administrator per tutti.
Copia l'URL generato in fondo alla pagina, aprilo e invita il bot sul tuo server Discord.

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.
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 (commands/,events/…).Quando compare il riquadro «Trascina i tuoi file qui», rilascia.
Ogni file inviato così è limitato a 100 MB.

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

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.
Apri Configurazione › Impostazioni del server.
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.
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 |
bot.js | bot.js |
main.js | main.js |
src/index.js | src/index.js |
app.js | app.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.

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
Apri Discord. Il tuo bot appare online, con un pallino verde.
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.
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 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.

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.
Carica i file dei tuoi bot nella radice del server, per esempio
bot1.jsebot2.js.Riunisci le dipendenze di tutti i bot nel
package.jsondella radice.Nel file
.env, dai un nome diverso al token di ogni bot, comeDISCORD_TOKEN_1eDISCORD_TOKEN_2. Fai leggere a ogni bot il suo, per esempio conclient.login(process.env.DISCORD_TOKEN_1).Nella radice, crea un file
launcher.jscon il contenuto qui sotto, poi adatta l'elencobots.In Configurazione › Impostazioni del server, scrivi
launcher.jsin Fichier principal (file principale), poi clicca sulla spunta (Salva).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
| Errore | Soluzione |
|---|---|
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 directory | Il file indicato non esiste. |
Errore di token
| Errore | Soluzione |
|---|---|
An invalid token was provided | Controlla il token in .env. |
TOKEN_INVALID | Rigenera il token sul Portale sviluppatori di Discord. |
Used disallowed intents | Attiva gli intent sul Portale sviluppatori di Discord. |
Il bot non legge i messaggi
| Causa | Soluzione |
|---|---|
| MESSAGE CONTENT INTENT disattivato | Attivalo sul Portale sviluppatori di Discord. |
| Intent sbagliati nel codice | Aggiungi GatewayIntentBits.MessageContent. |
Il file .env non viene letto
| Causa | Soluzione |
|---|---|
| dotenv mancante | Verifica che sia in package.json. |
require nel posto sbagliato | require('dotenv').config(); deve essere la prima riga. |
| Nome del file sbagliato | Il file deve chiamarsi esattamente .env. |
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. |
Buone pratiche
Proteggere il file .env
| Da fare | Da evitare |
|---|---|
Tenere il .env solo sul server | Condividere il .env |
Creare il .env direttamente in OuiPanel | Caricare il .env dal tuo computer |
Aggiungere .env al .gitignore | Pubblicare 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
.envdirettamente sul server.Attiva solo gli intent necessari.
Gestisci gli errori con
try/catche 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.
Distribuisci le tue applicazioni Node.js con il nostro hosting ottimizzato e supporto dedicato.
Vedi le offerte →