يوضح هذا الدليل تثبيت Node.js وnpm على Ubuntu أو Debian لتشغيل تطبيقات الويب (Express، NestJS، أدوات البناء، إلخ).
المتطلبات
- VPS مع
sudoأو root - Ubuntu 20.04+ أو Debian 11+ (64 بت)
- SSH يعمل
توصية
للبناء المتكرر (npm install، تجميع)، يُفضّل VPS بقرص سريع مثل VPS NVMe.
الطريقة الموصى بها: NodeSource (LTS)
1. تحديث النظام
Bashsudo apt update && sudo apt upgrade -y
2. المتطلبات
Bashsudo apt install -y ca-certificates curl gnupg
3. إضافة مفتاح ومستودع NodeSource (مثال: Node.js 22.x LTS)
استبدل 22.x بالفرع LTS المناسب من وثائق NodeSource.
Bashcurl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
4. تثبيت Node.js
Bashsudo apt install -y nodejs
5. التحقق
Bashnode -v npm -v
بديل سريع: حزم Debian/Ubuntu
Bashsudo apt install -y nodejs npm
قد تكون الإصدارات أقدم. للإنتاج يُفضّل NodeSource أو nvm.
تحديث npm (اختياري)
Bashsudo npm install -g npm@latest
ممارسات جيدة
- لا تشغّل
npmكـ root لمشاريعك: أنشئ مستخدماً أو استخدمsudo -u user. - للإنتاج استخدم PM2 أو systemd.
- افتح المنافذ الضرورية فقط (جدار، Nginx أمام التطبيق).
استكشاف الأخطاء
- Permission denied على
npm install -g: اضبط مجلداً عاماً للمستخدم أو استخدمnvm. - Command not found: أعد جلسة SSH أو افتح shell جديداً.
لمزيد من الخطوات: تأمين SSH وNginx + Certbot.