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



