configure 支持下面的选项:
–prefix=<path> - Nginx安装路径。如果没有指定,默认为 /usr/local/nginx。
–sbin-path=<path> - Nginx可执行文件安装路径。只能安装时指定,如果没有指定,默认为<prefix>/sbin/nginx。
–conf-path=<path> - 在没有给定-c选项下默认的nginx.conf的路径。如果没有指定,默认为<prefix>/conf/nginx.conf。
–pid-path=<path> - 在nginx.conf中没有指定pid指令的情况下,默认的nginx.pid的路径。如果没有指定,默认为 <prefix>/logs/nginx.pid。
–lock-path=<path> - nginx.lock文件的路径。
–error-log-path=<path> - 在nginx.conf中没有指定error_log指令的情况下,默认的错误日志的路径。如果没有指定,默认为 <prefix>/logs/error.log。
–http-log-path=<path> - 在nginx.conf中没有指定access_log指令的情况下,默认的访问日志的路径。如果没有指定,默认为 <prefix>/logs/access.log。
–user=<user> - 在nginx.conf中没有指定user指令的情况下,默认的nginx使用的用户。如果没有指定,默认为 nobody。
–group=<group> - 在nginx.conf中没有指定user指令的情况下,默认的nginx使用的组。如果没有指定,默认为 nobody。
–builddir=DIR - 指定编译的目录
–with-rtsig_module - 启用 rtsig 模块
–with-select_module –without-select_module - Whether or not to enable the select module. This module is enabled by default if a more suitable method such as kqueue, epoll, rtsig or /dev/poll is not discovered by configure.
//允许或不允许开启SELECT模式,如果 configure 没有找到更合适的模式,比如:kqueue(sun os),epoll (linux kenel 2.6+), rtsig(实时信号)或者/dev/poll(一种类似select的模式,底层实现与SELECT基本相 同,都是采用轮训方法) SELECT模式将是默认安装模式
–with-poll_module –without-poll_module - Whether or not to enable the poll module. This module is enabled by default if a more suitable method such as kqueue, epoll, rtsig or /dev/poll is not discovered by configure.
–with-http_ssl_module - Enable ngx_http_ssl_module. Enables SSL support and the ability to handle HTTPS requests. Requires OpenSSL. On Debian, this is libssl-dev.
//开启HTTP SSL模块,使NGINX可以支持HTTPS请求。这个模块需要已经安装了OPENSSL,在DEBIAN上是libssl
–with-http_realip_module - 启用 ngx_http_realip_module
–with-http_addition_module - 启用 ngx_http_addition_module
–with-http_sub_module - 启用 ngx_http_sub_module
–with-http_dav_module - 启用 ngx_http_dav_module
–with-http_flv_module - 启用 ngx_http_flv_module
–with-http_stub_status_module - 启用 “server status” 页
–without-http_charset_module - 禁用 ngx_http_charset_module
–without-http_gzip_module - 禁用 ngx_http_gzip_module. 如果启用,需要 zlib 。
–without-http_ssi_module - 禁用 ngx_http_ssi_module
–without-http_userid_module - 禁用 ngx_http_userid_module
–without-http_access_module - 禁用 ngx_http_access_module
–without-http_auth_basic_module - 禁用 ngx_http_auth_basic_module
–without-http_autoindex_module - 禁用 ngx_http_autoindex_module
–without-http_geo_module - 禁用 ngx_http_geo_module
–without-http_map_module - 禁用 ngx_http_map_module
–without-http_referer_module - 禁用 ngx_http_referer_module
–without-http_rewrite_module - 禁用 ngx_http_rewrite_module. 如果启用需要 PCRE 。
–without-http_proxy_module - 禁用 ngx_http_proxy_module
–without-http_fastcgi_module - 禁用 ngx_http_fastcgi_module
–without-http_memcached_module - 禁用 ngx_http_memcached_module
–without-http_limit_zone_module - 禁用 ngx_http_limit_zone_module
–without-http_empty_gif_module - 禁用 ngx_http_empty_gif_module
–without-http_browser_module - 禁用 ngx_http_browser_module
–without-http_upstream_ip_hash_module - 禁用 ngx_http_upstream_ip_hash_module
–with-http_perl_module - 启用 ngx_http_perl_module
–with-perl_modules_path=PATH - 指定 perl 模块的路径
–with-perl=PATH - 指定 perl 执行文件的路径
–http-log-path=PATH - Set path to the http access log
–http-client-body-temp-path=PATH - Set path to the http client request body temporary files
–http-proxy-temp-path=PATH - Set path to the http proxy temporary files
–http-fastcgi-temp-path=PATH - Set path to the http fastcgi temporary files
–without-http - 禁用 HTTP server
–with-mail - 启用 IMAP4/POP3/SMTP 代理模块
–with-mail_ssl_module - 启用 ngx_mail_ssl_module
–with-cc=PATH - 指定 C 编译器的路径
–with-cpp=PATH - 指定 C 预处理器的路径
–with-cc-opt=OPTIONS - Additional parameters which will be added to the variable CFLAGS. With the use of the system library PCRE in FreeBSD, it is necessary to indicate –with-cc-opt=”-I /usr/local/include”. If we are using select() and it is necessary to increase the number of file descriptors, then this also can be assigned here: –with-cc-opt=”-D FD_SETSIZE=2048″.
–with-ld-opt=OPTIONS - Additional parameters passed to the linker. With the use of the system library PCRE in FreeBSD, it is necessary to indicate –with-ld-opt=”-L /usr/local/lib”.
–with-cpu-opt=CPU - 为特定的 CPU 编译,有效的值包括:pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64
–without-pcre - 禁止 PCRE 库的使用。同时也会禁止 HTTP rewrite 模块。在 “location” 配置指令中的正则表达式也需要 PCRE 。
–with-pcre=DIR - 指定 PCRE 库的源代码的路径。
–with-pcre-opt=OPTIONS - Set additional options for PCRE building.
–with-md5=DIR - Set path to md5 library sources.
–with-md5-opt=OPTIONS - Set additional options for md5 building.
–with-md5-asm - Use md5 assembler sources.
–with-sha1=DIR - Set path to sha1 library sources.
–with-sha1-opt=OPTIONS - Set additional options for sha1 building.
–with-sha1-asm - Use sha1 assembler sources.
–with-zlib=DIR - Set path to zlib library sources.
–with-zlib-opt=OPTIONS - Set additional options for zlib building.
–with-zlib-asm=CPU - Use zlib assembler sources optimized for specified CPU, valid values are: pentium, pentiumpro
–with-openssl=DIR - Set path to OpenSSL library sources
–with-openssl-opt=OPTIONS - Set additional options for OpenSSL building
–with-debug - 启用调试日志
–add-module=PATH - Add in a third-party module found in directory PATH
在不同版本间,选项可能会有些许变化,请总是使用 ./configure –help 命令来检查一下当前的选项列表。
示例 (最好能在同一行):
./configure
–sbin-path=/usr/local/nginx/nginx
–conf-path=/usr/local/nginx/nginx.conf
–pid-path=/usr/local/nginx/nginx.pid
–with-http_ssl_module
–with-pcre=../pcre-4.4
–with-zlib=../zlib-1.1.3
Example on Ubuntu/debian with libgcrypt11-dev, libpcre3-dev and libssl-dev installed (choose EITHER –with-md5 OR –with-sha1, but not both; on debian and ubuntu, they should both point to /usr/lib)
./configure --with-openssl=/usr/lib/ssl/ --with-md5=/usr/lib选项
-c </path/to/config> 为 Nginx 指定一个配置文件,来代替缺省的。
-t 不运行,而仅仅测试配置文件。nginx 将检查配置文件的语法的正确性,并尝试打开配置文件中所引用到的文件。
-v 显示 nginx 的版本。
-V 显示 nginx 的版本,编译器版本和配置参数。
示例
/usr/bin/nginx -t -c ~/mynginx.conf
通过系统的信号控制 Nginx
可以使用信号系统来控制主进程。默认,nginx 将其主进程的 pid 写入到 /usr/local/nginx/logs/nginx.pid 文件中。通过传递参数给 ./configure 或使用 pid 指令,来改变该文件的位置。
主进程可以处理以下的信号:
TERM, INT
快速关闭
QUIT
从容关闭
HUP
重载配置
用新的配置开始新的工作进程
从容关闭旧的工作进程
USR1
重新打开日志文件
USR2
平滑升级可执行程序。
WINCH
从容关闭工作进程
尽管你不必自己操作工作进程,但是,它们也支持一些信号:
TERM, INT
快速关闭
QUIT
从容关闭
USR1
重新打开日志文件
使用信号加载新的配置
Nginx 支持几个信号,能在它运行时控制其操作。其中最普通的是 15 ,用来中止运行的进程:
# ps aux | egrep '(PID|nginx)'
USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
root 22130.00.0 67842036 ? Ss 03:01 0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
# kill -15 2213
而最有趣的是能平滑改变 nginx 配置的选项(请注意,在重载前,要先测试一下配置文件):
# nginx -t -c /etc/nginx/nginx.conf
2006/09/16 13:07:10 [info] 15686#0: the configuration file /etc/nginx/nginx.conf syntax is ok
2006/09/16 13:07:10 [info] 15686#0: the configuration file /etc/nginx/nginx.conf was tested successfully
# ps aux | egrep ‘(PID|nginx)’
USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
root 22130.00.0 67842036 ? Ss 03:01 0:00 nginx: master process /usr/sbin/nginx -c /etc/nginx/nginx.conf
# kill -HUP 2213
当 nginx 接收到 HUP 信号,它会尝试先解析配置文件(如果指定配置文件,就使用指定的,否则使用默认的),成功的话,就应用新的配置文件(例如:重新打开日志文件或监听的套接 字)。之后,nginx 运行新的工作进程并从容关闭旧的工作进程。通知工作进程关闭监听套接字但是继续为当前连接的客户提供服务。所有客户端的服务完成后,旧的工作进程被关闭。 如果新的配置文件应用失败,nginx 将继续使用旧的配置进行工作。
RequestForReviewCategory
平滑升级到新的二进制代码
你可以在不中断服务的情况下 - 新的请求也不会丢失,使用新的 nginx 可执行程序替换旧的(当升级新版本或添加/删除服务器模块时)。
首先,使用新的可执行程序替换旧的(最好做好备份),然后,发送 USR2 (kill -USR2 pid)信号给主进程。主进程将重命名它的 .pid 文件为 .oldbin (比如:/usr/local/nginx/logs/nginx.pid.oldbin),然后执行新的可执行程序,依次启动新的主进程和新的工作进程:
PIDPPID USER %CPU VSZ WCHANCOMMAND
33126 1 root 0.01164 pausenginx: master process /usr/local/nginx/sbin/nginx
33134 33126 nobody 0.01368 kqread nginx: worker process (nginx)
33135 33126 nobody 0.01380 kqread nginx: worker process (nginx)
33136 33126 nobody 0.01368 kqread nginx: worker process (nginx)
36264 33126 root 0.01148 pausenginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.01364 kqread nginx: worker process (nginx)
在这时,两个 nginx 实例会同时运行,一起处理输入的请求。要逐步停止旧的实例,你必须发送 WINCH 信号给旧的主进程,然后,它的工作进程就将开始从容关闭:
PIDPPID USER %CPU VSZ WCHANCOMMAND
33126 1 root 0.01164 pausenginx: master process /usr/local/nginx/sbin/nginx
33135 33126 nobody 0.01380 kqread nginx: worker process is shutting down (nginx)
36264 33126 root 0.01148 pausenginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.01364 kqread nginx: worker process (nginx)
一段时间后,旧的工作进程处理了所有已连接的请求后退出,就仅由新的工作进程来处理输入的请求了:
PIDPPID USER %CPU VSZ WCHANCOMMAND
33126 1 root 0.01164 pausenginx: master process /usr/local/nginx/sbin/nginx
36264 33126 root 0.01148 pausenginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.01364 kqread nginx: worker process (nginx)
这时,因为旧的服务器还尚未关闭它监听的套接字,所以,通过下面的几步,你仍可以恢复旧的服务器:
发送 HUP 信号给旧的主进程 - 它将在不重载配置文件的情况下启动它的工作进程
发送 QUIT 信号给新的主进程,要求其从容关闭其工作进程
发送 TERM 信号给新的主进程,迫使其退出
如果因为某些原因新的工作进程不能退出,向其发送 KILL 信号
新的主进程退出后,旧的主进程会由移除 .oldbin 前缀,恢复为它的 .pid 文件,这样,一切就都恢复到升级之前了。
如果尝试升级成功,而你也希望保留新的服务器时,发送 QUIT 信号给旧的主进程使其退出而只留下新的服务器运行:
PIDPPID USER %CPU VSZ WCHANCOMMAND
36264 1 root 0.01148 pausenginx: master process /usr/local/nginx/sbin/nginx
36265 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36266 36264 nobody 0.01364 kqread nginx: worker process (nginx)
36267 36264 nobody 0.01364 kqread nginx: worker process (nginx)hash表
Ngnix使用hash表来协助完成请求的快速处理。
考虑到保存键及其值的hash表存储单元的大小不至于超出设定参数(hash bucket size), 在启动和每次重新配置时,Nginx为hash表选择尽可能小的尺寸。
直到hash表超过参数(hash max size)的大小才重新进行选择. 对于大多数hash表都有指令来修改这些参数。例如,保存服务器名字的hash表是由指令 server_names_hash_max_size 和 server_names_hash_bucket_size所 控制的。参数hash bucket size总是等于hash表的大小,并且是一路处理器缓存大小的倍数。在减少了在内存中的存取次数后,使在处理器中加速查找hash表键值成为可能。如果 hash bucket size等于一路处理器缓存的大小,那么在查找键的时候,最坏的情况下在内存中查找的次数为2。第一次是确定存储单元的地址,第二次是在存储单元中查找键 值。因此,如果Nginx给出需要增大 hash max size 或 hash bucket size的提示,那么首要的是增大前一个参数的大小.
事件模型
Nginx支持如下处理连接的方法(I/O复用方法),这些方法可以通过use指令指定。
select - 标准方法。 如果当前平台没有更有效的方法,它是编译时默认的方法。你可以使用配置参数 –with-select_module 和 –without-select_module 来启用或禁用这个模块。
poll - 标准方法。 如果当前平台没有更有效的方法,它是编译时默认的方法。你可以使用配置参数 –with-poll_module 和 –without-poll_module 来启用或禁用这个模块。
kqueue - 高效的方法,使用于 FreeBSD 4.1+, OpenBSD 2.9+, NetBSD 2.0 和 MacOS X. 使用双处理器的MacOS X系统使用kqueue可能会造成内核崩溃。
epoll - 高效的方法,使用于Linux内核2.6版本及以后的系统。在某些发行版本中,如SuSE 8.2, 有让2.4版本的内核支持epoll的补丁。
rtsig - 可执行的实时信号,使用于Linux内核版本2.2.19以后的系统。默认情况下整个系统中不能出现大于1024个POSIX实时(排队)信号。这种情况对于高负载的服务器来说是低效的;所以有必要通过调节内核参数 /proc/sys/kernel/rtsig-max 来增加队列的大小。可是从Linux内核版本2.6.6-mm2开始, 这个参数就不再使用了,并且对于每个进程有一个独立的信号队列,这个队列的大小可以用 RLIMIT_SIGPENDING 参数调节。当这个队列过于拥塞,nginx就放弃它并且开始使用 poll 方法来处理连接直到恢复正常。
/dev/poll - 高效的方法,使用于 Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+ 和 Tru64 UNIX 5.1A+.
eventport - 高效的方法,使用于 Solaris 10. 为了防止出现内核崩溃的问题, 有必要安装 http://sunsolve.sun.com/search/document.do?assetkey=1-26-102485-1 安全补丁。