تثبيت CloudPanel على VPS لينكس (Ubuntu/Debian)

لوحة CloudPanel لوحة تحكم مجانية وخفيفة تدير Nginx وPHP-FPM وقواعد البيانات وشهادات SSL من واجهة ويب. عند تثبيتها على VPS لينكس من Infrawire تحوّل الخادم الفارغ إلى منصة استضافة لعدة مواقع خلال دقائق. يغطي هذا الدليل Ubuntu 24.04 وDebian 12.

📋 المتطلبات

خادم VPS جديد من نوع KVM بنظام Ubuntu 24.04 أو Debian 12 دون أي برامج أخرى مثبتة (لا Apache ولا Nginx ولا MySQL ولا لوحة أخرى).
ذاكرة 2 غيغابايت على الأقل ووصول SSH بصلاحية root. ستجد عنوان IP وكلمة مرور root الخاصة بالـ VPS في منطقة العميل.
اسم نطاق يشير سجل DNS من نوع A (وAAAA إذا كنت تستخدم IPv6) فيه إلى VPS_IP.
المنافذ 22 و80 و443 و8443 متاحة من الإنترنت.

🔄 1. تجهيز النظام

اتصل بصفتك root وحدّث الحزم. تحتاج CloudPanel إلى curl وwget وsudo.

Bash
1ssh root@VPS_IP
2apt update && apt -y upgrade && apt -y install curl wget sudo

إذا تم تحديث النواة فأعد التشغيل بالأمر reboot ثم اتصل من جديد قبل المتابعة.

⬇️ 2. تشغيل المثبّت الرسمي

يُنزَّل المثبّت أولاً ثم يُتحقَّق من مجموع التحقق SHA-256 الخاص به قبل تشغيله. يتغير هذا المجموع مع كل إصدار من المثبّت: انسخ القيمة الحالية وقائمة محركات قواعد البيانات المحدّثة من الصفحة الرسمية https://www.cloudpanel.io/docs/v2/getting-started/other/ (استبدل SHA256_FROM_DOCS أدناه).

Bash
1curl -sS https://installer.cloudpanel.io/ce/v2/install.sh -o install.sh
2echo "SHA256_FROM_DOCS install.sh" | sha256sum -c
3sudo CLOUD_PANEL_DB_ENGINE=MARIADB_11.4 bash install.sh

يحدد المتغير CLOUD_PANEL_DB_ENGINE خادم قاعدة البيانات. القيم الموثّقة هي MYSQL_8.4 وMYSQL_8.0 وMARIADB_11.4 وMARIADB_10.11. إذا حذفته يستخدم المثبّت قيمته الافتراضية. يجب أن يعرض الأمر sha256sum -c العبارة install.sh: OK؛ وإذا عرض FAILED فتوقف ونزّل الملف من جديد. يستغرق التثبيت بضع دقائق.

🔑 3. إنشاء أول حساب مدير

افتح https://VPS_IP:8443 في المتصفح. الشهادة موقّعة ذاتياً، لذلك سيعرض المتصفح تحذيراً: اقبله لتسجيل الدخول الأول.

أول زائر هو من ينشئ المدير، لذا افعل ذلك فوراً. أدخل اسم المستخدم والبريد الإلكتروني وكلمة مرور طويلة ثم سجّل الدخول. لا تترك اللوحة مكشوفة لساعات قبل إنشاء الحساب.

🌐 4. إضافة موقع PHP

في اللوحة انقر على Sites ثم Add Site ثم Create a PHP Site. اختر قالب تطبيق (Generic أو WordPress أو Laravel وغيرها)، واكتب example.com كنطاق، واختر إصدار PHP، وحدّد مستخدم الموقع وكلمة مروره. تنشئ CloudPanel ملف vhost لـ Nginx ومجمّع PHP-FPM ومستخدم نظام مخصصاً للموقع.

ارفع ملفاتك عبر SFTP باستخدام مستخدم الموقع (وليس root) إلى /home/USER/htdocs/example.com. يمكنك أيضاً إنشاء قاعدة بيانات للموقع من Databases.

🔒 5. إصدار شهادة Let's Encrypt

تأكد من أن example.com يشير بالفعل إلى VPS_IP:

Bash
1dig +short example.com

ثم افتح الموقع وانتقل إلى تبويب SSL/TLS وانقر على Actions واختر New Let's Encrypt Certificate. حدّد أسماء النطاقات المطلوبة وأكّد. تتولى CloudPanel التجديد تلقائياً.

🛡️ 6. تأمين اللوحة

في Admin Area > Security > Firewall اقصر المنفذ 8443 على عنوان IP الخاص بك واحذف القاعدة التي تسمح به من أي مكان. أبقِ 22 و80 و443 مفتوحة حسب حاجتك.
في Admin Area > Security فعّل Basic Auth للوحة كحاجز ثانٍ.
فعّل المصادقة الثنائية في ملفك الشخصي.
استخدم كلمة مرور طويلة وفريدة وأبقِ النظام محدّثاً:

Bash
1apt update && apt -y upgrade

✅ 7. التحقق من التثبيت

Bash
1ss -tlnp | grep -E ':(80|443|8443)\b'
2systemctl is-active nginx clp-agent
3curl -I https://example.com

يجب أن تكون المنافذ 80 و443 و8443 في وضع الاستماع، وأن تُرجع الخدمتان active، وأن يُرجع الأمر الأخير HTTP 200 أو إعادة توجيه مع شهادة صالحة.

🧰 استكشاف الأخطاء

يرفض المثبّت العمل أو يفشل في المنتصف: يجب تثبيت CloudPanel على نظام نظيف. إذا كان هناك خادم ويب أو قاعدة بيانات أخرى، فأعد تثبيت نظام التشغيل من منطقة العميل وابدأ من جديد.
المنفذ 8443 لا يستجيب: تحقق من أن جدار الحماية (قواعد اللوحة وأي جدار حماية آخر) يسمح به، ومن أن عنوان IP الخاص بك لم يُحذف من القائمة المسموح بها. شغّل ss -tlnp | grep 8443 على الخادم.
فشل Let's Encrypt: النطاق لا يشير إلى الـ VPS بعد، أو أن وكيلاً يخفي عنوان IP الحقيقي. صحّح سجل DNS وانتظر الانتشار وأعد المحاولة. يجب أن يكون المنفذ 80 مفتوحاً.
نسيان كلمة مرور المدير: أعد تعيينها من الطرفية بالأمر clpctl user:reset:password --userName='admin' --password='NEW_PASSWORD'.

🎉 CloudPanel يعمل الآن: أضف مواقعك، وأمّن المنفذ 8443، واستمتع ببيئة استضافة نظيفة على الـ VPS الخاص بك.