NOVO 📢 Black Friday: a oferta de lançamento termina em 30/11. Até 70% de desconto no seu primeiro mês!Ver planos
Black FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 minBlack FridayAté 70% de desconto no seu primeiro mês, termina em 30/11Termina em 9 d 02 h 49 min

Como hospedar um bot disnake 24/7: seu bot sempre online

Hospedagem de bot do DiscordAtualizado 6/11/202610 min de leitura

Para hospedar um bot disnake 24/7, rode-o em uma máquina que fica sempre ligada em vez de no seu PC: um VPS Linux com um serviço systemd, se você mesmo hospeda, ou um plano de bots na PlayNHost Discord bot hosting (a partir de US$1,99 por mês), onde você envia seu código, cola o token e clica em Iniciar. No nosso teste, um bot disnake 2.12.2 usou cerca de 47 MB de memória e chegou ao Discord cerca de 0,9 segundo depois de ser iniciado. O disnake pede que você fixe a versão, e em um servidor que atualiza pacotes sozinho isso importa. Os passos na PlayNHost:

  1. Na página Discord bot hosting, clique em Criar servidor em um plano. Na janela do pedido, responda a Para qual plataforma é o seu bot? com Discord e escolha Python.
  2. Abra seu servidor no painel. O cartão Configurar seu bot em Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve mostrar Este bot roda Python Bot.; clique nesse passo para conferir e depois em Continuar.
  3. Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
  4. Em Permissões, marque Meu código usa isto apenas para os intents privilegiados que seu código pede (o bot abaixo não precisa de nenhum), clique em Adicionar a um servidor do Discord e depois em Continuar.
  5. Em Seu código, clique em Enviar arquivos e envie bot.py e um requirements.txt com uma linha disnake fixada, ou clique em Conectar o Git.
  6. Se o seu arquivo principal não for bot.py, defina o Arquivo de entrada na página Bot, painel Código, e clique em Salvar.
  7. Clique em Iniciar bot e acompanhe o Console. Quando seu bot imprimir Logged in as ..., o cartão mostra Seu bot está online no Discord.

Os passos gerais de Python (runtime, pacotes, linhas do console) estão em Como hospedar um bot do Discord em Python. Esta página cobre o que muda com o disnake.

O que medimos

Rodamos cada biblioteca de Discord para Python em nossos próprios servidores, na mesma configuração de Python 3.12 que um plano de bots usa, com limite de memória de 1 GB:

BibliotecaVersãoMemória em repousoDo início à resposta do Discord
disnake2.12.247 MB0,9 s
discord.py2.7.148 MB1,0 s
Pycord2.8.151 MB1,1 s
nextcord3.2.047 MB1,0 s
hikari2.7.061 MB1,3 s
Só o Python3.129 MB

Como: o menor programa que carrega a biblioteca e faz login com um token falso, instalado do jeito que nossos servidores instalam. A memória é o que o processo ocupava 15 segundos depois de o Discord recusar o token, e o tempo de início vai do lançamento até essa resposta, então inclui uma ida ao Discord. Cada valor é a mediana de três execuções após uma execução de aquecimento. É o piso: um bot que se conectou, entrou em servidores e guardou membros em cache usa mais, em uma quantidade que depende do bot.

O que isso significa para o plano: um bot disnake mínimo usa uma pequena parte do plano STARTER de 0,5 GB. Dimensione o plano pelo que o seu próprio bot guarda na memória, não pela biblioteca.

Um bot disnake mínimo

Ele responde a /ping com um comando de barra e imprime uma linha de pronto. Lê o token de DISCORD_TOKEN, o nome que o painel dá ao seu código.

requirements.txt

disnake==2.12.*

bot.py

import os

import disnake
from disnake.ext import commands

bot = commands.InteractionBot()


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.slash_command(description="Check that the bot answers")
async def ping(inter: disnake.ApplicationCommandInteraction):
    await inter.response.send_message("Pong!")


bot.run(os.environ["DISCORD_TOKEN"])

commands.InteractionBot é o bot do disnake só para comandos de aplicativo, sem prefixo para definir. Ele registra /ping no Discord sozinho depois de conectar. A linha Logged in as é a que muda o indicador em Visão geral para Online no Discord.

Se o token estiver errado

Quando o Discord recusa o token, o disnake lança este erro (o texto que nosso bot de teste imprimiu):

LoginFailure: Improper token has been passed.

Com bot.run(), um traceback termina como disnake.errors.LoginFailure: Improper token has been passed. e o bot para. O painel lê essa linha: o indicador mostra Problema no token e um banner diz O Discord não aceitou o token do seu bot. Gere um novo token no Discord Developer Portal: seu aplicativo, Bot, Reset Token (ele é mostrado uma única vez). Clique em Substituir o token no banner, depois em Substituir token no painel Discord, cole-o e inicie o bot de novo. Veja Como criar um bot do Discord e obter o token.

