语法:worker_processes number | auto
默认值:worker_processes 1
语境:main
指定worker进程的数量。进程数最好是CPU核心数或CPU核心数的倍数。当设置为auto时,nginx会尝试自动获取CPU核心数并设置。
auto参数从v1.3.8和v1.2.5版本以后支持。
语法:worker_cpu_affinity cpumask ...;
worker_cpu_affinity auto [cpumask];
默认值:无
语境:main
将worker进程绑定到CPU核心,每个worker进程对应一个二进制掩码,掩码的每一位对应一个CPU。默认情况下,worker不与cpu核心绑定。此指令只适用于Linux和FreeBSD。
举例:
1 2 |
|
表示有4个worker进程,第一个绑定到CPU0,第二个绑定到CPU1,以此类推,4个进程分别绑定一个CPU核心。
再例:
1 2 |
|
表示将第一个进程绑定到CPU0/CPU2,第二个worker进程绑定到CPU1/CPU3,这个例子适用于超线程场景,即一个核心虚拟出两个CPU线程。
值auto(v1.9.10)允许自动和可用的CPU绑定:
1 2 |
|
掩码(mask)可用用于限制某些CPU参加绑定。例如:
1 |
|
只有CPU0/2/4/6参与绑定,其他的CPU不分配worker进程。
语法:worker_rlimit_core size;
默认值:无
语境:main
为worker进程修改系统核心转储文件(core file)的大小限制。通常提升这个值不需要重启主进程。
语法:worker_rlimit_nofile number;
默认值:无
语境:main
修改worker进程最大可打开句柄数限制。通常提升这个值不需要重启主进程。
语法:worker_shutdown_timeout time;
默认值:无
语境:main
此指令在v1.11.11中出现。用于设置安全地结束一个worker进程的超时时间。
当安全结束一个worker进程时,会停止对worker进程分配新连接,并等待他处理完当前的任务后再退出,如果设置了超时时间,超时后nginx会强制关闭worker进程的连接。
语法:working_directory directory;
默认值:无
语境:main
指定默认工作路径。主要用于worker进程导出内存转储文件,为worker进程指定的用户需要有改文件的写入权限。
连接处理控制指令
语法:events { ... }
默认值:无
语境:main
作用只是开辟一个指令区块,events语境中配置的指令用于控制连接处理行为。
语法:accept_mutex on | off;
默认值:accept_mutex off;
语境:events
当启用这个参数时,会使用互斥锁交替给worker进程分配新连接,否则话所有worker进程会争抢新连接,即或造成所谓的“惊群问题”,惊群问题会使nginx的空闲worker进程无法进入休眠状态,造成系统资源占用过多。启用此参数会一定程度上导致后台服务器负载不均衡,但是在高并发的情况下,关闭此参数可以提高nginx的吞吐量。
在支持epoll的操作系统上不需要启用accept_mutex(v1.11.3后),使用了reuseport功能也不需要启用(v1.9.1后,需要操作系统支持SO_REUSEPORT socket选项,Linux 3.9+)。
在v1.11.3以前版本中,默认值为on。
语法:accept_mutex_delay time;
默认值:accept_mutex_delay 500ms;
语境:events
如果accept_mutex参数启用,当一个空闲worker进程尝试获取互斥锁时发现有另一个worker进程已经获得互斥锁并处理新连接,这个空闲的worker进程等待下一次获取互斥锁尝试的时间。而获得互斥锁的进程在处理完当前连接后,会立即尝试获取互斥锁,因此此数值较大或连接压力较小时,会造成部分worker进程总是空闲,一部分进程总是繁忙的情况。
语法:debug_connection address | network | unix:;
默认值:无
语境:events
需要debug模块支持,需确认安装时包括了debug模块,可以使用nginx -V命令确定包含--wih-debug参数。
对特定的客户发起的连接开启debugging级别日志,用于分析和拍错。可以指定IPv4或者IPv6地址(v1.3.0,v1.2.1)或一个无类网段或域名,或UNIX socket(v1.3.0,v1.2.1)。例如:
1 2 3 4 5 6 7 |
|
非指定连接的日志级别依然由error_log指令决定。
语法:multi_accept on | off;
默认值:multi_accept off;
语境:events
当设置为off时,一个worker进程获得互斥锁时一次只处理一个新连接,如果设置为on,则一次性将所有新连接都分配给获得当前互斥锁的worker进程、当使用kqueue连接处理方式时(use kqueue),此项指令无效。
语法:use method;
默认值:无
语境:events
指定连接处理方式,通常不需要指定,nginx会自动使用最有效的方式。
连接处理方式用于决定用什么方法从当前的连接池中找出哪些连接已经准备好传输/接收数据。常见的连接处理方式有:
select(需要select模块)、poll(需要poll模块)、kqueue(macOS/FreeBSD 4.1+/OpenBSD 2.9+)、epoll(Linux 2.6+)、/dev/poll(Solaris 7 11/99+, HP/UX 11.22+ (eventport), IRIX 6.5.15+, and Tru64 UNIX 5.1A+)、eventport(Solaris 10+)
语法:worker_aio_requests number;
默认值:worker_aio_requests 32;
语境:events
在v1.1.4和1.0.7中出现。当启用aio(异步IO)和epoll连接处理方式后,单个worker进程最大的未完成异步IO操作数。
语法:worker_connections number;
默认值:worker_connections 512;
语境:events
单个worker进程可处理的最大并发连接数限制。
这个连接数包括和后台服务器之间的连接在内的所有的连接,而不仅是与客户的连接。所有worker进程的总连接数(即worker_connections × worker_processes )不能超过操作系统最大可打开句柄数的限制(nofile),nofile限制可以通过worker_rlimit_nofile指令修改。
以上就是Nginx配置文件实例详解的详细内容,更多文章请关注木庄网络博客!
相关阅读 >>
更多相关阅读请进入《nginx》频道 >>