НОВОЕ 📢 Чёрная пятница: стартовая акция заканчивается 30 ноября. Скидка до 70% на первый месяц!Посмотреть тарифы
Чёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 минЧёрная пятницаСкидка до 70% на первый месяц, акция по 30 ноябряДо конца 9 дн. 02 ч 49 мин

Как запустить бота DSharpPlus 24/7

Хостинг Discord-ботовОбновлено 6 нояб. 2026 г.12 мин чтения

Чтобы запустить бота 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:

  1. На странице хостинга Discord-ботов нажмите Создать сервер у нужного тарифа. В окне заказа ответьте на Для какой платформы ваш бот? выбором Discord и выберите C# (.NET).
  2. Откройте свой сервер в панели. Карточка Настройка бота в разделе Обзор открывается на шаге Подключение к Discord. Первый шаг, Что запускается, должен показывать Этот бот запускает .NET Bot.; нажмите на этот шаг, чтобы проверить, затем Продолжить.
  3. На шаге Подключение к Discord вставьте токен в поле Вставьте токен бота, нажмите Подключить, затем Да, продолжить.
  4. На шаге Разрешения отметьте Мой код это использует только для привилегированных интентов, которые запрашивает ваш код (боту ниже они не нужны), нажмите Добавить на сервер Discord, затем Продолжить.
  5. На шаге Ваш код нажмите Загрузить файлы и загрузите Bot.csproj и Program.cs в основную папку, без папок bin и obj, или нажмите Подключить Git.
  6. На странице Бот, в панели Код, выберите .NET 10 в поле Среда выполнения (она сохраняется сразу после выбора) и оставьте Файл запуска пустым.
  7. Нажмите Запустить бота и следите за Console. Сначала сервер собирает проект, затем бот выводит Logged in as ..., а карточка показывает Ваш бот онлайн в Discord.

О том, как создать бота и получить его токен, рассказано в Как создать Discord-бота и получить его токен, а о типе бота .NET в целом (оба способа загрузки, ошибки сборки) в Как запустить Discord-бота на C# (.NET). Эта страница посвящена самому DSharpPlus: какую версию взять, что ему нужно на сервере и что стоит знать перед запуском.

Что мы измерили

БиблиотекаВерсияПамять без нагрузкиОт старта до ответа Discord, со сборкойОт запуска программы до ответа Discord
DSharpPlus5.0.0-nightly-0261469 МБ1,9 с0,5 с
Discord.Net3.20.276 МБ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-ботов.

Ваш бот уже у другого хостинга? Перенесите его к нам

ПОСЛЕДНИЕ БЛОГИ