كيفية تثبيت واستخدام Node.js على نظام أوبونتو: دليل شامل للمبتدئين والمطورين

目次

1. مقدمة: لماذا تستخدم Node.js على أوبونتو؟

مدى توافق Node.js مع أوبونتو

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

عند تثبيت Node.js على أوبونتو، ستحصل على مزايا عديدة، منها:

  • النظام خفيف مع ميزات قليلة زائدة، مما يسمح بالاستخدام الفعال للموارد
  • إمكانية توحيد بيئة التطوير والاختبار والإنتاج على نظام Linux واحد
  • تكامل قوي مع Node.js وأدواته مثل npm وnvm

لذلك، الجمع بين أوبونتو وNode.js هو خيار جذاب جداً لبيئات التطوير سواء للواجهة الأمامية أو الخلفية.

من هو جمهور هذا المقال وما الهدف منه؟

هذا المقال موجه إلى:

  • من يريد استخدام Node.js لأول مرة على أوبونتو
  • من يبحث عن أفضل طريقة للتثبيت
  • من يريد استخدام أحدث إصدار من Node.js ويشعر بالقلق بشأن الإعدادات

بعد قراءة هذا المقال، ستتمكن من مقارنة ثلاث طرق لتثبيت Node.js على أوبونتو واختيار الأنسب حسب هدفك ومستواك. بالإضافة إلى ذلك، نشرح تثبيت الأدوات المحيطة مثل npm وyarn والتعامل مع المشاكل الشائعة، حتى تتمكن من استخدام بيئة Node.js بثقة.

侍エンジニア塾

2. ملخص مقارنة طرق تثبيت Node.js على أوبونتو

ثلاث طرق رئيسية لكل منها ميزاتها

هناك ثلاث طرق رئيسية لتثبيت Node.js على أوبونتو:

  1. تثبيت الحزمة القياسية عبر APT (أداة إدارة الحزم المتقدمة)
  2. تثبيت عبر PPA (أرشيف الحزم الشخصية) المقدم من NodeSource
  3. تثبيت مرن باستخدام nvm (مدير إصدارات Node)

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

جدول مقارنة طرق تثبيت Node.js

طريقة التثبيتالميزات الرئيسيةالمزاياالعيوبالفئة الموصى بها
APT (الافتراضي)يستخدم مستودع أوبونتو الرسميسهل وآمنقد يكون الإصدار قديماًمبتدئون يريدون التجربة بسرعة
NodeSource PPAإدارة أحدث Node.js عبر APTيدعم الإصدارات الأحدث نسبياًيتطلب إضافة PPAمطورون يحتاجون إصداراً مستقراً حديثاً
nvmتبديل بين الإصدارات بحريةمرن ومناسب للتطوير المتعدديحتاج ضبط إعدادات الشلمناسب لجميع أغراض التعلم والتطوير

لماذا المقارنة مهمة؟

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

بالمقابل، إذا أردت تجربة Node.js بسرعة أو لم ترغب في إجراء إعدادات إضافية على خادم الإنتاج، قد يكون تثبيت APT كافياً.

أي طريقة تختار؟

الخلاصة: للمطورين أو من يخطط لاستخدام Node.js على المدى المتوسط أو الطويل، يوصى بشدة باستخدام nvm.
الأسباب:

  • سهولة التبديل بين أحدث الإصدارات أو الإصدارات القديمة
  • يتم تثبيت npm تلقائياً
  • قليل المشاكل المتعلقة بالصلاحيات (لا حاجة لـ sudo)

3. الطريقة الأولى: تثبيت Node.js بسهولة باستخدام APT (رسمي من أوبونتو)

ما هو APT؟ أداة إدارة الحزم الافتراضية على أوبونتو

APT (أداة إدارة الحزم المتقدمة) هو نظام إدارة الحزم القياسي في توزيعات ديبيان مثل أوبونتو. باستخدام APT يمكنك تثبيت البرامج وتحديثها وإزالتها بسهولة من خلال الأوامر.

Node.js متوفر في مستودع أوبونتو الرسمي، لذا يمكن تثبيته فوراً دون إعدادات خاصة.

