YENİ 📢 Black Friday: Lansman teklifimiz 30 Kasım'da sona eriyor. Tüm oyunlarda ilk aya %70'e varan indirim!Paketleri görün
Black Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dkBlack Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dkBlack Fridayİlk aya %70'e varan indirim, 30 Kasım'a kadarBitimine 9 gün 02 sa 49 dk

DSharpPlus botu 24/7 nasıl barındırılır

Discord botlarıGüncellendi 6 Kas 202611 dk okuma

Bir DSharpPlus botunu 24/7 barındırmak için onu hep açık kalan bir makinede çalıştırırsınız: durduğunda yeniden başlatan bir systemd hizmetine sahip bir Linux VPS'te ya da PlayNHost Discord bot barındırma hizmetinde bir bot planında (ayda 1,99 US$'dan başlayan fiyatlarla). Burada C# projenizi yükler, .NET 10'u seçer, token'ı yapıştırır ve Start'a basarsınız. Testimizde DSharpPlus 5.0.0-nightly-02614 ile çalışan bir bot, .NET 10 üzerinde yaklaşık 69 MB bellek kullandı. DSharpPlus'ın kendi README dosyası nightly sürümlerini kullanmanızı söyler ve belgeleri 5.0 nightly sürümleri için tek .NET olarak .NET 10'u listeler, bu yüzden bu sayfa bir nightly kullanır. PlayNHost'taki adımlar:

  1. Discord bot barındırma sayfasında bir planın üzerindeki Sunucu oluştur düğmesine tıklayın. Sipariş penceresinde Botunuz hangi platform için? sorusunu Discord ile yanıtlayın ve C# (.NET) seçin.
  2. Sunucunuzu panelde açın. Botunuzu kurun kartı, Genel bakış sayfasında Discord’a bağlan adımında açılır. İlk adımı olan Ne çalışır, Bu bot .NET Bot çalıştırır. demelidir; kontrol etmek için bu adıma tıklayın, ardından Devam et'e tıklayın.
  3. Discord’a bağlan adımında token'ınızı Bot token’ınızı yapıştırın alanına yapıştırın, Bağlan düğmesine, ardından Evet, devam düğmesine tıklayın.
  4. İzinler adımında, Kodum bunu kullanıyor kutusunu yalnızca kodunuzun istediği ayrıcalıklı intent'ler için işaretleyin (aşağıdaki botun hiçbirine ihtiyacı yok), Bir Discord sunucusuna ekle düğmesine, ardından Devam et düğmesine tıklayın.
  5. Kodunuz adımında Dosya yükle düğmesine tıklayın ve Bot.csproj ile Program.cs dosyalarını ana klasöre yükleyin, bin ve obj klasörleri olmadan; ya da Git’i bağla düğmesine tıklayın.
  6. Bot sayfasında Kod bölmesinde, Çalışma ortamı altında .NET 10'u seçin (seçer seçmez kaydedilir) ve Giriş dosyası alanını boş bırakın.
  7. Botu başlat düğmesine tıklayın ve Console'u izleyin. Sunucu önce projenizi derler, ardından botunuz Logged in as ... yazdırır ve kart Botunuz Discord’da çevrimiçi. der.

Botu ve token'ını oluşturmak Discord botu nasıl oluşturulur ve token’ı nasıl alınır rehberinde, genel olarak .NET bot türü (iki yükleme yolu, derleme hataları) ise C# (.NET) Discord botu nasıl barındırılır rehberinde anlatılır. Bu sayfa DSharpPlus'ın kendisiyle ilgilidir: hangi sürümü kullanmalı, bir sunucuda neye ihtiyaç duyar ve barındırmadan önce neleri bilmelisiniz.

Ne ölçtük

KütüphaneSürümYüksüz bellekBaşlangıçtan Discord'un yanıtına, derleme dahilProgramın başlatılmasından Discord'un yanıtına
DSharpPlus5.0.0-nightly-0261469 MB1,9 sn0,5 sn
Discord.Net3.20.276 MB1,6 sn0,5 sn
Yalnızca .NET 8, kütüphanesizyok24 MB1,3 sn (derleme ve başlatma, çağrı yok)yok

