# إضافة خادم إلى WHMCS
Source: https://docs.webgee.com/ar/reseller/how-to-add-a-server-or-reseller-account-into-your-whmcs



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

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

## 1. ولّد رمز API في WHM [#1-ولّد-رمز-api-في-whm]

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

<Callout type="warn">
  يُعرَض الرمز **مرة واحدة**. فإن غادرت الصفحة دون نسخه، فعليك توليد آخر.
</Callout>

وقيّد الرمز بعنوان IP لخادم WHMCS لديك وأنت هنا — راجع
[تقييد رموز API في WHM حسب عنوان IP](/ar/reseller/enhancing-security-with-whm-api-token-ip-address-restrictions).
فالرمز الذي يعمل من أي مكان مفتاح دائم لخادمك كله.

## 2. أضف الخادم في WHMCS [#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. اختبر الاتصال [#3-اختبر-الاتصال]

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

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

## إن فشل الاختبار [#إن-فشل-الاختبار]

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

## اقرأ أيضًا [#اقرأ-أيضًا]

* [تقييد رموز API في WHM حسب عنوان IP](/ar/reseller/enhancing-security-with-whm-api-token-ip-address-restrictions)
* [تثبيت WHMCS عبر Softaculous](/ar/reseller/softaculous-how-do-i-install-whmcs)
* [إنشاء حساب موزّع في WHM](/ar/reseller/how-to-create-a-reseller-whm)