NOWOŚĆ 📢 Black Friday: nasza oferta na start kończy się 30 listopada. Do 70% zniżki na pierwszy miesiąc, na każdą grę!Zobacz plany
Black FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 minBlack FridayDo 70% zniżki na pierwszy miesiąc, do 30 listopadaKoniec za 9 dni 02 godz. 49 min

Jak hostować bota DSharpPlus 24/7

Hosting botów DiscordZaktualizowano 6 lis 202612 min czytania

Żeby hostować bota DSharpPlus 24/7, uruchamiasz go na maszynie, która stale działa: na VPS z Linuksem z usługą systemd, która uruchamia go ponownie, gdy się zatrzyma, albo w planie botów w hostingu botów Discord PlayNHost (od 1,99 USD miesięcznie), gdzie przesyłasz swój projekt w C#, wybierasz .NET 10, wklejasz token i klikasz Start. W naszym teście bot z DSharpPlus 5.0.0-nightly-02614 zużył około 69 MB pamięci na .NET 10. README DSharpPlus każe używać jego wersji nightly, a dokumentacja podaje .NET 10 jako jedyny .NET dla nightly 5.0, więc ta strona używa jednej z nich. Kroki w PlayNHost:

  1. Na stronie hostingu botów Discord kliknij Utwórz serwer przy wybranym planie. W oknie zamówienia odpowiedz na Na jaką platformę jest Twój bot? wyborem Discord i wybierz C# (.NET).
  2. Otwórz swój serwer w panelu. Karta Skonfiguruj swojego bota w sekcji Przegląd otwiera się na kroku Połącz z Discord. Jej pierwszy krok, Co działa, powinien pokazywać Ten bot uruchamia .NET Bot.; kliknij ten krok, aby to sprawdzić, a potem Dalej.
  3. W kroku Połącz z Discord wklej token w polu Wklej token swojego bota, kliknij Połącz, a potem Tak, dalej.
  4. W kroku Uprawnienia zaznacz Mój kod tego używa tylko dla uprzywilejowanych intentów, o które prosi twój kod (bot poniżej żadnego nie potrzebuje), kliknij Dodaj na serwer Discord, a potem Dalej.
  5. W kroku Twój kod kliknij Prześlij pliki i prześlij Bot.csproj oraz Program.cs do głównego folderu, bez folderów bin i obj, albo kliknij Połącz Git.
  6. Na stronie Bot, w panelu Kod, wybierz .NET 10 w polu Runtime (zapisuje się od razu po wyborze) i zostaw Plik startowy pusty.
  7. Kliknij Uruchom bota i obserwuj Console. Serwer najpierw buduje twój projekt, potem bot wypisuje Logged in as ..., a karta pokazuje Twój bot jest online na Discordzie.

Jak utworzyć bota i jego token, wyjaśnia Jak stworzyć bota Discord i zdobyć jego token, a typ bota .NET w ogólności (oba sposoby przesyłania, błędy budowania) opisuje Jak hostować bota Discord w C# (.NET). Ta strona dotyczy samego DSharpPlus: jakiej wersji użyć, czego potrzebuje na serwerze i co warto wiedzieć, zanim go zahostujesz.

Co zmierzyliśmy

BibliotekaWersjaPamięć bez obciążeniaOd startu do odpowiedzi Discorda, z budowaniemOd uruchomienia programu do odpowiedzi Discorda
DSharpPlus5.0.0-nightly-0261469 MB1,9 s0,5 s
Discord.Net3.20.276 MB1,6 s0,5 s
.NET 8 samo, bez bibliotekibrak24 MB1,3 s (budowanie i start, bez wywołania)brak

