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 hikari 24/7

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

Para hospedar um bot hikari 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ê hospeda por conta própria, ou um plano de bots na hospedagem de bots do Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu código, cola o token e clica em Start. No nosso teste, um bot hikari 2.7.0 usou cerca de 61 MB de memória e alcançou o Discord cerca de 1,3 segundo depois de iniciado. O hikari 2.7 exige Python 3.11 ou mais recente e não tem framework de comandos próprio, por isso esta página inclui um comando slash escrito só com hikari. Os passos na PlayNHost:

  1. Na página de hospedagem de bots do Discord, 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 na Visão geral abre em Conectar ao Discord. O primeiro passo, O que roda, deve dizer 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 que liste hikari, ou clique em Conectar o Git.
  6. Na página Bot, painel Código, deixe o Runtime em Python 3.12 (recommended) ou escolha 3.11, 3.13 ou 3.14 (não 3.10), defina o Arquivo de entrada se não for bot.py e clique em Salvar.
  7. Clique em Iniciar bot e acompanhe o Console. Quando seu bot imprimir Logged in as ..., o cartão dirá Seu bot está online no Discord.

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

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
hikari2.7.061 MB1.3 s
discord.py2.7.148 MB1.0 s
Pycord2.8.151 MB1.1 s
nextcord3.2.047 MB1.0 s
disnake2.12.247 MB0.9 s
Só 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 é a 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 hikari 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 hikari mínimo

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

requirements.txt

hikari>=2.7,<3

bot.py

import os

import hikari

bot = hikari.GatewayBot(token=os.environ["DISCORD_TOKEN"])


@bot.listen()
async def register_commands(event: hikari.StartedEvent) -> None:
    application = await bot.rest.fetch_application()
    await bot.rest.set_application_commands(
        application=application.id,
        commands=[bot.rest.slash_command_builder("ping", "Check that the bot answers")],
    )
    print(f"Logged in as {bot.get_me()}")


@bot.listen()
async def on_command(event: hikari.CommandInteractionCreateEvent) -> None:
    if event.interaction.command_name == "ping":
        await event.interaction.create_initial_response(
            hikari.ResponseType.MESSAGE_CREATE, "Pong!"
        )


bot.run()

O hikari escolhe o evento pelo tipo em cada listener. Quando todos os shards iniciaram (StartedEvent), o bot envia sua lista de comandos ao Discord com set_application_commands, o que substitui os comandos globais do bot por essa lista, e depois imprime a linha de pronto. CommandInteractionCreateEvent chega toda vez que alguém usa um comando. A linha Logged in as faz o indicador da Visão geral mudar para Online no Discord.

Se o token estiver errado

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

UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot

É um hikari.errors.UnauthorizedError, lançado pela primeira requisição do hikari ao Discord quando o bot inicia, e o bot para. Confira o token na página Bot, painel Discord: clique em Verificar agora e, se aparecer O Discord não aceitou, copie um novo token no Discord Developer Portal, Bot, Reset Token, cole-o com Substituir token 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 hikari

  • Python 3.11 ou mais recente. O hikari 2.7.0 exige Python 3.11 ou posterior; o README indica de 3.11 a 3.15. No Python 3.10, uma linha hikari simples faz o pip instalar a 2.6.0, a última versão para 3.10. Com hikari>=2.7,<3, o pip recusa: o console mostra o erro do pip e [PlayNHost] pip could not install everything in requirements.txt., e se o hikari nunca foi instalado no servidor, o bot para depois com ModuleNotFoundError: No module named 'hikari'. Em Runtime, qualquer escolha exceto 3.10 funciona.
  • Sem framework de comandos incluído. O hikari oferece eventos e a API REST do Discord; o README indica lightbulb, tanjun, crescent e arc para comandos. O bot acima registra o próprio comando a cada início, o que o README chama de bastante spammy; ele sugere um gerenciador de comandos ou verificações para enviar os comandos só quando mudaram. Um framework é uma linha a mais em requirements.txt.
  • Um aviso a cada início. O hikari registra You are running on optimization level 0 (no optimizations) e sugere -O. Em um servidor PlayNHost, o script de início roda seu arquivo de entrada com python simples, então você vê esse aviso e o bot funciona normalmente. Para escondê-lo, passe suppress_optimization_warning=True para hikari.GatewayBot(). No seu próprio VPS, você pode adicionar -O no lugar.
  • Logs e um banner vêm ativados por padrão. GatewayBot configura o log em INFO e imprime o banner do hikari. A linha própria quando um shard conecta é shard is ready: ...; o indicador do painel não conta essa linha como online, então imprima sua própria linha Logged in as como acima.
  • Ele verifica atualizações. Por padrão, run() pergunta ao PyPI qual é o hikari mais novo e registra A newer version of hikari is available quando há um. bot.run(check_for_updates=False) desativa isso.
  • Intents. O padrão são todos os intents que não são privilegiados. Ler o texto das mensagens exige hikari.Intents.MESSAGE_CONTENT em intents= e o Message Content Intent ligado no Developer Portal. Se seu código pedir isso enquanto está desligado no Portal, o Discord recusa o login. Veja Corrigir "Used disallowed intents" no seu bot do Discord.

