ابدأ الآن
كل المقالاتدروس · 7 دقائق قراءة

انشر تطبيق Node.js على استضافة Rivervo (Next.js وNuxt).

RT
Rivervo Team · Rivervo
·
April 29, 2026
·
آخر تحديث November 13, 2026
Node
ON SHARED HOSTING

يظن كثيرون أن تطبيقات Node.js لا بد أن تعمل على VPS، وهذا غير صحيح. ففي كل باقة استضافة مشتركة من Rivervo يوجد قسم Node.js وPython في قائمة الموقع، وهو يشغّل عملية Phusion Passenger لتطبيقك خلف واجهة Apache نفسها التي تخدم مواقعك الأخرى.

يشرح هذا الدليل العملية كاملة لأكثر إطارين شيوعًا: Next.js وNuxt 3. النتيجة النهائية: تطبيقك على https://nitaquk.sa (أو أي نطاق فرعي)، يعمل بعملية Node.js حقيقية، ويستمر بعد إعادة التشغيل، ويمكن إعادة تشغيله بنقرة واحدة.

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

ما تحتاجه قبل البدء

  • باقة استضافة من Rivervo (أي مستوى، فتطبيقات Node.js تعمل على كل الباقات)
  • Node.js الإصدار 20 أو أحدث على جهازك لبناء التطبيق
  • نسخة التطبيق المبنية جاهزة للرفع (سنشرح ذلك لكل إطار)
  • وصول إلى مدير الملفات أو SFTP في حسابك (كلاهما يعمل)

لا تحتاج إلى صلاحيات root أو sudo أو systemd أو إعداد خادم وكيل عكسي، فـ Passenger يتولى كل ذلك.

الخطوة 1: ابنِ تطبيقك محليًا

سترفع تطبيقًا مبنيًا، لا الشيفرة المصدرية. تثبّت لوحة التحكم الاعتماديات، لكنها لا تُصرّف React ولا تشغّل بناء Vite، فافعل ذلك على جهازك أولًا.

Next.js:

npm ci
npm run build

ينتج عن ذلك المجلد .next/ (المخرجات المبنية). لا تشغّل next start هنا، فسنشغّله من ملف التشغيل بعد قليل.

Nuxt 3:

npm ci
npm run build

ينتج عن ذلك المجلد .output/ (مجلد البناء الشامل في Nuxt). الأمر نفسه: لا تشغّل شيئًا بعد.

الخطوة 2: ارفع الملفات الصحيحة

لا تحتاج إلى رفع node_modules/، فلوحة التحكم تثبّت الاعتماديات نيابةً عنك. ولا تحتاج أيضًا إلى git أو ذاكرة البناء المؤقتة.

ارفع الملفات إلى حسابك، ويُفضّل إلى مسار خارج public_html (مثل /home/<account>/myapp/). لماذا خارجه؟ لأن Passenger يربط public_html بجذر الرابط تلقائيًا، ووضع شيفرة تطبيقك فيه يجعلها مكشوفة.

الإطارارفع هذهتجاوز
Next.js.next/، public/، package.json، package-lock.json، next.config.js، وملفك server.cjs (أدناه)node_modules/، .git/، .env.local
Nuxt 3.output/، package.json، package-lock.json، وملفك server.cjs (أدناه)node_modules/، .nuxt/، .git/، ومجلدا المصدر pages/ وcomponents/

طريقتان لنقل الملفات:

  • الموقع ← الملفات ← ارفع ملف zip ← فك ضغطه هي الأسهل إذا كان اتصالك غير مستقر.
  • SFTP (FileZilla أو Cyberduck أو rsync) أسرع لعمليات النشر المتكررة. تجد الخادم والمنفذ واسم المستخدم وكلمة المرور في الموقع ← SSH وSFTP.

الخطوة 3: أضف ملف التشغيل

هذا هو الملف الذي ينفذه Passenger عند وصول طلب. ضعه بجانب package.json في مجلد تطبيقك.

لـ Next.js: server.cjs

const next = require('next')
const http = require('http')
 
const port = process.env.PORT || 3000
const dev = process.env.NODE_ENV !== 'production'
const app = next({ dev, dir: __dirname })
const handle = app.getRequestHandler()
 
