ماژول Vultr WHMCS

• اطلاعات ماژول
• معرفی
• مورد نیاز سیستم
• پیش نیازها
• محدودیت ها
• محدوده
• ویژگی های ماژول
• ایجاد کلید API
• نصب و راه اندازی
• اولین راه اندازی
• پیکربندی ماژول
• فرآیند سفارش
• سؤالات متداول

توجه : لطفاً قبل از نصب ماژول Vultr WHMCS ، این سند را به طور کامل بخوانید

اطلاعات ماژول

• نسخه: 2.0.0 (به روز شده)
• تاریخ انتشار: 25 ژوئن 2019
• تغییر
• لطفاً گزارشهای مربوط به مشکلات و مشکلات را به مخزن رسمی Vultr WHMCS github ارسال کنید

معرفی

پلتفرم Vultr یک API قدرتمند و غنی از ویژگی ها ارائه می دهد که به کاربران امکان می دهد هر جنبه ای از حساب خود را کنترل کنند. ماژول 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 Loader.

پیش نیازها

• کلید API Vultr
• IP های سرور WHMCS شما برای دسترسی به API در لیست سفید قرار گرفته اند

یادداشت

• شما باید IPv4 و IPv6 آدرس خود را WHMCS سرور برای دسترسی به API لیست سفید
  • اگر سرور شما دارای چندین آدرس IPv4 است ، می توانید آنها را بصورت جداگانه لیست کنید یا کل زیر شبکه را لیست کنید.
  • اگر سرور شما دارای آدرس IPv6 است ، بهتر است لیست کامل / 64 Subnet را لیست کنید
• WHMCS نسخه 6 به دلیل رسیدن به پایان عمر پشتیبانی نمی شود.
• PHP نسخه 7.0.x به دلیل دستیابی به پایان عمر پشتیبانی نمی شود.
• هیچ برنامه ای برای پشتیبانی از نسخه های قدیمی WHMCS و PHP وجود ندارد.
• شما باید از گزینه های قابل تنظیم تولید شده توسط ماژول برای محصولات استفاده کنید. ایجاد خود شما به احتمال زیاد باعث درگیری خواهد شد.

محدودیت ها

در زیر لیستی از گزینه های ماژول کند هستند نه با طراحی باشد.

1. آدرسهای IPv4 اضافی را اضافه کنید.
2. پس از استقرار یک ماشین مجازی ، شبکه های خصوصی را فعال کنید .
3. جابجایی بین سیستم عامل و برنامه ها.
4. جابجایی بین لینوکس و ویندوز.

محدوده

این سند روند نصب و پیکربندی ماژول رسمی Vultr WHMCS را پوشش می دهد. ماژول های بارگیری شده از وب سایت های شخص ثالث توسط Vultr پشتیبانی نمی شوند.

ویژگی های ماژول

• ایجاد یک کلیک محصولات VPS مبتنی بر Vultr
  • شما باید قیمت گذاری برای هر محصول و گزینه تنظیم را به صورت دستی تنظیم کنید.
• ماشین های مجازی را مستقر و به روز کنید
• ویژگی روشن / خاموش / چرخه
• کنسول HTML5 VNC
• کنترل rDNS
• شبکه خصوصی
• اسکریپت های راه اندازی
• کلیدهای SSH
• کنترل عکس فوری
• VM ها را از لیستی از ISO های از پیش تعریف شده مستقر کنید
• VM ها را از لیستی از عکس های از پیش تعریف شده مستقر کنید
• فعال سازی / غیرفعال کردن ISO های خاص و عکس های فوری برای کاربری VM
• فعال یا غیرفعال کردن مکان های استقرار
• پشتیبانی Vultr DNS با پشتیبانی Vanity DNS (نام کاربری سفارشی)

ایجاد کلید 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. Addons -> Vultr Moduleبرای پیکربندی گزینه های ماژول خود که در قسمت بعدی این سند ارائه شده است ، به پنل مدیریت WHMCS خود وارد شوید و حرکت کنید.