خطوات التثبيت

  1. أولاً، حدّث قائمة الحزم عبر APT.
   sudo apt update
  1. ثبّت Node.js وnpm.
   sudo apt install nodejs npm
  1. تأكد من التثبيت.
   node -v
   npm -v

إذا ظهرت معلومات الإصدار بعد تنفيذ الأوامر، فقد تم التثبيت بنجاح.

المزايا: سهل جداً وآمن

  • عبر مستودع أوبونتو الرسمي، مصداقية عالية
  • أوامر بسيطة، مناسب للمبتدئين
  • إدارة النظام مرتبطة مع APT، سهل التحديث مع النظام

خيار مفيد لمن يريد تجربة Node.js أو لمن لا يرغب في إعدادات معقدة للخادم.

العيوب: قد يكون الإصدار قديماً

نظرًا لتركيز APT على الاستقرار، قد يكون إصدار Node.js أقدم بعدة أجيال.

مثلاً في Ubuntu 22.04، قد يكون الإصدار عبر APT هو 12 أو 14، ولا يحتوي على أحدث الميزات أو التحديثات الأمنية.

أيضاً من الصعب إدارة نسخ متعددة، لذا ليس الأنسب لمن يريد استخدام إصدارات مختلفة لمشاريع متعددة.

من هو الأنسب لهذه الطريقة؟

  • مبتدئون يريدون تجربة Node.js بسرعة
  • بيئات أعمال لا تحتاج أحدث الإصدارات
  • حالات لا تتطلب تعدد الإصدارات

4. الطريقة الثانية: تثبيت أحدث إصدار عبر NodeSource PPA

ما هو NodeSource؟

NodeSource هو مصدر موثوق يوفر إصدارات مستقرة وحديثة من Node.js بشكل أسرع من الفريق الرسمي. خاصّةً على أوبونتو وديبيان، يعد خياراً رئيسياً لمن يريد استخدام أحدث إصدارات Node.js عبر APT.

موقع Node.js الرسمي يوصي باستخدامه، ويستخدم في الشركات أيضاً.

خطوات التثبيت (مثال: Node.js 18.x)

  1. حدّث قائمة الحزم.
   sudo apt update
  1. إذا لم يكن curl مثبتاً، ثبته أولاً.
   sudo apt install curl
  1. نفذ سكريبت إعداد NodeSource.
   curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
  1. ثبّت Node.js.
   sudo apt install -y nodejs
  1. تأكد من التثبيت.
   node -v
   npm -v

المزايا: استخدام أحدث إصدار بسهولة عبر APT

  • تثبيت أحدث إصدارات Node.js بسهولة
  • سهولة دمجها في عمليات الإدارة المعتادة مع APT
  • تثبيت npm تلقائياً

خيار ممتاز لمن يريد تحديثاً دائماً وسريعاً خارج مستودعات أوبونتو الرسمية.

العيوب: يتطلب إضافة PPA

  • خطوات أكثر من APT العادي، وقد تكون مربكة للمبتدئين
  • ينبغي التأكد من موثوقية المصدر (NodeSource موثوق عادةً)

من هو الأنسب لهذه الطريقة؟

  • مطورون يحتاجون أحدث إصدار مستقر من Node.js
  • من يريد بديلاً عن مستودع أوبونتو ولا يحتاج إلى nvm
  • من يفضل إدارة الحزم عبر APT فقط

5. الطريقة الثالثة: إدارة الإصدارات مرونة عبر nvm (موصى به)

ما هو nvm؟ أداة مريحة لإدارة إصدارات Node.js

nvm (مدير إصدارات Node) أداة لإدارة وتبديل نسخ متعددة من Node.js عبر الطرفية. هو الأنسب للمطورين الذين يحتاجون لاستخدام إصدارات مختلفة لمشاريعهم أو تجربة أحدث وأطول دعم.

عند استخدام nvm، يمكنك بناء بيئة تطوير مرنة لا تؤثر على النظام الرئيسي.

خطوات تثبيت nvm

  1. نفذ سكريبت التثبيت باستخدام curl.
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
  1. أعد تحميل ملف إعدادات الشل (حسب نوع الشل).
   source ~/.bashrc

