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

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

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

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