تخطي إلى المحتوى الرئيسي

سيرفر مخصص: إعداد Node.js على لينكس

تم إنشاء هذا الدليل باستخدام المنتجات التالية:

(قد تختلف التفاصيل مع المنتجات من مزودين مختلفين ولكن المفاهيم الرئيسية تظل كما هي)

مقدمة

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

نموذج "جافاسكريبت في كل مكان" يسمح للمطورين باستخدام لغة واحدة لكل من تطوير الواجهة الخلفية والواجهة الأمامية.

التحضير

قبل إعداد Node.js، تحتاج لتحضير نظامك. هذا يشمل تحديث نظام التشغيل لأحدث إصدار وتثبيت جميع التبعيات المطلوبة. هذه التحضيرات تضمن بيئة مستقرة وتساعد على تجنب المشاكل أثناء أو بعد التثبيت.

تحديث النظام

لتتأكد أن نظامك يعمل بأحدث البرامج وتحسينات الأمان، يجب دائمًا تنفيذ تحديثات النظام أولًا. لتفعل ذلك، شغّل الأمر التالي:

sudo apt update && sudo apt upgrade -y

هذا يضمن أن نظامك يحتوي على أحدث تصحيحات الأمان وإصدارات البرامج قبل المتابعة.

تثبيت التبعيات

بعد الانتهاء من التحديث، يمكنك الآن تثبيت التبعيات. سيتم نشر وتشغيل Node.js على جهازك باستخدام مجموعة من حاويات Docker. لذلك، يجب تثبيت Docker أولًا. لتثبيته، شغّل الأمر التالي:

curl -fsSL https://get.docker.com -o get-docker.sh
sh get-docker.sh

شرح كامل لعملية التثبيت وكيفية استخدام Docker متوفر في دليل Docker الخاص بنا.

التثبيت

الآن بعد أن تم استيفاء جميع المتطلبات واكتمال التحضيرات اللازمة، يمكنك متابعة تثبيت تطبيق Node.js.

لاستخدام Node.js داخل بيئة معزولة، تحتاج أولًا لتحميل الصورة الرسمية المبنية على Alpine. شغّل الأمر التالي لجلب أحدث صورة Node.js 22 إلى نظامك، لتكون جاهزة لنشر الحاويات:

docker pull node:22-alpine

بعدها، يمكنك تشغيل حاوية مبنية على هذه الصورة وفتح جلسة شل داخلها. استخدم الأمر التالي لبدء الحاوية مع شل تفاعلي. خيار --rm يضمن حذف الحاوية تلقائيًا عند الخروج، للحفاظ على نظافة بيئة المضيف.

docker run -it --rm --entrypoint sh node:22-alpine

داخل الحاوية، تحقق من إصدار Node.js المثبت باستخدام node -v والذي يجب أن يعرض v22.19.0. يمكنك أيضًا التأكد من إصدار npm عبر الأمر

npm -v والناتج المتوقع هو 10.9.3. هذا يؤكد أن الصورة توفر الإصدارات الصحيحة من Node.js و npm، جاهزة للاستخدام الفوري.

التهيئة

بعد تشغيل حاوية Node.js، يُنصح بتكوين إعدادات Node.js الأساسية داخل البيئة نفسها. أحد الأساليب الشائعة هو تعريف متغيرات البيئة، مثل:

export NODE_ENV=production

هذا يُفعّل وضع الإنتاج، مما يُنشط تحسينات الأداء ويُعدل سلوك التسجيل. لأغراض التطوير، يمكنك بدلاً من ذلك تعيين NODE_ENV=development للاستفادة من رسائل الخطأ التفصيلية وميزات التصحيح.

هيكلية مجلد المشروع مهمة، تبدأ بإنشاء ملف التهيئة عبر:

npm init -y

هذا ينشئ ملف package.json، الذي يحدد التبعيات، السكربتات، والبيانات الوصفية لمشروعك. هو ملف التهيئة المركزي لكل تطبيق Node.js.

يمكن تثبيت التبعيات باستخدام npm install <package>، بينما تُضاف تبعيات التطوير عبر npm install <package> --save-dev. قسم scripts داخل package.json يسمح لك بتعريف أوامر مخصصة، مثل npm start أو npm run build، لتبسيط التنفيذ وإدارة المشروع.

لإعدادات أكثر تقدمًا، يمكن تخصيص Node.js باستخدام ملفات .npmrc أو .nvmrc، التي تسمح بتكوين سجلات خاصة، خيارات التخزين المؤقت، أو فرض إصدار Node.js محدد. هذا يضمن تشغيل تطبيقاتك بشكل متسق عبر بيئات مختلفة.

الخاتمة والمزيد من الموارد

مبروك! لقد قمت الآن بتثبيت وتكوين Node.js بنجاح على سيرفرك المخصص. ننصح أيضًا بإلقاء نظرة على الموارد التالية، التي قد توفر لك مساعدة إضافية وإرشادات خلال عملية إعداد السيرفر:

عندك أسئلة محددة مش مغطاة هنا؟ لأي استفسارات أو مساعدة إضافية، لا تتردد في التواصل مع فريق الدعم الخاص بنا، المتوفر يوميًا لمساعدتك! 🙂