پیکربندی ماژول

در این بخش از اسناد ، تمام گزینه های پیکربندی موجود برای ماژول به نمایش گذاشته می شود ، نحوه کار آنها توضیح داده می شود و نحوه پیکربندی آنها توضیح داده می شود.

خالق محصول

در این بخش به شما امکان ایجاد محصولی مبتنی بر Vultr را در WHMCS می دهیم. دو حالت وجود دارد ، Single Product Creatorو Multiple Product Creator.

این Single Product Creatorحالت به شما امکان می دهد محصولی را بر اساس بسته های موجود Vultr ایجاد کنید ، یک گروه محصول را انتخاب کنید و قیمت کالای مورد نظر خود را اضافه کنید. قیمت گذاری گزینه های قابل تنظیم مانند عکس های فوری ، ویندوز ، برنامه های cPanel و غیره ... باید به صورت دستی به گزینه های قابل تنظیم محصول اضافه شود.

Multi Product Creatorاراده فله-ایجاد سرور مجازی بسته های مبتنی بر Vultr در WHMCS شما، اما شما را به راه اندازی دستی برای هر بسته و همچنین قیمت گذاری قیمت گذاری برای گزینه های قابل تنظیم، شبیه به Single Product Creatorحالت.

محصولات

در این بخش لیست کاملی از تمام محصولات مبتنی بر Vultr شما در WHMCS نشان داده می شود و به شما امکان می دهد تا به سرعت به صفحه Editیا Configurable Optionsصفحه برای هر یک از آنها بروید. همچنین می توانید محصولی را از آن صفحه حذف کنید. این بخش برای زمانی مفید است که می خواهید سریعاً یک محصول Vultr را در قسمت Admin WHMCS خود پیدا کنید تا آن را تغییر داده یا گزینه های قابل تنظیم را برای آن تغییر دهید.

DNS

ماژول Vultr WHMCS از Vanity Nameservers (سفارشی ns1 و ns2.domain.com) پشتیبانی می کند. راه اندازی Vanity Nameservers اولین قدم را می طلبد ، یعنی ایجاد سرورهای نام سفارشی با ثبت دامنه شما و اشاره آنها به IP ها 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 را فعال و غیرفعال کنید ، بنابراین به مشتریان خود اجازه می دهید ماشین های مجازی را فقط در مکان هایی که انتخاب می کنید مستقر کنند. لطفاً به خاطر داشته باشید که انتخاب مکان 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دکمه کلیک کنید تا عکس های فوری مورد نظر خود را عمومی کنید (با کلیک بر روی دکمه هنگامی که می گوید EnabledSnapshot را دوباره فعال کنید).
5. شما تمام شد

ISO

مشابه ویژگی Snapshot ، شما می توانید یک یا چند مورد از ISO بارگذاری شده سفارشی را روی حساب خود ایجاد کنید Public- به این معنی که در صورت انتخاب چنین کاری ، به مشتریان خود اجازه می دهید ماشین های مجازی جدیدی را از این ISO ها مستقر کنند. تمام ایزو های موجود در حساب شما به Disabled صورت پیش فرض در ماژول تنظیم شده اند و باید آنها را فعال کنید.

به منظور انتخاب عکس های فوری برای عمومی کردن مشتریان ، لطفاً مراحل زیر را دنبال کنید:

1. به پنل مدیریت WHMCS خود وارد شوید.
2. برو در Addons -> Vultr Module.
3. با کلیک بر روی ISO.
4. بر روی Disabledدکمه کلیک کنید تا ISO های مورد نظر خود را عمومی کنید (با کلیک بر روی دکمه هنگامی که می گوید EnabledISO را دوباره فعال می کند).
5. شما تمام شد

فرآیند سفارش

سفارش محصولات مبتنی بر Vultr در WHMCS یک فرایند سه مرحله ای است.

مرحله 1

