.\"
.\" Copyright (C) 2010, 2019 Sergey A. Osokin
.\" Copyright (C) Nginx, Inc.
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"
.Dd January 21, 2026
.Dt NGINX 8
.Os
.Sh "نام (NAME)"
.Nm nginx
.Nd سرور وب و کارگزار معکوس HTTP، کارگزار ایمیل
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Fl ?hqTtVv
.Op Fl c Ar file
.Op Fl e Ar file
.Op Fl g Ar directives
.Op Fl p Ar prefix
.Op Fl s Ar signal
.Sh "توضیحات (DESCRIPTION)"
.Nm
(تلفظ می‌شود
.Dq engine x )
یک سرور HTTP و کارگزار معکوس (reverse proxy)، یک سرور کارگزار ایمیل، و یک سرور کارگزار عمومی TCP/UDP است.
این نرم‌افزار به دلیل کارایی بالا، پایداری، مجموعه قابلیت‌های غنی، پیکربندی ساده و مصرف اندک منابع شناخته می‌شود.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width ".Fl d Ar directives"
.It Fl ?\& , h
نمایش راهنما.
.It Fl c Ar file
استفاده از
.Ar file
پیکربندی جایگزین.
.It Fl e Ar file
استفاده از
.Ar file
ثبت گزارش خطای جایگزین.
مقدار ویژه
.Cm stderr
مشخص می‌کند که باید از خروجی خطای استاندارد استفاده شود.
.It Fl g Ar directives
تنظیم دستورالعمل‌های سراسری پیکربندی.
برای جزئیات بیشتر به بخش
.Sx "مثال‌ها (EXAMPLES)"
مراجعه کنید.
.It Fl p Ar prefix
تنظیم مسیر پیشوند.
مقدار پیش‌فرض
.Pa /etc/nginx
است.
.It Fl q
نادیده گرفتن پیام‌های غیرخطا در حین آزمایش پیکربندی.
.It Fl s Ar signal
ارسال سیگنال به فرایند اصلی (master process).
آرگومان
.Ar signal
می‌تواند یکی از موارد زیر باشد:
.Cm stop , quit , reopen , reload .
جدول زیر سیگنال‌های سیستمی متناظر را نشان می‌دهد:
.Pp
.Bl -tag -width ".Cm reopen" -compact
.It Cm stop
.Dv SIGTERM
.It Cm quit
.Dv SIGQUIT
.It Cm reopen
.Dv SIGUSR1
.It Cm reload
.Dv SIGHUP
.El
.It Fl T
مشابه
.Fl t
اما علاوه بر آن، فایل‌های پیکربندی را در خروجی استاندارد درج (dump) می‌کند.
.It Fl t
عدم اجرا، فقط آزمایش فایل پیکربندی.
.Nm
نحو فایل پیکربندی را بررسی کرده و سپس تلاش می‌کند فایل‌های ارجاع‌داده‌شده در فایل پیکربندی را باز کند، از جمله اتصال (bind) به نشانی‌های گوش‌دادن پیکربندی‌شده.
.It Fl V
نمایش نسخه
.Nm
، نسخه کامپایلر، و پارامترهای اسکریپت
.Pa configure .
.It Fl v
نمایش نسخه
.Nm .
.El
.Sh "سیگنال‌ها (SIGNALS)"
فرایند اصلی
.Nm
می‌تواند سیگنال‌های زیر را مدیریت کند:
.Pp
.Bl -tag -width ".Dv SIGINT , SIGTERM" -compact
.It Dv SIGINT , SIGTERM
خاموش شدن سریع.
.It Dv SIGHUP
بارگذاری مجدد پیکربندی، راه‌اندازی فرایند کاری جدید با پیکربندی جدید، و خاموش کردن مسالمت‌آمیز (graceful) فرایندهای کاری قدیمی.
.It Dv SIGQUIT
خاموش شدن مسالمت‌آمیز.
.It Dv SIGUSR1
بازگشایی مجدد فایل‌های گزارش.
.It Dv SIGUSR2
ارتقای فایل اجرایی
.Nm
به‌صورت زنده و بدون وقفه (on the fly).
.It Dv SIGWINCH
خاموش کردن مسالمت‌آمیز فرایندهای کاری.
.El
.Pp
اگرچه در شرایط عادی نیازی به کنترل صریح فرایندهای کاری نیست، اما آن‌ها نیز از برخی سیگنال‌ها پشتیبانی می‌کنند:
.Pp
.Bl -tag -width ".Dv SIGINT , SIGTERM" -compact
.It Dv SIGTERM
خاموش شدن سریع.
.It Dv SIGQUIT
خاموش شدن مسالمت‌آمیز.
.It Dv SIGUSR1
بازگشایی مجدد فایل‌های گزارش.
.El
.Sh "گزارش اشکال‌زدایی (DEBUGGING LOG)"
برای فعال‌سازی گزارش اشکال‌زدایی،
.Nm
را جهت ساخت با قابلیت اشکال‌زدایی مجدداً پیکربندی کنید:
.Pp
.Dl "./configure --with-debug ..."
.Pp
و سپس سطح
.Cm debug
را برای
.Va error_log
تنظیم کنید:
.Pp
.Dl "error_log /path/to/log debug;"
.Pp
همچنین امکان فعال‌سازی اشکال‌زدایی برای یک نشانی IP خاص وجود دارد:
.Bd -literal -offset indent
events {
	debug_connection 127.0.0.1;
}
.Ed
.Sh "متغیرهای محیطی (ENVIRONMENT)"
متغیر محیطی
.Ev NGINX
به‌صورت داخلی توسط
.Nm
استفاده می‌شود و نباید مستقیماً توسط کاربر تنظیم شود.
.Sh "فایل‌ها (FILES)"
.Bl -tag -width indent
.It Pa /run/nginx.pid
حاوی شناسه فرایند (PID)
.Nm .
محتویات این فایل حساس نیست، بنابراین برای همگان قابل خواندن است.
.It Pa /etc/nginx/nginx.conf
فایل اصلی پیکربندی.
.It Pa stderr
فایل گزارش خطا.
.El
.Sh "وضعیت خروج (EXIT STATUS)"
وضعیت خروج در صورت موفقیت 0 و در صورت شکست دستور 1 است.
.Sh "مثال‌ها (EXAMPLES)"
آزمایش فایل پیکربندی
.Pa ~/mynginx.conf
با دستورالعمل‌های سراسری برای PID و تعداد فرایندهای کاری:
.Bd -literal -offset indent
nginx -t -c ~/mynginx.conf \e
	-g "pid /var/run/mynginx.pid; worker_processes 2;"
.Ed
.Sh "همچنین ببینید (SEE ALSO)"
.\"Xr nginx.conf 5
.\"Pp
مستندات در
.Pa http://nginx.org/en/docs
.Pp
برای پرسش‌ها و پشتیبانی فنی، لطفاً به
.Pa http://nginx.org/en/support.html
مراجعه کنید.
.Sh "تاریخچه (HISTORY)"
توسعه
.Nm
در سال 2002 آغاز شد و نخستین انتشار عمومی آن در 4 اکتبر 2004 بود.
.Sh "نویسندگان (AUTHORS)"
.An -nosplit
.An Igor Sysoev Aq Mt igor@sysoev.ru .
.Pp
این صفحه راهنما در اصل توسط
.An Sergey A. Osokin Aq Mt osa@FreeBSD.org.ru
در نتیجه گردآوری اسناد متعدد
.Nm
از سراسر جهان نوشته شده است.