Jak: na naszym własnym węźle, w jednorazowym kontenerze skonfigurowanym jak plan botów z 1 GB (DSharpPlus na obrazie .NET 10, Discord.Net i wiersz bez biblioteki na obrazie .NET 8, oraz polecenie startowe naszego typu bota .NET, które przy każdym starcie wykonuje dotnet publish), każdy bot próbował zalogować się fałszywym tokenem, który Discord odrzucił; pamięć to pamięć rezydentna 15 sekund po tej odpowiedzi, pierwsza kolumna czasu biegnie od początku budowania do odpowiedzi, druga od uruchomienia programu, a każda wartość to mediana przebiegów od 2 do 4. Zmierzony bot DSharpPlus tylko się logował, z samym DSharpPlus (bez DSharpPlus.Commands); jego pierwsze budowanie, które pobrało też DSharpPlus, trwało 7 sekund.

To są wartości minimalne: żadnych serwerów, żadnych członków w pamięci podręcznej, jeszcze bez otwartej sesji gateway. Dochodzą do nich twój kod, pakiet poleceń i liczba serwerów, na których jest bot. Aby pominąć budowanie przy każdym starcie, możesz przesłać pliki opublikowane na własnym komputerze zamiast projektu (zobacz przewodnik po C# podlinkowany wyżej). Porównaj te liczby z planami w hostingu botów Discord i wybierz według tego, co robi twój bot.

Minimalny bot DSharpPlus

Rejestruje polecenie ukośnikowe /ping, odpowiada na nie Pong!, czyta token z DISCORD_TOKEN (taką nazwę nadaje mu panel) i wypisuje linię gotowości. Nie potrzebuje uprzywilejowanych intentów. Dwa pliki w głównym folderze:

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!");
}

Przy każdym starcie serwer wykonuje dotnet publish dla Bot.csproj i uruchamia Bot.dll. Konsola pokazuje [PlayNHost] Building your bot (the first build downloads packages and can take a minute), potem [PlayNHost] Starting your bot, potem własne linie logu DSharpPlus i Logged in as ..., czyli linię, która przełącza znacznik w sekcji Przegląd na Online na Discordzie. Zaproś bota przez Dodaj na serwer Discord, zanim wypróbujesz /ping: Jak zaprosić bota Discord na serwer.

Gdy token jest błędny

W naszym teście, z fałszywym tokenem, ConnectAsync() w DSharpPlus zakończyło się tym błędem:

UnauthorizedException: Unauthorized: Unauthorized

Wcześniej DSharpPlus zapisuje ostrzeżenie: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. Bot powyżej przechwytuje ten UnauthorizedException i zamiast tego wypisuje Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., po czym kończy działanie z kodem wyjścia 1. Aby to naprawić, otwórz Discord Developer Portal, swoją aplikację, Bot, i kliknij Reset Token; Discord pokazuje nowy token tylko raz. Na naszej stronie Bot, w panelu Discord, kliknij Zastąp token, wklej go, kliknij Zapisz token, a potem Zrestartuj teraz. Gdy Discord odrzuci sprawdzenie zapisanego tokena, panel pokazuje Discord go nie przyjął.

