نام (NAME)

nginx — سرور وب و کارگزار معکوس HTTP، کارگزار ایمیل

خلاصه دستور (SYNOPSIS)

nginx [-?hqTtVv] [-c file] [-e file] [-g directives] [-p prefix] [-s signal]

توضیحات (DESCRIPTION)

nginx (تلفظ می‌شود “engine x”) یک سرور HTTP و کارگزار معکوس (reverse proxy)، یک سرور کارگزار ایمیل، و یک سرور کارگزار عمومی TCP/UDP است. این نرم‌افزار به دلیل کارایی بالا، پایداری، مجموعه قابلیت‌های غنی، پیکربندی ساده و مصرف اندک منابع شناخته می‌شود.

گزینه‌ها به شرح زیر هستند:

-?, -h

نمایش راهنما.

-c file

استفاده از file پیکربندی جایگزین.

-e file

استفاده از file ثبت گزارش خطای جایگزین. مقدار ویژه stderr مشخص می‌کند که باید از خروجی خطای استاندارد استفاده شود.

-g directives

تنظیم دستورالعمل‌های سراسری پیکربندی. برای جزئیات بیشتر به بخش مثال‌ها (EXAMPLES) مراجعه کنید.

-p prefix

تنظیم مسیر پیشوند. مقدار پیش‌فرض /etc/nginx است.

-q

نادیده گرفتن پیام‌های غیرخطا در حین آزمایش پیکربندی.

-s signal

ارسال سیگنال به فرایند اصلی (master process). آرگومان signal می‌تواند یکی از موارد زیر باشد: stop, quit, reopen, reload. جدول زیر سیگنال‌های سیستمی متناظر را نشان می‌دهد:

stop: SIGTERM
quit: SIGQUIT
reopen: SIGUSR1
reload: SIGHUP

-T

مشابه -t اما علاوه بر آن، فایل‌های پیکربندی را در خروجی استاندارد درج (dump) می‌کند.

-t

عدم اجرا، فقط آزمایش فایل پیکربندی. nginx نحو فایل پیکربندی را بررسی کرده و سپس تلاش می‌کند فایل‌های ارجاع‌داده‌شده در فایل پیکربندی را باز کند، از جمله اتصال (bind) به نشانی‌های گوش‌دادن پیکربندی‌شده.

-V

نمایش نسخه nginx ، نسخه کامپایلر، و پارامترهای اسکریپت configure.

-v

نمایش نسخه nginx.

سیگنال‌ها (SIGNALS)

فرایند اصلی nginx می‌تواند سیگنال‌های زیر را مدیریت کند:

SIGINT, SIGTERM: خاموش شدن سریع.
SIGHUP: بارگذاری مجدد پیکربندی، راه‌اندازی فرایند کاری جدید با پیکربندی جدید، و خاموش کردن مسالمت‌آمیز (graceful) فرایندهای کاری قدیمی.
SIGQUIT: خاموش شدن مسالمت‌آمیز.
SIGUSR1: بازگشایی مجدد فایل‌های گزارش.
SIGUSR2: ارتقای فایل اجرایی nginx به‌صورت زنده و بدون وقفه (on the fly).
SIGWINCH: خاموش کردن مسالمت‌آمیز فرایندهای کاری.

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

SIGTERM: خاموش شدن سریع.
SIGQUIT: خاموش شدن مسالمت‌آمیز.
SIGUSR1: بازگشایی مجدد فایل‌های گزارش.

گزارش اشکال‌زدایی (DEBUGGING LOG)

برای فعال‌سازی گزارش اشکال‌زدایی، nginx را جهت ساخت با قابلیت اشکال‌زدایی مجدداً پیکربندی کنید:

./configure --with-debug
  ...

و سپس سطح debug را برای error_log تنظیم کنید:

error_log /path/to/log
  debug;

همچنین امکان فعال‌سازی اشکال‌زدایی برای یک نشانی IP خاص وجود دارد:

events {
	debug_connection 127.0.0.1;
}

متغیرهای محیطی (ENVIRONMENT)

متغیر محیطی NGINX به‌صورت داخلی توسط nginx استفاده می‌شود و نباید مستقیماً توسط کاربر تنظیم شود.

فایل‌ها (FILES)

/run/nginx.pid: حاوی شناسه فرایند (PID) nginx. محتویات این فایل حساس نیست، بنابراین برای همگان قابل خواندن است.
/etc/nginx/nginx.conf: فایل اصلی پیکربندی.
stderr: فایل گزارش خطا.

وضعیت خروج (EXIT STATUS)

وضعیت خروج در صورت موفقیت 0 و در صورت شکست دستور 1 است.

مثال‌ها (EXAMPLES)

آزمایش فایل پیکربندی ~/mynginx.conf با دستورالعمل‌های سراسری برای PID و تعداد فرایندهای کاری:

nginx -t -c ~/mynginx.conf \
	-g "pid /var/run/mynginx.pid; worker_processes 2;"

همچنین ببینید (SEE ALSO)

مستندات در http://nginx.org/en/docs

برای پرسش‌ها و پشتیبانی فنی، لطفاً به http://nginx.org/en/support.html مراجعه کنید.

تاریخچه (HISTORY)

توسعه nginx در سال 2002 آغاز شد و نخستین انتشار عمومی آن در 4 اکتبر 2004 بود.

نویسندگان (AUTHORS)

Igor Sysoev <igor@sysoev.ru>.

این صفحه راهنما در اصل توسط Sergey A. Osokin <osa@FreeBSD.org.ru> در نتیجه گردآوری اسناد متعدد nginx از سراسر جهان نوشته شده است.