تخطّ إلى المحتوى

التثبيت

تثبيت Proxmox Suite

التثبيت 3 دقائق قراءة

تسرد هذه الصفحة المتطلبات وترتيب التثبيت لـ Proxmox Suite. وهي موجهة للمدير الذي يضع الموديولات على مضيف WHMCS.

المتطلبات

  • WHMCS 8.13 أو أحدث
  • PHP 8.2 أو أحدث
  • ionCube Loader 13 أو أحدث للإصدار المرمّز
  • رمز API لـ Proxmox VE يستطيع إدارة الضيوف على العقد التي تبيعها
  • مفتاح ترخيص (PS-…) وملف srvprox.lic للأشجار المرمّزة

Note

قد تكون أشجار التطوير PHP عادية ومرتبطة رمزياً من ServBay. أشجار الإنتاج مرمّزة. صفحة ملحق فارغة تذكر ionCube مشكلة في المحمّل أو في .lic، وليست عنقوداً ناقصاً.

رفع ملفات الموديول

تُشحن Proxmox Suite في مجلدين. اسم المجلد هو المعرّف التقني SrvProxmoxSuite. الاسم الظاهر في WHMCS هو Proxmox Suite.

  1. ارفع modules/addons/SrvProxmoxSuite/ إلى modules/addons/.
  2. ارفع modules/servers/SrvProxmoxSuite/ إلى modules/servers/.
  3. في الإصدار المرمّز، ضع srvprox.lic في المجلدين معاً. ملف ترخيص على الملحق وحده لا يكفي عندما يفتح موديول الخادم صفحة منطقة العميل.

يجب أن يستطيع خادم الويب قراءة الملفات المرفوعة. يكتب الملحق السجلات تحت modules/addons/SrvProxmoxSuite/storage/logs/%60 وقفل cron تحت storage/cron.lock`، لذا يجب أن يكون مجلد التخزين قابلاً للكتابة من PHP.

تفعيل الملحق

  1. سجّل الدخول إلى WHMCS مديراً كامل الصلاحية.
  2. افتح System Settings → Addon Modules.
  3. ابحث عن Proxmox Suite واضغط Activate.
  4. اضبط Access Control على أدوار الإدارة التي يجوز لها إدارة المزرعة.
  5. افتح Addons → Proxmox Suite.

يشغّل التفعيل مثبّت المخطط ويبذر مقتطفات cloud-init المدمجة. نص النجاح: Proxmox Suite addon activated and schema installed. إلغاء التفعيل لا يحذف الجداول. كل تحميل لاحق لصفحة الملحق يشغّل المثبّت مرة أخرى، وتكرار ذلك آمن.

شاشة إعداد الملحق بلا حقول. يُدخل مفتاح الترخيص في Info، وليس تحت System Settings → Addon Modules.

يفترض أن ترى العائلات Overview وNodes وVM List وResource وMedia Manager وProducts وOperations وConfiguration وError Log. إلى أن تقبل Info ترخيصاً، تبقى العائلات الأخرى مغلقة.

ربط موديول الخادم بمنتج

  1. افتح System Settings → Products/Services.
  2. أنشئ منتجاً أو حرّر منتجاً قائماً.
  3. Module Settings → Module Name = Proxmox Suite.
  4. اضبط الخيارات الثلاثة بعد أن تتوفر سياسة وحزمة:
الخيار ماذا تختار
Distribution Policy سياسة Active من Nodes → Policy Manager
Guest Type KVM أو LXC. الافتراضي KVM.
Hardware Package حزمة Active من Products → VM Plan، أو None (module defaults)

يتقدّم حقل Policy الخاص بالحزمة على Distribution Policy الخاص بالمنتج وقت الإنشاء، عندما تكون للحزمة سياسة.

لا ينفّذ موديول الخادم Test Connection ولا List Accounts ولا تسجيل الدخول الأحادي. RequiresServer متوقف: لا تنشئ صف خادم WHMCS لـ Proxmox.

إجراء WHMCS ماذا تفعل Proxmox Suite
Create يتحقق من الترخيص، ويحل السياسة والحزمة، وقد يولّد اسم مضيف وكلمة مرور، ويكتب كلمة مرور الخدمة، ويضع مهمة تزويد في الطابور، ويشغّل تلك المهمة مرة واحدة فوراً.
Suspend يوقف الضيف المربوط.
Unsuspend يشغّل الضيف المربوط.
Terminate يتبع Configuration → General → Terminate mode (التدمير الآن، أو الإيقاف الآن ثم التدمير بعد فترة السماح).
Change Package يضع مهمة ترقية في الطابور.

Note

حقول الحزمة Suspension action وTerminate action وChange package action تُحفظ في VM Plan. لا يقرأها Suspend ولا Terminate ولا Change Package. يتبع Terminate سياسة الإنهاء العامة. يوقف Suspend الضيف دائماً.

Cron جزء من التثبيت

انسخ الأسطر من Configuration → Cron Scheduler إلى crontab النظام. نقطة دخول سطر الأوامر هي:

text
php -q /path/to/whmcs/modules/addons/SrvProxmoxSuite/cron/run.php

يستخدم AfterCronJob قفل storage/cron.lock نفسه الذي يستخدمه cron/run.php. إلى أن يعمل cron تبقى قوائم الفهرس فارغة، وتبقى مهام التزويد المتبقية معلّقة، ولا تُطلق جداول النسخ ولا تنبيهات الموارد.

التفاصيل: Cron Scheduler.

الكونسول

تتصل كونسولات المتصفح بـ Proxmox مباشرة إلا إذا فعّلت الوكيل الاختياري. التفاصيل: Console.

الخطوة التالية

تابع إلى قائمة التحقق بعد التثبيت، ثم الخطوات الأولى.