إضافة خادم إلى WHMCS

اربط WHMCS بخادم استضافتك ليتمكّن من إنشاء حسابات cPanel وإيقافها وإنهائها تلقائيًا حين يطلب العملاء. ينطبق على حسابات الموزّعين وعلى خوادم VPS والمخصّصة التي فيها WHM.

واستخدم رمز API، لا كلمة مرور WHM. فالرمز يمكن إبطاله وحده وتقييده بعناوين IP محدّدة، ولا يتغيّر حين تدوّر كلمة مرورك.

1. ولّد رمز API في WHM

1. سجّل الدخول إلى WHM.
2. انتقل إلى Development ← Manage API Tokens.
3. اختر Generate Token.
4. سمّه اسمًا يمكن تمييزه — whmcs — واختر الصلاحيات التي يحتاجها.
5. انسخ الرمز.

وقيّد الرمز بعنوان IP لخادم WHMCS لديك وأنت هنا — راجع تقييد رموز API في WHM حسب عنوان IP. فالرمز الذي يعمل من أي مكان مفتاح دائم لخادمك كله.

2. أضف الخادم في WHMCS

1. في منطقة إدارة WHMCS، انتقل إلى Setup ← Products/Services ← Servers.

2. اختر Add New Server.

3. املأ:

   الحقل	القيمة
   Name	أي اسم يمكن تمييزه، مثل webgee-uk-1
   Hostname	اسم مضيف الخادم
   IP Address	عنوان IP الرئيسي للخادم
   Assigned IP Addresses	العناوين المتاحة للحسابات عليه
   Type	cPanel
   Username	اسم مستخدم WHM لديك — root على VPS، أو اسم مستخدم الموزّع فيما عداه
   Access Hash / API Token	الرمز من الخطوة الأولى

4. اترك Password فارغًا. فهو غير مستخدَم عند تقديم رمز.

5. علّم Secure للاتصال عبر SSL، واضبط المنفذ على 2087.

3. اختبر الاتصال

اختر Test Connection قبل الحفظ. ويُبلغ WHMCS بالنجاح أو بالخطأ الدقيق.

ولا تحفظ إلا بعد نجاح الاختبار — فحفظ خادم لا يستطيع الاتصال يعني فشل الطلبات عند التزويد، بعد أن يكون العميل قد دفع.

إن فشل الاختبار

• Invalid username or token — يجب أن يطابق اسم المستخدم الحساب الذي وُلّد الرمز تحته. فرمز أُنشئ تحت root لا يعمل مع اسم مستخدم موزّع.
• رفض الاتصال أو انتهاء المهلة — المنفذ 2087 محجوب بين خادم WHMCS وخادم الاستضافة، أو الرمز مقيَّد بعنوان IP مختلف.
• Access denied — الرمز يفتقر إلى صلاحية مطلوبة. ولّده من جديد بصلاحيات إنشاء الحسابات وإدارتها.

اقرأ أيضًا

• تقييد رموز API في WHM حسب عنوان IP
• تثبيت WHMCS عبر Softaculous
• إنشاء حساب موزّع في WHM