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

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

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

لاستضافة بوت hikari على مدار الساعة 24/7، شغّله على جهاز يبقى قيد التشغيل بدلًا من حاسوبك الشخصي: خادم VPS لينكس مع خدمة systemd إن كنت تستضيفه بنفسك، أو خطة بوتات في استضافة بوتات Discord من PlayNHost (ابتداءً من US$1.99 شهريًا) حيث ترفع كودك وتلصق الرمز وتضغط Start. في اختبارنا استخدم بوت hikari 2.7.0 نحو 61 MB من الذاكرة ووصل إلى Discord بعد نحو 1.3 ثانية من تشغيله. يحتاج hikari 2.7 إلى Python 3.11 أو أحدث وليس له إطار عمل أوامر خاص به، لذلك تتضمن هذه الصفحة أمر slash مكتوبًا بـ hikari وحده. الخطوات على PlayNHost:

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

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

ما الذي قسناه

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

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

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

ماذا يعني هذا للخطة: بوت hikari الأدنى يستخدم جزءًا صغيرًا من خطة STARTER ذات 0.5 GB. حدّد حجم الخطة بما يحتفظ به بوتك نفسه في الذاكرة، لا بالمكتبة.

بوت hikari أدنى

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

requirements.txt

hikari>=2.7,<3

bot.py

import os

import hikari

bot = hikari.GatewayBot(token=os.environ["DISCORD_TOKEN"])


@bot.listen()
async def register_commands(event: hikari.StartedEvent) -> None:
    application = await bot.rest.fetch_application()
    await bot.rest.set_application_commands(
        application=application.id,
        commands=[bot.rest.slash_command_builder("ping", "Check that the bot answers")],
    )
    print(f"Logged in as {bot.get_me()}")


@bot.listen()
async def on_command(event: hikari.CommandInteractionCreateEvent) -> None:
    if event.interaction.command_name == "ping":
        await event.interaction.create_initial_response(
            hikari.ResponseType.MESSAGE_CREATE, "Pong!"
        )


bot.run()

يختار hikari الحدث من النوع المكتوب على كل listener. عندما تبدأ كل الـ shards (StartedEvent)، يرسل البوت قائمة أوامره إلى Discord بواسطة set_application_commands، وهذا يستبدل أوامر البوت العامة بتلك القائمة، ثم يطبع سطر الجاهزية. يصل CommandInteractionCreateEvent في كل مرة يستخدم فيها أحدهم أمرًا. السطر Logged in as هو ما يحوّل الشارة في نظرة عامة إلى متصل في Discord.

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

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

UnauthorizedError: Unauthorized 401: '401: Unauthorized' for https://discord.com/api/v10/gateway/bot

هو hikari.errors.UnauthorizedError، يطلقه أول طلب يرسله hikari إلى Discord عند بدء البوت، ثم يتوقف البوت. تحقق من الرمز في صفحة بوت، لوحة Discord: انقر فحص الآن، وإذا ظهرت العبارة لم يقبله Discord فانسخ رمزًا جديدًا من Discord Developer Portal، Bot، Reset Token، والصقه بواسطة استبدال الرمز ثم شغّل البوت من جديد. راجع كيف تنشئ بوت Discord وتحصل على رمزه.

