راه‌اندازی nginx unit روی دایرکت ادمین

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

پیش‌نیازهای نصب NGINX Unit روی دایرکت ادمین

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

• دسترسی کامل مدیریت: برخورداری از دسترسی روت (Root) به سرور از طریق ارتباط SSH ضروری است.
• لایسنس معتبر Pro Pack: دایرکت ادمین شما باید دارای لایسنس مدرن با قابلیت Pro Pack باشد، زیرا این ابزار در لایسنس‌های Legacy پشتیبانی نمی‌شود.
• نسخه به‌روز CustomBuild: سرور شما باید از ابزار CustomBuild 2.0 برای دریافت، کامپایل و نصب ماژول‌ها بهره ببرد.
• سیستم‌عامل سازگار: توزیع لینوکسی شما (مانند اوبونتو، آلما لینوکس یا دبیان) باید جزو نسخه‌های رسمی و پشتیبانی‌شده توسط دایرکت ادمین باشد.

نصب nginx unit در DirectAdmin

عملیات نصب این سرویس به لطف ابزار کاستوم‌بیلد در دایرکت ادمین به صورت کاملاً خودکار و در چند مرحله ساده انجام می‌پذیرد. در ادامه مراحل اجرایی آن آورده شده است:

۱. ورود به سرور: نرم‌افزار ترمینال یا PuTTY را باز کرده و با کاربر root به سرور متصل شوید.

۲. مراجعه به مسیر نصب: با استفاده از دستور cd /usr/local/directadmin/custombuild وارد پوشه تنظیمات شوید.

۳. به‌روزرسانی اسکریپت‌ها: برای جلوگیری از تداخل نسخه‌ها، ابتدا دستور زیر را اجرا کنید:

./build update

۴. تایید ماژول جهت نصب: فعال بودن ماژول را با کد زیر در تنظیمات CustomBuild ثبت نمایید.

./build set unit yes

۵. اجرای عملیات نصب: در نهایت با تایپ دستور زیر منتظر بمانید تا پکیج‌ها دانلود و نصب شوند.

./build unit

نکات تکمیلی راه‌اندازی nginx unit

برای استفاده بهینه از این سرویس، توجه به ساختار و نحوه مدیریت اپلیکیشن‌ها اهمیت زیادی دارد:

• ایجاد اپلیکیشن (Application): از پنل کاربری دایرکت ادمین وارد Advanced Features شده و در بخش Nginx Unit، با تعیین مسیر فایل‌ها و نوع زبان برنامه‌نویسی، پروژه خود را تعریف کنید.

• تنظیم مسیرهای هدایت (Routes): اپلیکیشن‌های ساخته‌شده به تنهایی در وب نمایش داده نمی‌شوند؛ شما باید یک Route جدید بسازید تا مشخص کنید ترافیک کدام دامنه یا زیردامنه باید به سمت این اپلیکیشن هدایت شود.

• فایل‌های تنظیمات: برخلاف تنظیمات متداول، تمام کانفیگ‌های NGINX Unit در قالب فایل‌های JSON (عموماً در مسیر var/lib/unit/conf.json) ذخیره می‌شوند که از طریق API قابل تغییر هستند.

مشکلات نصب و حل آن‌ها

در فرایند راه‌اندازی ممکن است با چالش‌هایی روبه‌رو شوید که در ادامه متداول‌ترین آن‌ها را بررسی و رفع می‌کنیم:

• عدم نمایش ماژول در دایرکت ادمین: اگر پس از نصب، گزینه NGINX Unit در پنل شما ظاهر نشد، ابتدا از فعال بودن Pro Pack در لایسنس خود مطمئن شوید. به عنوان راهکار سریع، می‌توانید تیک این قابلیت را از تنظیمات پکیج کاربران غیرفعال کرده و پس از ۱ دقیقه دوباره فعال کنید تا دسترسی‌ها به‌روز شوند.
• خطای پیکربندی (Value does not exist): این ارور معمولاً زمان ایجاد یک Route جدید و به دلیل خالی بودن لیست Listeners رخ می‌دهد. با اتصال به SSH و اجرای دستور زیر در پوشه CustomBuild، فایل‌های تنظیمات بازنویسی و مشکل برطرف می‌گردد.

./build rewrite_confs

• تداخل پورت و اجرا نشدن اپلیکیشن: اطمینان حاصل کنید کدهای برنامه شما روی پورتی تنظیم شده باشند که با سایر وب‌سرورهای سرور در تضاد نباشد.

جمع‌بندی

در این مقاله یاد گرفتیم که NGINX Unit یک بستر قدرتمند برای اجرای همزمان برنامه‌های توسعه‌یافته با زبان‌های گوناگون است. همچنین با مطالعه این راهنما توانستید پیش‌نیازهای سرور را بررسی کرده، مراحل نصب را از طریق CustomBuild به درستی پشت سر بگذارید و مشکلات احتمالی و خطاهای رایج را به راحتی شناسایی و برطرف کنید. با این مهارت‌ها، اکنون آماده‌اید تا اپلیکیشن‌های پویا و مدرن خود را با بالاترین کیفیت در بستر دایرکت ادمین میزبانی نمایید.

سوالات متداول

۱. آیا NGINX Unit جایگزین وب‌سرور سنتی سرور می‌شود؟

خیر، این اپلیکیشن سرور در کنار وب‌سرورهای اصلی (نظیر آپاچی یا NGINX) کار می‌کند و با آن‌ها تداخلی نخواهد داشت.

۲. این سرویس در دایرکت ادمین از چه زبان‌هایی پشتیبانی می‌کند؟

شما می‌توانید برنامه‌های نوشته‌شده با Python ،Node.js ،PHP ،Ruby ،Perl ،Go و Java را به سادگی میزبانی کنید.

۳. چرا نمی‌توانم مسیر (Route) جدیدی ایجاد کنم و با ارور مواجه می‌شوم؟

این مشکل معمولاً به دلیل وجود نقص در فایل تنظیمات JSON یا عدم شناسایی Listeners است که با بازنویسی تنظیمات از طریق دستور rewrite_confs در خط فرمان رفع می‌گردد.