O que um host precisa saber sobre o disnake

  • Fixe a versão. O README do disnake diz que ele não segue totalmente o versionamento semântico e recomenda fixar uma versão menor, como disnake==2.12.* ou disnake~=2.12.2. Em nossos servidores isso conta em dobro: o script de início executa pip install -U no seu requirements.txt quando ele muda, e de novo no primeiro início um dia depois da última instalação, então uma linha disnake sem fixação pode passar sozinha para uma versão nova. Com a versão fixada, você recebe correções dentro da 2.12 e escolhe quando subir.
  • A importação é disnake. Você instala disnake e escreve import disnake; ele não instala um módulo discord, então não sobrescreve o discord.py nem o Pycord. Mesmo assim, deixe em requirements.txt só a biblioteca que seu código usa.
  • Versão do Python. O disnake 2.12 exige Python 3.10 ou mais novo. O Runtime no painel Código oferece de 3.10 a 3.14, com 3.12 como padrão, então qualquer escolha funciona.
  • A sincronização de comandos apaga o que seu código não define. Por padrão, o disnake sincroniza comandos globais e de servidor e pode apagar no Discord comandos que seu código não tem mais (allow_command_deletion). Um segundo programa conectado com o mesmo bot, como uma cópia de teste no seu PC, perde seus comandos quando a cópia do servidor sincroniza. Use um aplicativo separado para testes.
  • Ver a sincronização. Passe command_sync_flags=commands.CommandSyncFlags(sync_commands_debug=True) para InteractionBot(). O disnake então imprime o que sincroniza mesmo sem o logging configurado, e as linhas aparecem no Console.
  • Intents. Os intents padrão não incluem nenhum privilegiado, e comandos de barra não precisam de nenhum. Comandos com prefixo usando commands.Bot precisam de intents.message_content = True no seu código e de Message Content Intent ativado no Developer Portal. Se seu código pedir isso enquanto estiver desativado no Portal, o Discord recusa o login. Veja Corrigir "Used disallowed intents" no seu bot do Discord.

Hospede você mesmo em um VPS Linux

No Debian ou Ubuntu, instale o Python, crie um usuário e uma pasta para o bot e instale o disnake em um ambiente virtual:

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/disnake-bot bot
sudo cp bot.py requirements.txt /opt/disnake-bot/
sudo chown bot: /opt/disnake-bot/bot.py /opt/disnake-bot/requirements.txt
sudo -u bot python3 -m venv /opt/disnake-bot/venv
sudo -u bot /opt/disnake-bot/venv/bin/pip install -r /opt/disnake-bot/requirements.txt

Coloque o token em um arquivo que só o root possa ler. Crie /etc/disnake-bot.env com sudo nano /etc/disnake-bot.env, escreva uma linha, DISCORD_TOKEN= seguido do seu token, salve e execute sudo chmod 600 /etc/disnake-bot.env.

Depois crie /etc/systemd/system/disnake-bot.service:

[Unit]
Description=disnake Discord bot
Wants=network-online.target
After=network-online.target

[Service]
User=bot
WorkingDirectory=/opt/disnake-bot
EnvironmentFile=/etc/disnake-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/disnake-bot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Inicie agora e a cada boot, e depois acompanhe a saída:

sudo systemctl daemon-reload
sudo systemctl enable --now disnake-bot
sudo journalctl -u disnake-bot -f

PYTHONUNBUFFERED=1 faz print() chegar ao journal na hora, em vez de quando um buffer enche. Aqui nada se atualiza sozinho: para passar a um disnake mais novo, mude a versão fixada, execute a linha pip install de novo e sudo systemctl restart disnake-bot.

Hospedagem própria ou plano de bots

Seu próprio VPSUm plano de bots da PlayNHost
PythonA versão que sua distribuição traz; você instala e atualizaEscolha de 3.10 a 3.14 em Runtime
PacotesVocê executa pip install depois de cada mudançaInstalados com pip install -U em um início após mudar requirements.txt ou a versão do Python, e no primeiro início um dia depois da última instalação, dentro das suas versões fixadas
ReiníciosSua unidade systemdIniciado de novo após uma falha; deixado parado com o motivo se falhar outra vez em menos de um minuto
O tokenUm arquivo que você mesmo protegeGuardado criptografado, verificado com o Discord quando você o cola e entregue ao seu código como DISCORD_TOKEN
ErrosVocê lê o journalO banner do console diz a causa, como um token errado ou um intent faltando
Atualizações do sistema, firewall, SSHPor sua contaNão é tarefa sua

Perguntas frequentes

Meu bot disnake quebrou depois de um reinício sem nenhuma mudança. Por quê?

Se requirements.txt traz só disnake, a instalação de pacotes no primeiro início um dia depois da anterior pode tê-lo passado para uma versão mais nova, e o disnake não promete que versões menores estejam livres de mudanças que quebram a compatibilidade. Fixe a versão que você testou, por exemplo disnake==2.12.*, e inicie o bot de novo: os pacotes são instalados outra vez porque o arquivo mudou.

Por que o /ping não aparece no meu servidor?

Confira se o bot foi adicionado com Adicionar a um servidor do Discord e se o console mostra Logged in as. Enquanto testa, passe test_guilds=[your_server_id] para InteractionBot(), como fazem os próprios exemplos do disnake: os comandos são então criados nesse servidor, e a documentação do Discord diz que comandos de servidor atualizam na hora.

O código do disnake é igual ao do discord.py?

Parecido, não igual. O disnake mantém a sintaxe e a estrutura do discord.py 2.0, com o nome disnake, mas tem seus próprios comandos de barra: @bot.slash_command com inter.response.send_message(), e as opções são lidas dos parâmetros da função. Mude as importações e o código dos comandos quando migrar.

Um bot disnake cabe no menor plano?

Sim. Com cerca de 47 MB no nosso teste, um bot disnake mínimo deixa a maior parte do plano STARTER de 0,5 GB para o seu próprio código. Suba de plano quando o próprio bot precisar: servidores grandes cujos membros ele guarda em cache, arquivos ou imagens que ele processa, ou dados que ele mantém na memória.

Pronto para rodar o seu? Escolha um plano em Discord bot hosting e envie seu bot disnake.

Seu bot já está em outro lugar? Traga-o para nós

NOSSOS ÚLTIMOS ARTIGOS