- 1 1. مقدمة: لماذا تستخدم Node.js على أوبونتو؟
- 2 2. ملخص مقارنة طرق تثبيت Node.js على أوبونتو
- 3 3. الطريقة الأولى: تثبيت Node.js بسهولة باستخدام APT (رسمي من أوبونتو)
- 4 4. الطريقة الثانية: تثبيت أحدث إصدار عبر NodeSource PPA
- 5 5. الطريقة الثالثة: إدارة الإصدارات مرونة عبر nvm (موصى به)
- 6 6. استخدام وتثبيت npm وyarn
- 7 7. الأخطاء والمشاكل الشائعة والحلول
- 8 8. الأسئلة الشائعة (FAQ)
- 9 9. الخلاصة: اختر طريقة التثبيت حسب حاجتك
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 على أوبونتو:
- تثبيت الحزمة القياسية عبر APT (أداة إدارة الحزم المتقدمة)
- تثبيت عبر PPA (أرشيف الحزم الشخصية) المقدم من NodeSource
- تثبيت مرن باستخدام 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 متوفر في مستودع أوبونتو الرسمي، لذا يمكن تثبيته فوراً دون إعدادات خاصة.
خطوات التثبيت
- أولاً، حدّث قائمة الحزم عبر APT.
sudo apt update
- ثبّت Node.js وnpm.
sudo apt install nodejs npm
- تأكد من التثبيت.
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)
- حدّث قائمة الحزم.
sudo apt update
- إذا لم يكن curl مثبتاً، ثبته أولاً.
sudo apt install curl
- نفذ سكريبت إعداد NodeSource.
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
- ثبّت Node.js.
sudo apt install -y nodejs
- تأكد من التثبيت.
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
- نفذ سكريبت التثبيت باستخدام
curl
.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
- أعد تحميل ملف إعدادات الشل (حسب نوع الشل).
source ~/.bashrc
أو إذا كنت تستخدم Zsh:
source ~/.zshrc
- تأكد من تثبيت nvm.
command -v nvm
إذا ظهرت كلمة nvm
فالتركيب صحيح.
تثبيت Node.js باستخدام nvm
- لتثبيت نسخة LTS (دعم طويل الأمد):
nvm install --lts
- لتثبيت إصدار معين:
nvm install 18
- تبديل الإصدار المستخدم:
nvm use 18
- تعيين إصدار افتراضي:
nvm alias default 18
- تأكد من الإصدارات:
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؟ أيهما تختار؟
المعيار | npm | yarn |
---|---|---|
الافتراضية | يأتي مع Node.js | يحتاج تثبيت منفصل |
السرعة | متوسطة | أسرع بفضل الكاش |
ملف الإقفال | package-lock.json | yarn.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 مستقبلاً.