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:
- 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.
- 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.
- Em Conectar ao Discord, cole seu token em Cole o token do seu bot, clique em Conectar e depois em Sim, continuar.
- 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.
- Em Seu código, clique em Enviar arquivos e envie
bot.pye umrequirements.txtcom uma linhadisnakefixada, ou clique em Conectar o Git. - 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. - 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:
| Biblioteca | Versão | Memória em repouso | Do início à resposta do Discord |
|---|---|---|---|
| disnake | 2.12.2 | 47 MB | 0,9 s |
| discord.py | 2.7.1 | 48 MB | 1,0 s |
| Pycord | 2.8.1 | 51 MB | 1,1 s |
| nextcord | 3.2.0 | 47 MB | 1,0 s |
| hikari | 2.7.0 | 61 MB | 1,3 s |
| Só o Python | 3.12 | 9 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.*oudisnake~=2.12.2. Em nossos servidores isso conta em dobro: o script de início executapip install -Uno seurequirements.txtquando ele muda, e de novo no primeiro início um dia depois da última instalação, então uma linhadisnakesem 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
disnakee escreveimport disnake; ele não instala um módulodiscord, então não sobrescreve o discord.py nem o Pycord. Mesmo assim, deixe emrequirements.txtsó 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)paraInteractionBot(). 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.Botprecisam deintents.message_content = Trueno 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 VPS | Um plano de bots da PlayNHost | |
|---|---|---|
| Python | A versão que sua distribuição traz; você instala e atualiza | Escolha de 3.10 a 3.14 em Runtime |
| Pacotes | Você executa pip install depois de cada mudança | Instalados 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ícios | Sua unidade systemd | Iniciado de novo após uma falha; deixado parado com o motivo se falhar outra vez em menos de um minuto |
| O token | Um arquivo que você mesmo protege | Guardado criptografado, verificado com o Discord quando você o cola e entregue ao seu código como DISCORD_TOKEN |
| Erros | Você lê o journal | O banner do console diz a causa, como um token errado ou um intent faltando |
| Atualizações do sistema, firewall, SSH | Por sua conta | Nã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.



