هاست Node.js در پلسک زمانی قابل استفاده است که سرور و اشتراک شما امکان اجرای برنامهٔ Node.js را داشته باشند. فعال شدن این گزینه به‌تنهایی به معنی آماده بودن پروژه نیست؛ نسخهٔ سازگار، فایل شروع و وابستگی‌ها نیز باید درست باشند. این مقاله روی آماده‌سازی دامنه تمرکز دارد و راهنمای اجرای پروژه در بخش مرتبط آمده است.
پیش‌نیاز هاست Node.js در پلسک
Node.js یک محیط اجرای JavaScript خارج از مرورگر است، نه نام یک فریم‌ورک خاص. اگر فقط خروجی HTML و CSS ایستا دارید، ممکن است اصلاً به اجرای دائمی Node.js روی هاست نیاز نداشته باشید. نیاز پروژه را از مستندات روش استقرار آن مشخص کنید.
طبق مستندات Plesk، قابلیت میزبانی به افزونهٔ Node.js Toolkit وابسته است. کاربر عادی هاست نمی‌تواند نبود این قابلیت در سرور را با آپلود یک فایل حل کند. در صورت نبود گزینه، نام دامنه و نیاز نسخهٔ پروژه را به پشتیبانی سرویس اعلام کنید.
ورود به تنظیمات دامنه
در Websites & Domains دامنهٔ مورد نظر را پیدا کنید. بسته به نسخه و نمایش پنل، Node.js مستقیماً در کارت دامنه یا زیر Create Website دیده می‌شود. پیش از تغییر، مطمئن شوید دامنهٔ فعالِ سایت دیگری را انتخاب نکرده‌اید.
تنظیمات اصلی شامل نسخهٔ اجرا، مسیر برنامه، مسیر فایل‌های عمومی و فایل شروع است. نام فایل شروع را از ساختار واقعی پروژه بردارید؛ نوشتن server.js فقط به این دلیل که در آموزشی دیده‌اید، فایل مفقود را ایجاد نمی‌کند.
انتخاب نسخه و بررسی ساختار
نسخهٔ مورد نیاز را از راهنمای پروژه و بخش engines در package.json بررسی کنید. وجود فایل package.json به‌تنهایی سازگاری همهٔ وابستگی‌ها را ثابت نمی‌کند. محدودیت نسخه و روش build نیز اهمیت دارند.
در Plesk لینوکس، Document Root باید زیرپوشهٔ Application Root باشد؛ در پلسک ویندوز قاعدهٔ مسیر متفاوت است. بنابراین تنظیمات تصویری یک محیط را بدون تطبیق روی محیط دیگر کپی نکنید. فایل‌های محرمانه و تنظیمات خصوصی نباید برای دانلود عمومی در دسترس باشند.
فعال‌سازی و معنای پیام موفقیت
پس از تنظیم مسیرها، Enable Node.js را بزنید. اگر پنل فعال شدن قابلیت را اعلام کرد ولی فایل شروع پیدا نشد، کار هنوز تمام نشده است. پیام موفقیت فقط همان مرحله را تأیید می‌کند؛ نصب وابستگی‌ها و آزمون برنامه جدا هستند.
اجرای NPM Install برای نصب بسته‌های پروژه است، نه نصب خود npm. برای خروجی وابسته به build نیز دستور ساختِ تعریف‌شده توسط پروژه لازم است. یک فایل JavaScript مرورگر را نمی‌توان همیشه به‌عنوان ورودی سرور اجرا کرد.
چک نهایی دامنه
- نشانی و گواهی HTTPS دامنه درست باشد.
- صفحهٔ مورد انتظار برنامه، نه صفحهٔ پیش‌فرض هاست، نمایش داده شود.
- درخواست‌های اصلی و فایل‌های عمومی بدون خطای مسیر کار کنند.
- گزارش برنامه اطلاعات محرمانه را به بازدیدکننده نمایش ندهد.
اگر به‌جای پاسخ برنامه خطا می‌بینید، همان زمان را در Logs بررسی کنید. تغییر تصادفی نسخه‌ها یا غیرفعال کردن حفاظت‌های سرور، جای تشخیص خطای فایل، وابستگی یا تنظیمات را نمی‌گیرد.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
