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

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

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

لاستضافة بوت Pycord على مدار الساعة 24/7، شغّله على جهاز يبقى قيد التشغيل بدلًا من حاسوبك الشخصي: خادم Linux VPS مع خدمة systemd إذا استضفته بنفسك، أو خطة بوتات في استضافة بوتات Discord من PlayNHost (ابتداءً من US$1.99 شهريًا)، حيث ترفع الكود وتلصق الرمز وتضغط «تشغيل». في اختبارنا استخدم بوت بإصدار Pycord 2.8.1 نحو 51 MB من الذاكرة ووصل إلى Discord بعد نحو 1.1 ثانية من إطلاقه. يُثبَّت Pycord باسم py-cord لكنك تستورده باسم discord، وهو الاسم نفسه الذي تستخدمه discord.py، لذا أدرج واحدة فقط من المكتبتين. الخطوات على PlayNHost:

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

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

ما الذي قسناه

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

المكتبةالإصدارالذاكرة في وضع السكونمن البدء إلى رد Discord
Pycord2.8.151 MB1.1 ث
discord.py2.7.148 MB1.0 ث
nextcord3.2.047 MB1.0 ث
disnake2.12.247 MB0.9 ث
hikari2.7.061 MB1.3 ث
Python وحده3.129 MB

الطريقة: أصغر برنامج يحمّل المكتبة ويسجّل الدخول برمز مزيّف، مثبَّتًا بالطريقة التي تثبّت بها خوادمنا الحزم. الذاكرة هي ما كانت العملية تشغله بعد 15 ثانية من رفض Discord للرمز، ويُحسب زمن البدء من الإطلاق حتى هذا الرد، فهو يشمل رحلة واحدة إلى Discord. كل رقم هو الوسيط لثلاث تشغيلات بعد تشغيل تسخين. وهو الحد الأدنى: فالبوت الذي اتصل وانضم إلى خوادم وخزّن أعضاء مؤقتًا يستخدم أكثر، بقدر يختلف من بوت إلى آخر.

ماذا يعني هذا للخطة: يستهلك بوت Pycord الأدنى نحو عُشر خطة STARTER ذات 0.5 GB. اختر الخطة بحسب ما يحتفظ به بوتك نفسه في الذاكرة، لا بحسب المكتبة.

بوت Pycord أدنى

يردّ على /ping بأمر slash ويطبع سطر الجاهزية. يقرأ الرمز من DISCORD_TOKEN، وهو الاسم الذي تمنحه اللوحة لكودك.

requirements.txt

py-cord>=2.8,<3

bot.py

import os

import discord

bot = discord.Bot()


@bot.event
async def on_ready():
    print(f"Logged in as {bot.user}")


@bot.slash_command(name="ping", description="Check that the bot answers")
async def ping(ctx: discord.ApplicationContext):
    await ctx.respond("Pong!")


bot.run(os.environ["DISCORD_TOKEN"])

discord.Bot هو صنف Pycord الخاص بأوامر slash. يسجّل /ping لدى Discord تلقائيًا عند كل اتصال، لأن auto_sync_commands مفعّل افتراضيًا، فلا حاجة إلى كتابة خطوة مزامنة. السطر Logged in as هو ما يحوّل الشارة في نظرة عامة إلى متصل في Discord.

إذا كان الرمز خاطئًا

عندما يرفض Discord الرمز، يُطلق Pycord هذا الخطأ (النص الذي طبعه بوت الاختبار لدينا):

LoginFailure: Improper token has been passed.

مع bot.run() ينتهي التتبّع بالسطر discord.errors.LoginFailure: Improper token has been passed. ويتوقف البوت. تقرأ اللوحة هذا السطر: تعرض الشارة مشكلة في الرمز وتعرض اللافتة لم يقبل Discord رمز بوتك. احصل على رمز جديد من Discord Developer Portal: تطبيقك، ثم Bot، ثم Reset Token (يظهر مرة واحدة فقط). انقر استبدال الرمز في اللافتة، ثم استبدال الرمز في لوحة Discord، والصقه وشغّل البوت من جديد. راجع كيف تنشئ بوت Discord وتحصل على رمزه.