Hospede você mesmo em um VPS Linux

Confira primeiro a versão do Python: python3 --version deve mostrar 3.11 ou mais recente. O Debian 12 traz 3.11, o Ubuntu 24.04 traz 3.12 e o Debian 13 traz 3.13; o Ubuntu 22.04 traz 3.10, antigo demais para o hikari 2.7. Depois instale o Python, crie um usuário e uma pasta para o bot e instale o hikari em um ambiente virtual:

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

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

Depois crie /etc/systemd/system/hikari-bot.service. Ele roda o Python com -O, como o README do hikari recomenda para produção:

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

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

[Install]
WantedBy=multi-user.target

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

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

PYTHONUNBUFFERED=1 faz print() chegar ao journal na hora, em vez de quando um buffer enche. Para atualizar o bot, copie os arquivos novos, execute de novo a linha pip install e sudo systemctl restart hikari-bot.

Hospedagem própria ou plano de bots

Seu próprio VPSUm plano de bots da PlayNHost
PythonA versão da sua distribuição, que precisa ser 3.11 ou mais recente para o hikari 2.7Escolha 3.11, 3.12, 3.13 ou 3.14 em Runtime
PacotesVocê executa pip install após cada mudançaInstalados em um início depois que requirements.txt ou a versão do Python muda, e no primeiro início um dia depois da última instalação
ReiníciosSua unidade systemdIniciado de novo após uma falha; deixado parado com o motivo se falhar de novo em menos de um minuto
O tokenUm arquivo que você protege por conta própriaGuardado criptografado, verificado com o Discord quando você o cola, entregue ao seu código como DISCORD_TOKEN
Opções do PythonAdicione -O em ExecStartRoda com python simples
Atualizações do sistema, firewall, SSHFicam por sua contaNão é tarefa sua

Perguntas frequentes

Preciso de lightbulb, tanjun, crescent ou arc?

Não. O hikari sozinho consegue registrar e responder comandos slash, como o bot acima mostra. Um framework é um gerenciador de comandos pronto, para você não escrever o registro e o roteamento quando tiver mais do que alguns comandos. Adicione-o ao requirements.txt; ele é instalado no próximo início.

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: o comando é registrado logo antes dessa linha. Enquanto testa, passe guild=your_server_id para set_application_commands: o comando é então criado só nesse servidor, e a documentação do Discord diz que comandos de servidor são atualizados na hora.

O aviso de otimização é um problema?

Não. Ele diz que o Python roda sem -O, a opção que remove instruções assert e outras verificações só de depuração, que o hikari sugere por velocidade. Seu bot funciona sem ela. Esconda o aviso com suppress_optimization_warning=True.

Um bot hikari cabe no menor plano?

Sim. Com cerca de 61 MB no nosso teste, um bot hikari 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 seu bot mesmo 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 hospedagem de bots do Discord e envie seu bot hikari.

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

NOSSOS ÚLTIMOS ARTIGOS