وحدة فولتر WHMCS

• معلومات الوحدة
• المقدمة
• متطلبات النظام
• المتطلبات الأساسية
• محددات
• نطاق
• ميزات الوحدة
• إنشاء مفتاح API
• التركيب
• الإعداد الأول
• تكوين الوحدة النمطية
• عملية ترتيب
• التعليمات

ملاحظة : يرجى قراءة هذا المستند بالكامل قبل تثبيت وحدة Vultr WHMCS

معلومات الوحدة

• الإصدار: 2.0.0 (محدث)
• تاريخ الإصدار: 25 يونيو 2019
• التغيير
• يرجى تقديم أي تقارير مشكلة / خطأ إلى مستودع Vultr WHMCS github الرسمي

المقدمة

تقدم منصة Vultr واجهة برمجة تطبيقات قوية وغنية بالميزات تتيح للمستخدمين التحكم في كل جانب من جوانب حساباتهم. توفر وحدة Vultr WHMCS لمقدمي الاستضافة حلاً مؤتمتًا بالكامل يتيح لهم تقديم خوادم سحابية موثوقة على منصة Vultr لعملائهم.

ملاحظة: الإصدار الحالي من الوحدة هو إعادة كتابة كاملة للوحدة الأصلية ، ولكنه متوافق مع المنتجات القائمة على Vultr الموجودة في WHMCS.

متطلبات النظام

• إصدار WHMCS 7.2.x أو أحدث
• إصدار PHP 7.1.x أو أحدث
• MySQL  5.6 أو MariaDB  5.6 أو MariaDB  10.0 أو MariaDB  10.1 .
• محمل ionCube.

المتطلبات الأساسية

• مفتاح Vultr API
• تمت إضافة عناوين IP لخادم WHMCS إلى القائمة البيضاء للوصول إلى واجهة برمجة التطبيقات

ملاحظات

• أنت يجب أن القائمة البيضاء عناوين IPv4 و IPv6 الخاص WHMCS خادم لAPI الوصول
  • إذا كان الخادم الخاص بك يحتوي على عناوين IPv4 متعددة ، فيمكنك إضافتها إلى القائمة البيضاء بشكل فردي أو إدراج الشبكة الفرعية بأكملها.
  • إذا كان الخادم الخاص بك يحتوي على عنوان IPv6 ، فمن الأفضل إضافة القائمة الفرعية / 64 شبكة فرعية بالكامل إلى القائمة البيضاء
• وWHMCS الإصدار 6 لا تدعمها بسبب الوصول إلى نهاية عمرها الافتراضي.
• وPHP النسخة 7.0.x لا يؤيد بسبب الوصول إلى نهاية عمرها الافتراضي.
• لا توجد خطط لدعم الإصدار القديم من WHMCS و PHP.
• يجب عليك استخدام الخيارات القابلة للتكوين التي تم إنشاؤها بواسطة الوحدة النمطية للمنتجات. من المحتمل أن يتسبب إنشاء الخاصة بك في حدوث صراع.

محددات

وفيما يلي قائمة من الخيارات لا وحدة لا تشمل حسب التصميم.

1. أضف عناوين IPv4 إضافية.
2. تمكين الشبكات الخاصة بعد نشر جهاز افتراضي.
3. التبديل بين نظام التشغيل والتطبيقات.
4. التبديل بين لينكس وويندوز.

نطاق

يغطي هذا المستند عملية تثبيت وتكوين وحدة Vultr WHMCS الرسمية. لا يتم دعم الوحدات التي تم تنزيلها من مواقع الويب التابعة لجهات خارجية بواسطة Vultr.

ميزات الوحدة

• إنشاء منتجات VPS بنقرة واحدة بناءً على Vultr
  • ستحتاج إلى تعيين التسعير يدويًا لكل منتج وخيار قابل للتكوين.
