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

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

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

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

dedicated server

مقدمة​

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 بنجاح على سيرفرك المخصص. ننصحك أيضًا بإلقاء نظرة على الموارد التالية، التي قد توفر لك مساعدة إضافية وإرشادات أثناء عملية إعداد السيرفر:

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

إعدادات الكوكيز