دليل
قائمة العناقيد
تسجّل هذه الصفحة اتصالات واجهة Proxmox API. وهي موجهة للمشغّل الذي يضيف رمز عنقود أو يستبدله.
القائمة: Addons → Proxmox Suite → Nodes → Clusters List

الغرض
كل صف عنقود Proxmox واحد: رابط API ورمز ومستخدم كونسول اختياري. تبقى العناقيد غير النشطة في قاعدة البيانات وتُستبعد من جرد العقد وجرد الضيوف وVM Cleaner وقوائم الفهرس.
مقدمة الصفحة: Register Proxmox clusters with API URL and token. Use Health Check to verify connectivity.
القائمة
يفتح Add new النافذة. الأعمدة: ID وName وAPI URL وActive (Yes / No) وToken set (Yes / No). القائمة الفارغة: No records yet.
| إجراء الصف | ماذا يفعل |
|---|---|
| Edit | يفتح النافذة نفسها بالصف المحفوظ. |
| Health | يستدعي Proxmox. النجاح: Cluster health check succeeded. مع إصدار Proxmox وعدد العقد المتصلة. الفشل: Cluster health check failed. مع Cluster not found. أو API token is not configured. أو خطأ API. |
| Delete | يطلب التأكيد Delete this record?، ويحذف صف العنقود، وتظهر رسالة Record deleted. |
إضافة / تعديل

Cancel يغلق النافذة. Save يرسل النموذج.
| الحقل | النوع | ماذا يفعل |
|---|---|---|
| Name | نص، مطلوب | تسمية المشغّل. الاسم أو الرابط الفارغ: Name and API URL are required. |
| API URL | رابط، مطلوب | تُحذف / الزائدة في نهاية الرابط. |
| API token | كلمة مرور | مطلوب عند الإنشاء: API token is required for new clusters. عند التعديل، ترك الحقل فارغاً يُبقي الرمز المخزّن. العنصر النائب: Leave blank to keep existing token. |
| Console username | نص، العنصر النائب root@pam |
مستخدم Proxmox لمصادقة كونسول المتصفح (PVEAuthCookie). الفراغ لا يخزّن شيئاً، وتستخدم Proxmox Suite المستخدم المستخرج من رمز API. |
| Console password | كلمة مرور | كلمة مرور مستخدم الكونسول ذلك. مطلوبة لـ noVNC وxterm: رمز API وحده لا يستطيع مصادقة ترقية WebSocket في المتصفح. ترك الحقل فارغاً عند التعديل يُبقي كلمة المرور المخزّنة. |
| Active | مفتاح، الافتراضي تشغيل | العناقيد غير النشطة تختفي من قوائم الاختيار. |
| Verify SSL | مفتاح، الافتراضي تشغيل | يتحقق من شهادة TLS في Proxmox. أوقفها فقط لمضيف مختبر بشهادة موقّعة ذاتياً. |
وميض النجاح: Changes saved successfully.
Note
Console username وConsole password للكونسول في المتصفح، وليسا لرمز API. وضع الكونسول المباشر ما زال يحتاج مستخدماً يستطيع إصدار PVEAuthCookie.
مثال
- Add new. الاسم
pve-a. رابط API بقيمةhttps://pve.example:8006. الصق الرمز. - اترك Verify SSL وActive مفعّلين. Save.
- اضغط Health. يجب أن يتضمن الوميض إصدار Proxmox.
الخطوة التالية
شغّل Farm catalog cache، ثم افتح Nodes List.