Alojar um bot de Discord 24/7 num VPS com PM2

Instalar o Node.js, lançar o bot com o PM2, reiniciá-lo automaticamente e atualizá-lo sem interrupções: o método passo a passo.

Título do guia sobre o alojamento de um bot de Discord com PM2

O seu bot de Discord funciona no seu computador, mas para assim que o desliga. Para que fique online permanentemente, a solução mais simples é um pequeno servidor VPS e o PM2, um gestor de processos para Node.js.

O que precisa

  • um VPS Linux (Ubuntu ou Debian) acessível por SSH;
  • o código do seu bot, idealmente num repositório Git privado;
  • o token do bot, que nunca deve aparecer no código.

1. Instalar o Node.js

Ligue-se ao servidor e instale uma versão recente do Node.js. As versões fornecidas por defeito por algumas distribuições são antigas: use antes o gestor de versões nvm ou os repositórios oficiais da NodeSource. Depois, verifique a instalação:

node --version
npm --version

2. Obter o código e as dependências

git clone https://github.com/voce/meu-bot.git
cd meu-bot
npm ci

O npm ci instala exatamente as versões do ficheiro package-lock.json: o bot comporta-se como na sua máquina.

3. Proteger o token

Crie um ficheiro .env na raiz do projeto com o token e os outros segredos, e adicione-o ao .gitignore. O código lê estes valores no arranque (por exemplo, com o pacote dotenv). Um token publicado no GitHub é detetado e revogado pelo Discord em poucos minutos.

4. Lançar o bot com o PM2

npm install -g pm2
pm2 start index.js --name meu-bot

O PM2 reinicia automaticamente o bot se este falhar. Para que também arranque depois de um reinício do servidor:

pm2 save
pm2 startup

O comando pm2 startup mostra uma linha para copiar e colar: execute-a e volte a correr pm2 save.

5. Monitorizar e diagnosticar

pm2 status
pm2 logs meu-bot
pm2 monit

O pm2 logs mostra os erros em direto: é o primeiro reflexo quando o bot deixa de responder.

6. Atualizar o bot

git pull
npm ci
pm2 restart meu-bot

A interrupção dura apenas alguns segundos. Para ir mais longe, automatize estas três linhas num script de implementação.

Prefere que tratemos de tudo, do desenvolvimento à entrada em produção? Ver a oferta de bots de Discord.