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

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

Para hospedar um bot DSharpPlus 24/7, você o executa em uma máquina que fica sempre ligada: um VPS Linux com um serviço systemd que o inicia de novo quando ele para, ou um plano de bot na hospedagem de bots Discord da PlayNHost (a partir de US$1,99 por mês), onde você envia seu projeto em C#, escolhe .NET 10, cola o token e clica em Start. No nosso teste, um bot com DSharpPlus 5.0.0-nightly-02614 usou cerca de 69 MB de memória no .NET 10. O README do DSharpPlus diz para você usar suas builds nightly, e a documentação lista o .NET 10 como o único .NET para os nightly 5.0, então esta página usa uma. Os passos na PlayNHost:

  1. Na página de hospedagem de bots Discord, clique em Criar servidor em um plano. Na janela do pedido, responda Para qual plataforma é o seu bot? com Discord e escolha C# (.NET).
  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 .NET 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 somente 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.csproj e Program.cs para a pasta principal, sem as pastas bin e obj, ou clique em Conectar o Git.
  6. Na página Bot, painel Código, escolha .NET 10 em Runtime (ele é salvo assim que você escolhe) e deixe Arquivo de entrada vazio.
  7. Clique em Iniciar bot e acompanhe o Console. O servidor primeiro compila seu projeto, depois seu bot imprime Logged in as ... e o cartão mostra Seu bot está online no Discord.

Como criar o bot e o token dele é explicado em Como criar um bot do Discord e obter o token, e o tipo de bot .NET em geral (as duas formas de envio, erros de compilação) em Como hospedar um bot do Discord em C# (.NET). Esta página trata do DSharpPlus em si: qual versão usar, do que ele precisa em um servidor e o que saber antes de hospedá-lo.

O que medimos

BibliotecaVersãoMemória sem cargaDo início à resposta do Discord, com a compilaçãoDa execução do programa à resposta do Discord
DSharpPlus5.0.0-nightly-0261469 MB1,9 s0,5 s
Discord.Net3.20.276 MB1,6 s0,5 s
.NET 8 sozinho, sem bibliotecanenhuma24 MB1,3 s (compilação e início, sem chamada)nenhuma

Como: no nosso próprio nó, em um contêiner descartável configurado como um plano de bot de 1 GB (DSharpPlus na imagem do .NET 10, Discord.Net e a linha sem biblioteca na imagem do .NET 8, e o comando de início do nosso tipo de bot .NET, que executa dotnet publish a cada início), cada bot tentou entrar com um token falso, que o Discord recusou; a memória é a memória residente 15 segundos depois dessa resposta, a primeira coluna de tempo vai do começo da compilação até a resposta, a segunda da execução do programa, e cada valor é a mediana das execuções 2 a 4. O bot DSharpPlus medido apenas fez login, só com o DSharpPlus (sem DSharpPlus.Commands); sua primeira compilação, que também baixou o DSharpPlus, levou 7 segundos.