ما يجب أن يعرفه المضيف عن hikari

  • Python 3.11 أو أحدث. يتطلب hikari 2.7.0 إصدار Python 3.11 أو أحدث؛ ويذكر ملف README الإصدارات من 3.11 إلى 3.15. على Python 3.10، يجعل سطر hikari المجرد pip يثبّت 2.6.0، آخر إصدار لـ 3.10. مع hikari>=2.7,<3 يرفض pip: تعرض وحدة التحكم خطأ pip والسطر [PlayNHost] pip could not install everything in requirements.txt.، وإذا لم يكن hikari قد ثُبّت على الخادم قط، يتوقف البوت بعدها مع ModuleNotFoundError: No module named 'hikari'. تحت بيئة التشغيل يصلح أي اختيار عدا 3.10.
  • لا يتضمن إطار عمل للأوامر. يوفر hikari الأحداث وواجهة REST الخاصة بـ Discord؛ ويحيل README إلى lightbulb وtanjun وcrescent وarc للأوامر. يسجّل البوت أعلاه أمره بنفسه عند كل بدء، وهو ما يصفه README بأنه spammy إلى حد ما؛ ويقترح معالج أوامر، أو فحوصات لإرسال الأوامر فقط عند تغيّرها. إطار العمل سطر إضافي واحد في requirements.txt.
  • تحذير عند كل بدء. يسجّل hikari السطر You are running on optimization level 0 (no optimizations) ويقترح -O. على خادم PlayNHost يشغّل سكربت البدء ملف البدء الخاص بك بـ python المجرد، فترى هذا التحذير ويعمل البوت بصورة طبيعية. لإخفائه مرّر suppress_optimization_warning=True إلى hikari.GatewayBot(). على VPS الخاص بك يمكنك إضافة -O بدلًا من ذلك.
  • التسجيل واللافتة مفعّلان افتراضيًا. يضبط GatewayBot التسجيل على المستوى INFO ويطبع لافتة hikari. سطره الخاص عند اتصال shard هو shard is ready: ...؛ ولا تحتسب شارة اللوحة هذا السطر اتصالًا، لذا اطبع سطرك الخاص Logged in as كما في الأعلى.
  • يتحقق من التحديثات. افتراضيًا يسأل run() موقع PyPI عن أحدث hikari ويسجّل A newer version of hikari is available عند وجود إصدار أحدث. يوقف bot.run(check_for_updates=False) ذلك.
  • النوايا (Intents). الافتراضي هو كل النوايا غير المميّزة. تتطلب قراءة نص الرسائل hikari.Intents.MESSAGE_CONTENT في intents= وتفعيل Message Content Intent في Developer Portal. إذا طلبه كودك وهو معطّل في البوابة، يرفض Discord تسجيل الدخول. راجع إصلاح خطأ «Used disallowed intents» في بوت Discord.

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

تحقق من إصدار Python أولًا: يجب أن يعرض python3 --version الإصدار 3.11 أو أحدث. يأتي Debian 12 بالإصدار 3.11 ويأتي Ubuntu 24.04 بالإصدار 3.12 ويأتي Debian 13 بالإصدار 3.13؛ ويأتي Ubuntu 22.04 بالإصدار 3.10، وهو قديم جدًا لـ hikari 2.7. ثم ثبّت Python وأنشئ مستخدمًا ومجلدًا للبوت وثبّت hikari في بيئة افتراضية:

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

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

ثم أنشئ /etc/systemd/system/hikari-bot.service. يشغّل Python مع -O، كما يوصي README الخاص بـ hikari للإنتاج:

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

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

[Install]
WantedBy=multi-user.target

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

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

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

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

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

أسئلة يطرحها الناس

هل أحتاج إلى lightbulb أو tanjun أو crescent أو arc؟

لا. يستطيع hikari وحده تسجيل أوامر slash والرد عليها، كما يوضح البوت أعلاه. إطار العمل معالج أوامر جاهز، فلا تكتب التسجيل والتوجيه بنفسك عندما تزيد أوامرك على بضعة أوامر. أضفه إلى requirements.txt؛ يُثبَّت عند البدء التالي.

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

تحقق من أن البوت أُضيف بواسطة إضافة إلى خادم Discord ومن أن وحدة التحكم تعرض Logged in as: يُسجَّل الأمر قبل هذا السطر مباشرة. أثناء الاختبار مرّر guild=your_server_id إلى set_application_commands: عندها يُنشأ الأمر في ذلك السيرفر فقط، وتقول وثائق Discord إن أوامر السيرفر تتحدث فورًا.

هل تحذير التحسين مشكلة؟

لا. يقول إن Python يعمل بدون -O، وهو الخيار الذي يزيل عبارات assert وفحوصات أخرى للتنقيح فقط، ويقترحه hikari للسرعة. بوتك يعمل بدونه. أخفِ التحذير بواسطة suppress_optimization_warning=True.

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

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

مستعد لتشغيل بوتك؟ اختر خطة في استضافة بوتات Discord وارفع بوت hikari الخاص بك.

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

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