لاستضافة بوت 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:
- في صفحة استضافة بوتات Discord، انقر أنشئ سيرفرًا على إحدى الخطط. في نافذة الطلب أجب عن لأي منصة بوتك؟ باختيار Discord ثم اختر Python.
- افتح خادمك في اللوحة. تفتح بطاقة إعداد بوتك في نظرة عامة عند الخطوة الاتصال بـ Discord. ينبغي أن تقول خطوتها الأولى ما الذي يعمل العبارة يشغّل هذا البوت Python Bot.؛ انقر هذه الخطوة للتحقق منها ثم انقر متابعة.
- في الاتصال بـ Discord الصق الرمز في الحقل الصق رمز بوتك وانقر الاتصال ثم نعم، متابعة.
- في الأذونات حدّد كودي يستخدم هذا فقط للنوايا (intents) المميّزة التي يطلبها كودك (البوت أدناه لا يحتاج إلى أي منها)، وانقر إضافة إلى خادم Discord ثم متابعة.
- في كودك انقر رفع الملفات وارفع
bot.pyوملفrequirements.txtيذكرpy-cord، أو انقر ربط Git. - إذا لم يكن ملفك الرئيسي
bot.py، فاضبط ملف البدء في صفحة البوت ضمن لوحة الكود ثم انقر حفظ. - انقر تشغيل البوت وتابع Console. عندما يطبع بوتك
Logged in as ...تعرض البطاقة بوتك متصل في Discord.
الخطوات العامة لـ Python (بيئة التشغيل والحزم وأسطر وحدة التحكم) موجودة في كيف تستضيف بوت Discord بلغة Python. تتناول هذه الصفحة ما يختلف مع Pycord.
ما الذي قسناه
شغّلنا كل مكتبة Discord للغة Python على خوادمنا، بإعداد Python 3.12 نفسه الذي تستخدمه خطة البوتات، وبحد للذاكرة قدره 1 GB:
| المكتبة | الإصدار | الذاكرة في وضع السكون | من البدء إلى رد Discord |
|---|---|---|---|
| Pycord | 2.8.1 | 51 MB | 1.1 ث |
| discord.py | 2.7.1 | 48 MB | 1.0 ث |
| nextcord | 3.2.0 | 47 MB | 1.0 ث |
| disnake | 2.12.2 | 47 MB | 0.9 ث |
| hikari | 2.7.0 | 61 MB | 1.3 ث |
| Python وحده | 3.12 | 9 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 الخاص بك.



