جديد 📢 الجمعة البيضاء: ينتهي عرض الإطلاق في 30 نوفمبر. خصم حتى 70% على شهرك الأول في كل لعبة.عرض الباقات
الجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقةالجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقةالجمعة البيضاءخصم حتى 70% على شهرك الأول، حتى 30 نوفمبرينتهي خلال 9 يوم 02 ساعة 49 دقيقة

كيفية استضافة بوت disnake على مدار الساعة 24/7

استضافة بوتات Discordحُدّث في 6 نوفمبر 20269 دقائق للقراءة

لاستضافة بوت disnake على مدار الساعة 24/7، شغّله على جهاز يبقى قيد التشغيل دائمًا بدلًا من حاسوبك: على VPS لينكس مع خدمة systemd إن كنت تستضيفه بنفسك، أو في خطة بوتات على استضافة بوتات Discord من PlayNHost (بدءًا من US$1.99 شهريًا)، حيث ترفع الشيفرة وتلصق الرمز وتضغط على تشغيل. في اختبارنا استخدم بوت disnake 2.12.2 نحو 47 MB من الذاكرة ووصل إلى Discord بعد نحو 0.9 ثانية من إطلاقه. يطلب disnake منك تثبيت إصداره، وهذا مهم على خادم يحدّث الحزم من تلقاء نفسه. الخطوات على PlayNHost:

  1. في صفحة استضافة بوتات Discord، اضغط على أنشئ سيرفرًا عند إحدى الخطط. في نافذة الطلب أجب عن السؤال لأي منصة بوتك؟ باختيار Discord، ثم اختر Python.
  2. افتح سيرفرك في اللوحة. تفتح بطاقة إعداد بوتك في نظرة عامة عند الخطوة الاتصال بـ Discord. يجب أن تعرض خطوتها الأولى، ما الذي يعمل، العبارة يشغّل هذا البوت Python Bot.؛ اضغط على هذه الخطوة للتحقق، ثم على متابعة.
  3. عند الاتصال بـ Discord، الصق الرمز في الصق رمز بوتك، واضغط على الاتصال، ثم على نعم، متابعة.
  4. عند الأذونات، فعّل كودي يستخدم هذا فقط للـ intents المميزة التي تطلبها شيفرتك (البوت أدناه لا يحتاج إلى أي منها)، واضغط على إضافة إلى خادم Discord، ثم على متابعة.
  5. عند كودك، اضغط على رفع الملفات وارفع bot.py مع requirements.txt يتضمن سطر disnake مثبّتًا، أو اضغط على ربط Git.
  6. إذا لم يكن ملفك الرئيسي bot.py، فاضبط ملف البدء في صفحة بوت، في جزء الكود، واضغط على حفظ.
  7. اضغط على تشغيل البوت وراقب Console. عندما يطبع بوتك Logged in as ...، تعرض البطاقة بوتك متصل في Discord.

الخطوات العامة لـ Python (بيئة التشغيل والحزم وأسطر وحدة التحكم) موجودة في كيف تستضيف بوت Discord بلغة Python. تتناول هذه الصفحة ما يختلف مع disnake.

ما الذي قسناه

شغّلنا كل مكتبة Discord لـ Python على خوادمنا، بنفس إعداد Python 3.12 الذي تستخدمه خطة البوتات، وبحد ذاكرة 1 GB:

المكتبةالإصدارالذاكرة في الحالة الأساسيةمن البدء إلى رد Discord
disnake2.12.247 MB0.9 ث
discord.py2.7.148 MB1.0 ث
Pycord2.8.151 MB1.1 ث
nextcord3.2.047 MB1.0 ث
hikari2.7.061 MB1.3 ث
Python وحده3.129 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 الخاص بك.

بوتك مستضاف في مكان آخر بالفعل؟ انقله إلينا

أحدث مقالات المدونة