• نشر الأجهزة الظاهرية وترقيتها
• ميزة التشغيل / الإيقاف / الدورة
• وحدة تحكم HTML5 VNC
• تحكم rDNS
• الشبكات الخاصة
• البرامج النصية لبدء التشغيل
• مفاتيح SSH
• التحكم في اللقطة
• نشر VMs من قائمة ISOs المحددة مسبقًا
• نشر VMs من قائمة اللقطات المحددة مسبقًا
• تمكين / تعطيل ISO و لقطات محددة لعمليات نشر VM
• تمكين / تعطيل مواقع النشر
• دعم Vultr DNS مع دعم Vanity DNS (Custom Nameserver)

إنشاء مفتاح API

1. تسجيل الدخول إلى منطقة عميل Vultr.
2. انقر فوق الحساب.
3. انقر فوق API.
4. انقر فوق تمكين API.
5. أضف عناوين IP لخادم WHMCS إلى القائمة البيضاء تحت التحكم في الوصول.

التركيب

الخطوة الأولى هي تنزيل وحدة Vultr WHMCS هنا

تثبيت جديد

1. استخرج أرشيف ZIP.
2. قم بتحميل ملفات الوحدة إلى خادم WHMCS الخاص بك باتباع التسلسل الهرمي للدليل المحدد أدناه

الترقية من نسخة قديمة من الوحدة

1. النسخ الاحتياطي لقاعدة البيانات الخاصة بك والملفات
2. تماما حذف modules/addons/vultrو modules/servers/vultrالدلائل.
3. قم باستخراج وتحميل الوحدة الجديدة.

التسلسل الهرمي للدليل

الأرشيف الذي تم تنزيله

• الوحدات
  • الإضافات
    • فولتر
  • خوادم
    • فولتر

الإعداد الأول

1. قم بتحميل الوحدة كما هو موضح أعلاه
2. قم بتسجيل الدخول إلى لوحة إدارة WHMCS وانتقل إلى Setup -> Addon Modules.
3. بجانب Vultr Module، انقر فوق Configureالزر.
4. حدد خانة الاختيار بجوار Hooks Enabled.
5. أدخل مفتاح API الخاص بك في API Keyالحقل.
6. الإعداد Access Controlل Administratorوالأدوار الأخرى التي ترغب في تمكينه.
7. انقر Save Changes
8. قم بتسجيل الدخول إلى لوحة إدارة WHMCS وانتقل إلى Addons -> Vultr Moduleتكوين خيارات الوحدة النمطية الخاصة بك الواردة في القسم التالي من هذا المستند

تكوين الوحدة النمطية

سيعرض هذا القسم من الوثائق جميع خيارات التكوين المتاحة للوحدة النمطية ، ويشرح كيفية عملها ، ويشرح كيفية تكوينها.

منتج المنتج

سيسمح لك هذا القسم بإنشاء منتج قائم على Vultr في WHMCS. هناك وضعان ، Single Product Creatorو Multiple Product Creator.

و Single Product Creatorسوف وضع يسمح لك لخلق منتج على أساس حزم Vultr المتاحة، حدد مجموعة المنتج، والتسعير للمنتج كنت تقوم بإضافة. يجب إضافة أسعار الخيارات القابلة للتكوين مثل اللقطات و Windows وتطبيقات cPanel وما إلى ذلك يدويًا إلى خيارات المنتج القابلة للتكوين.

و Multi Product Creatorإرادة كبيرة الحجم خلق VPS الحزم استنادا Vultr في WHMCS، ولكن سيكون لديك لإعداد يدويا التسعير لكل صفقة، فضلا التسعير للخيارات شكلي، على غرار Single Product Creatorالوضع.

منتجات

سيعرض هذا القسم قائمة كاملة بجميع منتجاتك المستندة إلى Vultr في WHMCS وسيسمح لك بالانتقال بسرعة إلى الصفحة Editأو إلى Configurable Optionsكل منها. يمكنك أيضًا حذف منتج من تلك الصفحة. هذا القسم مفيد جدًا عندما تريد العثور بسرعة على منتج Vultr في منطقة إدارة WHMCS لتعديله ، أو تعديل الخيارات القابلة للتكوين له.