Nasıl: kendi düğümümüzde, 1 GB'lık bir bot planı gibi ayarlanmış tek kullanımlık bir konteynerde (DSharpPlus .NET 10 imajında, Discord.Net ve kütüphanesiz satır .NET 8 imajında, ayrıca .NET bot türümüzün her başlatmada dotnet publish çalıştıran başlatma komutuyla) her bot sahte bir token ile giriş yapmayı denedi ve Discord bunu reddetti; bellek, bu yanıttan 15 saniye sonraki resident bellektir, ilk süre sütunu derlemenin başlangıcından yanıta kadar, ikincisi programın başlatılmasından itibaren ölçülür ve her değer 2 ile 4 arasındaki çalıştırmaların medyanıdır. Ölçülen DSharpPlus botu yalnızca giriş yaptı, tek başına DSharpPlus ile (DSharpPlus.Commands olmadan); DSharpPlus'ı da indiren ilk derlemesi 7 saniye sürdü.

Bunlar alt sınırlardır: henüz sunucu yok, önbelleğe alınmış üye yok, açık bir gateway oturumu yok. Kendi kodunuz, komut paketi ve botunuzun bulunduğu sunucu sayısı bunlara eklenir. Her başlatmada derlemeyi atlamak için proje yerine kendi bilgisayarınızda yayımladığınız dosyaları yükleyebilirsiniz (yukarıda bağlantısı verilen C# rehberine bakın). Sayıları Discord bot barındırma planlarıyla karşılaştırın ve botunuzun yaptığı işe göre seçin.

Minimal bir DSharpPlus botu

Bir /ping eğik çizgi komutu kaydeder, ona Pong! ile yanıt verir, token'ı DISCORD_TOKEN içinden okur (panelin ona verdiği ad) ve bir hazır satırı yazdırır. Ayrıcalıklı intent gerektirmez. Ana klasörde iki dosya:

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

Her başlatmada sunucu dotnet publish komutunu Bot.csproj üzerinde çalıştırır ve Bot.dll dosyasını başlatır. Konsol [PlayNHost] Building your bot (the first build downloads packages and can take a minute), sonra [PlayNHost] Starting your bot, sonra DSharpPlus'ın kendi günlük satırlarını ve Logged in as ... satırını gösterir; bu satır Genel bakış sayfasındaki etiketi Discord’da çevrimiçi durumuna getirir. Botu Bir Discord sunucusuna ekle ile davet edin, sonra /ping komutunu deneyin: Discord botunuzu bir sunucuya nasıl davet edersiniz.

Token yanlışsa

Testimizde, sahte bir token ile DSharpPlus'ın ConnectAsync() çağrısı şu hatayla başarısız oldu:

UnauthorizedException: Unauthorized: Unauthorized

Bundan önce DSharpPlus bir uyarı günlüğe yazar: [DSharpPlus.Net.RestClient] [Warn] Received non-success status code Unauthorized making a request to https://discord.com/api/v10/users/@me. Yukarıdaki bot bu UnauthorizedException hatasını yakalar ve onun yerine Discord did not accept the bot token. Copy it again (Developer Portal, Bot, Reset Token), paste it on the Bot page, then restart. yazdırır, ardından 1 çıkış koduyla durur. Düzeltmek için Discord Developer Portal'ı, uygulamanızı, Bot bölümünü açın ve Reset Token düğmesine tıklayın; Discord yeni token'ı yalnızca bir kez gösterir. Bizim Bot sayfamızda, Discord bölmesinde Token’ı değiştir düğmesine tıklayın, yapıştırın, Token’ı kaydet düğmesine, ardından Şimdi yeniden başlat düğmesine tıklayın. Discord kayıtlı token'ın kontrolünü reddettiğinde bölme Discord kabul etmedi gösterir.

Bir sunucuda DSharpPlus hakkında bilinmesi gerekenler

  • Hangi sürüm: NuGet'te DSharpPlus'ın en yeni kararlı sürümü 4.5.3'tür (24 Ağu 2026) ve 5.0 nightly sürümleri ön sürüm olarak listelenir (en yenisi, 5.0.0-nightly-02614, 1 Kas 2026). README genel kural olarak nightly sürümlerini kullanmanızı söyler, belgeleri yalnızca onları kapsar ve belgeler 4.5 için destek verilmediğini belirtir. NuGet'te düz 5.0.0 numaralı bir paket de vardır, ancak listelenmemiştir, Mayıs 2023 tarihlidir ve bu sayfadaki API'ye sahip değildir: Version="5.0.0" yazmayın.
  • Nightly sürümleri için .NET 10: 5.0.0-nightly-02614 yalnızca .NET 10 için derlenmiştir ve DSharpPlus belgeleri 5.0 nightly sürümleri için tek .NET olarak .NET 10'u listeler; bu yüzden projenizde net10.0 ayarlayın ve .NET 10'u Çalışma ortamı olarak seçin. .NET 8 (recommended) seçiliyken derleme NETSDK1045 hatasıyla durur. DSharpPlus 4.5.3 .NET Standard 2.0'ı hedefler ve belgeler 4.5 için .NET 8'den 10'a kadarını desteklenen olarak listeler; eski API'ye sahiptir (new DiscordClient(new DiscordConfiguration { ... })).
  • Nightly'yi sabitleyin, joker karakter kullanmayın. Yukarıdaki gibi tam nightly numarasını yazın. NuGet'in belgelenmiş kurallarına göre kayan bir sürüm, kararlı sürümler dahil en yüksek eşleşmeyi alır ve paketin listelenip listelenmediğini yok sayar; bu yüzden 5.0.0-nightly-* eski, listelenmemiş 5.0.0 sürümüne çözülürdü ve o, her nightly'den yüksek sayılır. Sunucu projenizi her başlatmada geri yükler ve derler, dolayısıyla tam bir numara onun sizin haberiniz olmadan değişmesini de engeller. Güncellemek için Bot.csproj içindeki numarayı değiştirin ve yeniden başlatın.
  • Komutlar: komut çerçevesi, eğik çizgi ve metin komutlarını işleyen ayrı DSharpPlus.Commands paketidir. DSharpPlus.SlashCommands kullanımdan kalkmıştır ve DSharpPlus.CommandsNext da aynı yolu izleyecektir, bu yüzden bunları kullanan eski öğreticilerde değişiklik gerekir. Tüm DSharpPlus paketlerini aynı nightly numarasında tutun.
  • Intent'ler: SlashCommandProcessor.RequiredIntents yalnızca Guilds değerindedir ve bu ayrıcalıklı değildir. Varsayılan olarak açık olan metin komutu işlemcisi ! önekine ve botun anılmasına tepki verir; sunucularda Discord, bir bota onu anmayan mesajların metnini yalnızca ayrıcalıklı Message Content intent'i ile gönderir. Yukarıdaki bot varsayılan işlemcileri kapatır ve yalnızca eğik çizgi işlemcisini ekler. Message Content eklerseniz onu Developer Portal'da da açın ve onun için Kodum bunu kullanıyor kutusunu işaretleyin, yoksa Discord bağlantıyı kapatır. Bkz. Discord botunuzdaki "Used disallowed intents" hatasını düzeltin.
  • Discord'un komut listesi kodunuzu izler. Her başlatmada, DebugGuildId olmadan, DSharpPlus.Commands uygulamanızın genel komutlarını Discord'dan okur, yenileri oluşturur, değişenleri düzenler ve kodunuzda artık olmayanları siler; bir Activity giriş noktası hariç. Kodunuzdan sildiğiniz bir komut bir sonraki başlatmada Discord'dan kaybolur; aynı uygulama için başka bir programın kaydettiği genel komut da öyle.
  • Günlükler: DSharpPlus'ın varsayılan günlükçüsü konsola Information düzeyinden itibaren yazar. Discord token'ı kabul ettiğinde Console başlangıç satırını, DSharpPlus; version ..., gösterir; reddedilen bir token ile yalnızca yukarıdaki [Warn] satırını kaydeder. builder.SetLogLevel(...) düzeyi değiştirir.
  • Çökmeler: bot çıktığında, yukarıdaki botun reddedilen bir token ile yaptığı gibi, panel onu hemen yeniden başlatır ve önce yeniden derler. Bundan sonra bir dakika içinde yine durursa durmuş kalır ve Console nedenini söyler.

Bir Linux VPS'te kendiniz barındırın

Bir VPS'te botu kendi bilgisayarınızda derleyin ve sunucuda yalnızca sonucu çalıştırın. .NET 10 SDK ile yayımlayın:

dotnet publish Bot.csproj -c Release -o publish

Ubuntu 24.04'te .NET 10 çalışma zamanı Ubuntu'nun kendi paketlerinde bulunur:

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

Bot için bir kullanıcı oluşturun ve publish klasörünü sunucuya kopyalayın (örneğin scp -r ile), ardından onun klasörüne:

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

Token'ı kodunuzdan uzak tutun, yalnızca root'un okuyabileceği bir dosyada:

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

/etc/systemd/system/mybot.service dosyasını oluşturun:

[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

Onu şimdi ve her açılışta başlatın, ardından çıktısını izleyin:

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

Restart=always botu çıktıktan veya çöktükten 5 saniye sonra yeniden başlatır, ancak onu systemctl stop ile durdurduktan sonra başlatmaz. Güncellemek için yeniden yayımlayın, yeni dosyaları eskilerin üzerine kopyalayın ve sudo systemctl restart mybot çalıştırın. Debian'da .NET dağıtımın kendi paketlerinde yoktur; Microsoft'un kurulum yönergeleri bunu kapsar.

Kendi barındırmanız mı, bot planı mı

Kendinizin yönettiği bir VPS'te şunlar size aittir:

  • İşletim sistemi güncellemeleri ve güvenliği ile .NET çalışma zamanı yükseltmeleri.
  • Her yeni derlemeyi yayımlamak ve kopyalamak, hizmet dosyası, token dosyası ve izinleri.
  • Botun neden durduğunu öğrenmek için journalctl okumak.
  • Botunuzun depoladığı her şeyin yedekleri.

Karşılığında bir VPS üzerine kurduğunuz her şeyi çalıştırır ve orada hiçbir şey derlenmez.

PlayNHost bot planında bunu panel sizin için yapar:

  • Bir seçiciden .NET 6, 8, 9 veya 10 ve derleme: projeyi yükleyin ve Start'a basın.
  • Kaydedilmeden önce Discord ile doğrulanan, şifreli saklanan ve koda DISCORD_TOKEN olarak verilen token.
  • Seçtiğiniz izinlerle bir davet bağlantısı ve Developer Portal'ınızda hangilerinin açık olduğunu kontrol eden bir Ayrıcalıklı intent’ler kartı.
  • Çökmeden sonra botun yeniden başlatılması ve bot belleği tükettiğinde Console üzerinde bir uyarı.
  • Panelden yükleme, Git dağıtımları ve yedekler.

Sık sorulan sorular

DSharpPlus 4.5.3 mü yoksa 5.0 nightly mi kullanmalıyım?

Yeni bir bot için 5.0 nightly: DSharpPlus ekibi bunu README'de söyler ve belgeleri ile desteği yalnızca 5.0'ı kapsar. Mevcut bir 4.5 botu planlarımızda olduğu gibi çalışmaya devam eder; Çalışma ortamı projesinin hedeflediği .NET sürümüne ayarlanır. 5.0'a geçmek kodu değiştirmek demektir, çünkü 5.0 istemciyi DiscordClientBuilder ile oluşturur (new DiscordClient(new DiscordConfiguration { ... }) ile değil) ve komutları eski komut paketleri yerine DSharpPlus.Commands paketinden gelir.

Derleme NETSDK1045 ile başarısız oluyor. Şimdi ne yapmalı?

Projeniz, seçtiğiniz Çalışma ortamından daha yeni bir .NET'i hedefliyor. 5.0 nightly için net10.0 ve .NET 10 gerekir: bunu Kod bölmesinde ayarlayın, Kaydet düğmesine tıklayın ve botu yeniden başlatın.

Her başlatma neden botun kendisinin ihtiyacından uzun sürüyor?

Çünkü sunucu her başlatmadan önce dotnet publish çalıştırır, böylece yüklediğiniz değişiklik her zaman derlenir. Testimizde bu, başlatmayı yalnızca programın 0,5 saniyesine karşılık 1,9 saniye yaptı. Derlemeyi atlamak için kendi bilgisayarınızda yayımlayın ve proje yerine publish klasöründeki dosyaları yükleyin.

PlayNHost'ta DSharpPlus mı Discord.Net mi?

İkisi de aynı .NET bot türünde çalışır. Yukarıdaki tabloda her biri için ölçtüğümüz bellek var. Discord.Net'in, önerilen çalışma zamanı olan .NET 8'de derlenen kararlı sürümleri (3.20.2, 8 Eki 2026) vardır; DSharpPlus ise nightly sürümlerini .NET 10'da izlemenizi ister. Tercih ettiğiniz API'yi seçin. Discord.Net adımları: C# (.NET) Discord botu nasıl barındırılır.

DSharpPlus botunuzu gece gündüz çalıştırmaya hazır mısınız? Discord bot barındırma planlarına bakın.

Botun başka bir yerde mi? Bize taşı

EN YENİ BLOG YAZILARIMIZ