دليل
سيرفر ومنتج WHMCS
تشرح هذه الصفحة خطوات إنشاء سجل السيرفر في WHMCS ومنتج قابل للبيع لـ Hetzner Cloud باستخدام موديول السيرفر srv_hetzner_cloud. وهي موجهة لمديري WHMCS الذين يُعدّون أول منتج سحابي لديهم، أو يضيفون مشروع Hetzner Cloud ثانياً.
الخطوة 1 — إنشاء سجل سيرفر WHMCS
انتقل إلى الإعداد → المنتجات/الخدمات → السيرفرات → إضافة سيرفر جديد.
| الحقل | القيمة |
|---|---|
| Name | تسمية وصفية، مثلاً "Hetzner Cloud EU" |
| Hostname | اختياري |
| Module | Hetzner Cloud |
| Access Hash | رمز API لـ Hetzner Cloud (اختياري إذا كان رمز مستوى الملحق مُعدّاً مسبقاً) |
اضغط Test Connection — يجب أن ينجح عندما يكون الرمز صالحاً.
Note
كل سجل سيرفر في WHMCS يقابل مشروع Hetzner Cloud واحداً. إذا كنت تدير عدة مشاريع Hetzner Cloud، أضف سجل سيرفر واحداً لكل مشروع.
الخطوة 2 — إنشاء أو استيراد منتج
الخيار أ — الاستيراد من الملحق (موصى به)
استخدم استيراد أنواع الخوادم لإنشاء المنتجات تلقائياً من كتالوج Hetzner الحي.
الخيار ب — منتج يدوي
- انتقل إلى الإعداد → المنتجات/الخدمات → المنتجات/الخدمات → إنشاء منتج جديد.
- عيّن نوع المنتج إلى Server/VPS.
- في تبويب إعدادات الموديول، عيّن:
- Module: Hetzner Cloud
- Server Group: المجموعة التي تحتوي على سجل سيرفر Hetzner لديك
- Server Type وImage وLocation: مختارة من القوائم الحية المجلوبة من واجهة Hetzner
تُستبعد أنواع Gen1 القديمة؛ يُفضَّل استخدام أنواع Gen2 الحالية (cx23، cpx22، وغيرها).
Tip
إذا ظهرت القوائم المنسدلة فارغة، تحقق من رمز API على السيرفر المرتبط أو من رمز API للسحابة على مستوى الملحق.
الخطوة 3 — خيارات التكوين (اختياري)
لتسعير مرن للموقع والصورة:
- ولّد المجموعات من خيارات التكوين.
- انتقل إلى الإعداد → المنتجات/الخدمات → [المنتج] → Configurable Options، ثم اربط المجموعات وحدّد التسعير.
أسماء المجموعات المتوقعة:
| نمط اسم المجموعة | الغرض |
|---|---|
Hetzner Locations — {type} |
الموقع/مركز البيانات |
Hetzner Cloud Options (x86) |
الإضافات المشتركة لـ x86 |
Hetzner Cloud Options (ARM) |
الإضافات المشتركة لـ ARM |
الخطوة 4 — الحقول المخصصة
ينشئ الموديول تلقائياً حقلين مخصصين عند أول عملية إنشاء:
| الحقل | الغرض |
|---|---|
serverID |
معرّف خادم Hetzner — لا تعدّله يدوياً |
sshKey |
مرجع اختياري لمفتاح SSH يُستخدم أثناء الإنشاء |
الخطوة 5 — فوترة التجاوز (اختياري)
في تبويب إعدادات الموديول للمنتج:
- Overage Price/GB — يحدّد السعر لكل جيجابايت يتجاوز حصة حركة المرور المضمّنة. عيّنه إلى
0لتعطيل فوترة التجاوز.
الخطوة 6 — سياسة منطقة العميل
أكمل الإعداد في إعدادات المنتج:
- أدخل معرّف المنتج.
- اضبط تبديلات Client Actions للإجراءات التي تريد أن يراها العملاء.
- عيّن نسبة ربح الاستيراد إذا لزم الأمر.
أعدّ إعدادات ISO إذا أردت تقييد القائمة البيضاء العالمية لـ ISO.
أوامر الموديول
| الأمر | الغرض |
|---|---|
| Sync Details | يحدّث hostname وIP وبيانات الاعتماد في WHMCS من Hetzner |
| Create / Terminate | إجراءات دورة حياة الموديول القياسية في WHMCS |
تدفق الطلب إلى الإنشاء
sequenceDiagram participant Client as العميل participant WHMCS participant Module as srv_hetzner_cloud participant Hetzner Client->>WHMCS: تقديم طلب WHMCS->>Module: CreateAccount Module->>Hetzner: POST /servers Hetzner-->>Module: معرّف الخادم + عناوين IP Module->>WHMCS: تحديث سجل الخدمة + الحقل serverID Client->>WHMCS: فتح منطقة العميل WHMCS->>Module: ClientArea Module-->>Client: النظرة العامة + أدوات الإدارة