الانتقال إلى المحتوى الرئيسي
يشغّل EchoAuth Bothosting بوت Discord الخاص بك في حاوية مستقلة على bothosting-eu01.echoauth.dev، مع لوحة فوترة لحسابك ورصيدك ولوحة تحكم مبنية على Pterodactyl للخادم نفسه (وحدة التحكم والملفات وإعدادات التشغيل). يرشدك هذا الدليل خلال المسار الكامل: إنشاء حساب، واستبدال ترخيص، وإنشاء خادم، ورفع البوت، واستقبال webhooks.

بداية سريعة

  1. أنشئ حسابك على control-hosting.echoauth.dev/register
  2. استبدل ترخيصك في صفحة Store لإضافة رصيد
  3. أنشئ خادمًا — اختر بيئة التشغيل وسمِّه وأكّد
  4. ارفع ملفات البوت واضبط متغيرات بدء التشغيل
  5. شغّل الخادم واختبر webhook
قبل أن تبدأ، جهّز ما يلي:
  • رمز ترخيص (من رسالة الدفع الإلكترونية بعد شراء وقت الاستضافة)
  • كود البوت — ملف index.js لـ Node.js أو app.py لـ Python، بالإضافة إلى requirements.txt لـ Python إذا كانت لديك اعتماديات

أنشئ حسابك

انتقل إلى control-hosting.echoauth.dev/register وأنشئ حسابًا وسجّل الدخول. تصل إلى Dashboard التي تعرض عدد الخوادم ورصيدك.
لوحة تحكم EchoAuth Bothosting بعد تسجيل الدخول تعرض 0 خوادم و0.00 رصيد

لوحة التحكم مباشرةً بعد تسجيل الدخول: 0 خوادم و0 رصيد.

استبدل ترخيصك

افتح Store في الشريط الجانبي، ثم انقر على Redeem code وأدخل رمز الترخيص.
1 رصيد = شهر واحد من التشغيل لحاوية بوت واحدة، ولا يوجد حد لعدد الحاويات التي يمكنك تشغيلها — كل حاوية تحتاج فقط إلى رصيد كافٍ لتغطية تكلفتها الشهرية.
صفحة Store تعرض خيارات ترخيص لمدة 1 و6 و12 شهرًا وزر Redeem code

صفحة Store مع زر Redeem code وسعر 1 رصيد = شهر واحد.

نافذة Redeem voucher code مع رمز ترخيص معبّأ

رمز ترخيص مُدخَل في نافذة Redeem voucher code.

بعد الاستبدال، يُضاف الرصيد إلى حسابك فورًا ويُسجَّل في Activity Logs في لوحة التحكم.
نافذة الاستبدال تعرض رسالة نجاح بأنه تمت إضافة 1.00 رصيد

الاستبدال الناجح يضيف الرصيد إلى حسابك فورًا.

أنشئ خادمًا

انتقل إلى Servers وانقر على Create Server. أعطه اسمًا واختر Language: Node.js أو Python. يتم تعبئة الموقع وخطة الموارد (منتج Bot Container: 0.3 vCPU و256 MB من RAM و512 MB من القرص ونسخة احتياطية واحدة ومنفذ واحد و1 رصيد/شهر) تلقائيًا.
نموذج إنشاء خادم باسم معبّأ واختيار Node.js كلغة وتفاصيل خطة Bot Container أدناه

نموذج إنشاء الخادم مع اختيار Node.js، يعرض خطة موارد Bot Container والسعر.

انقر على Create server. يُخصم المبلغ من رصيدك فورًا ويظهر الخادم بحالة Active في صفحة Servers.
بطاقة الخادم تعرض الحالة Active والمواصفة Node.js وخطة الموارد Bot Container والسعر 1.00 رصيد شهريًا

الخادم الجديد، نشط ومفوتر بمعدل 1.00 رصيد شهريًا.

جولة في لوحة التحكم

انقر على أيقونة المفتاح على بطاقة الخادم لفتحه في لوحة التحكم على controlpanel.echoauth.dev. تحتوي اللوحة على تبويبات Console وFiles وDatabases وSchedules وUsers وBackups وNetwork وStartup وSettings وActivity.
لوحة Pterodactyl تعرض الخادم المُنشأ حديثًا

قائمة الخوادم في لوحة التحكم بعد فتحها من لوحة الحساب.

يبدأ الخادم الجديد غير متصل، وبمدير ملفات فارغ، في انتظار الكود الخاص بك.
تبويب Console يعرض الخادم بحالة offline مع أزرار Start وRestart وStop

تبويب Console على خادم لم يبدأ بعد.

مدير ملفات فارغ يعرض المجلد /home/container بدون ملفات

مدير الملفات على خادم جديد.

ارفع ملفات البوت

افتح تبويب Startup أولًا لترى ما تتوقعه بيئة التشغيل.
يشغّل أمر بدء التشغيل ${MAIN_FILE} من /home/container. القيمة الافتراضية للمتغير Main File هي index.js — إذا كان اسم ملفك الرئيسي مختلفًا، فحدّث هذا المتغير ليطابقه (يمكن أن يكون .js أو .ts).
تبويب Startup يعرض أمر بدء تشغيل Node.js وقائمة منسدلة لصورة Docker مضبوطة على Nodejs 26