app.prepare().then(() => {
  http.createServer((req, res) => handle(req, res)).listen(port, () => {
    console.log(`Next.js server listening on port ${port}`)
  })
})

ما يفعله:

  • يحمّل Next ويوجّهه إلى المجلد الحالي (حيث يوجد .next/ وpackage.json).
  • ينشئ معالج طلبات من الموجّه الداخلي في Next.
  • يشغّل خادم HTTP على المنفذ الذي يحدده Passenger (process.env.PORT).
  • يستخدم المنفذ 3000 احتياطيًا للاختبار المحلي.

تُستنتج قيمة dev تلقائيًا من NODE_ENV: اضبط وضع Production في لوحة التحكم (سنفعل ذلك في الخطوة 4) وسيعمل Next في وضع الإنتاج.

لـ Nuxt 3: server.cjs

import('./.output/server/index.mjs').then(({ createApp }) => {
  createApp().then(({ app }) => {
    const port = process.env.PORT || 3000
    app.listen(port, () => {
      console.log(`Nuxt server listening on port ${port}`)
    })
  })
})

ما يفعله:

  • يستورد ديناميكيًا ملف Nuxt ‏.output/server/index.mjs (نقطة الدخول الناتجة عن npm run build).
  • يستخدم createApp() لإنشاء نسخة خادم H3.
  • يستمع على المنفذ الذي يحدده Passenger.

الاستيراد الديناميكي import() مقصود: وحدات .mjs لا يمكن تحميلها بـ require()، لكن ملف .cjs يستطيع استيرادها ديناميكيًا. وهذا أنظف نمط يعمل داخل مشغّل Passenger.

الخطوة 4: أنشئ التطبيق في لوحة التحكم

افتح مشروعك ← الموقع ← Node.js وPython ← تطبيق Node.js.

الحقلالقيمة
الإصدار20 أو أحدث
الوضعProduction
المجلدmyapp في مجلدك الرئيسي (حيث رفعت الملفات)
العنوانnitaquk.sa (أو نطاق فرعي مثل app.nitaquk.sa)
ملف التشغيلserver.cjs

انقر إنشاء. تُنشأ بيئة Node.js في ~/nodevenv/myapp/20/.

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

بعد إنشاء التطبيق، انقر تثبيت الاعتماديات (npm install) عليه وراقب المخرجات. إذا فشل التثبيت:

  • تأكد من أن package.json موجود في جذر التطبيق (وليس داخل مجلد فرعي).
  • في Next.js: تأكد من أن next ضمن dependencies وليس devDependencies (تثبيت الإنتاج يتجاوز اعتماديات التطوير).
  • في Nuxt: يجب أن تكون nuxt نفسها اعتمادية عادية أيضًا.

أضف متغيرات البيئة

الإعدادات الخاصة بالتطبيق ← متغيرات البيئة ← إضافة متغير. يضبط وضع Production القيمة NODE_ENV=production مسبقًا.

إذا كان تطبيق Next.js يقرأ قيمًا أثناء التشغيل (روابط قواعد البيانات، مفاتيح API)، فأضفها هنا. لا ترفع ملف .env يحتوي على أسرار، فمتغيرات بيئة التطبيق هي المكان الصحيح لها.

حفظ الإعدادات يعيد تشغيل التطبيق، فتُطبّق المتغيرات الجديدة فورًا.

الخطوة 5: تحقق

افتح رابط تطبيقك، ويجب أن ترى التطبيق.

إذا ظهرت صفحة خطأ من Passenger، فوسّعها وانظر إلى أسفلها، ففيها غالبًا تتبع واضح للخطأ. أكثر خطأين شيوعًا:

Error: Cannot find module 'next': لم يُشغَّل npm install، أو شُغّل في المجلد الخطأ. انقر تثبيت الاعتماديات (npm install) مرة أخرى.

Error: ENOENT: no such file or directory, open '.next/...': رفعت الشيفرة المصدرية دون مجلد .next/ المبني. ابنِ التطبيق محليًا وأعد الرفع.

كيف تنشر التحديثات

كرر الخطوتين 1 و2، ثم انقر إعادة تشغيل على التطبيق. بالتفصيل:

1. Build locally    npm run build
2. Upload          .next/ or .output/, plus any changed source/config
3. Panel          Restart the app

