بعد ربط سيرفر Plesk، يتولى Hostinvo إنشاء استضافة عملائك وإدارتها عليه. تأخذك هذه الصفحة من ربط السيرفر إلى تشغيل أوامر الخدمة، وتشرح الرسائل التي قد تظهر لك أثناء ذلك.
١. ربط سيرفر Plesk
- 1
أنشئ مفتاح API على سيرفر Plesk
ادخل إلى سيرفر Plesk عبر SSH وشغّل الأمر التالي. سيظهر لك مفتاح يعمل مع Plesk API فقط، ويمكنك حذفه في أي وقت دون المساس بكلمة مرور المدير.
plesk bin secret_key --create -description "Hostinvo" - 2
أضف السيرفر في Hostinvo
السيرفرات ← إضافة سيرفر. أدخل الاسم واسم المضيف، واختر Plesk نوعاً للوحة، ثم اختر "مفتاح Plesk API (مُوصى به)" في طريقة دخول Hostinvo إلى Plesk والصق المفتاح. اترك عنوان اللوحة ومنفذها فارغين إلا إذا لم تكن لوحتك على https://hostname:8443.
- 3
اختبر الاتصال
احفظ، ثم اضغط اختبار الاتصال في صفحة السيرفر. إذا فشل، تشرح الرسالة السبب: مفتاح مرفوض، أو عنوان IP محظور في إعدادات الوصول إلى API في Plesk، أو عنوان خاطئ.
٢. اربط كل منتج بباقة في Plesk
- افتح المنتج، ثم إعدادات الموديول: اختر Plesk في وحدة التزويد، وسيرفرك في الخادم المرتبط.
- حزمة التزويد هي اسم الباقة كما يظهر في Plesk تماماً (مثل Starter).
- لا يلزم أن تكون الباقة موجودة مسبقاً: املأ الحدود في قسم باقة Plesk واضغط إنشاء الباقة على Plesk، فينشئها Hostinvo أو يحدّثها إن كانت موجودة.
- في قسم الأتمتة اختر متى يُنشأ الحساب: فوراً، أو بعد أول دفعة، أو يدوياً.
٣. إنشاء حساب الاستضافة
مع تفعيل الأتمتة يُنشأ الحساب عند دفع الطلب أو قبوله. ويمكنك أيضاً الضغط على إنشاء الحساب في صفحة الخدمة (العملاء ← العميل ← الخدمات ← الخدمة).
| في Plesk | ما ينشئه Hostinvo |
|---|---|
| العميل (Customer) | عميل واحد في Plesk لكل عميل في Hostinvo، باسمه وشركته وبريده، واسم دخول يبدأ بـ hv. خدمات العميل اللاحقة تُضاف تحت العميل نفسه. |
| الاشتراك (Subscription) | باسم دومين الخدمة، على باقة المنتج، ومالكه ذلك العميل. |
| الدخول | اسم المستخدم وكلمة المرور الظاهران في صفحة الخدمة يفتحان استضافة العميل على Plesk. |
٤. أوامر الخدمة
تعرض بطاقة Module Commands في صفحة الخدمة الأوامر الستة دائماً. الأوامر التي لا تناسب حالة الخدمة تظهر باهتة، ومرّر المؤشر فوق أي منها لترى السبب.
| الأمر | ما يفعله في Plesk | متى يكون متاحاً |
|---|---|---|
| Create account (إنشاء الحساب) | ينشئ العميل (أول مرة) والاشتراك. | عندما لا يكون للخدمة حساب على Plesk بعد. |
| Suspend account (إيقاف) | يوقف الاشتراك: تتوقف مواقعه وبريده والدخول إليه. | عندما تكون الخدمة نشطة. |
| Unsuspend account (إعادة التفعيل) | يعيد تشغيل الاشتراك. | عندما تكون الخدمة موقوفة. |
| Terminate account (حذف) | يحذف الاشتراك وبياناته من Plesk، ولا يمكن التراجع عنه. | عندما تكون الخدمة نشطة أو موقوفة، ويطلب Hostinvo تأكيداً. |
| Change package (تغيير الباقة) | ينقل الاشتراك إلى باقة أخرى. | عندما تكون الخدمة نشطة. |
| Reset password (إعادة كلمة المرور) | يضع كلمة مرور جديدة لدخول الاستضافة. | عندما تكون الخدمة نشطة. |
زر المزامنة (أيقونة التحديث) يقرأ من Plesk حالة الاشتراك واستخدامه: القرص والترافيك والبريد وقواعد البيانات. ويُزامَن الاستخدام تلقائياً كل ساعة أيضاً.
٥. الطابور: "ينتظر في الطابور" وزر Send again
كل أمر يُنفَّذ في الخلفية عبر عامل الطابور. أثناء انتظاره تعرض صفحة الخدمة "… is waiting in the queue" وتتوقف بقية الأوامر. ينتهي عادة خلال ثوانٍ، فحدّث الصفحة لترى النتيجة. وتظهر كل نتيجة أيضاً في رسالة منبثقة وفي جرس الإشعارات.
- بعد ثلاث دقائق يظهر للأمر المنتظر زر أزرق Send again: اضغطه لإعادة إرسال الأمر.
- إذا بقيت الأوامر تنتظر، فحاوية عامل الطابور لا تعمل. على سيرفرك الخاص تحقّق منها بالأوامر التالية.
هل عامل الطابور يعمل، وما آخر ما نفّذه؟
docker ps --filter name=queue --format '{{.Names}} {{.Status}}'
docker logs --since 10m hostinvo-queue-worker-1 2>&1 | tail -20٦. اشتراك حُذف من Plesk
إذا حذف أحد اشتراكاً من Plesk مباشرة، يبقى Hostinvo يظن أن الحساب موجود. أول أمر أو مزامنة بعدها يكتشف أنه غير موجود: يفشل مرة واحدة برسالة "الحساب لم يعد موجوداً على اللوحة"، ويلغي Hostinvo ربط الخدمة. عندها يصبح إنشاء الحساب متاحاً من جديد، والضغط عليه ينشئ الاشتراك مرة أخرى بنفس بيانات الدخول.
٧. الطلبات
إذا فشل تفعيل طلب (مثلاً رفض السيرفر الباقة)، أصلح السبب واضغط إنشاء الحساب في صفحة الخدمة. بعد إنشاء الحساب يتحول بند الطلب إلى نشط تلقائياً ويكتمل الطلب، ولا حاجة لإعادة محاولة الطلب.
حل المشاكل
| الرسالة | ما العمل |
|---|---|
| زر إنشاء الحساب باهت | للخدمة حساب على Plesk بالفعل. إذا كان قد حُذف من Plesk، اضغط المزامنة مرة واحدة فيُلغى الربط ويُفتح إنشاء الحساب. |
| … is waiting in the queue (لدقائق) | اضغط Send again. إذا بقيت، شغّل عامل الطابور (القسم ٥). |
| Domain '…' does not belong to any customer | لا يوجد في Plesk اشتراك بهذا الاسم. اضغط المزامنة فيلغي Hostinvo الربط لتنشئ الحساب من جديد. |
| الحساب لم يعد موجوداً على اللوحة | متوقعة بعد حذف الاشتراك من Plesk. اضغط إنشاء الحساب. |
| الحالة النشطة تحتاج حساباً على اللوحة | حاولت تغيير الحالة إلى نشط يدوياً. استخدم إنشاء الحساب. |
| HTTP 401 أو لم يقبل تسجيل الدخول | المفتاح خاطئ أو حُذف. أنشئ مفتاحاً جديداً (القسم ١) واحفظه في صفحة السيرفر. |
| HTTP 403 | المفتاح بلا صلاحية، أو عنوان IP الخاص بـ Hostinvo غير مسموح في Plesk ← Tools & Settings ← Remote API. |