نکات کلیدی
- فرمان `pm2 startup` یک فایل سرویس systemd ایجاد می کند که در زمان بوت، فهرست ذخیره شدهٔ برنامه ها را بارگذاری می کند.
- دستور `pm2 save` وضعیت فعلی را در فایل `~/.pm2/dump.pm2` ذخیره می کند.
- اگر برنامه ای در حالت fork اجرا می شود و سپس با `pm2 start ecosystem.config.js` به Cluster تغییر می کند، ممکن است بدون هشدار ریست شود؛ پس ابتدا آن را حذف کنید و سپس از فایل پیکربندی اجرا کنید.
مقدمه
سرورهای لینوکسی که بهصورت دورهای ریبوت میشوند، گاهی باعث متوقف شدن سرویسهای Node.js میشوند. این مشکل معمولاً به دلیل عدم ذخیرهسازی صحیح فهرست برنامهها در PM2 یا نداشتن سرویس systemd برای راهاندازی مجدد است. در ادامه، راهکارهای عملی برای جلوگیری از این اختلالات آورده شده است.
نصب Node.js با nvm
- nvm برای هر کاربر به صورت جداگانه نصب میشود و تمام نسخههای Node.js را در مسیر `~/.nvm/versions/node` نگه میدارد.
- پکیجهای سراسری مانند `pm2` نیز در همان پوشهٔ نسخه نصب میشوند؛ بنابراین، دستورات را با همان کاربری اجرا کنید که برنامه را اجرا میکند، نه `root`.
نکته ۱: ارتقاء Node.js
- پس از نصب نسخهٔ جدید، باید مسیر `bin` در سرویس systemd را بهروز کنید.
- دستور `pm2 update` را اجرا کنید تا نسخهٔ جدید در حافظهٔ PM2 ثبت شود.
- سپس سرویس را با `pm2 startup` و `pm2 save` دوباره بسازید.
نکته ۲: دانلود ناکامل Node.js
- اگر `nvm install` در هنگام دریافت فایل متوقف میشود، میتوانید آدرس مخزن را تغییر دهید:
“`bash export NVM_NODEJS_ORG_MIRROR= nvm install <نسخه> “`
- از مررهای معتبر استفاده کنید تا سرعت و اطمینان دانلود افزایش یابد.
ایجاد و نگهداری سرویس systemd
- فرمان `pm2 startup` یک فایل سرویس systemd ایجاد میکند که در زمان بوت، فهرست ذخیرهشدهٔ برنامهها را بارگذاری میکند.
- دستور `pm2 save` فهرست فعلی را بر روی دیسک ذخیره میکند.
- اگر یکی از این دو دستور را نادیده بگیرید، پس از ریبوت برنامهها بهصورت خودکار اجرا نخواهند شد.
نکته ۳: جلوگیری از اختلال پس از ریبوت
- پس از هر تغییر در برنامهها (افزودن یا حذف)، حتماً `pm2 save` را اجرا کنید.
- در صورت بروز خطا یا کرش، PM2 خودکار برنامه را مجدداً اجرا میکند.
- برای اطمینان از عملکرد صحیح، در ساعات کاری یک بار `sudo reboot` اجرا کنید و وضعیت سرویسها را بررسی کنید.
جمعبندی
با رعایت مراحل نصب صحیح nvm، نگهداری دقیق فهرست برنامهها در PM2، و ایجاد سرویس systemd، میتوانید از اختلالات ناشی از ریبوت سرور جلوگیری کنید و اطمینان حاصل کنید که برنامههای Node.js شما همواره در دسترس باشند.
راهاندازی PM2 بدون دسترسی root
- در سیستمهای مبتنی بر systemd، هنگام اجرای `pm2 startup`، فایل سرویس `/etc/systemd/system/pm2-USER.service` ایجاد و فعال میشود.
- در این فایل، خط `Environment=PATH` مسیر پوشهی `bin` نسخهی Node را نگه میدارد و `ExecStart` فرمان `resurrect` را فراخوانی میکند.
- برای مشاهدهی تنظیمات فعلی، دستور `systemctl cat pm2-$USER` را اجرا کنید.
ذخیرهسازی فهرست برنامهها
- دستور `pm2 save` وضعیت فعلی را در فایل `~/.pm2/dump.pm2` ذخیره میکند.
- در زمان بوت، `resurrect` این فایل را بارگذاری میکند؛ بنابراین هر تغییر (start/delete) بعد از آخرین `save` در ریبوت گم میشود.
- برای اطمینان از پایداری، پس از هر تغییر، `pm2 save` را اجرا کنید.
عملکرد حالت Cluster
- حالت Cluster در PM2 چند نمونه از برنامه را روی هستههای مختلف اجرا میکند تا همگی بر روی یک پورت گوش دهند.
- در سرورهای تک هسته یا برنامههایی که به حافظهی session وابستهاند، استفاده از Cluster ممکن است باعث کاهش سرعت و مشکلات session شود.
- اگر برنامهتان به صورت stateless نیست، توصیه میشود session را در Redis یا دیتابیس ذخیره کنید.
استفاده از فایل `ecosystem.config.js`
- برای پیکربندی پایدار، نام فایل باید با `.config.js` پایان یابد.
- مقادیر `env` در فایل بر متغیرهای شل غلبه دارند؛ برای محیط production، از `–env production` استفاده کنید تا به `env_production` اشاره کند.
- اگر برنامهای در حالت fork اجرا میشود و سپس با `pm2 start ecosystem.config.js` به Cluster تغییر میکند، ممکن است بدون هشدار ریست شود؛ پس ابتدا آن را حذف کنید و سپس از فایل پیکربندی اجرا کنید.
مدیریت هستهها در حالت Cluster
- پارامتر `max` تعداد پردازشهای مجاز برای هر هسته را تعیین میکند؛ در سرورهای یک vCPU، این مقدار معمولاً برابر با ۱ است.
- برای توزیع بار بین چند سرور، از لود بالانسر استفاده کنید.
- توجه داشته باشید که session در حافظه بین پردازشهای Cluster به اشتراک گذاشته نمیشود؛ بنابراین کاربران ممکن است پس از هر درخواست از حساب خارج شوند.
فرمان `reload` در مقابل `restart`
- پس از هر استقرار، استفاده از `pm2 reload` به جای `restart` باعث میشود برنامه بدون وقفهی کامل، بهروزرسانی شود.
- `reload` فایل پیکربندی را بارگذاری کرده و پردازشهای جدید را بدون قطع ارتباط کاربران راهاندازی میکند.
فرمان restart و reload در حالت cluster
- restart: فرآیند را بهصورت کامل میکشد و سپس دوباره راهاندازی میکند.
- reload: در محیط cluster بدون قطعی اجرا میشود.
- در هنگام توقف، ابتدا سیگنال `SIGINT` ارسال میشود.
- اگر برنامه در کمتر از ۱.۶ ثانیه بسته نشود، سیگنال `SIGKILL` اعمال میشود.
- برای اجازه دادن به بسته شدن آرام اتصالهای دیتابیس، مقدار `kill_timeout` را افزایش دهید.
لاگها و نقش Nginx در عملکرد PM2
- خروجی برنامه در پوشه `~/.pm2/logs` ذخیره میشود.
- چرخش و محدودیت حجم لاگ توسط ماژول جداگانهای انجام میشود.
- Nginx بهصورت پیشفرض هدرهای WebSocket را به برنامه ارسال نمیکند.
کارت ۶: لاگی که هیچگاه چرخانده نمیشود
- نشانه: دستور `df -h` نشان میدهد دیسک تقریباً پر است و بزرگترین فایلها لاگهای برنامه هستند.
- تنظیمات پیشفرض ماژول:
- حجم چرخش: 10 MiB
- نگهداری: 30 فایل
- چرخش اجباری: هر نیمهشب
- فشردهسازی: خاموش
- اگر نصب ماژول خطا داد، ممکن است به دلیل تنظیمات registry تحریمهای npm باشد.
کارت ۷: پروکسی Nginx بدون هدر `Upgrade`
- نشانه: صفحه بارگذاری میشود ولی WebSocket متصل نمیشود یا پس از ۶۰ ثانیه قطع میشود.
- تنظیمات پیشفرض ماژول proxy در Nginx:
- `proxy_http_version` پیش از نسخه 1.29.7 برابر 1.0 بود؛ از آن پس 1.1.
- `proxy_read_timeout` پیشفرض ۶۰ ثانیه است.
- فایل پیکربندی را در یک فایل `.conf` قرار دهید که توسط `nginx.conf` شامل شود.
- برای HTTPS: `listen 443 ssl` و مسیر گواهی را اضافه کنید.
- سرور Node.js بدون تعیین `host` بر روی همه نشانیها گوش میدهد؛ برای محدود کردن به Nginx، از `app.listen(process.env.PORT, ‘127.0.0.1’)` استفاده کنید.
راهاندازی مجدد پس از ریبوت سرور
- برنامههای Node.js فقط در صورت وجود سرویس خودکار ساختهشده و ذخیرهسازی فهرست تغییرات، پس از ریبوت باز میگردند.
- ریبوت دستی همیشه مطمئنکننده است.
دستور `startup` با یا بدون `sudo`
- نیازی به `sudo` نیست. خروجی دستور بدون `sudo` مسیر Node و نام کاربر را نشان میدهد؛ همان را اجرا کنید.
تغییر نسخه Node با `nvm`
- نسخه جدید را بهعنوان پیشفرض تنظیم کنید.
- `update` را اجرا کنید.
- سرویسهای قبلی را با `unstartup` حذف کنید.
- سرویس جدید را با `startup` بسازید.
محل ذخیرهسازی فایلهای لاگ برنامه
- مسیر: `~/.pm2/logs`.
- در حالت `fork`: `api-out.log`.
- در حالت `cluster`: `api-out-0.log`، `api-out-1.log` و غیره.
- دستور `pm2 logs api –lines 200` تمام لاگها را در یک صفحه نمایش میدهد.
آیا حالت cluster برای همه برنامههای Node.js مناسب است؟
- بسته به نیازهای مقیاسپذیری و تحمل خطا، استفاده از cluster میتواند مفید باشد، اما برای برنامههای ساده یا کممصرف، حالت `fork` ممکن است کافی باشد.
حذف کامل اجرای خودکار
- فرمان `unstartup` فقط سرویس را از systemd پاک میکند؛ پس از اجرای آن، فایل `dump` بر روی دیسک باقی میماند.
- برای پاکسازی کامل، پس از حذف سرویس، فایل `dump` را دستی حذف کنید.
آیا لازم است Nginx جلوی برنامه قرار گیرد؟
- استفاده از Nginx اختیاری است.
- در مستندات مدیر پروسس، پیشنهاد میشود Nginx فایلهای ثابت و SSL را مدیریت کند و ترافیک را به برنامه منتقل نماید.
- این تنظیمات باعث کاهش بار بر روی برنامه و سادهسازی مدیریت گواهی میشود.
نکات کلیدی پس از ریبوت
- ساخت سرویس
- دو فرمان `startup` و `save` در pm2 وجود دارد.
- `startup` سرویس systemd را ایجاد میکند؛ `save` فهرست برنامهها را روی دیسک ذخیره میکند.
- مشکلات رایج
- اکثر خرابیهای پس از ریبوت به دلیل عدم وجود مسیرهای `nvm` یا عدم بازسازی سرویس پس از ارتقا Node است.
- پس از هر ارتقا، سرویس را دوباره بسازید.
- تنظیمات پیشرفته
- فقط برای برنامههای stateless، `cluster` را فعال کنید.
- چرخش لاگ و هدرهای `Upgrade` را پیش از رسیدن ترافیک واقعی تنظیم کنید.
- تست دستی
- یک ریبوت دستی انجام دهید و با `pm2 list` فهرست پروسسها را بررسی کنید.
مشکلات نصب npm در سرورهای داخلی
- سرورهایی که به رجیستری npm دسترسی ندارند، قادر به نصب ماژولها یا نسخههای جدید مدیر پروسس نیستند.
- راهحل: استفاده از میرور جایگزین در مستندات راهنما.
منابع مستندات
- مستندات رسمی Startup Script Generator
- مستندات رسمی Configuration File
- مستندات رسمی Cluster Mode
- مستندات nginx برای ماژول `ngx_http_proxy_module`
- فایل README پروژه nvm
پرسشهای متداول
آیا باید pm2 را به صورت سراسری نصب کنم؟
بله، pm2 را با `npm install -g pm2` نصب کنید تا در تمام نسخه های Node.js قابل دسترسی باشد.
چگونه مطمئن شوم سرویس systemd به درستی ساخته شده است؟
دستور `systemctl status pm2-<username>` را اجرا کنید؛ اگر وضعیت `active (running)` باشد، سرویس به درستی فعال است.
چه زمانی باید `pm2 save` را اجرا کنم؟
پس از هر تغییر در برنامه ها یا پس از ارتقاء Node.js، حتماً `pm2 save` را اجرا کنید تا فهرست جدید ذخیره شود.

کمپین ابتکار نو
کمپین ایده های نو
کمپین آینده روشن
کمپین طراحی مدرن