NGINX(8) | System Manager's Manual | NGINX(8) |
nginx
— HTTP and
reverse proxy server, mail proxy server
nginx |
[-?hqtuVv ] [-c
file] [-g
directives] [-p
prefix] [-s
signal] |
nginx
(pronounced “engine
x”) is an HTTP and reverse proxy server, as well as a mail proxy
server. It is known for its high performance, stability, rich feature set,
simple configuration, and low resource consumption.
The options are as follows:
-?
|
-h
-c
file-g
directives-p
prefix-q
-s
signalstop
,
quit
, reopen
,
reload
. The following table shows the
corresponding system signals.
-t
nginx
checks the configuration file syntax and then tries to open any files
referred to in the configuration file.-u
nginx
will
chroot(2) to the home
directory of the user running the daemon, typically “www”,
or to the home directory of user
in
nginx.conf. The -u
option
disables this behaviour, and returns nginx
to the
original "unsecure" behaviour.-V
nginx
version, compiler version, and
configure script parameters.-v
nginx
version.The master process of nginx
can handle the
following signals.
SIGINT
,
SIGTERM
SIGHUP
SIGQUIT
SIGUSR1
SIGUSR2
nginx
executable on the fly.SIGWINCH
While there's no need to explicitly control worker processes normally, they support some signals too:
To enable a debugging log, reconfigure
nginx
to build with debugging:
./configure --with-debug
...
and then set the debug
level of the
error_log:
error_log /path/to/log
debug;
It is also possible to enable the debugging for a particular IP address:
events { debug_connection 127.0.0.1; }
nginx
. The contents of
this file are not sensitive, so it can be world-readable.The nginx
utility exits 0 on
success, and >0 if an error occurs.
Test configuration file ~/mynginx.conf with global directives for PID and quantity of worker processes:
nginx -t -c ~/mynginx.conf \ -g "pid /var/run/mynginx.pid; worker_processes 2;"
Documentation at http://nginx.org/en/docs/.
For questions and technical support, please refer to http://nginx.org/en/support.html.
Development of nginx
started in 2002, with
the first public release on October 4, 2004.
Igor Sysoev <igor@sysoev.ru>.
This manual page was written by Sergey A.
Osokin
<osa@FreeBSD.org.ru>
as a result of compiling many nginx
documents from
all over the world.
July 16, 2013 | OpenBSD-5.4 |