راه‌اندازی Node.js در پلسک به فایل‌های آمادهٔ پروژه و نسخهٔ سازگار محیط اجرا نیاز دارد. این آموزش برای استقرار برنامهٔ خودتان است؛ برای تمرین از دامنه یا زیر‌دامنهٔ جدا استفاده کنید. ایجاد زیردامنه الزام Node.js نیست، اما مانع تداخل آزمایش با سایت فعال می‌شود.
آماده‌سازی راه‌اندازی Node.js در پلسک
ساختار پوشه، فایل شروع، نیازهای نسخه و فرمان build را از توسعه‌دهنده یا مستند پروژه بگیرید. package.json اطلاعات وابستگی‌ها و scriptها را نگه می‌دارد. فایل lock مربوط به مدیر بستهٔ همان پروژه را نیز همراه داشته باشید.
پوشهٔ node_modules ساخته‌شده روی سیستم دیگر ممکن است شامل افزونهٔ بومی ناسازگار باشد. وابستگی‌ها را برای محیط مقصد نصب کنید و فایل‌های موقت، رمزها و دادهٔ واقعی کاربران را در بستهٔ عمومی نمونه قرار ندهید.
آپلود بدون جایگزینی ناخواسته
در File Manager یک پوشهٔ مشخص برای برنامه انتخاب و فایل‌ها را با ساختار اصلی منتقل کنید. اگر فایل فشرده است، پیش از استخراج مسیر و پوشهٔ داخلی آن را بررسی کنید. گزینهٔ Replace existing files را روی سایت فعال بدون شناخت فایل‌های مقصد فعال نکنید.
لینک دانلود نمونهٔ قدیمی برای اجرای همهٔ پروژه‌ها مناسب نیست. مسیرهایی مانند routes/index.js فقط در بعضی ساختارهای Express وجود دارند؛ در پروژهٔ دیگری ممکن است اصلاً چنین پوشه‌ای نباشد.
مسیر عمومی و فایل شروع
در تنظیمات پلسک لینوکس، Application Root پوشهٔ اصلی پروژه و Document Root زیرپوشهٔ فایل‌های عمومی است. برای نمونه، app و app/public دو مسیر متفاوت‌اند. این نام‌ها نمونه‌اند؛ مسیر واقعی پروژه را تنظیم کنید. در پلسک ویندوز، قاعدهٔ تنظیم این دو ریشه متفاوت است.
فایل شروع باید با ورودی واقعی برنامه تطبیق داشته باشد. app.js، server.js یا یک فایل ساخته‌شده انتخاب‌های قابل تعویض خودکار نیستند. تغییر نام داخل پنل، فایل روی دیسک یا خروجی TypeScript را تولید نمی‌کند.
نصب وابستگی و ساخت خروجی
نسخهٔ Node.js و مدیر بستهٔ پروژه را انتخاب کنید، قابلیت را فعال و نصب وابستگی‌ها را اجرا کنید. اگر برنامه build لازم دارد، script مشخص آن را از ابزار اجرای script پنل یا محیط مجاز اجرا کنید. عبارت درست ممکن است build باشد، اما باید در پروژه تعریف شده باشد.
برای استقرار دارای package-lock هماهنگ، npm ci در محیط خط فرمان مناسب است: وابستگی‌ها را بر اساس lock نصب می‌کند و در صورت ناسازگاری فایل‌ها خطا می‌دهد. این فرمان node_modules قبلی را جایگزین می‌کند؛ آن را در پوشهٔ درست و مرحلهٔ استقرار برنامه اجرا کنید. دکمهٔ NPM Install لزوماً همان رفتار npm ci را ندارد.
تنظیم محیط و آزمون برنامه
اطلاعات اتصال دیتابیس و کلیدها را با روش محرمانهٔ سازگار با سرویس تنظیم کنید. نمایش Production فقط زمانی رفتار برنامه را تغییر می‌دهد که برنامه آن را رعایت کند؛ جای تنظیم امنیت و مدیریت خطا را نمی‌گیرد. پس از تغییر، از روش راه‌اندازی مجدد همان پنل استفاده کنید.
با HTTPS، مسیر اصلی، یک مسیر داخلی و یک فایل عمومی را باز کنید. برای برنامهٔ دارای حساب یا فرم، عملیات مرتبط را نیز با دادهٔ آزمایشی بررسی کنید. لازم نیست برای آزمایش پلسک درگاه داخلی برنامه را عمومی کنید.
وقتی برنامه بالا نمی‌آید
از Logs دامنه در زمان خطا شروع کنید: فایل پیدا نمی‌شود، dependency نصب نشده، نسخه ناسازگار است یا متغیر لازم وجود ندارد. نتیجهٔ آخرین نصب و build را هم بخوانید. ثبت خطای دقیق و رفع همان علت معمولاً مؤثرتر از تغییر هم‌زمان چند تنظیم است. راهنمای میزبانی Plesk مرجع گزینه‌های پنل است.
مطالعهٔ مرتبط
بازبینی فنی: ۱۳ آبان ۱۴۰۵. تاریخ انتشار اولیه و نشانی قبلی حفظ شده‌اند.