ما الذي يحتاج المضيف إلى معرفته عن Pycord

  • اسم التثبيت واسم الاستيراد مختلفان. تثبّت py-cord وتكتب import discord. تثبّت discord.py وحدة بالاسم نفسه، discord، لذا لا يمكن أن تتعايش المكتبتان. يقول دليل Pycord نفسه إن عليك إلغاء تثبيت discord.py أولًا، ويحذّر من أن إلغاء تثبيت discord.py بعد تثبيت py-cord قد يسبب مشكلات.
  • نقل خادم من discord.py إلى Pycord. تثبّت خوادمنا الحزم في مجلد .local ولا تزيل أبدًا حزمة تحذفها من requirements.txt، لذا ستبقى discord.py بجانب Pycord. في Files احذف المجلد .local والملف .pnh/packages.state ثم اضغط تشغيل: يُعاد تثبيت كل ما في requirements.txt دون discord.py.
  • إصدار Python. يدعم Pycord 2.8.1 إصدارات Python من 3.10 إلى 3.14. تعرض بيئة التشغيل في لوحة الكود هذه الإصدارات بالضبط، والافتراضي 3.12، لذا فأي اختيار يعمل.
  • Intents. يستخدم discord.Bot() النوايا الافتراضية، وليس فيها أي نية مميّزة، ولا تحتاج أوامر slash إلى أي منها. أما أوامر البادئة مثل !ping فتحتاج إلى intents.message_content = True في كودك وإلى تفعيل Message Content Intent في Developer Portal. إذا طلبه كودك وهو معطّل في البوابة، يرفض Discord تسجيل الدخول. راجع إصلاح خطأ «Used disallowed intents» في بوت Discord.
  • اترك on_connect حرًّا. يعمل التسجيل التلقائي داخل on_connect الخاص بالبوت. إذا عرّفت on_connect بنفسك، فإن وثائق Pycord تقول باستدعاء await bot.sync_commands() داخلها، وإلا توقفت أوامرك عن التحديث. ضع كود البدء في on_ready كما في الأعلى.
  • التسجيل (logging) متوقف ما لم تشغّله. لا تهيّئ run() في Pycord التسجيل، لذا يعرض Python تحذيرات المكتبة وأخطاءها فقط، لا أسطر المعلومات مثل تسجيل الدخول. اطبع سطر الجاهزية الخاص بك كما في الأعلى، أو استدعِ logging.basicConfig(level=logging.INFO) لترى ما تفعله المكتبة.
  • الصوت. لقنوات الصوت اكتب py-cord[voice] في requirements.txt بدلًا من py-cord.

استضفه بنفسك على Linux VPS

على Debian أو Ubuntu ثبّت Python وأنشئ مستخدمًا ومجلدًا للبوت وثبّت Pycord في بيئة افتراضية:

sudo apt update
sudo apt install -y python3 python3-venv
sudo useradd --system --create-home --home-dir /opt/pycord-bot bot
sudo cp bot.py requirements.txt /opt/pycord-bot/
sudo chown bot: /opt/pycord-bot/bot.py /opt/pycord-bot/requirements.txt
sudo -u bot python3 -m venv /opt/pycord-bot/venv
sudo -u bot /opt/pycord-bot/venv/bin/pip install -r /opt/pycord-bot/requirements.txt

ضع الرمز في ملف لا يقرأه إلا root. أنشئ /etc/pycord-bot.env بالأمر sudo nano /etc/pycord-bot.env واكتب سطرًا واحدًا، DISCORD_TOKEN= متبوعًا برمزك، ثم احفظه ونفّذ sudo chmod 600 /etc/pycord-bot.env.

ثم أنشئ /etc/systemd/system/pycord-bot.service:

[Unit]
Description=Pycord Discord bot
Wants=network-online.target
After=network-online.target

