Чтобы запустить бота DSharpPlus 24/7, его нужно держать на машине, которая всегда включена: на Linux VPS со службой systemd, которая снова запускает его после остановки, или на тарифе для ботов в хостинге Discord-ботов PlayNHost (от US$1.99 в месяц), где вы загружаете проект на C#, выбираете .NET 10, вставляете токен и нажимаете Start. В нашем тесте бот на DSharpPlus 5.0.0-nightly-02614 занял около 69 МБ памяти на .NET 10. README самого DSharpPlus советует использовать его nightly-сборки, а в документации .NET 10 указан как единственный .NET для nightly 5.0, поэтому на этой странице используется одна из них. Шаги в PlayNHost:
- На странице хостинга Discord-ботов нажмите Создать сервер у нужного тарифа. В окне заказа ответьте на Для какой платформы ваш бот? выбором Discord и выберите C# (.NET).
- Откройте свой сервер в панели. Карточка Настройка бота в разделе Обзор открывается на шаге Подключение к Discord. Первый шаг, Что запускается, должен показывать Этот бот запускает .NET Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
- На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключить, затем Да, продолжить.
- На шаге Разрешения отметьте Мой код это использует только для привилегированных интентов, которые запрашивает ваш код (боту ниже они не нужны), нажмите Добавить на сервер Discord, затем Продолжить.
- На шаге Ваш код нажмите Загрузить файлы и загрузите
Bot.csprojиProgram.csв основную папку, без папокbinиobj, или нажмите Подключить Git. - На странице Бот, в панели Код, выберите .NET 10 в поле Среда выполнения (она сохраняется сразу после выбора) и оставьте Файл запуска пустым.
- Нажмите Запустить бота и следите за Console. Сначала сервер собирает проект, затем бот выводит
Logged in as ..., а карточка показывает Ваш бот онлайн в Discord.
О том, как создать бота и получить его токен, рассказано в Как создать Discord-бота и получить его токен, а о типе бота .NET в целом (оба способа загрузки, ошибки сборки) в Как запустить Discord-бота на C# (.NET). Эта страница посвящена самому DSharpPlus: какую версию взять, что ему нужно на сервере и что стоит знать перед запуском.
Что мы измерили
| Библиотека | Версия | Память без нагрузки | От старта до ответа Discord, со сборкой | От запуска программы до ответа Discord |
|---|---|---|---|---|
| DSharpPlus | 5.0.0-nightly-02614 | 69 МБ | 1,9 с | 0,5 с |
| Discord.Net | 3.20.2 | 76 МБ | 1,6 с | 0,5 с |
| Один .NET 8, без библиотеки | нет | 24 МБ | 1,3 с (сборка и запуск, без вызова) | нет |
Как мы измеряли: на нашем собственном узле, в одноразовом контейнере, настроенном как тариф для ботов с 1 ГБ (DSharpPlus на образе .NET 10, Discord.Net и строка без библиотеки на образе .NET 8, плюс команда запуска нашего типа бота .NET, которая при каждом старте выполняет dotnet publish), каждый бот пытался войти с поддельным токеном, который Discord отклонил; память это резидентная память через 15 секунд после этого ответа, первый столбец времени идёт от начала сборки до ответа, второй от запуска программы, а каждое значение это медиана запусков со 2 по 4. Замеренный бот DSharpPlus только входил в систему, с одним DSharpPlus (без DSharpPlus.Commands); его первая сборка, которая заодно скачала DSharpPlus, заняла 7 секунд.
Это нижние границы: ещё нет серверов, нет кешированных участников, нет открытой сессии шлюза. К ним добавятся ваш собственный код, пакет команд и число серверов, на которых находится бот. Чтобы не собирать проект при каждом старте, можно загрузить файлы, опубликованные на вашем компьютере, вместо проекта (см. руководство по C# по ссылке выше). Сравните эти цифры с тарифами хостинга Discord-ботов и выбирайте по тому, что делает ваш бот.
Минимальный бот на DSharpPlus
Он регистрирует слеш-команду /ping, отвечает на неё Pong!, читает токен из DISCORD_TOKEN (так его называет панель) и выводит строку готовности. Привилегированные интенты ему не нужны. Два файла в основной папке:
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!");
}
При каждом старте сервер выполняет dotnet publish для Bot.csproj и запускает Bot.dll. В консоли появляется [PlayNHost] Building your bot (the first build downloads packages and can take a minute), затем [PlayNHost] Starting your bot, затем собственные строки лога DSharpPlus и Logged in as ..., строка, которая переключает метку в разделе Обзор на Онлайн в Discord. Пригласите бота через Добавить на сервер Discord, прежде чем пробовать /ping: Как пригласить Discord-бота на сервер.
Если токен неверный
В нашем тесте с поддельным токеном ConnectAsync() в DSharpPlus завершился такой ошибкой:
UnauthorizedException: Unauthorized: Unauthorized
Перед этим DSharpPlus пишет предупреждение: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. Бот выше перехватывает это UnauthorizedException и выводит вместо него Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart., после чего завершается с кодом выхода 1. Чтобы это исправить, откройте Discord Developer Portal, своё приложение, Bot и нажмите Reset Token; Discord показывает новый токен один раз. На нашей странице Бот, в панели Discord, нажмите Заменить токен, вставьте его, нажмите Сохранить токен, затем Перезапустить сейчас. Если Discord отклоняет проверку сохранённого токена, в панели появляется Discord его не принял.
Что нужно знать о DSharpPlus на сервере
- Какая версия: в NuGet последняя стабильная версия DSharpPlus это 4.5.3 (24 авг 2026), а nightly 5.0 отмечены как предварительные (самая новая, 5.0.0-nightly-02614, от 1 ноя 2026). В README сказано, что, как правило, нужно использовать nightly, документация описывает только их, а по документации для 4.5 поддержка не оказывается. В NuGet есть и пакет с обычным номером
5.0.0, но он скрыт из списка, датируется маем 2023 года и не имеет API, показанного на этой странице: не пишитеVersion="5.0.0". - .NET 10 для nightly: 5.0.0-nightly-02614 собран только для .NET 10, а в документации DSharpPlus .NET 10 указан как единственный .NET для nightly 5.0, поэтому задайте
net10.0в проекте и .NET 10 в поле Среда выполнения. Если выбран .NET 8 (recommended), сборка останавливается с ошибкойNETSDK1045. DSharpPlus 4.5.3 нацелен на .NET Standard 2.0, а в документации для 4.5 поддерживаемыми указаны .NET с 8 по 10; в нём более старый API (new DiscordClient(new DiscordConfiguration { ... })). - Закрепите nightly, без подстановочных знаков. Укажите точный номер nightly, как выше. По документированным правилам NuGet плавающая версия берёт наибольшее совпадение, включая стабильные версии, и не смотрит, есть ли пакет в списке, поэтому
5.0.0-nightly-*разрешилось бы в тот старый скрытый5.0.0, который считается выше любого nightly. Сервер восстанавливает и собирает проект при каждом старте, так что точный номер ещё и не даёт ему измениться без вашего ведома. Чтобы обновиться, смените номер вBot.csprojи перезапустите. - Команды: фреймворк команд это отдельный пакет
DSharpPlus.Commands, который обрабатывает слеш-команды и текстовые.DSharpPlus.SlashCommandsустарел, аDSharpPlus.CommandsNextтоже будет объявлен устаревшим, поэтому старые руководства, где они используются, требуют правок. Держите все пакеты DSharpPlus на одном номере nightly. - Интенты:
SlashCommandProcessor.RequiredIntentsэто толькоGuilds, а он не привилегированный. Обработчик текстовых команд, включённый по умолчанию, реагирует на префикс!и на упоминания бота; на серверах Discord присылает боту текст сообщений, которые его не упоминают, только при привилегированном интенте Message Content. Бот выше отключает обработчики по умолчанию и добавляет только слеш-обработчик. Если вы добавите Message Content, включите его и в Developer Portal, и отметьте для него Мой код это использует, иначе Discord закроет соединение. См. Как исправить «Used disallowed intents» у вашего Discord-бота. - Список команд Discord следует за вашим кодом. При каждом старте, без
DebugGuildId, DSharpPlus.Commands читает из Discord глобальные команды вашего приложения, создаёт новые, изменяет изменённые и удаляет те, которых в вашем коде больше нет, кроме точки входа Activity. Команда, удалённая из кода, исчезает из Discord при следующем старте, так же как и глобальная команда, которую другая программа зарегистрировала для того же приложения. - Логи: стандартный логгер DSharpPlus пишет в консоль начиная с уровня Information. Когда Discord принимает токен, Console показывает его стартовую строку,
DSharpPlus; version ...; при отклонённом токене он пишет только строку[Warn]выше.builder.SetLogLevel(...)меняет уровень. - Сбои: когда бот завершается, как бот выше при отклонённом токене, панель сразу запускает его снова, предварительно пересобрав. Если он остановится опять в течение минуты после этого, он останется остановленным, а Console покажет причину.
Запуск самостоятельно на Linux VPS
На VPS соберите бота на своём компьютере и запускайте на сервере только результат. Опубликуйте его с помощью .NET 10 SDK:
dotnet publish Bot.csproj -c Release -o publish
В Ubuntu 24.04 среда выполнения .NET 10 есть в собственных пакетах Ubuntu:
sudo apt update
sudo apt install dotnet-runtime-10.0
dotnet --list-runtimes
Создайте пользователя для бота и скопируйте папку publish на сервер (например, с помощью scp -r), затем в его папку:
sudo useradd --system --create-home --home-dir /opt/mybot mybot
sudo cp -r publish/. /opt/mybot/
sudo chown -R mybot: /opt/mybot
Храните токен вне кода, в файле, который может читать только root:
sudo sh -c 'echo "DISCORD_TOKEN=your-token" > /etc/mybot.env'
sudo chmod 600 /etc/mybot.env
Создайте /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
Запустите его сейчас и при каждой загрузке, затем следите за выводом:
sudo systemctl daemon-reload
sudo systemctl enable --now mybot
sudo journalctl -u mybot -f
Restart=always запускает бота снова через 5 секунд после его завершения или сбоя, но не после того, как вы остановили его через systemctl stop. Чтобы обновить, опубликуйте снова, скопируйте новые файлы поверх старых и выполните sudo systemctl restart mybot. В Debian .NET нет в собственных пакетах дистрибутива; это описано в инструкции по установке от Microsoft.
Свой сервер или тариф для ботов
На VPS, которым вы управляете сами, на вас лежит:
- Обновление и защита операционной системы, обновление среды выполнения .NET.
- Публикация и копирование каждой новой сборки, файл службы, файл токена и его права.
- Чтение
journalctl, чтобы выяснить, почему бот остановился. - Резервные копии всего, что хранит ваш бот.
Взамен VPS запускает всё, что вы на него установите, и там ничего не собирается.
На тарифе для ботов PlayNHost панель делает это за вас:
- .NET 6, 8, 9 или 10 из списка выбора и сборка: загрузите проект и нажмите Start.
- Токен, который проверяется в Discord до сохранения, хранится в зашифрованном виде и передаётся вашему коду как
DISCORD_TOKEN. - Ссылка-приглашение с выбранными вами разрешениями и карточка Привилегированные интенты, которая проверяет, какие из них включены в вашем Developer Portal.
- Повторный запуск бота после сбоя и баннер над Console, когда боту не хватает памяти.
- Загрузка файлов, деплой из Git и резервные копии из панели.
Частые вопросы
Что взять: DSharpPlus 4.5.3 или nightly 5.0?
Для нового бота nightly 5.0: так говорит команда DSharpPlus в README, а её документация и поддержка относятся только к 5.0. Существующий бот на 4.5 по-прежнему работает на наших тарифах как есть, с полем Среда выполнения, равным версии .NET, на которую нацелен его проект; переход на 5.0 означает правку кода, потому что 5.0 создаёт клиент через DiscordClientBuilder вместо new DiscordClient(new DiscordConfiguration { ... }), а его команды берутся из DSharpPlus.Commands, а не из старых пакетов команд.
Сборка падает с ошибкой NETSDK1045. Что делать?
Ваш проект нацелен на более новый .NET, чем выбранная Среда выполнения. Для nightly 5.0 нужны net10.0 и .NET 10: задайте это в панели Код, нажмите Сохранить и снова запустите бота.
Почему каждый старт длится дольше, чем нужно самому боту?
Потому что сервер выполняет dotnet publish перед каждым стартом, так что загруженное вами изменение всегда собирается. В нашем тесте из-за этого старт занял 1,9 секунды против 0,5 секунды у одной программы. Чтобы пропустить сборку, опубликуйте проект на компьютере и загрузите файлы из папки publish вместо проекта.
DSharpPlus или Discord.Net в PlayNHost?
Оба работают на одном и том же типе бота .NET. В таблице выше указана память, которую мы замерили для каждого. У Discord.Net есть стабильные релизы (3.20.2 от 8 окт 2026), которые собираются на .NET 8, рекомендуемой среде выполнения; DSharpPlus просит следовать его nightly на .NET 10. Выбирайте API, который вам больше нравится. Шаги для Discord.Net: Как запустить Discord-бота на C# (.NET).
Готовы запустить своего бота на DSharpPlus круглосуточно? Посмотрите тарифы хостинга Discord-ботов.