Co warto wiedzieć o DSharpPlus na serwerze

  • Jaka wersja: w NuGet najnowsza stabilna wersja DSharpPlus to 4.5.3 (24 sierpnia 2026), a nightly 5.0 są wymienione jako wersje wstępne (najnowsza, 5.0.0-nightly-02614, z 1 listopada 2026). README mówi, że co do zasady należy używać nightly, dokumentacja obejmuje tylko je, a według dokumentacji dla 4.5 nie ma wsparcia. W NuGet istnieje też pakiet z numerem po prostu 5.0.0, ale jest niewymieniony na liście, pochodzi z maja 2023 i nie ma API z tej strony: nie pisz Version="5.0.0".
  • .NET 10 dla nightly: 5.0.0-nightly-02614 jest zbudowany tylko dla .NET 10, a dokumentacja DSharpPlus podaje .NET 10 jako jedyny .NET dla nightly 5.0, więc ustaw net10.0 w projekcie i .NET 10 jako Runtime. Gdy wybrane jest .NET 8 (recommended), budowanie kończy się błędem NETSDK1045. DSharpPlus 4.5.3 celuje w .NET Standard 2.0, a dokumentacja podaje .NET od 8 do 10 jako obsługiwane dla 4.5; ma starsze API (new DiscordClient(new DiscordConfiguration { ... })).
  • Przypnij nightly, bez symboli wieloznacznych. Wpisz dokładny numer nightly, jak wyżej. Według udokumentowanych zasad NuGet wersja zmienna wybiera najwyższe dopasowanie, w tym wersje stabilne, i ignoruje to, czy pakiet jest na liście, więc 5.0.0-nightly-* rozwiązałoby się do tego starego niewymienionego 5.0.0, który liczy się jako wyższy niż każdy nightly. Serwer przy każdym starcie przywraca i buduje twój projekt, więc dokładny numer chroni też przed zmianą pod twoimi rękami. Aby zaktualizować, zmień numer w Bot.csproj i zrestartuj.
  • Polecenia: framework poleceń to osobny pakiet DSharpPlus.Commands, który obsługuje polecenia ukośnikowe i tekstowe. DSharpPlus.SlashCommands jest przestarzały, a DSharpPlus.CommandsNext ma pójść w jego ślady, więc starsze poradniki, które ich używają, wymagają zmian. Trzymaj wszystkie pakiety DSharpPlus na tym samym numerze nightly.
  • Intenty: SlashCommandProcessor.RequiredIntents to tylko Guilds, który nie jest uprzywilejowany. Procesor poleceń tekstowych, domyślnie włączony, reaguje na prefiks ! i na wzmianki o bocie; na serwerach Discord wysyła botowi treść wiadomości, które go nie wspominają, tylko z uprzywilejowanym intentem Message Content. Bot powyżej wyłącza procesory domyślne i dodaje tylko ukośnikowy. Jeśli dodasz Message Content, włącz go też w Developer Portal i zaznacz dla niego Mój kod tego używa, bo inaczej Discord zamknie połączenie. Zobacz Napraw błąd „Used disallowed intents” w bocie Discord.
  • Lista poleceń Discorda podąża za twoim kodem. Przy każdym starcie, bez DebugGuildId, DSharpPlus.Commands odczytuje z Discorda globalne polecenia twojej aplikacji, tworzy nowe, edytuje zmienione i usuwa te, których twój kod już nie ma, poza punktem wejścia Activity. Polecenie usunięte z kodu znika z Discorda przy następnym starcie, tak samo jak globalne polecenie, które inny program zarejestrował dla tej samej aplikacji.
  • Logi: domyślny logger DSharpPlus zapisuje w konsoli od poziomu Information wzwyż. Gdy Discord przyjmie token, Console pokazuje jego linię startową, DSharpPlus; version ...; przy odrzuconym tokenie loguje tylko linię [Warn] powyżej. builder.SetLogLevel(...) zmienia poziom.
  • Awarie: gdy bot się kończy, jak bot powyżej przy odrzuconym tokenie, panel od razu uruchamia go ponownie, najpierw budując go jeszcze raz. Jeśli zatrzyma się znowu w ciągu minuty od tego, pozostaje zatrzymany, a Console podaje powód.

Hostowanie samodzielnie na VPS z Linuksem

Na VPS zbuduj bota na własnym komputerze i uruchamiaj na serwerze tylko wynik. Opublikuj go za pomocą .NET 10 SDK:

dotnet publish Bot.csproj -c Release -o publish

W Ubuntu 24.04 środowisko uruchomieniowe .NET 10 jest we własnych pakietach Ubuntu:

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

Utwórz użytkownika dla bota i skopiuj folder publish na serwer (na przykład za pomocą scp -r), a potem do jego folderu:

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

Trzymaj token poza kodem, w pliku, który może czytać tylko root:

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

Utwórz /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

Uruchom go teraz i przy każdym starcie systemu, a potem śledź jego wyjście:

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