DNS

تدعم وحدة Vultr WHMCS خوادم أسماء Vanity (ns1 و ns2.domain.com مخصصين). إنشاء الغرور خوادم الأسماء يتطلب كخطوة أولى، وهو لإنشاء خوادم اسم مخصص مع مسجل نطاقك ونوجهه إلى البرامج المتكاملة ns1.vultr.comو ns2.vultr.comيقرر ل. مرة واحدة ، يرجى اتباع الخطوات التالية:

1. قم بتسجيل الدخول إلى لوحة إدارة WHMCS الخاصة بك.
2. هيا Addons -> Vultr Module.
3. انقر فوق DNS.
4. إضافة قيم Nameserver 1و Nameserver 2وانقر Save Changes.
5. انت انتهيت.

يرجى ملاحظة أن Vanity Nameservers يتم تطبيقها على مناطق / نطاقات DNS المضافة حديثًا. يجب تعديل المواقع الموجودة في https://my.vultr.com يدويًا.

موقع الخادم

لديك الخيار لتمكين وتعطيل مواقع Cloud معينة ، وبالتالي السماح لعملائك بنشر الأجهزة الافتراضية فقط في المواقع التي تختارها. يرجى الانتباه إلى أن تحديد موقع السحابة أثناء عملية الطلب غير ممكن حيث يتم تحميل المواقع ديناميكيًا اعتمادًا على مكان توفر الحزمة المحددة في وقت النشر.

لتحديد المواقع التي تريد تمكينها لعملائك ، يرجى اتباع الخطوات أدناه:

1. قم بتسجيل الدخول إلى لوحة إدارة WHMCS الخاصة بك.
2. هيا Addons -> Vultr Module.
3. انقر فوق Server Location.
4. انقر فوق Enabledالزر لتعطيل المواقع التي ترغب في تعطيلها (النقر فوق الزر عندما يقول Disabledسيعيد تمكين الموقع).
5. انت انتهيت.

لقطات

تتيح لك وحدة Vultr WHMCS عمل لقطة أو أكثر من حسابك Public- مما يعني أنك ستسمح لعملائك بنشر أجهزة افتراضية جديدة من هذه اللقطات إذا اختاروا القيام بذلك. يتم تعيين جميع اللقطات في حسابك Disabled افتراضيًا في الوحدة وستحتاج إلى تمكينها.

لتحديد اللقطات التي سيتم نشرها لعملائك ، يُرجى اتباع الخطوات أدناه:

1. قم بتسجيل الدخول إلى لوحة إدارة WHMCS الخاصة بك.
2. هيا Addons -> Vultr Module.
3. انقر فوق Snapshots.
4. انقر فوق Disabledالزر لتمكين اللقطات التي ترغب في جعلها عامة (النقر فوق الزر عندما يقول Enabledسيعيد تمكين اللقطة).
5. انت انتهيت.

ISO

على غرار ميزة اللقطات ، يمكنك إنشاء واحد أو أكثر من ملفات ISO المخصصة التي تم تحميلها على حسابك Public- مما يعني أنك ستسمح لعملائك بنشر أجهزة افتراضية جديدة من هذه ISO إذا اختاروا القيام بذلك. يتم تعيين جميع ISO في حسابك بشكل Disabled افتراضي في الوحدة وستحتاج إلى تمكينها.

لتحديد اللقطات التي سيتم نشرها لعملائك ، يُرجى اتباع الخطوات أدناه:

1. قم بتسجيل الدخول إلى لوحة إدارة WHMCS الخاصة بك.
2. هيا Addons -> Vultr Module.
3. انقر فوق ISO.
4. انقر فوق Disabledالزر لتمكين ISOs التي ترغب في جعلها عامة (النقر فوق الزر عندما تقول Enabledستعيد تمكين ISO).
5. انت انتهيت.

عملية ترتيب

إن طلب المنتجات القائمة على Vultr في WHMCS هو عملية من ثلاث خطوات.

الخطوة 1