أمر بدء تشغيل Node.js ومحدد صورة Docker.

متغير بدء التشغيل Main File بقيمة افتراضية index.js

المتغير Main File، والقيمة الافتراضية index.js.

لا يوجد مفتاح منفصل بين HTTP وHTTPS في بيئة Node.js — الكود الخاص بك هو الذي يحدد أيهما يستمع إليه.
افتح Files وانقر على New File (أو Upload لإرسال ملف من حاسوبك) وأضف الكود الخاص بك.
محرر ملف جديد مع لصق كود مثال لخادم webhook

كتابة كود البوت مباشرةً في محرر الملفات في اللوحة.

مدير الملفات يعرض index.js في /home/container

تم رفع index.js وهو جاهز للتشغيل.

شغّل الخادم

انتقل إلى Console وانقر على Start. تسحب اللوحة صورة Docker وتشغّل أمر البدء وتبث المخرجات مباشرةً.
وحدة التحكم تعرض تشغيل سكربت البدء ثم Bot webhook server listening on port 25500

مخرجات وحدة التحكم مباشرةً بعد بدء خادم Node.js، والبوت يسجّل أنه يستمع.

اعثر على عنوان خادمك ومنفذه

افتح تبويب Network. عنوان خادمك العام هو <hostname>:<port> — مثل bothosting-eu01.echoauth.dev:25500. المنافذ المسموح بها ضمن النطاق 25500–25650.
تبويب Network مع اسم المضيف bothosting-eu01.echoauth.dev والمنفذ 25500

تبويب Network يعرض اسم مضيف الخادم والمنفذ المخصص.

استقبل webhooks

هناك طريقتان للوصول إلى البوت من الخارج:
كلاهما يعيد الاستجابة نفسها من بوت المثال أعلاه:
…وكلا الاستدعاءين يظهران مباشرةً في وحدة التحكم، مع إحصاءات المعالج والذاكرة ومدة التشغيل للخادم.
وحدة التحكم تعرض سطري سجل Webhook received، بالإضافة إلى بطاقات الإحصاءات Address وUptime وCPU Load وMemory

تسليمان لـ webhook مسجلان مباشرةً في وحدة التحكم، مع إحصاءات الموارد أدناه.

الشيء نفسه يعمل من البداية إلى النهاية على بيئة Python:
سجل وحدة تحكم Python يعرض بدء الخادم ثم سطري Webhook received من عنواني IP مصدر مختلفين

بوت Python يسجّل webhook مستلمًا عبر المنفذ المباشر ووكيل HTTPS.

أدر خادمك

استخدم Restart وStop في تبويب Console للتحكم في العملية الجارية.

النسخ الاحتياطية

تتضمن خطة Bot Container خانة نسخة احتياطية واحدة. افتح Backups وانقر على Create Backup لالتقاط لقطة من ملفاتك.
تبويب Backups لا يعرض نسخًا احتياطية محفوظة مع زر Create Backup

لا توجد نسخ احتياطية بعد — تبويب Backups على خادم جديد.

قائمة النسخ الاحتياطية تعرض نسخة واحدة أُنشئت قبل ثوانٍ، 1 من 1 نسخ مستخدمة

أول نسخة احتياطية، مُنشأة وجاهزة.

جدّد ترخيصك

اشترِ رمز ترخيص آخر أو استبدله بالطريقة نفسها كما في استبدل ترخيصك — يغطي الرصيد المضاف دورة الفوترة الشهرية التالية لخادمك تلقائيًا.

استكشاف الأخطاء وإصلاحها

تحقق من تبويب Startup: في Node.js يجب أن يطابق المتغير Main File اسم الملف المرفوع تمامًا؛ وفي Python يجب أن يكون اسم ملفك الرئيسي app.py. الملف المفقود أو المسمّى خطأً هو السبب الأكثر شيوعًا.
استخدم اسم المضيف والمنفذ كما يظهران تمامًا في تبويب Network، وليس منفذًا اخترته بنفسك — فقط المنفذ المخصص (ضمن نطاق 25500–25650) يُوجَّه إلى حاويتك.
تأكد من أنك تستخدم الصيغة الصحيحة لوضع البوت: وكيل HTTPS (/hook/<port>/<path>) يعمل فقط عندما يستمع البوت على HTTP عادي (Use HTTPS = 0 في Python). وتحقق أيضًا من أن المسار يطابق ما يتوقعه كودك — الخطأ المطبعي هناك يعيد 404 من خادمك أنت، وليس من EchoAuth.
افتح Support Ticket في الشريط الجانبي مع اسم خادمك وما جرّبته.

الأسئلة الشائعة

بقدر ما يتيحه رصيدك — تكلّف كل Bot Container رصيدًا واحدًا (شهرًا واحدًا) وتُفوتر شهريًا من رصيدك.
نعم — اضبط Main File على ملف .ts وسيُشغَّل عبر tsx بدلًا من node.
لا — فهو اختياري. إذا كان موجودًا فتُثبَّت حزمه عند كل بدء تشغيل؛ وإذا كان بوتك يستخدم المكتبة القياسية فقط فيمكنك تركه.
استبدل رمز ترخيص جديدًا في صفحة Store قبل أن يصل رصيدك إلى الصفر — يُطبَّق الرصيد المضاف على دورة الفوترة التالية تلقائيًا.