نصب Node.js در اوبونتو از انتخاب نسخهٔ سازگار با پروژه شروع می‌شود. نسخهٔ موجود در apt الزاماً جدیدترین LTS بالادستی نیست. همچنین پشتیبانی یک انتشار اوبونتو به معنی پشتیبانی نامحدود همان نسخهٔ Node.js توسط پروژهٔ Node نیست. پیش از نصب، نیاز برنامه و روش نگهداری سرور را مشخص کنید.
انتخاب روش نصب Node.js در اوبونتو
برای مدیریت بسته در سطح سیستم می‌توان از apt استفاده کرد؛ برای توسعه و جابه‌جایی بین نسخه‌ها، nvm محیط هر کاربر را جدا مدیریت می‌کند. این دو روش را بدون توجه به مسیر اجرا ترکیب نکنید. ابتدا وضعیت فعلی را ببینید:
cat /etc/os-release
command -v node
node --version
command -v npm
npm --versionنبود فرمان روی نصب تازه طبیعی است. اگر برنامه‌ای از نسخهٔ موجود استفاده می‌کند، پیش از تغییر مسیر ارتقای آن را مشخص کنید؛ حذف nodejs و npm همیشه بی‌اثر بر سرویس‌های دیگر نیست.
روش apt؛ بررسی نسخه پیش از نصب
sudo apt update
apt-cache policy nodejs npmنسخهٔ Candidate را با نیاز پروژه و جدول پشتیبانی Node.js مقایسه کنید. شاخه‌های قدیمی 12، 14، 16 و 18 انتخاب عمومی مناسبی برای پروژهٔ تازه نیستند. اگر بستهٔ توزیع برای نیاز و سیاست نگهداری شما مناسب است:
sudo apt install nodejs npm
node --version
npm --versionاین دستور برای بسته‌های مخزن توزیع است. بعضی تأمین‌کنندگان دیگر npm را همراه بستهٔ nodejs عرضه می‌کنند؛ روش یک مخزن را به مخزن دیگر تعمیم ندهید. NodeSource نیز مخزن شخص ثالث است، نه PPA رسمی اوبونتو.
روش nvm؛ نصب در حساب کاربر
دستور نصب را با مخزن رسمی nvm تطبیق دهید. نمونهٔ زیر نصب‌کنندهٔ نسخهٔ مشخص را ابتدا در فایل دریافت می‌کند تا بتوانید آن را بررسی کنید. با حساب کاربر پروژه اجرا کنید، نه root:
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.41.0/install.sh -o nvm-install.sh
less nvm-install.sh
bash nvm-install.shپس از نصب، یک نشست تازهٔ Bash باز کنید و سپس:
command -v nvm
nvm install 24
nvm use 24
node --version
npm --versionشاخهٔ 24 نمونهٔ LTS پشتیبانی‌شده در زمان بازبینی است، نه تضمین مناسب بودن برای هر پروژه. نیاز دقیق و وضعیت روز را در صفحهٔ رسمی دریافت Node.js بررسی کنید. اگر پروژه .nvmrc دارد، نسخهٔ ثبت‌شدهٔ آن را با پشتیبانی و وابستگی‌ها تطبیق دهید.
اطمینان از محیط فعال
command -v node
node -p "process.execPath"
node -e "console.log('Node installation OK')"این آزمون اجرای محیط را تأیید می‌کند، نه سلامت کل برنامه. nvm برای هر کاربر و نشست shell است؛ سرویس systemd یا کار زمان‌بندی‌شده لزوماً همان PATH نشست تعاملی را ندارد. مسیر و نسخهٔ اجرای سرویس را جدا و صریح تنظیم کنید.
وابستگی‌های پروژه و خطاهای رایج
در پروژهٔ دارای lock هماهنگ، از npm ci در فرایند استقرار استفاده کنید و آزمون‌های پروژه را اجرا کنید. برای حل خطای مجوز، نصب بسته‌های برنامه با sudo را عادت نکنید؛ مالکیت پوشه و روش نصب را اصلاح کنید.
اگر nvm پیدا نشد، shell و فایل آغاز نشست را بررسی کنید. اگر نسخهٔ node با انتظار فرق دارد، خروجی مسیر اجرا را ببینید. نصب موفق Node.js به معنی آماده شدن HTTPS، مدیریت فرایند یا انتشار برنامه نیست؛ این‌ها مراحل جداگانهٔ استقرار هستند.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
