لاستضافة بوت DSharpPlus على مدار الساعة 24/7 تشغّله على جهاز يبقى قيد التشغيل دائمًا: إما VPS لينكس مع خدمة systemd تعيد تشغيله عندما يتوقف، أو خطة بوت على استضافة بوتات Discord من PlayNHost (ابتداءً من US$1.99 شهريًا)، حيث ترفع مشروع C# الخاص بك وتختار .NET 10 وتلصق التوكن وتضغط Start. في اختبارنا استخدم بوت يعمل بـ DSharpPlus 5.0.0-nightly-02614 نحو 69 MB من الذاكرة على .NET 10. يوصي ملف README الخاص بـ DSharpPlus باستخدام إصدارات nightly، وتذكر وثائقه أن .NET 10 هو .NET الوحيد لإصدارات nightly 5.0، ولذلك تستخدم هذه الصفحة واحدًا منها. الخطوات على PlayNHost:
- في صفحة استضافة بوتات Discord اضغط أنشئ سيرفرًا على إحدى الخطط. في نافذة الطلب أجب عن لأي منصة بوتك؟ باختيار Discord واختر C# (.NET).
- افتح خادمك في اللوحة. تفتح بطاقة إعداد بوتك في نظرة عامة عند الخطوة الاتصال بـ Discord. ينبغي أن تقول خطوتها الأولى ما الذي يعمل العبارة يشغّل هذا البوت .NET Bot.؛ انقر هذه الخطوة للتحقق منها ثم انقر متابعة.
- في الاتصال بـ Discord الصق التوكن في الصق رمز بوتك، ثم اضغط اتصال، ثم نعم، متابعة.
- في الأذونات ضع علامة على كودي يستخدم هذا فقط للـ intents المميزة التي يطلبها كودك (البوت أدناه لا يحتاج إلى أي منها)، ثم اضغط إضافة إلى خادم 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 MB | 1.9 ث | 0.5 ث |
| Discord.Net | 3.20.2 | 76 MB | 1.6 ث | 0.5 ث |
| .NET 8 وحده، دون مكتبة | لا يوجد | 24 MB | 1.3 ث (بناء وبدء، دون استدعاء) | لا يوجد |
الطريقة: على عقدتنا الخاصة، وفي حاوية مؤقتة مضبوطة مثل خطة بوت بسعة 1 GB (DSharpPlus على صورة .NET 10، وDiscord.Net والصف دون مكتبة على صورة .NET 8، مع أمر البدء الخاص بنوع بوت .NET لدينا الذي ينفّذ dotnet publish عند كل بدء)، حاول كل بوت تسجيل الدخول بتوكن مزيف رفضه Discord؛ والذاكرة هي الذاكرة المقيمة بعد 15 ثانية من ذلك الرد، ويمتد عمود الوقت الأول من بداية البناء حتى الرد، والثاني من تشغيل البرنامج، وكل رقم هو وسيط التشغيلات من 2 إلى 4. بوت DSharpPlus الذي قسناه سجّل الدخول فقط، مع DSharpPlus وحده (دون DSharpPlus.Commands)؛ واستغرق أول بناء له، الذي نزّل DSharpPlus أيضًا، 7 ثوانٍ.
هذه حدود دنيا: لا سيرفرات ولا أعضاء مخزنون مؤقتًا ولا جلسة gateway مفتوحة بعد. يضاف إليها كودك الخاص وحزمة الأوامر وعدد السيرفرات التي يوجد فيها بوتك. لتجنب البناء عند كل بدء يمكنك رفع الملفات التي نشرتها على حاسوبك بدلًا من المشروع (راجع دليل C# المرتبط أعلاه). قارن الأرقام بالخطط في استضافة بوتات Discord واختر بحسب ما يفعله بوتك.
بوت DSharpPlus بسيط جدًا
يسجّل أمر شرطة مائلة /ping، ويرد عليه بـ Pong!، ويقرأ التوكن من DISCORD_TOKEN (الاسم الذي تعطيه اللوحة له) ويطبع سطر الجاهزية. لا يحتاج إلى أي intent مميز. ملفان في المجلد الرئيسي:
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 ولا تملك الواجهة البرمجية المعروضة في هذه الصفحة: لا تكتب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، وتذكر الوثائق أن .NET 8 إلى 10 مدعومة للإصدار 4.5؛ ولديه الواجهة الأقدم (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 نفسه. - Intents:
SlashCommandProcessor.RequiredIntentsهوGuildsفقط، وهو غير مميز. يستجيب معالج الأوامر النصية، المفعّل افتراضيًا، للبادئة!ولذكر البوت؛ وفي السيرفرات لا يرسل Discord إلى البوت نص الرسائل التي لا تذكره إلا مع intent المحتوى المميز 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 السبب.
استضفه بنفسك على 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. - رابط دعوة بالأذونات التي تختارها، وبطاقة الأذونات المميزة (Privileged intents) تفحص أيها مفعّل في 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. اختر الواجهة البرمجية التي تفضلها. خطوات Discord.Net: كيف تستضيف بوت Discord بلغة C# (.NET).
هل أنت مستعد لتشغيل بوت DSharpPlus على مدار الساعة؟ اطّلع على الخطط في استضافة بوتات Discord.