سفارشات مشتری در WHMCS Client Area / Cart: مشتری می خواهد سفارش ماشین مجازی را سفارش دهد. از آنها خواسته می شود وارد شوند:

• نام میزبان
• رمز عبور ریشه
• NS1 و NS2

این فرم سفارش WHMCS استاندارد است و Vultr هیچ کنترلی بر روی آن ندارد. شما خوشحال هستید که الگوی فرم سفارش WHMCS خود را تغییر دهید تا هرکدام از این گزینه ها مخفی شود. لطفاً به خاطر داشته باشید که رمز عبور اصلی انتخاب شده در سفارش مورد استفاده قرار نمی گیرد زیرا API Vultr یک رمز عبور ایمن تصادفی برای هر VM تولید می کند. علاوه بر این ، اگر مشتری از Snapshot مستقر شود ، باید قبل از دستی ، رمز عبور اصلی Snapshot را بداند ، در غیر این صورت قادر به ورود به سیستم نخواهد بود.

علاوه بر این ، از مشتری خواسته می شود که آیا پشتیبان گیری خودکار ، حد فوری و نوع OS را فعال کند یا خیر.

در رابطه با OS نوع ، 4 گزینه در منوی کشویی وجود دارد که OS Typeدر فرم سفارش مشاهده می شود

1. لیستی از کلیه تصاویر سیستم عامل موجود
2. ISO
3. عکس فوری
4. کاربرد

انتخاب Applicationلیستی از تمام برنامه های موجود با یک کلیک Vultr را فعال می کند. ISO و Snapshot به مشتری امکان می دهد ISO یا Snapshot را انتخاب کند تا ماشین مجازی را از آن استفاده کند.

گام 2

سرپرست سفارش و ارائه خدمات در WHMCS را تأیید می کند (یا می توانید یک فرآیند خودکار را در گزینه محصول در WHMCS به همان شیوه محصولات دیگر در WHMCS انتخاب کنید.

مرحله 3

مشتری می بایست با انتخاب یک Lable / Nickname برای سرور ، نام میزبان و گزینه های دیگر مانند SSH Key ، IPv6 ، شبکه خصوصی یا اسکریپت راه اندازی ، مراحل سفارش را در منطقه مشتری نهایی کند.

سؤالات متداول

خطایی درباره خرابی اتصال دریافت کردم.

اطمینان حاصل کنید که کلید API شما با هر فضای سفید پیشوند یا پسوند نیست و آدرس های IPv4 و IPv6 سرور شما برای دسترسی API در لیست سفید قرار گرفته اند. می توانید قوانین API خود را در قسمت اعضا تأیید کنید .

در صورت درست بودن قوانین و کلیدهای ACL ، می توانید با وارد شدن به سرور WHMCS و اجرای تماسهای مستقیم API با استفاده از cURL ، کلید خود را آزمایش کنید. نمونه های cURL در بخش مثال API ما ارائه شده است .

چگونه می توانم یک اسکریپت راه اندازی استاندارد را از طریق سیستم راه اندازی خودکار مشخص کنم؟

همانطور که گفته شد انتظار می رود مشتری پس از اینکه گزینه های خود را به دلخواه خود تنظیم کرده است ، استقرار دستگاه مجازی را در منطقه مشتری نهایی کند. لطفا در نظر داشته باشید که بسته به در دسترس بودن برنامه انتخاب شده در سراسر مکانهای ابری Vultr ، لیست مکان به صورت پویا پر جمعیت می شود - به مرحله سوم مراجعه کنید. در حال حاضر تابعی برای تنظیم اسکریپت راه اندازی جهانی وجود ندارد.

چگونه می توان برنامه ها را در گزینه های پیکربندی به روز کرد؟

اگر می خواهید تمام برنامه های موجود را لیست کنید ، می توانید از این دستور API استفاده کرده و برنامه های مورد نظر خود را در گزینه های تنظیم شده اضافه کنید. هماهنگ سازی خودکار در ماژول وجود ندارد.