طلبات العميل في منطقة / سلة عميل WHMCS: سيقدم العميل طلبًا لجهاز افتراضي. سيُطلب منهم إدخال:

• اسم المضيف
• كلمة مرور الجذر
• NS1 و NS2

هذا هو نموذج طلب WHMCS القياسي ولا يمتلك Vultr أي سيطرة عليه. مرحبًا بك لتغيير قالب نموذج طلب WHMCS لإخفاء أي من هذه الخيارات. يرجى أن نضع في الاعتبار أن كلمة سر الجذر المحددة في الترتيب لسوف لا يتم استخدامها منذ API Vultr سوف إنشاء كلمة مرور آمنة العشوائية لكل VM. بالإضافة إلى ذلك ، إذا قام العميل بالنشر من لقطة ، فسيحتاج إلى معرفة كلمة مرور الجذر الخاصة باللقطة قبل اليد ، وإلا فلن يتمكن من تسجيل الدخول.

بالإضافة إلى ذلك ، سيُط��ب من العميل تحديد ما إذا كان سيتم تمكين النسخ الاحتياطي التلقائي وحد اللقطات ونوع نظام التشغيل أم لا.

فيما يتعلق بنوع نظام التشغيل ، هناك 4 خيارات في القائمة المنسدلة تظهر تحت OS Typeنموذج الطلب

1. قائمة بجميع صور نظام التشغيل المتاحة
2. ISO
3. لمحة
4. تطبيق

اختيار Applicationسيمكن قائمة جميع المتاحة بنقرة واحدة العروض تطبيقات Vultr. سيسمح ISO و Snapshot للعميل بتحديد ISO أو Snapshot لنشر الجهاز الظاهري منه.

الخطوة 2

سيوافق المسؤول على الطلب وتقديم الخدمة في WHMCS (أو يمكنك اختيار جعل هذه العملية التلقائية في خيار المنتج في WHMCS بنفس الطريقة مثل أي منتج آخر في WHMCS.

الخطوه 3

سيتعين على العميل إنهاء عملية الطلب في منطقة العميل عن طريق اختيار Lable / Nickname لخادمه واسم المضيف وخيارات أخرى مثل مفتاح SSH أو IPv6 أو الشبكات الخاصة أو Startup Script.

التعليمات

تلقيت خطأ حول فشل الاتصال.

تأكد من أن مفتاح واجهة برمجة التطبيقات الخاص بك ليس مسبوقًا أو مسبوقًا بأي مسافة بيضاء ، وأن عناوين IPv4 و IPv6 لخادمك مدرجة في القائمة البيضاء للوصول إلى API. يمكنك التحقق من قواعد API الخاصة بك في منطقة الأعضاء .

إذا كانت قواعد المفتاح وقائمة التحكم بالوصول (ACL) صحيحة ، يمكنك اختبار المفتاح الخاص بك عن طريق تسجيل الدخول إلى خادم WHMCS وتشغيل مكالمات API المباشرة باستخدام cURL. يتم توفير أمثلة cURL في قسم أمثلة API الخاص بنا .

كيف يمكنني تحديد برنامج نصي قياسي لبدء التشغيل من خلال نظام الإعداد التلقائي؟

كما هو مذكور ، من المتوقع أن ينهي العميل نشر الجهاز الافتراضي في منطقة العميل بعد تخصيص خياراته حسب رغبته. يرجى مراعاة أن قائمة الموقع يتم ملؤها ديناميكيًا اعتمادًا على توفر الخطة المحددة عبر مواقع السحابة في Vultr - انظر الخطوة 3 أعلاه. لا توجد حاليًا وظيفة لإعداد برنامج نصي لبدء التشغيل العام.

كيف أقوم بتحديث التطبيقات في خيارات التكوين؟

إذا كنت ترغب في سرد ​​جميع التطبيقات المتاحة ، يمكنك استخدام أمر API هذا وإضافة التطبيقات التي تريدها في الخيارات القابلة للتكوين. التزامن التلقائي غير موجود في الوحدة النمطية.