أو إذا كنت تستخدم Zsh:

   source ~/.zshrc
  1. تأكد من تثبيت nvm.
   command -v nvm

إذا ظهرت كلمة nvm فالتركيب صحيح.

تثبيت Node.js باستخدام nvm

  1. لتثبيت نسخة LTS (دعم طويل الأمد):
   nvm install --lts
  1. لتثبيت إصدار معين:
   nvm install 18
  1. تبديل الإصدار المستخدم:
   nvm use 18
  1. تعيين إصدار افتراضي:
   nvm alias default 18
  1. تأكد من الإصدارات:
   node -v
   npm -v

المزايا: مرونة فائقة وإدارة مثالية

  • سهولة تبديل وتعدد الإصدارات
  • تثبيت npm تلقائياً
  • لا حاجة لـ sudo، تفادي مشاكل الصلاحيات
  • لا يؤثر على النظام الرئيسي، مثالي للتطوير

العيوب: يحتاج بعض الإعداد الأولي

  • إذا نسيت تحميل .bashrc أو .zshrc قد لا يعمل nvm
  • التثبيت يتم على مستوى المستخدم وليس النظام ككل

من هو الأنسب لهذه الطريقة؟

  • مطورون يحتاجون تبديل سريع بين نسخ Node.js
  • من يعمل على مشاريع متعددة بإصدارات مختلفة
  • حتى المبتدئين الذين يريدون تجنب مشاكل الصلاحيات

6. استخدام وتثبيت npm وyarn

ما هو npm؟ أداة أساسية مع Node.js

npm (مدير حزم Node) هو أداة لإدارة الحزم تُستخدم مع Node.js لتثبيت وإدارة مكتبات وأدوات المطورين. لا غنى عنها في تطوير Node.js.

عند تثبيت Node.js عبر APT أو NodeSource عادةً يتم تثبيت npm معه. عند استخدام nvm أيضاً، nvm install يثبت npm تلقائياً.

أمر التحقق من الإصدار:
npm -v

الاستخدام الأساسي لـ npm

نوع العمليةأمر المثال
تثبيت حزمةnpm install <اسم-الحزمة>
تثبيت عالميnpm install -g <اسم-الحزمة>
إلغاء تثبيتnpm uninstall <اسم-الحزمة>
تهيئة مشروعnpm init أو npm init -y
عرض قائمة الحزمnpm list أو npm list -g

npm مهم لإدارة الاعتمادات الخاصة بكل مشروع.

ما هو yarn؟ بديل شائع لـ npm

yarn أداة طورتها Facebook كبديل أسرع وأكثر استقراراً لـ npm. أوامره متوافقة إلى حد كبير مع npm.

خطوات تثبيت yarn (عبر npm)

npm install -g yarn

بعد التثبيت تحقق من الإصدار:

yarn -v

الاستخدام الأساسي لـ yarn

نوع العمليةأمر المثال
تثبيت حزمةyarn add <اسم-الحزمة>
تثبيت عالميyarn global add <اسم-الحزمة>
إلغاء تثبيتyarn remove <اسم-الحزمة>
تهيئة مشروعyarn init
عرض قائمة الحزمyarn list أو yarn global list

npm أم yarn؟ أيهما تختار؟

المعيارnpmyarn
الافتراضيةيأتي مع Node.jsيحتاج تثبيت منفصل
السرعةمتوسطةأسرع بفضل الكاش
ملف الإقفالpackage-lock.jsonyarn.lock
توافق الأوامرمتوافق تقريباً (ينبغي الانتباه)

مع تحديثات npm (الإصدار 7 وما بعده) لم تعد هناك فروقات كبيرة، ويُنصح باتباع ما يستخدمه فريق المشروع.

7. الأخطاء والمشاكل الشائعة والحلول

أخطاء شائعة وحلولها

node: command not found

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

الحل:

  • أعد تحميل .bashrc أو .zshrc لتفعيل nvm
  source ~/.bashrc
  • إذا لم يعمل، سجل الخروج أو أعد تشغيل الجهاز

E: Unable to locate package nodejs

السبب:
قائمة حزم APT قديمة أو لم تتم إضافة الـPPA بشكل صحيح.

