دليل
الخطوات الأولى
هذه الصفحة أقصر مسار من ملحق فارغ إلى ضيف يمكن طلبه. وهي موجهة للمشغّل الذي يُعدّ المزرعة لأول مرة. نفّذ الخطوات بالترتيب. القوائم اللاحقة تقرأ البيانات المحفوظة هنا.
1. ربط العنقود
القائمة: Addons → Proxmox Suite → Nodes → Clusters List → Add new
أدخل Name وAPI URL (مضيف API في Proxmox، والمنفذ المعتاد 8006) وAPI token. اترك Active مفعّلاً. اترك Verify SSL مفعّلاً إلا إذا كانت العقدة تستخدم شهادة قررت عدم الوثوق بها.


اضغط Save، ثم Health على الصف. فشل فحص الصحة يعني أن الرابط أو الرمز أو إعداد TLS غير صحيح. أصلح ذلك قبل أي شيء آخر. مرجع الحقول: Clusters List.
2. تحديث الفهرس وتأكيد العقد
افتح Configuration → Cron Scheduler واضغط Run now على Farm catalog cache (أو Run all now). ثم افتح Nodes → Nodes List وتأكد أن العقد متصلة.

القائمة الفارغة تعني أنه لا يوجد عنقود Active، أو أن الرمز لا يستطيع سرد العقد، أو أن مهمة الفهرس لم تعمل. العناقيد غير النشطة تُتخطى.
3. إضافة مساحة IP
Resource → Network → IPv4 Addresses → + New IP Addresses. استخدم التخصيص الحقيقي: CIDR للشبكة أو العنوان الأول والأخير، مع البوابة التي يجب أن يستخدمها الضيوف.

أضف IPv6 Addresses أو IPv6 Subnets فقط عندما تبيعها خطة. يمكنك ربط المجمّع الجديد بسياسة في الخطوة التالية.
4. إنشاء سياسة توزيع
Nodes → Policy → Policy Manager → Add new. اختر العنقود وقاعدة موازنة الحمل ومجمّعات IP من الخطوة 3، والتخزين والجسر الافتراضيين لـ KVM أو LXC.

إذا لم تُظهر قوائم التخزين والجسر إلا شرطة طويلة، ففهرس الكتالوج فارغ. أعد الخطوة 2. مرجع الحقول: Policy Manager.
5. استيراد القوالب أو صور ISO
Resource → Templates Center → KVM Templates أو LXC Templates أو ISO Images. اختر العنقود واضغط Import، أو استخدم Add new / + Create لتسجيل وحدة تخزين يدوياً.

اختياري: أنشئ عائلة نظام تشغيل ومجموعة حتى تعرض صفحة إعادة التثبيت لدى العميل بطاقة واحدة لكل عائلة.
6. تعريف حزمة ومنتج WHMCS
Products → VM Plan → VM Plan → Add new. اضبط Name وGuest type وPolicy والمعالج والذاكرة والقرص ووسائط نظام التشغيل. اترك Active مفعّلاً. اضغط Save.

ثم حرّر منتج WHMCS: Module Name بقيمة Proxmox Suite، وGuest Type مطابقاً للحزمة، وHardware Package على هذه الحزمة. سياسة الحزمة تتقدّم على سياسة المنتج عندما تكون الاثنتان مضبوطتين.
مرجع الحقول: VM Plan.
7. إبقاء cron مثبّتاً
Run now اليدوي في الخطوة 2 لا يغني عن crontab. ثبّت الأسطر الموصى بها، وتأكد لاحقاً من التشغيل على Cron Scheduler.

ضع طلباً تجريبياً. يجب أن يترك Operations → Task History المهمة ناجحة، وأن تعرض VM List → VMs List الضيف مربوطاً.
الخطوة التالية
استخدم قائمة التحقق بعد التثبيت قائمة اعتماد.