المستندات / تثبيت Nimbopanel

تثبيت Nimbopanel

المتطلبات

يُثبَّت Nimbopanel على خادم Linux جديد تتحكم فيه (خادم VPS أو جهاز مخصّص) — لا على استضافة مشتركة. تحتاج:

  • خادمًا مُجهَّزًا حديثًا بمعمارية x86_64/arm64 (64-bit) يشغّل نظام تشغيل مدعومًا:

    • Ubuntu 22.04 LTS أو 24.04 LTS — مُختبَر من طرف إلى طرف، وهو ما نشغّله نحن أنفسنا.
    • Debian 12 — مُختبَر من طرف إلى طرف.
    • AlmaLinux 8 و9 و10 — مُختبَر من طرف إلى طرف.
    • Rocky Linux 9 — مُختبَر من طرف إلى طرف. RHEL 9 من العائلة نفسها ويُتوقّع أن يتصرّف بشكل مماثل.
    • CloudLinux 9 — مُختبَر من طرف إلى طرف، مع احترام حدود موارد LVE لكل حساب حيثما توفّرها نواة CloudLinux.
    • معمارية ARM ‏(aarch64) غير مدعومة بعد.

    لا يوقفك المُثبِّت على تركيبة غير مُختبَرة — يحذّر ويتابع.

  • وصول root (أو sudo).

  • نطاقًا أو نطاقًا فرعيًا يشير إلى عنوان IP الخادم للوحة (مثل panel.yourdomain.com).

  • ذاكرة RAM لا تقل عن 1 غيغابايت لمضيف صغير؛ أكثر مع إضافة حسابات.

التثبيت بسطر واحد

سجّل الدخول إلى حسابك، افتح لوحة المعلومات، وانسخ أمر التثبيت المعروض هناك — فهو يحتوي بالفعل على مفتاح ترخيصك:

curl -fsSL https://nimbopanel.com/install.sh | sudo bash -s -- --license NIMB-XXXX-XXXX-XXXX-XXXX

الأمر الدقيق الجاهز للتشغيل بمفتاحك الخاص معروض على لوحة المعلومات وعلى التنزيلات بعد تسجيل الدخول. انسخه من هناك بدلًا من كتابة هذا — فهو يحمل المفتاح الصحيح لحسابك.

يفتح المُثبِّت معالج إعداد قصيرًا في المتصفح (يطبع رابطًا وينتظر)، حيث تؤكّد ترخيصك، وتنشئ حساب المسؤول، وتسمّي اسم مضيف اللوحة. هذا هو المسار الطبيعي ويعمل سواء مرّرت --wizard أم لا؛ المفتاح على سطر الأوامر يملأ الحقل مسبقًا فقط.

ثم يُعدّ لوحة التحكم، وخادم الويب، وPHP، وحزمة البريد، وDNS، وخدمات قاعدة البيانات، وينتهي بطباعة عنوان URL للوحة وبيانات دخول المسؤول. يُسجَّل المرور بأكمله في /var/log/nimbopanel-install.log.

لا مفتاح بعد؟ اترك --license. يُثبَّت الخادم ويعمل على استحقاقات Free — موقع واحد، دون نطاقات إضافية — ويمكنك إدخال مفتاح من اللوحة لاحقًا.

قبل التثبيت (إن كان لديك نطاق)

للحصول على HTTPS تلقائيًا أثناء التثبيت، افعل هذا أولًا:

  1. أنشئ سجل A لاسم مضيف لوحتك (مثل panel.yourdomain.com) يشير إلى عنوان IP خادمك — إضافة إلى سجلات ns1 وns2 وmail إن كنت ستستضيف DNS/البريد.
  2. في جدار الحماية السحابي لديك (DigitalOcean أو Vultr أو AWS، …)، افتح المنفذين 80 و443.

لا نطاق بعد؟ يمكنك التثبيت على عنوان IP المجرّد للخادم وإضافة نطاق + HTTPS لاحقًا.

هل أعطيت خادمك بالفعل اسمًا (hostname) يشير إليه، مثل srv1.yourdomain.com؟ يلاحظ المعالج ذلك ويقترحه كعنوان للوحة — دون أي خطوة DNS على الإطلاق.

بعد التثبيت

  1. افتح عنوان URL للوحة وسجّل الدخول ببيانات اعتماد المسؤول المعروضة في نهاية التثبيت.
  2. HTTPS تلقائي. إن كان DNS لاسم مضيف لوحتك يشير بالفعل إلى الخادم، يُصدِر المُثبِّت شهادة Let's Encrypt حقيقية لك — يؤكّد ذلك الملخص النهائي. إن لم يكن النطاق يشير بعد، تبقى اللوحة على http:// ويُفعَّل HTTPS من تلقاء نفسه خلال ~5 دقائق بمجرد توجيهك DNS. لفرضه فورًا، ادخل بـ SSH كـ root وشغّل sudo nimbopanel-enable-https.
  3. أنشئ أول حساب استضافة لك، أو استورد حساب cPanel موجودًا — راجع الترحيل من cPanel. كل نطاق استضافة تضيفه يحصل على شهادة Let's Encrypt مجانية خاصة به تلقائيًا بمجرد أن يشير إلى الخادم.

ما الذي يختلف على عائلة RHEL

يشغّل AlmaLinux و Rocky و CloudLinux و RHEL اللوحة نفسها ومجموعة الميزات نفسها، مع ثلاثة مكوّنات مُجمَّعة لا يُعدّها المُثبِّت هناك:

  • phpMyAdmin وبريد الويب Roundcube لـ Debian/Ubuntu فقط. تخفي لوحات عملائك البلاطتين تلقائيًا على خادم لا يملكهما، فلا يُرسَل أحد إلى صفحة غير موجودة — لكن إن كان أيّهما يهمّك، فاختر Debian أو Ubuntu.
  • rspamd لترشيح البريد المزعج غير مثبّت على عائلة RHEL. يوقّع مستودعه الحزم بمفتاح يرفضه RHEL 9، وتثبيت خدمة جذر من مستودع غير موثَّق ليس مقايضة تستحق العناء.

كل شيء آخر — البريد وDNS وقواعد البيانات وPHP والنسخ الاحتياطية وSSL — هو نفسه على العائلتين.

الترخيص والتحمّل دون اتصال

يتواصل خادمك مع خادم الترخيص من حين لآخر. إن لم يستطع الوصول إلى خادم الترخيص — انقطاع، أو خلل شبكة — تبقى استضافتك عاملة. Nimbopanel مصمَّم عمدًا ألّا يكون "fail-closed" أبدًا. راجع كيف يعمل الترخيص للتفاصيل.

التحديث

تُشحَن التحديثات كإصدار جديد. شغّل المُثبِّت نفسه مجددًا (أو المُحدِّث المدمج) للانتقال إلى أحدث إصدار؛ تُحفَظ حساباتك وبياناتك.