Node.js روی Debian؛ مهاجرت از Debian 10 و نصب نسخه LTS

Debian 10 از پشتیبانی رسمی LTS خارج شده است و برای پروژه تازه توصیه نمی‌شود. اگر آموزش قبلی شما Node.js را روی این نسخه نصب می‌کرد، اکنون باید سیستم میزبان و runtime را با هم بررسی کنید. در این راهنما، مقصد یک Debian پشتیبانی‌شده مانند 13 است؛ دستور نصب Node روی سرور موجود، روش ارتقای Debian نیست.

نسخه و وابستگی‌های فعلی را ثبت کنید

cat /etc/os-release
command -v node
node --version
npm --version

این خروجی‌ها را از حساب اجرای برنامه بگیرید. در سرویس‌های چندکاربره، نسخه shell مدیر ممکن است با runtime برنامه فرق کند. package.json، فایل lock، متغیرهای محیطی و سرویس راه‌انداز را همراه بکاپ ثبت کنید؛ فایل حاوی رمز را وارد مخزن عمومی نکنید.

نصب در حساب توسعه با nvm

از مخزن رسمی nvm، اسکریپت نصب نسخه مشخص را دریافت و پیش از اجرا بررسی کنید. نصب nvm با sudo لازم نیست. پس از بازکردن shell تازه، شاخه 24 LTS را نصب و انتخاب کنید.

sudo apt update
sudo apt install curl ca-certificates
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.8/install.sh -o nvm-install.sh
less nvm-install.sh
bash nvm-install.sh

command -v nvm
nvm install 24
nvm use 24
node --version

بلوک دوم پس از بارگذاری profile در shell جدید اجرا می‌شود. اگر command -v nvm نتیجه نداشت، ابتدا تنظیم profile و حساب نصب را اصلاح کنید.

بازسازی و آزمون برنامه در مقصد

1. کد و lock را به پوشه مستقل در مقصد منتقل کنید؛ node_modules سیستم قدیمی را مبنای انتشار نگذارید.
2. وابستگی‌ها را با نسخه هدف و از منبع قابل اعتماد نصب کنید و آزمون‌ها و build پروژه را اجرا کنید.
3. اتصال دیتابیس، سرویس بیرونی و زمان‌بندی‌ها را با تنظیمات غیرعملیاتی آزمایش کنید.
4. مسیر مطلق Node را در مدیر فرایند یا سرویس مشخص و رفتار پس از reboot را کنترل کنید.

انتقال بدون دو نسخه متناقض

برای برنامه دارای داده قابل نوشتن، زمان هماهنگی داده نهایی و توقف نوشتن در مقصد قدیمی را تعیین کنید. عوض‌کردن DNS بدون این هماهنگی ممکن است درخواست‌ها را بین دو نسخه جدا پخش کند. پس از انتقال، خطا، زمان پاسخ و صف کار را پایش کنید و سرور قدیمی را تا پایان بازه بازگشت حفظ کنید.

خطاهای متداول

node: command not found در systemd معمولاً به محیط و مسیر اجرا مربوط است، نه لزوماً نصب ناقص. خطای ماژول native پس از ارتقا به بازسازی همان وابستگی برای runtime هدف نیاز دارد. نصب یک نسخه منقضی صرفاً برای ساکت‌کردن خطا، راه‌حل نهایی نگهداری نیست.

مطالعه مرتبط

• آموزش نصب Node.js بر روی CentOS
• راه اندازی اولیه سرور با Debian 11

منابع و مستندات

• چرخه پشتیبانی Debian
• چرخه انتشار Node.js
• نصب و استفاده از nvm

بازبینی محتوا و منابع: ۲۶ مهر ۱۴۰۵. دستورهای نمونه برای محیط مشخص‌شده‌اند؛ پیش از استفاده روی سرویس عملیاتی، سازگاری محیط و نسخه پشتیبان را بررسی کنید.