[Service]
User=bot
WorkingDirectory=/opt/pycord-bot
EnvironmentFile=/etc/pycord-bot.env
Environment=PYTHONUNBUFFERED=1
ExecStart=/opt/pycord-bot/venv/bin/python bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

شغّله الآن وعند كل إقلاع، ثم تابع مخرجاته:

sudo systemctl daemon-reload
sudo systemctl enable --now pycord-bot
sudo journalctl -u pycord-bot -f

يجعل PYTHONUNBUFFERED=1 أمر print() يصل إلى السجل فورًا بدلًا من انتظار امتلاء المخزن المؤقت. لتحديث البوت انسخ الملفات الجديدة ونفّذ سطر pip install مرة أخرى ثم sudo systemctl restart pycord-bot.

الاستضافة الذاتية أم خطة البوتات

خادمك VPS الخاصخطة بوتات من PlayNHost
Pythonالإصدار الذي يأتي مع توزيعتك؛ تثبّته وتحدّثه أنتاختر من 3.10 إلى 3.14 ضمن بيئة التشغيل
الحزمتنفّذ pip install بعد كل تغييرتُثبَّت عند تشغيل يلي تغيّر requirements.txt أو إصدار Python، وعند أول تشغيل بعد يوم من آخر تثبيت
إعادة التشغيلوحدة systemd الخاصة بكيُشغَّل من جديد بعد التعطل؛ ويُترك متوقفًا مع ذكر السبب إذا تعطل مرة أخرى خلال دقيقة
الرمزملف تحميه بنفسكيُخزَّن مشفرًا، ويُتحقق منه لدى Discord عند لصقه، ويُمرَّر إلى كودك باسم DISCORD_TOKEN
الأخطاءتقرأ السجل بنفسكتذكر لافتة وحدة التحكم السبب، مثل رمز خاطئ أو نية مفقودة
تحديثات النظام وجدار الحماية وSSHعليك أنتليست من مهامك

أسئلة شائعة

هل يمكن استخدام Pycord وdiscord.py في البوت نفسه؟

لا. كلتاهما تثبّتان الوحدة discord، فتحل إحداهما محل الأخرى. أبقِ py-cord وحده في requirements.txt. إذا كان الخادم يشغّل discord.py من قبل، فاحذف .local و.pnh/packages.state في Files لتُثبَّت الحزم من جديد بشكل نظيف.

لماذا لا يظهر /ping في خادمي؟

تأكد من أن البوت أُضيف عبر إضافة إلى خادم Discord وأن وحدة التحكم تعرض السطر Logged in as: يسجّل Pycord الأمر عند الاتصال. أثناء الاختبار مرّر debug_guilds=[your_server_id] إلى discord.Bot(): تُنشأ الأوامر حينها في ذلك الخادم وحده، وبحسب وثائق Discord تُحدَّث أوامر الخادم فورًا.

هل Pycord هي نفسها discord.py؟

لا. بدأت Pycord تفرّعًا (fork) من discord.py وتحتفظ بكثير من واجهتها البرمجية، مثل discord.Client وdiscord.ext.commands، لكن أوامر slash فيها مختلفة: @bot.slash_command وctx.respond() في Pycord، وapp_commands واستدعاء مزامنة في discord.py. والكود المكتوب لإحداهما لا يعمل دائمًا على الأخرى.

هل يناسب بوت Pycord أصغر خطة؟

نعم. بنحو 51 MB في اختبارنا، يستخدم بوت Pycord الأدنى نحو عُشر خطة STARTER ذات 0.5 GB. انتقل إلى خطة أعلى عندما يحتاج بوتك نفسه إلى ذلك: خوادم كبيرة يخزّن أعضاءها مؤقتًا، أو ملفات وصور يعالجها، أو بيانات يحتفظ بها في الذاكرة.

جاهز لتشغيل بوتك؟ اختر خطة في استضافة بوتات Discord وارفع بوت Pycord الخاص بك.

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

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