إذا غيّرت package.json، فانقر تثبيت الاعتماديات (npm install) قبل إعادة التشغيل. تفضّل سطر الأوامر؟ الموقع ← الطرفية: تعرض بطاقة التطبيق الأمر اللازم للدخول إلى بيئته.

مشكلات شائعة

WebSockets: يتعامل Passenger مع HTTP/1.1 وHTTP/2. ترقية WebSocket تعمل مع المسارات المدمجة في Next.js وNuxt. وإذا كنت تستخدم خادم WebSocket منفصلًا (ws أو socket.io)، فهو يشارك المنفذ نفسه ويبدأ عبر server.cjs نفسه، دون إعداد إضافي.

رفع الملفات / حدود body-parser في next.config.js: الحد الافتراضي لحجم الطلب في Passenger هو 10 MB. إذا كنت ترفع ملفات كبيرة، فارفع قيمة passenger_max_request_size عبر .htaccess في public_html:

PassengerMaxRequestSize 52428800

(50 MB بالبايت.)

مهام Cron: إذا كان تطبيقك يحتاج إلى مهام في الخلفية (إرسال نشرات بريدية، تصديرات مجدولة)، فلا تشغّلها داخل عملية الويب. استخدم الموقع ← مهام Cron لتشغيل سكربت Node مباشرة:

/home/<account>/nodevenv/myapp/20/bin/node /home/<account>/myapp/scripts/send-newsletter.js

ذاكرة العملية: يعيد Passenger تشغيل تطبيقك إذا تجاوز حد الذاكرة RAM للحساب (يعتمد على باقتك). تطبيق Next.js أو Nuxt المعتاد يستهلك أقل من 100 MB في وضع الخمول. إذا كنت تصل إلى الحدود، فحلّل الاستهلاك باستخدام process.memoryUsage() وابحث عن تسربات الذاكرة قبل أن تفترض أنك تحتاج إلى باقة أكبر.

النطاقات المخصصة وHTTPS: العنوان الذي تحدده للتطبيق هو ما يرتبط به Passenger. شهادة SSL تلقائية، دون أي إعداد إضافي. لاستخدام نطاق آخر أو نطاق فرعي، أضفه أولًا في الموقع ← النطاقات، ثم اختره عنوانًا للتطبيق.

إصدار Node: تعرض قائمة الإصدار كل الإصدارات المثبتة، ويمكنك تغييره من إعدادات التطبيق.

متى لا تستخدم الاستضافة المشتركة لـ Node

بصراحة: Node.js على الاستضافة المشتركة ممتاز لمواقع الأعمال الشخصية والمدونات والصفحات التسويقية وواجهات تطبيقات SaaS الصغيرة والأدوات الداخلية. لكنه يواجه صعوبة مع:

  • واجهات API عالية الإنتاجية (أكثر من 50 طلبًا في الثانية بشكل مستمر)، إذ ستشعر بحد المعالج للحساب
  • التطبيقات المعتمدة بكثافة على WebSocket مع آلاف الاتصالات المتزامنة
  • التطبيقات التي تنشئ عمليات عاملة (عمّال الطوابير، أدوات الزحف)، فحد العمليات لكل حساب في Passenger يجعل ذلك صعبًا
  • أي شيء يحتاج إلى systemd أو Docker أو صلاحيات root

لهذه الحالات، خادم VPS لدينا هو الخيار الصحيح: صلاحيات root كاملة ونواة خاصة بك، ويشغّل ما تريد. لكن لمعظم تطبيقات Next.js وNuxt التي لا تستقبل زيارات ضخمة، هذا الدليل هو كل ما تحتاجه.

الخلاصة

  1. npm run build محليًا
  2. ارفع .next/ (Next) أو .output/ (Nuxt) + package.json + server.cjs
  3. الموقع ← Node.js وPython ← تطبيق Node.js ← المجلد، وملف التشغيل server.cjs، والوضع Production
  4. تثبيت الاعتماديات (npm install)، ثم إعادة تشغيل

إذا لم يعمل شيء كما يجب، فافتح تذكرة والصق صفحة خطأ Passenger، وسنحدد لك السطر المسبب.

— فريق Rivervo