> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل إعداد استضافة بوت Discord

> سجّل واستبدل ترخيصًا وشغّل بوت Discord بلغة Node.js أو Python واستقبل webhooks على EchoAuth Bothosting.

يشغّل EchoAuth Bothosting بوت Discord الخاص بك في حاوية مستقلة على [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev)، مع لوحة فوترة لحسابك ورصيدك ولوحة تحكم مبنية على [Pterodactyl](https://pterodactyl.io) للخادم نفسه (وحدة التحكم والملفات وإعدادات التشغيل).

يرشدك هذا الدليل خلال المسار الكامل: إنشاء حساب، واستبدال ترخيص، وإنشاء خادم، ورفع البوت، واستقبال webhooks.

## بداية سريعة

1. [أنشئ حسابك](#أنشئ-حسابك) على [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [استبدل ترخيصك](#استبدل-ترخيصك) في صفحة Store لإضافة رصيد
3. [أنشئ خادمًا](#أنشئ-خادمًا) — اختر بيئة التشغيل وسمِّه وأكّد
4. [ارفع ملفات البوت](#ارفع-ملفات-البوت) واضبط متغيرات بدء التشغيل
5. [شغّل الخادم واختبر webhook](#شغّل-الخادم)

> [!NOTE]
>
> **قبل أن تبدأ، جهّز ما يلي:**
>
> * رمز ترخيص (من رسالة الدفع الإلكترونية بعد شراء وقت الاستضافة)
> * كود البوت — ملف `index.js` لـ Node.js أو `app.py` لـ Python، بالإضافة إلى `requirements.txt` لـ Python إذا كانت لديك اعتماديات

## أنشئ حسابك

انتقل إلى [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register) وأنشئ حسابًا وسجّل الدخول. تصل إلى Dashboard التي تعرض عدد الخوادم ورصيدك.

![لوحة تحكم EchoAuth Bothosting بعد تسجيل الدخول تعرض 0 خوادم و0.00 رصيد](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/01-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44a55bf2156a5be753248292b30a0ffa)

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

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

افتح **Store** في الشريط الجانبي، ثم انقر على **Redeem code** وأدخل رمز الترخيص.

> [!TIP]
>
> 1 رصيد = شهر واحد من التشغيل لحاوية بوت واحدة، ولا يوجد حد لعدد الحاويات التي يمكنك تشغيلها — كل حاوية تحتاج فقط إلى رصيد كافٍ لتغطية تكلفتها الشهرية.

![صفحة Store تعرض خيارات ترخيص لمدة 1 و6 و12 شهرًا وزر Redeem code](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/02-store.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d22be1809910deac312b6cc81cc0708f)

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

![نافذة Redeem voucher code مع رمز ترخيص معبّأ](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/03-redeem-filled.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=5e5333a498707f29e30f975978eef72b)

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

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

![نافذة الاستبدال تعرض رسالة نجاح بأنه تمت إضافة 1.00 رصيد](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/04-redeem-success.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=a79d87f20c1c7ebed2268dbdcbecd925)

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

## أنشئ خادمًا

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

![نموذج إنشاء خادم باسم معبّأ واختيار Node.js كلغة وتفاصيل خطة Bot Container أدناه](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/05-create-server.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d2eca2740ee95cbaf0c73a1282542ab0)

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

انقر على **Create server**. يُخصم المبلغ من رصيدك فورًا ويظهر الخادم بحالة **Active** في صفحة Servers.

![بطاقة الخادم تعرض الحالة Active والمواصفة Node.js وخطة الموارد Bot Container والسعر 1.00 رصيد شهريًا](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/06-server-active.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8efdd67bc293af11210788908d4f7f12)

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

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

انقر على أيقونة المفتاح على بطاقة الخادم لفتحه في لوحة التحكم على [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). تحتوي اللوحة على تبويبات **Console** و**Files** و**Databases** و**Schedules** و**Users** و**Backups** و**Network** و**Startup** و**Settings** و**Activity**.

![لوحة Pterodactyl تعرض الخادم المُنشأ حديثًا](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/07-panel-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=338631775f65f91731e5077d1d39bd43)

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

يبدأ الخادم الجديد غير متصل، وبمدير ملفات فارغ، في انتظار الكود الخاص بك.

![تبويب Console يعرض الخادم بحالة offline مع أزرار Start وRestart وStop](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/08-console-offline.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=065bea5d4fd06fd09ed92566554b0b8f)

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

![مدير ملفات فارغ يعرض المجلد /home/container بدون ملفات](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/09-files-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=1bb3ee4e94d3e98217f508c56db8fa4d)

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

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

افتح تبويب **Startup** أولًا لترى ما تتوقعه بيئة التشغيل.

> [tab] Node.js
>
> يشغّل أمر بدء التشغيل `${MAIN_FILE}` من `/home/container`. القيمة الافتراضية للمتغير **Main File** هي **`index.js`** — إذا كان اسم ملفك الرئيسي مختلفًا، فحدّث هذا المتغير ليطابقه (يمكن أن يكون `.js` أو `.ts`).
>
> ![تبويب Startup يعرض أمر بدء تشغيل Node.js وقائمة منسدلة لصورة Docker مضبوطة على Nodejs 26](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/10-startup-command.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44f941a8fa4f4797b6d95348d78b4af3)
>
> أمر بدء تشغيل Node.js ومحدد صورة Docker.
>
> ![متغير بدء التشغيل Main File بقيمة افتراضية index.js](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/11-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=373d4355cf41af1cf989e5cc5e1f1d8b)
>
> المتغير Main File، والقيمة الافتراضية index.js.
>
> لا يوجد مفتاح منفصل بين HTTP وHTTPS في بيئة Node.js — الكود الخاص بك هو الذي يحدد أيهما يستمع إليه.

> [tab] Python
>
> يشغّل أمر بدء التشغيل دائمًا **`app.py`** من `/home/container` — سمِّ ملفك الرئيسي بهذا الاسم تمامًا (المتغير "App Py File" وصفي فقط؛ ولا يُستبدل في الأمر الفعلي).
>
> ![متغير بدء التشغيل App Py File بقيمة افتراضية app.py](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/19-python-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=0a2a66543153c5bf520179357ef7d1a5)
>
> المتغير App Py File في Python، ويجب أن يبقى app.py.
>
> تحتوي بيئة Python أيضًا على مفتاح **Use HTTPS**: القيمة `0` = HTTP (الافتراضي) و`1` = HTTPS، وفي هذه الحالة تبحث عن `cert.pem` و`key.pem` في مجلد الخادم وتعود إلى شهادة موقّعة ذاتيًا إذا لم تكونا موجودتين.
>
> ![متغير بدء التشغيل Use HTTPS مع مفتاح مطفأ، موصوف بأن 0 = HTTP الافتراضي و1 = HTTPS](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/20-python-use-https.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=eb21f9df848c94c86d160a8158528de1)
>
> المتغير Use HTTPS، متاح فقط في بيئة Python.
>
> > [!WARNING]
> >
> > يتوقع وكيل webhook العام عبر HTTPS (أدناه) أن يستمع البوت على HTTP عادي. اترك **Use HTTPS** على `0` ما لم تكن تنهي TLS بنفسك وتتصل مباشرةً بمنفذك.
>
> اذكر أي حزم يحتاجها البوت في **`requirements.txt`** — تُثبَّت تلقائيًا عند بدء التشغيل.

افتح **Files** وانقر على **New File** (أو **Upload** لإرسال ملف من حاسوبك) وأضف الكود الخاص بك.

![محرر ملف جديد مع لصق كود مثال لخادم webhook](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/12-new-file-editor.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=202c32cf6ecd7d4021aa46cd952ba328)

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

> [tab] Node.js
>
> ![مدير الملفات يعرض index.js في /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/13-files-index-js.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=ed83b61d895d03949133422c43be0ce0)
>
> تم رفع index.js وهو جاهز للتشغيل.

> [tab] Python
>
> ![مدير الملفات يعرض app.py وrequirements.txt في /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/21-python-files.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8fb281d9be6156356abed7fcb9b1c0c6)
>
> تم رفع app.py وrequirements.txt وهما جاهزان للتشغيل.

## شغّل الخادم

انتقل إلى **Console** وانقر على **Start**. تسحب اللوحة صورة Docker وتشغّل أمر البدء وتبث المخرجات مباشرةً.

![وحدة التحكم تعرض تشغيل سكربت البدء ثم Bot webhook server listening on port 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/14-console-running.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=f118d50404f795183ec1dd8b0b1ef499)

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

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

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

![تبويب Network مع اسم المضيف bothosting-eu01.echoauth.dev والمنفذ 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/15-network-tab.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=72e0554fadab4528c1cbd9a90b694380)

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

## استقبل webhooks

هناك طريقتان للوصول إلى البوت من الخارج:

| الصيغة | الرابط | ملاحظات |
| - | - | - |
| HTTP مباشر | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | يصل مباشرةً إلى منفذ الحاوية. |
| وكيل HTTPS | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | يُنهى TLS نيابةً عنك — يتطلب أن يكون البوت في وضع HTTP (`Use HTTPS = 0`). |

```bash Direct HTTP theme={null}
curl -X POST http://bothosting-eu01.echoauth.dev:25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

```bash HTTPS proxy theme={null}
curl -X POST https://bothosting-eu01.echoauth.dev/hook/25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

كلاهما يعيد الاستجابة نفسها من بوت المثال أعلاه:

```json theme={null}
{"status": "ok", "received": true}
```

...وكلا الاستدعاءين يظهران مباشرةً في وحدة التحكم، مع إحصاءات المعالج والذاكرة ومدة التشغيل للخادم.

![وحدة التحكم تعرض سطري سجل Webhook received، بالإضافة إلى بطاقات الإحصاءات Address وUptime وCPU Load وMemory](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/16-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9da134cabf2ca3125e723ba7374ebc3b)

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

الشيء نفسه يعمل من البداية إلى النهاية على بيئة Python:

![سجل وحدة تحكم Python يعرض بدء الخادم ثم سطري Webhook received من عنواني IP مصدر مختلفين](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/22-python-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=59e609ce210b24b4f1811e9e4300c632)

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

## أدر خادمك

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

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

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

![تبويب Backups لا يعرض نسخًا احتياطية محفوظة مع زر Create Backup](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/17-backups-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9770bee3f420389ffac1676a6999477e)

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

![قائمة النسخ الاحتياطية تعرض نسخة واحدة أُنشئت قبل ثوانٍ، 1 من 1 نسخ مستخدمة](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/18-backup-created.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=7ccf5835b8ca402d763fac7997c4ffbe)

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

### جدّد ترخيصك

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

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

> [accordion] الخادم لا يبدأ
>
> تحقق من تبويب **Startup**: في Node.js يجب أن يطابق المتغير **Main File** اسم الملف المرفوع تمامًا؛ وفي Python يجب أن يكون اسم ملفك الرئيسي `app.py`. الملف المفقود أو المسمّى خطأً هو السبب الأكثر شيوعًا.

> [accordion] المنفذ غير قابل للوصول
>
> استخدم اسم المضيف والمنفذ كما يظهران تمامًا في تبويب **Network**، وليس منفذًا اخترته بنفسك — فقط المنفذ المخصص (ضمن نطاق `25500`–`25650`) يُوجَّه إلى حاويتك.

> [accordion] webhook لا يصل
>
> تأكد من أنك تستخدم الصيغة الصحيحة لوضع البوت: وكيل HTTPS (`/hook/<port>/<path>`) يعمل فقط عندما يستمع البوت على HTTP عادي (`Use HTTPS = 0` في Python). وتحقق أيضًا من أن المسار يطابق ما يتوقعه كودك — الخطأ المطبعي هناك يعيد 404 من خادمك أنت، وليس من EchoAuth.

> [accordion] ما زلت عالقًا؟
>
> افتح **Support Ticket** في الشريط الجانبي مع اسم خادمك وما جرّبته.

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

> [accordion] كم خادمًا يمكنني تشغيله؟
>
> بقدر ما يتيحه رصيدك — تكلّف كل Bot Container رصيدًا واحدًا (شهرًا واحدًا) وتُفوتر شهريًا من رصيدك.

> [accordion] هل يمكنني استخدام TypeScript في بيئة Node.js؟
>
> نعم — اضبط **Main File** على ملف `.ts` وسيُشغَّل عبر `tsx` بدلًا من `node`.

> [accordion] هل أحتاج إلى requirements.txt في Python إذا لم تكن لدي اعتماديات؟
>
> لا — فهو اختياري. إذا كان موجودًا فتُثبَّت حزمه عند كل بدء تشغيل؛ وإذا كان بوتك يستخدم المكتبة القياسية فقط فيمكنك تركه.

> [accordion] ماذا يحدث إذا انتهى ترخيصي؟
>
> استبدل رمز ترخيص جديدًا في صفحة Store قبل أن يصل رصيدك إلى الصفر — يُطبَّق الرصيد المضاف على دورة الفوترة التالية تلقائيًا.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.