لاستضافة بوت disnake على مدار الساعة 24/7، شغّله على جهاز يبقى قيد التشغيل دائمًا بدلًا من حاسوبك: على VPS لينكس مع خدمة systemd إن كنت تستضيفه بنفسك، أو في خطة بوتات على استضافة بوتات Discord من PlayNHost (بدءًا من US$1.99 شهريًا)، حيث ترفع الشيفرة وتلصق الرمز وتضغط على تشغيل. في اختبارنا استخدم بوت disnake 2.12.2 نحو 47 MB من الذاكرة ووصل إلى Discord بعد نحو 0.9 ثانية من إطلاقه. يطلب disnake منك تثبيت إصداره، وهذا مهم على خادم يحدّث الحزم من تلقاء نفسه. الخطوات على PlayNHost:
- في صفحة استضافة بوتات Discord، اضغط على أنشئ سيرفرًا عند إحدى الخطط. في نافذة الطلب أجب عن السؤال لأي منصة بوتك؟ باختيار Discord، ثم اختر Python.
- افتح سيرفرك في اللوحة. تفتح بطاقة إعداد بوتك في نظرة عامة عند الخطوة الاتصال بـ Discord. يجب أن تعرض خطوتها الأولى، ما الذي يعمل، العبارة يشغّل هذا البوت Python Bot.؛ اضغط على هذه الخطوة للتحقق، ثم على متابعة.
- عند الاتصال بـ Discord، الصق الرمز في الصق رمز بوتك، واضغط على الاتصال، ثم على نعم، متابعة.
- عند الأذونات، فعّل كودي يستخدم هذا فقط للـ intents المميزة التي تطلبها شيفرتك (البوت أدناه لا يحتاج إلى أي منها)، واضغط على إضافة إلى خادم Discord، ثم على متابعة.
- عند كودك، اضغط على رفع الملفات وارفع
bot.pyمعrequirements.txtيتضمن سطرdisnakeمثبّتًا، أو اضغط على ربط Git. - إذا لم يكن ملفك الرئيسي
bot.py، فاضبط ملف البدء في صفحة بوت، في جزء الكود، واضغط على حفظ. - اضغط على تشغيل البوت وراقب Console. عندما يطبع بوتك
Logged in as ...، تعرض البطاقة بوتك متصل في Discord.
الخطوات العامة لـ Python (بيئة التشغيل والحزم وأسطر وحدة التحكم) موجودة في كيف تستضيف بوت Discord بلغة Python. تتناول هذه الصفحة ما يختلف مع disnake.
ما الذي قسناه
شغّلنا كل مكتبة Discord لـ Python على خوادمنا، بنفس إعداد Python 3.12 الذي تستخدمه خطة البوتات، وبحد ذاكرة 1 GB:
| المكتبة | الإصدار | الذاكرة في الحالة الأساسية | من البدء إلى رد Discord |
|---|---|---|---|
| disnake | 2.12.2 | 47 MB | 0.9 ث |
| discord.py | 2.7.1 | 48 MB | 1.0 ث |
| Pycord | 2.8.1 | 51 MB | 1.1 ث |
| nextcord | 3.2.0 | 47 MB | 1.0 ث |
| hikari | 2.7.0 | 61 MB | 1.3 ث |
| Python وحده | 3.12 | 9 MB |
الطريقة: أصغر برنامج يحمّل المكتبة ويسجّل الدخول برمز مزيّف، مثبّتًا بالطريقة التي تثبّت بها خوادمنا. الذاكرة هي ما كانت العملية تشغله بعد 15 ثانية من رفض Discord للرمز، ويُحسب زمن البدء من الإطلاق إلى ذلك الرد، فهو يشمل رحلة واحدة إلى Discord. كل رقم هو الوسيط لثلاث تشغيلات بعد تشغيل تسخين. وهو الحد الأدنى: البوت الذي اتصل وانضم إلى خوادم وخزّن الأعضاء مؤقتًا يستخدم أكثر، بمقدار يعتمد على البوت.
ماذا يعني هذا للخطة: يستخدم بوت disnake الأدنى جزءًا صغيرًا من خطة STARTER بسعة 0.5 GB. اختر الخطة بحسب ما يحتفظ به بوتك في الذاكرة، لا بحسب المكتبة.
بوت disnake أدنى
يردّ على /ping بأمر شرطة مائلة ويطبع سطر الجاهزية. يقرأ الرمز من DISCORD_TOKEN، وهو الاسم الذي تعطيه اللوحة لشيفرتك.
requirements.txt
disnake==2.12.*
bot.py
import os
import disnake
from disnake.ext import commands
bot = commands.InteractionBot()
@bot.event
async def on_ready():
print(f"Logged in as {bot.user}")
@bot.slash_command(description="Check that the bot answers")
async def ping(inter: disnake.ApplicationCommandInteraction):
await inter.response.send_message("Pong!")
bot.run(os.environ["DISCORD_TOKEN"])
commands.InteractionBot هو بوت disnake المخصص لأوامر التطبيقات فقط، بلا بادئة لتحديدها. يسجّل /ping لدى Discord بنفسه بعد الاتصال. السطر Logged in as هو الذي يحوّل الشارة في نظرة عامة إلى متصل في Discord.
إذا كان الرمز خاطئًا
عندما يرفض Discord الرمز، يطلق disnake هذا الخطأ (النص الذي طبعه بوت الاختبار لدينا):
LoginFailure: Improper token has been passed.
مع bot.run() ينتهي التتبع بالسطر disnake.errors.LoginFailure: Improper token has been passed. ويتوقف البوت. تقرأ اللوحة هذا السطر: تعرض الشارة مشكلة في الرمز وتقول اللافتة لم يقبل Discord رمز بوتك. احصل على رمز جديد من Discord Developer Portal: تطبيقك، بوت، Reset Token (يظهر مرة واحدة فقط). اضغط على استبدال الرمز في اللافتة، ثم على استبدال الرمز في جزء Discord، والصقه وشغّل البوت من جديد. راجع كيف تنشئ بوت Discord وتحصل على رمزه.
ما الذي يحتاج المضيف إلى معرفته عن disnake
- ثبّت الإصدار. يذكر ملف README الخاص بـ disnake أنه لا يتبع الترقيم الدلالي تمامًا، وينصح بتثبيت إصدار فرعي، مثل
disnake==2.12.*أوdisnake~=2.12.2. على خوادمنا يُحتسب هذا مرتين: ينفّذ سكربت البدءpip install -Uعلىrequirements.txtعندما يتغير، ومرة أخرى عند أول تشغيل بعد يوم من آخر تثبيت، لذا قد ينتقل سطرdisnakeغير المثبّت إلى إصدار جديد من تلقاء نفسه. مع التثبيت تحصل على الإصلاحات ضمن 2.12 وتختار أنت متى تنتقل إلى إصدار أحدث. - الاستيراد هو disnake. تثبّت
disnakeوتكتبimport disnake؛ ولا يثبّت وحدةdiscord، لذا لا يكتب فوق discord.py أو Pycord. ومع ذلك أبقِ فيrequirements.txtالمكتبة التي تستخدمها شيفرتك فقط. - إصدار Python. يتطلب disnake 2.12 إصدار Python 3.10 أو أحدث. تعرض بيئة التشغيل في جزء الكود الإصدارات من 3.10 إلى 3.14، والافتراضي 3.12، فأي اختيار يصلح.
- مزامنة الأوامر تحذف ما لا تعرّفه شيفرتك. افتراضيًا يزامن disnake الأوامر العامة وأوامر الخوادم وقد يحذف من Discord أوامر لم تعد في شيفرتك (
allow_command_deletion). أي برنامج ثانٍ سجّل الدخول بالبوت نفسه، مثل نسخة اختبار على حاسوبك، يفقد أوامره عندما تتزامن نسخة الخادم. استخدم تطبيقًا منفصلًا للاختبار. - رؤية المزامنة. مرّر
command_sync_flags=commands.CommandSyncFlags(sync_commands_debug=True)إلىInteractionBot(). عندها يطبع disnake ما يزامنه حتى لو لم يُضبط التسجيل، فتظهر الأسطر في Console. - Intents. لا تتضمن الـ intents الافتراضية أي intent مميز، ولا تحتاج أوامر الشرطة المائلة إلى أي منها. تحتاج الأوامر ذات البادئة مع
commands.Botإلىintents.message_content = Trueفي شيفرتك وإلى تفعيل Message Content Intent في Developer Portal. إذا طلبته شيفرتك وهو معطّل في Portal، يرفض Discord تسجيل الدخول. راجع إصلاح خطأ «Used disallowed intents» في بوت Discord.
استضفه بنفسك على VPS لينكس
على Debian أو Ubuntu، ثبّت Python وأنشئ مستخدمًا ومجلدًا للبوت وثبّت disnake في بيئة افتراضية:
sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/disnake-bot bot
sudo cp bot.py requirements.txt /opt/disnake-bot/
sudo chown bot: /opt/disnake-bot/bot.py /opt/disnake-bot/requirements.txt
sudo -u bot python3 -m venv /opt/disnake-bot/venv
sudo -u bot /opt/disnake-bot/venv/bin/pip install -r /opt/disnake-bot/requirements.txt
ضع الرمز في ملف لا يستطيع قراءته سوى root. أنشئ /etc/disnake-bot.env بالأمر sudo nano /etc/disnake-bot.env، واكتب سطرًا واحدًا هو DISCORD_TOKEN= متبوعًا برمزك، ثم احفظه ونفّذ sudo chmod 600 /etc/disnake-bot.env.
ثم أنشئ /etc/systemd/system/disnake-bot.service:
[Unit]
Description=disnake Discord bot
Wants=network-online.target
After=network-online.target
[Service]
User=bot
WorkingDirectory=/opt/disnake-bot
EnvironmentFile=/etc/disnake-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/disnake-bot/venv/bin/python bot.py
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
شغّله الآن وعند كل إقلاع، ثم تابع مخرجاته:
sudo systemctl daemon-reload
sudo systemctl enable --now disnake-bot
sudo journalctl -u disnake-bot -f
يجعل PYTHONUNBUFFERED=1 المخرجات من print() تصل إلى السجل فورًا بدلًا من انتظار امتلاء المخزن المؤقت. لا يتحدّث أي شيء هنا من تلقاء نفسه: للانتقال إلى disnake أحدث، غيّر الإصدار المثبّت ونفّذ سطر pip install مرة أخرى ثم sudo systemctl restart disnake-bot.
الاستضافة الذاتية أو خطة بوتات
| VPS الخاص بك | خطة بوتات PlayNHost | |
|---|---|---|
| Python | الإصدار الذي يأتي مع توزيعتك؛ تثبّته وتحدّثه بنفسك | اختر من 3.10 إلى 3.14 ضمن بيئة التشغيل |
| الحزم | تنفّذ pip install بعد كل تغيير | تُثبَّت بالأمر pip install -U عند بدء بعد تغيير requirements.txt أو إصدار Python، وعند أول بدء بعد يوم من آخر تثبيت، ضمن إصداراتك المثبّتة |
| إعادة التشغيل | وحدة systemd الخاصة بك | يُشغَّل من جديد بعد انهيار؛ ويُترك متوقفًا مع ذكر السبب إذا انهار مرة أخرى خلال دقيقة |
| الرمز | ملف تحميه بنفسك | يُخزَّن مشفّرًا، ويُتحقق منه لدى Discord عند لصقه، ويُمرَّر إلى شيفرتك باسم DISCORD_TOKEN |
| الأخطاء | تقرأ السجل بنفسك | تذكر لافتة وحدة التحكم السبب، مثل رمز خاطئ أو intent ناقص |
| تحديثات النظام وجدار الحماية وSSH | عليك أنت | ليست من مهامك |
أسئلة يطرحها الناس
توقف بوت disnake عن العمل بعد إعادة تشغيل دون أي تغيير. لماذا؟
إذا كان requirements.txt يحتوي على disnake فقط، فقد ينقله تثبيت الحزم عند أول بدء بعد يوم من التثبيت السابق إلى إصدار أحدث، ولا يعد disnake بخلو الإصدارات الفرعية من التغييرات التي تكسر التوافق. ثبّت الإصدار الذي اختبرته، مثل disnake==2.12.*، وشغّل البوت من جديد: تُثبَّت الحزم مرة أخرى لأن الملف تغيّر.
لماذا لا يظهر /ping في خادمي؟
تأكد من أن البوت أُضيف عبر إضافة إلى خادم Discord وأن وحدة التحكم تعرض Logged in as. أثناء الاختبار مرّر test_guilds=[your_server_id] إلى InteractionBot()، كما تفعل أمثلة disnake نفسها: تُنشأ الأوامر عندئذ في ذلك الخادم، وتقول وثائق Discord إن أوامر الخوادم تتحدث فورًا.
هل شيفرة disnake هي نفسها شيفرة discord.py؟
قريبة وليست نفسها. يحتفظ disnake ببنية discord.py 2.0 وصياغتها تحت الاسم disnake، لكن له أوامر الشرطة المائلة الخاصة به: @bot.slash_command مع inter.response.send_message()، وتُقرأ الخيارات من معاملات الدالة. غيّر الاستيرادات وشيفرة الأوامر عند الانتقال.
هل يناسب بوت disnake أصغر خطة؟
نعم. بنحو 47 MB في اختبارنا، يترك بوت disnake الأدنى معظم خطة STARTER بسعة 0.5 GB لشيفرتك أنت. انتقل إلى خطة أكبر عندما يحتاج بوتك نفسه إلى ذلك: خوادم كبيرة يخزّن أعضاءها مؤقتًا، أو ملفات وصور يعالجها، أو بيانات يحتفظ بها في الذاكرة.
هل أنت مستعد لتشغيل بوتك؟ اختر خطة في استضافة بوتات Discord وارفع بوت disnake الخاص بك.