Esses são valores mínimos: sem servidores, sem membros em cache, ainda sem uma sessão de gateway aberta. Seu próprio código, o pacote de comandos e o número de servidores em que seu bot está se somam a eles. Para pular a compilação a cada início, você pode enviar os arquivos que publicou no seu computador em vez do projeto (veja o guia de C# linkado acima). Compare os números com os planos da hospedagem de bots Discord e escolha conforme o que seu bot faz.

Um bot DSharpPlus mínimo

Ele registra um comando de barra /ping, responde com Pong!, lê o token de DISCORD_TOKEN (o nome que o painel dá a ele) e imprime uma linha de pronto. Não precisa de nenhum intent privilegiado. Dois arquivos na pasta principal:

Bot.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="DSharpPlus" Version="5.0.0-nightly-02614" />
    <PackageReference Include="DSharpPlus.Commands" Version="5.0.0-nightly-02614" />
  </ItemGroup>
</Project>

Program.cs

using System.ComponentModel;
using DSharpPlus;
using DSharpPlus.Commands;
using DSharpPlus.Commands.Processors.SlashCommands;
using DSharpPlus.Exceptions;

string? token = Environment.GetEnvironmentVariable("DISCORD_TOKEN");
if (string.IsNullOrWhiteSpace(token))
{
    Console.WriteLine("No DISCORD_TOKEN found. Paste your bot token on the Bot page, then restart.");
    return 1;
}

// Slash commands only need the Guilds intent, which is not privileged.
DiscordClientBuilder builder = DiscordClientBuilder.CreateDefault(token, SlashCommandProcessor.RequiredIntents);

builder.ConfigureEventHandlers(events => events.HandleSessionCreated((sender, e) =>
{
    Console.WriteLine($"Logged in as {sender.CurrentUser.Username}");
    return Task.CompletedTask;
}));

builder.UseCommands((services, commands) =>
{
    commands.AddCommands(typeof(PingCommand));
    commands.AddProcessor(new SlashCommandProcessor());
}, new CommandsConfiguration { RegisterDefaultCommandProcessors = false });

DiscordClient client = builder.Build();
try
{
    await client.ConnectAsync();
}
catch (UnauthorizedException)
{
    Console.WriteLine("Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart.");
    return 1;
}

await Task.Delay(Timeout.Infinite);
return 0;

public class PingCommand
{
    [Command("ping"), Description("Replies with Pong!")]
    public static ValueTask ExecuteAsync(CommandContext context) => context.RespondAsync("Pong!");
}

A cada início, o servidor executa dotnet publish em Bot.csproj e inicia Bot.dll. O console mostra [PlayNHost] Building your bot (the first build downloads packages and can take a minute), depois [PlayNHost] Starting your bot, depois as linhas de log do próprio DSharpPlus e Logged in as ..., a linha que muda o indicador em Visão geral para Online no Discord. Convide o bot com Adicionar a um servidor do Discord antes de testar /ping: Como convidar seu bot do Discord para um servidor.

Se o token estiver errado

No nosso teste, com um token falso, ConnectAsync() do DSharpPlus falhou com este erro:

UnauthorizedException: Unauthorized: Unauthorized

Antes disso, o DSharpPlus registra um aviso: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. O bot acima captura essa UnauthorizedException e imprime Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. no lugar, e então para com o código de saída 1. Para corrigir, abra o Discord Developer Portal, seu aplicativo, Bot, e clique em Reset Token; o Discord mostra o novo token uma única vez. Na nossa página Bot, painel Discord, clique em Substituir token, cole-o, clique em Salvar token e depois em Reiniciar agora. Quando o Discord recusa a verificação do token salvo, o painel mostra O Discord não aceitou.

O que saber sobre o DSharpPlus em um servidor

  • Qual versão: no NuGet, a versão estável mais recente do DSharpPlus é a 4.5.3 (24 ago 2026), e os nightly 5.0 aparecem como pré-lançamentos (o mais recente, 5.0.0-nightly-02614, de 1 nov 2026). O README diz que, em regra, você deve usar os nightly, a documentação cobre apenas eles, e a documentação diz que não há suporte para a 4.5. Também existe no NuGet um pacote com o número simples 5.0.0, mas ele não está listado, é de maio de 2023 e não tem a API desta página: não escreva Version="5.0.0".
  • .NET 10 para os nightly: o 5.0.0-nightly-02614 é compilado apenas para .NET 10, e a documentação do DSharpPlus lista o .NET 10 como o único .NET para os nightly 5.0, então defina net10.0 no seu projeto e .NET 10 em Runtime. Com .NET 8 (recommended) escolhido, a compilação para com NETSDK1045. O DSharpPlus 4.5.3 tem como alvo o .NET Standard 2.0, e a documentação lista o .NET 8 a 10 como suportados para a 4.5; ele tem a API mais antiga (new DiscordClient(new DiscordConfiguration { ... })).
  • Fixe o nightly, sem curinga. Escreva o número exato do nightly, como acima. Pelas regras documentadas do NuGet, uma versão flutuante pega a maior correspondência, versões estáveis incluídas, e ignora se um pacote está listado, então 5.0.0-nightly-* seria resolvido para aquele 5.0.0 antigo não listado, que conta como maior que qualquer nightly. O servidor restaura e compila seu projeto a cada início, então um número exato também impede que ele mude sem você perceber. Para atualizar, mude o número em Bot.csproj e reinicie.
  • Comandos: o framework de comandos é o pacote separado DSharpPlus.Commands, que cuida de comandos de barra e de texto. DSharpPlus.SlashCommands está obsoleto e DSharpPlus.CommandsNext deve seguir o mesmo caminho, então tutoriais antigos que os usam precisam de mudanças. Mantenha todos os pacotes do DSharpPlus no mesmo número de nightly.
  • Intents: SlashCommandProcessor.RequiredIntents é só Guilds, que não é privilegiado. O processador de comandos de texto, ativado por padrão, reage ao prefixo ! e a menções ao bot; em servidores, o Discord envia a um bot o texto das mensagens que não o mencionam somente com o intent privilegiado Message Content. O bot acima desliga os processadores padrão e adiciona só o de comandos de barra. Se você adicionar Message Content, ative-o também no Developer Portal e marque Meu código usa isto para ele, ou o Discord fecha a conexão. Veja Corrigir "Used disallowed intents" no seu bot do Discord.
  • A lista de comandos do Discord acompanha o seu código. A cada início, sem DebugGuildId, o DSharpPlus.Commands lê do Discord os comandos globais do seu aplicativo, cria os novos, edita os alterados e exclui os que seu código não tem mais, exceto um ponto de entrada Activity. Um comando que você apaga do código desaparece do Discord no próximo início, e o mesmo vale para um comando global que outro programa registrou para o mesmo aplicativo.
  • Logs: o logger padrão do DSharpPlus escreve no console a partir do nível Information. Quando o Discord aceita o token, o Console mostra a linha de inicialização, DSharpPlus; version ...; com um token recusado, ele registra apenas a linha [Warn] acima. builder.SetLogLevel(...) muda o nível.
  • Falhas: quando o bot sai, como o bot acima faz com um token recusado, o painel o inicia de novo na hora, compilando-o antes. Se ele parar de novo dentro de um minuto, fica parado e o Console diz o motivo.

Hospede você mesmo em um VPS Linux

Em um VPS, compile o bot no seu próprio computador e execute no servidor só o resultado. Publique-o com o SDK do .NET 10:

dotnet publish Bot.csproj -c Release -o publish

No Ubuntu 24.04, o runtime do .NET 10 está nos pacotes do próprio Ubuntu:

sudo apt update
sudo apt install dotnet-runtime-10.0
dotnet --list-runtimes

Crie um usuário para o bot e copie a pasta publish para o servidor (por exemplo com scp -r), depois para a pasta dele:

sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp -r publish/. /opt/mybot/
sudo chown -R mybot: /opt/mybot

Mantenha o token fora do seu código, em um arquivo que só o root pode ler:

sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env

Crie /etc/systemd/system/mybot.service:

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

[Service]
User=mybot
WorkingDirectory=/opt/mybot
EnvironmentFile=/etc/mybot.env
ExecStart=/usr/bin/dotnet /opt/mybot/Bot.dll
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

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

sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f

Restart=always inicia o bot de novo 5 segundos depois de ele sair ou falhar, mas não depois de você pará-lo com systemctl stop. Para atualizar, publique de novo, copie os novos arquivos sobre os antigos e execute sudo systemctl restart mybot. No Debian, o .NET não está nos pacotes da própria distribuição; as instruções de instalação da Microsoft cobrem isso.

Hospedar por conta própria ou usar um plano de bot

Em um VPS que você mesmo gerencia, cabe a você:

  • Atualizações e segurança do sistema operacional, e upgrades do runtime do .NET.
  • Publicar e copiar cada nova build, o arquivo de serviço, o arquivo do token e suas permissões.
  • Ler journalctl para descobrir por que o bot parou.
  • Backups de tudo o que seu bot armazena.

Em troca, um VPS executa qualquer coisa que você instalar nele, e nada é compilado lá.

Em um plano de bot da PlayNHost, o painel faz isso por você:

  • .NET 6, 8, 9 ou 10 em um seletor, e a compilação: envie o projeto e clique em Start.
  • O token, verificado com o Discord antes de ser salvo, armazenado criptografado e entregue ao seu código como DISCORD_TOKEN.
  • Um link de convite com as permissões que você escolher, e um cartão Intents privilegiados que verifica quais estão ativados no seu Developer Portal.
  • Iniciar o bot de novo depois de uma falha, e um banner acima do Console quando o bot fica sem memória.
  • Envio de arquivos, deploys com Git e backups pelo painel.

Perguntas frequentes

Devo usar o DSharpPlus 4.5.3 ou um nightly 5.0?

Para um bot novo, um nightly 5.0: a equipe do DSharpPlus diz isso no README, e a documentação e o suporte cobrem apenas a 5.0. Um bot 4.5 existente continua rodando nos nossos planos como está, com Runtime na versão do .NET que o projeto dele usa como alvo; passar para a 5.0 significa mudar código, porque a 5.0 cria o cliente com DiscordClientBuilder em vez de new DiscordClient(new DiscordConfiguration { ... }), e seus comandos vêm de DSharpPlus.Commands em vez dos pacotes de comandos antigos.

A compilação falha com NETSDK1045. E agora?

Seu projeto tem como alvo um .NET mais novo que o Runtime que você escolheu. Um nightly 5.0 precisa de net10.0 e .NET 10: defina isso no painel Código, clique em Salvar e inicie o bot de novo.

Por que cada início demora mais do que o bot precisa?

Porque o servidor executa dotnet publish antes de cada início, então uma alteração que você envia é sempre compilada. No nosso teste, isso deixou o início em 1,9 segundo contra 0,5 segundo do programa sozinho. Para pular a compilação, publique no seu computador e envie os arquivos da pasta publish em vez do projeto.

DSharpPlus ou Discord.Net na PlayNHost?

Os dois rodam no mesmo tipo de bot .NET. A tabela acima traz a memória que medimos para cada um. O Discord.Net tem versões estáveis (3.20.2 de 8 out 2026) que compilam no .NET 8, o runtime recomendado; o DSharpPlus pede que você acompanhe os nightly no .NET 10. Escolha a API de que você mais gosta. Passos para o Discord.Net: Como hospedar um bot do Discord em C# (.NET).

Pronto para manter seu bot DSharpPlus no ar o dia todo? Veja os planos da hospedagem de bots Discord.

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

NOSSOS ÚLTIMOS ARTIGOS