الحل:

  • حدّث قائمة حزم APT
  sudo apt update
  • إذا استخدمت NodeSource، أعد تنفيذ سكريبت الإعداد

npm ERR! permission denied

السبب:
محاولة تثبيت حزمة عالمية بدون صلاحيات كافية.

الحل:

  • استخدم sudo مع التثبيت (ليس الحل الأفضل دائماً)
  sudo npm install -g <اسم-الحزمة>
  • أفضل ممارسة هي استخدام nvm لتجنب الحاجة إلى sudo

nvm: command not found

السبب:
لم يتم تفعيل إعدادات الشل بعد تثبيت nvm.

الحل:

  • تأكد من إضافة كود تفعيل nvm في .bashrc أو ما شابه
  • تفعيلها يدوياً إذا لزم الأمر
  export NVM_DIR="$HOME/.nvm"
  [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

نصائح أساسية لتجنب المشاكل

  • تأكد دائماً من إعداد المسارات PATH بشكل صحيح
  • استخدم nvm لتقليل مشاكل بيئة التطوير
  • انتبه إلى توافق إصدارات أوبونتو وNode.js

8. الأسئلة الشائعة (FAQ)

س1. كيف أتحقق من إصدار Node.js؟

جـ. يمكنك تنفيذ الأمر التالي في الطرفية:

node -v

للتحقق من إصدار npm أيضاً:

npm -v

س2. أريد استخدام عدة إصدارات من Node.js على أوبونتو، كيف؟

جـ. استخدام nvm هو الأسهل والأكثر أماناً. بعد التثبيت يمكنك التبديل بالأوامر:

nvm install 16
nvm use 16

وهكذا يمكنك تخصيص كل مشروع على إصدار معين.

س3. nvm لا يعمل بعد تثبيت Node.js، لماذا؟

جـ. غالباً لأن ملف إعدادات الشل لم يتم تفعيله. بعد التثبيت نفذ:

source ~/.bashrc

أو إذا كنت تستخدم zsh:
source ~/.zshrc

س4. ما الفرق بين yarn وnpm؟ أيهما أستخدم؟

جـ. الوظائف الأساسية متشابهة، لكن yarn أسرع في التثبيت وله إدارة اعتماد أفضل عبر yarn.lock. في الوقت نفسه، npm (من الإصدار 7+) تحسن كثيراً. الأفضل أن تستخدم الأداة المعتمدة في مشروعك أو فريقك.

س5. ما الفرق بين Node.js وDeno وBun؟

جـ. Deno وBun هما بيئتان جديدتان لمعالجة مشاكل Node.js:

  • Deno: يدعم TypeScript، أكثر أماناً، ويحتوي على مكتبات قياسية مدمجة
  • Bun: أسرع بكثير مع إدارة حزم مدمجة

مع ذلك، يظل Node.js الخيار الأكثر عملية بفضل مجتمع npm الضخم.

9. الخلاصة: اختر طريقة التثبيت حسب حاجتك

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

فيما يلي ملخص سريع:

APT (رسمي من أوبونتو)

  • المزايا: أسهل وأكثر أماناً
  • العيوب: قد يكون الإصدار قديماً
  • الموصى به: لمن يريد التجربة السريعة

NodeSource PPA

  • المزايا: يمكنك الحصول على إصدار حديث بسهولة عبر APT
  • العيوب: يحتاج إضافة PPA
  • الموصى به: مطورون يريدون إصداراً مستقراً وحديثاً

nvm (مدير إصدارات Node)

  • المزايا: مرونة عالية لتعدد الإصدارات
  • العيوب: يحتاج إعداد أولي
  • الموصى به: للمطورين المتقدمين أو من يدير عدة مشاريع

كما شرحنا أدوات npm وyarn وبعض الحلول لأشهر الأخطاء. قد يبدو إعداد Node.js معقداً في البداية، لكن باختيار الطريقة الصحيحة ستتمكن من بناء بيئة تطوير مستقرة على أوبونتو بسهولة.

ولمن يطمح لتوسيع مشاريعه، يفضل اعتماد nvm كخيار أساسي، مع التفكير في دمج التطوير الجماعي أو CI/CD مستقبلاً.

年収訴求