Restart=always uruchamia bota ponownie 5 sekund po tym, jak się zakończy lub ulegnie awarii, ale nie po zatrzymaniu go przez systemctl stop. Aby zaktualizować, opublikuj ponownie, skopiuj nowe pliki na stare i wykonaj sudo systemctl restart mybot. W Debianie .NET nie ma we własnych pakietach dystrybucji; obejmują to instrukcje instalacji Microsoftu.

Samodzielny hosting czy plan botów

Na VPS, którym zarządzasz sam, odpowiadasz za:

  • Aktualizacje i bezpieczeństwo systemu operacyjnego oraz aktualizacje środowiska .NET.
  • Publikowanie i kopiowanie każdego nowego builda, plik usługi, plik z tokenem i jego uprawnienia.
  • Czytanie journalctl, aby dowiedzieć się, dlaczego bot się zatrzymał.
  • Kopie zapasowe wszystkiego, co zapisuje twój bot.

W zamian VPS uruchamia wszystko, co na nim zainstalujesz, a nic się tam nie buduje.

W planie botów PlayNHost robi to za ciebie panel:

  • .NET 6, 8, 9 lub 10 z listy wyboru oraz budowanie: przesyłasz projekt i klikasz Start.
  • Token, sprawdzony w Discordzie przed zapisaniem, przechowywany w postaci zaszyfrowanej i przekazywany twojemu kodowi jako DISCORD_TOKEN.
  • Link z zaproszeniem z wybranymi przez ciebie uprawnieniami oraz karta Uprzywilejowane intenty, która sprawdza, które są włączone w twoim Developer Portal.
  • Ponowne uruchomienie bota po awarii oraz baner nad Console, gdy botowi zabraknie pamięci.
  • Przesyłanie plików, wdrożenia z Gita i kopie zapasowe z panelu.

Częste pytania

Czy użyć DSharpPlus 4.5.3, czy nightly 5.0?

Dla nowego bota nightly 5.0: mówi tak zespół DSharpPlus w README, a jego dokumentacja i wsparcie obejmują tylko 5.0. Istniejący bot 4.5 nadal działa w naszych planach tak, jak jest, z Runtime ustawionym na wersję .NET, na którą celuje jego projekt; przejście na 5.0 oznacza zmianę kodu, bo 5.0 tworzy klienta przez DiscordClientBuilder zamiast new DiscordClient(new DiscordConfiguration { ... }), a jego polecenia pochodzą z DSharpPlus.Commands zamiast ze starych pakietów poleceń.

Budowanie kończy się błędem NETSDK1045. Co teraz?

Twój projekt celuje w nowszy .NET niż wybrany Runtime. Nightly 5.0 wymaga net10.0 i .NET 10: ustaw to w panelu Kod, kliknij Zapisz i uruchom bota ponownie.

Dlaczego każdy start trwa dłużej, niż potrzebuje sam bot?

Bo serwer wykonuje dotnet publish przed każdym startem, więc przesłana zmiana jest zawsze budowana. W naszym teście start trwał przez to 1,9 sekundy wobec 0,5 sekundy dla samego programu. Aby pominąć budowanie, opublikuj na komputerze i prześlij pliki z folderu publish zamiast projektu.

DSharpPlus czy Discord.Net w PlayNHost?

Oba działają na tym samym typie bota .NET. Tabela powyżej zawiera pamięć, którą zmierzyliśmy dla każdego z nich. Discord.Net ma stabilne wydania (3.20.2 z 8 października 2026), które budują się na .NET 8, zalecanym środowisku; DSharpPlus każe śledzić jego nightly na .NET 10. Wybierz API, które wolisz. Kroki dla Discord.Net: Jak hostować bota Discord w C# (.NET).

Gotowy, by twój bot DSharpPlus działał całą dobę? Zobacz plany w hostingu botów Discord.

Twój bot działa już gdzie indziej? Przenieś go do nas

NASZE OSTATNIE WPISY