راسلنا عبر واتساب تواصل سريع معنا من خلال واتساب.

قاعدة المعرفة

كيفية تشغيل تطبيق Node.js على استضافة cPanel

لتشغيل تطبيق Node.js على استضافة cPanel، اتبع الخطوات التالية:

الخطوة الأولى: رفع ملفات التطبيق

  1. سجل الدخول إلى لوحة cPanel، ثم افتح File Manager.
  2. انتقل إلى المسار الرئيسي لحساب الاستضافة خارج مجلد public_html، ثم أنشئ مجلدًا باسم مناسب لتطبيقك، مثل app.
  3. افتح المجلد وارفع داخله جميع ملفات ومجلدات التطبيق، بما في ذلك ملف package.json وملف التشغيل الرئيسي.
ملاحظة: إذا رفعت التطبيق بصيغة ملف مضغوط، قم بفك ضغطه داخل المجلد، وتأكد من وجود ملفات التطبيق مباشرة داخله وليس ضمن مجلد إضافي.

رفع ملفات تطبيق Node.js داخل مجلد مستقل في cPanel

الخطوة الثانية: إنشاء تطبيق Node.js

  1. ارجع إلى الصفحة الرئيسية في لوحة cPanel، ثم من قسم Software اضغط على Setup Node.js App.

خيار Setup Node.js App داخل لوحة cPanel

  1. اضغط على Create Application.
  2. اضبط إعدادات التطبيق كما يلي:
    • Node.js version: اختر إصدار Node.js المتوافق مع تطبيقك.
    • Application mode: اختر Production.
    • Application root: اكتب اسم المجلد الذي رفعت داخله التطبيق، مثل app. إذا كان المجلد داخل مسارات فرعية، اكتب مساره كاملًا مثل apps/myapp.
    • Application URL: اختر النطاق الذي تريد تشغيل التطبيق عليه.
    • Application startup file: أدخل اسم ملف التشغيل الموجود في التطبيق، سواء كان app.js أو server.js أو أي اسم آخر.
    • Passenger log file: يمكنك ترك هذا الحقل فارغًا.
    • Environment variables: أضف متغيرات البيئة التي يحتاج إليها التطبيق إن وجدت.
تحديد رابط التطبيق: اترك حقل المسار المجاور للنطاق فارغًا لتشغيل التطبيق على النطاق المحدد مباشرة، أو أدخل مسارًا مثل app لتشغيله داخل المسار /app.
  1. بعد إكمال الإعدادات، اضغط على Create.

إعدادات إنشاء تطبيق Node.js في cPanel

الخطوة الثالثة: تثبيت حزم التطبيق

  1. بعد إنشاء التطبيق، اضغط على Run NPM Install لتثبيت الحزم الموجودة في ملف package.json.
  2. انتظر حتى تظهر رسالة NPM Install completed successfully.

الخطوة الرابعة: تشغيل التطبيق

  1. بعد اكتمال تثبيت الحزم، اضغط على Restart.
  2. إذا كانت حالة التطبيق stopped، اضغط على Start لتشغيله.

عند ظهور الحالة started، فهذا يعني أن التطبيق يعمل على الرابط المحدد. ويمكن فتحه من الرابط الظاهر في خانة App URI.

تطبيق Node.js يعمل بحالة Started في cPanel

معلومات مهمة

إدارة التطبيق:
  • بعد تعديل ملفات التطبيق أو متغيرات البيئة، اضغط على Restart لتطبيق التغييرات.
  • عند إضافة حزم جديدة أو تعديل الحزم في ملف package.json، شغّل Run NPM Install مرة أخرى، ثم أعد تشغيل التطبيق.
  • لا حاجة إلى رفع مجلد node_modules، حيث يتم تثبيت الحزم من خلال Run NPM Install.
  • لا يحتاج التطبيق إلى إبقاء جلسة Terminal مفتوحة أو تشغيله باستخدام PM2، حيث تتم إدارته من خلال Setup Node.js App.
إذا لم يعمل التطبيق:
  • تأكد من أن قيمة Application root مطابقة لمسار مجلد التطبيق.
  • تأكد من كتابة اسم ملف التشغيل الصحيح في Application startup file.
  • تحقق من وجود ملف package.json داخل مجلد التطبيق، ومن اكتمال Run NPM Install دون أخطاء.
  • تأكد من اختيار إصدار Node.js المتوافق مع التطبيق.
  • راجع ملف Passenger log إذا قمت بتحديده لمعرفة سبب الخطأ.
هل كانت هذه الإجابة مفيدة؟