إعداد تطبيق Node.js

شغّل تطبيق Node.js على حساب استضافتك. ينطبق على الاستضافة المشتركة والموزِّعة والمميّزة حيث يتوفّر محدّد Node.js.

قبل أن تبدأ

• ملفات تطبيقك مرفوعة، خارج public_html. فـ cPanel يقدّم التطبيق عبر وكيل، فلا ينبغي أن يكون مصدره قابلًا للتنزيل مباشرة.
• ملف package.json في جذر التطبيق.
• اسم نقطة الدخول — وشائعًا app.js أو server.js.

أنشئ التطبيق

1. في cPanel، افتح Setup Node.js App ضمن Software.

2. اختر Create Application.

3. املأ:

   الحقل	القيمة
   إصدار Node.js	الإصدار الذي يحتاجه تطبيقك
   وضع التطبيق	Production
   جذر التطبيق	حيث ملفاتك، مثل nodeapp
   رابط التطبيق	النطاق أو النطاق الفرعي الذي يقدّمه
   ملف بدء التطبيق	نقطة الدخول لديك

4. اختر Create.

وينشئ cPanel بيئة افتراضية ويشغّل التطبيق.

ثبّت الاعتماديات

استخدم زر Run NPM Install في صفحة التطبيق. فهو يقرأ package.json ويثبّت في بيئة التطبيق الخاصة.

ولأي شيء أكثر، اعمل داخل البيئة الافتراضية — راجع الدخول إلى البيئة الافتراضية. فتشغيل npm من جلسة SSH عادية يستخدم Node الخطأ ويثبّت في المكان الخطأ.

متغيّرات البيئة

أضفها في صفحة التطبيق بدل إيداع ملف .env. فكل ما في جذر تطبيقك قد يكون قابلًا للقراءة إن أُسيء ضبط الجذر يومًا، والقيم المضبوطة هنا محفوظة خارجه.

أعد التشغيل بعد التغييرات

تأكّد أنه نجح

زر رابط التطبيق. فإن لم يستجب، تعرض صفحة التطبيق الحالة ومخرجات السجل الأخيرة — ابدأ من هناك.

المشكلات الشائعة

• 502 Bad Gateway — التطبيق لا يعمل أو انهار عند البدء. راجع السجل في صفحة التطبيق.
• المنفذ خاطئ. اربط بـ process.env.PORT، لا برقم مكتوب صراحة. فـ cPanel يسند المنفذ.
• الوحدات غير موجودة — فقد ثُبّتت الاعتماديات خارج البيئة الافتراضية. استخدم Run NPM Install، أو ثبّت من داخل البيئة.
• يعمل ثم يتوقف — قد يتجاوز التطبيق حدود الحساب. راجع شرح CloudLinux وحدود LVE.

اقرأ أيضًا

• الدخول إلى البيئة الافتراضية
• الاتصال عبر SSH