Nginx的配置
运行中Nginx进程间的关系
# 为什么产品环境下安装master-worker方式配置同时启动多个进程?
- master进程不会对用户提供服务,只用于管理真正提供服务的worker进程,所以master进程可以是唯一的,为管理员 提供命令行服务,如启停、重载配置文件、平滑升级程序等。
master拥有的权限相对worker要大,当任意一个worker进程出现错误,master进程会立刻启动新的worker进程继续服务。
- 多个worker进程处理请求不但可以提供服务的健壮性,还可以充分利用常见的SMP多核架构,实现微观上真正的多核并发处理。
用一个master处理请求肯定是不合适的,将worker进程数量设置与CPU核数一致,真是Nginx与Apache服务器不同之处。
在Apache上每个进程在一个时刻只处理一个请求,因此,如果希望web服务器拥有并发处理的请求数更多,就要把Apache进程或线程数设置得更多,这样大量进程切换会无谓的消耗系统资源。
而Ngnix一个worker进程可以同时处理的请求数只受限于内存大小,而且在架构设计上,不同的worker进程之间处理并发请求时几乎没有同步锁的限制。,worker进程通常不会进入睡眠状态。因此,Nginx上的进程数与CPU核心数相等时,进程间切换的代价是最小的。
1.Nginx配置通用语法
# 块配置项:由一个块配置项名和一对大括号组成。
server {
...
}
# 配置项的语法格式
配置项名 配置项值1 配置项值2 ...;
access_log logs/access.log main buffer=32k;
说明:
1.行首是配置项名,配置项名必须是Nginx的某一个模块想要处理的,否则视为非法配置项名。
2.配置项名输入后,将以空格作为分隔符。
3.配置项值可以是数字,字符串或正则表达式。
4.一个配置项可以有一个或多个配置项值,一个配置项的配置项值有多少个取决于解析这个配置项的模块。
5.配置项值之间也是使用空格作为分隔符。
6.每行配置的结尾需要加上分号。
7.如果配置项值中包括语法符号,比如空格需要使用单引号或双引号包裹,否则Nginx会报语法错误。
2.配置项注释
# 使用#注释某一行配置
#pid logs/nginx.pid;
3.配置项的单位
# 大部分模块遵循一些通用规定,如指定空间大小不用每次都精确到字节;指定时间不用精确到毫秒。
- 当指定空间大小时,可使用单位:
- K或k千字节(KB)
- M或m兆字节(MB)
- 当指定时间时,可使用单位:
- ms(毫秒)
- s(秒)
- m(分钟)
- h(小时)
- d(天)
- w(周,包含7天)
- M(月,包含30天)
- y(年,包含365天)
4.在配置中使用变量
log_format main '$remote_addr - $remote_user [$time_local] "$request"'
# 如remote_addr是一个变量,使用时需要加上$符合。这种变量只有少数模块支持,并非通用。
Nginx服务的基本配置
Nginx运行时,至少必须加载几个核心模块和一个事件类模块。
这些模块运行时所支持的配置项称为基本配置——所有其他模块执行时都依赖的配置项。
基本配置项分为:
- 调试、定位问题配置项
- 正常运行的必备配置项
- 优化性能的配置项
- 事件类配置项(有些事件类配置项归到优化性能配置项)
1.用于调试进程和定位问题的配置项
序号 |
分类 |
语法 |
默认 |
说明 |
序号 |
分类 |
语法 |
默认 |
说明 |
1 |
是否以守护进程方式运行Nginx |
daemon on/off; |
daemon on; |
守护进程(daemon)是脱离终端并在后台运行的进程。脱离终端是为了避免执行过程中信息在终端上显示,同时也避免进程被终端输入中断。 |
2 |
是否以master/worker方式工作 |
master_process on/off; |
master_process on; |
提供该方式方便跟踪调试Nginx。如果不使用该方式,在worker异常时无法fork出worker子进程来处理请求。 |
3 |
error日志的设置 |
error_log /path/file level; |
error_log logs/error.log error; |
错误日志是定位Nginx问题的最佳工具。level是日志级别,取值:debug,info,notice,warn,error,crit,alert,emerg。从左至右依次增大 |
4 |
是否处理几个特殊的调试点 |
debug_points [stop/abort] |
/ |
用于帮助用户跟踪调试Nginx。设置stop时,Nginx执行到这些调试点时就会发出SIGSTOP信息用以调试;设置abort时,会产生一个coredump文件,可使用gdp来查看。通常不使用该配置项。 |
5 |
仅对指定客户端输出debug级别日志 |
debug_connection [IP/CIDR |
/ |
该配置实际属于事件类配置,因此需写到events块events |
6 |
限制coredump核心转储文件的大小 |
worker_rlimit_core size; |
/ |
在Linux系统中,当进程发生错误或收到信号终止,系统会将进程执行时的内存内容(核心镜像)写入一个文件(core文件),用作调试,这就是所谓的核心转储(core dumps)。当Nginx进程出现一些非法操作(如内存越界)导致进程直接被操作系统结束时,会生成核心转储core文件,可从core文件获取当时的堆栈、寄存器等信息,帮助定位问题。若不对文件大小进行限制可能达到几GB,这样随便几次coredumps就会把磁盘占满。 |
7 |
指定coredump文件生成目录 |
working_directory_ path; |
/ |
worker进程的工作目录,这个配置唯一用途就是coredump文件所放置的目录,协助定位问题。需确保worker进程有权限向working_directory指定的目录中写入文件。 |
如果日志设置debug级别或使用debug_connection,在configure时加入--with-debug
2.正常运行的配置项
序号 |
分类 |
语法 |
默认 |
说明 |
序号 |
分类 |
语法 |
默认 |
说明 |
1 |
定义环境变量 |
env VAR/VAR=VALUE; |
/ |
该配置项可以让用户之间设置操作系统上的环境变量。eg:env TESTPATH=/tmp/ |
2 |
嵌入其他配置文件 |
include /path/file |
/ |
该配置项可以将其他配置文件嵌入到当前nginx.conf文件中,它的参数可以是相对路径(相对于Nginx的配置目录,即nginx.conf所在目录),也可以是绝对路径。eg:includ mime.types; include vhost/星.conf;库看到参数值可以是一个明确文件,也可以是含有通配符“*”的文件名,同时一次嵌入多个配置文件 |
3 |
pid文件路径 |
pid path/file; |
pid logs/nginx.pid; |
保存master进程ID的pid文件存放路径。默认与configure执行时的参数“--pid-path”所指定的路径是相同的,可随时修改,确保Nginx有权限在相应目标中创建pid文件,该文件直接影响Nginx是否可以运行。 |
4 |
Nginx worker进程运行的用户及用户组 |
user username[groupname]; |
user nobody nobody; |
user用于设置master进程启动后,fork出的worker进程运行在哪个用户和用户组下。当按照“user username;”设置,用户组名与用户名相同。若用户在configure参数执行时使用--user=username和--group=groupname时,nginx.conf将使用参数中指定的用户和用户组。 |
5 |
指定Nginx worker进程可以打开的最大文件句柄描述符个数 |
worker_rlimit_nofile limit; |
/ |
设置一个worker进程可以打开的最大文件句柄数。 |
6 |
限制信号队列 |
worker_rlimit_sigpending limit; |
/ |
设置每个用户发往Nginx的信号队列的大小。即,当某个用户的信号队列满了,这个用户再发送信号量会被丢掉。 |
3.优化性能的配置项
序号 |
分类 |
语法 |
默认 |
说明 |
序号 |
分类 |
语法 |
默认 |
说明 |
1 |
Nginx worker进程个数 |
worker_processes number; |
worker_processes 1; |
master/worker运行方式下,定义worker进程个数。worker进程数量会直接影响性能,配置多少个worker进程与业务需求有关。每个worker都是单线程的进程。它们会调用各个模块以实现多种多样的功能。如果这些模块确认不会出现阻塞式调用,有多少CPU内核就应该配置多少个进程。反之,应配置稍多一些的worker进程。如:业务方面致使用户读取本地磁盘上的静态资源文件,而且服务器上的内存较小,以至于大部分的请求访问静态资源时都必须读取磁盘(磁头寻址是缓慢的),而不是内存中的磁盘缓存,那么磁盘I/O调用可能会阻塞worker进程少量时间,进而导致服务整体性能下降。多worker进程可以重发利用多核系统架构,但若worker进程数多于CPU内核数,会增大进程间切换带来的消耗(Linux是抢占式内核)一般情况下,用户应配置CPU核数相同的worker进程数,并绑定CPU内核 |
2 |
绑定Nginx worker进程到指定的CPU内核 |
worker_cpu_affinity cpumask [cpumask...] |
/ |
为什么要绑定?假设每一个worker进程都是非常繁忙,如果每一个worker都在抢同一个CPU,那么会出现同步问题。反之,每一个worker独享一个CPU,就在内核的调度上实现完全的并发。eg:有4颗CPU内核,就可以进行如下配置:worker_processes 4; worker_cpu_addinity 1000 0100 0010 0001;该配置仅对Linux操作系统有效,它使用sched_sctaffinity()系统调用实现这个功能。 |
3 |
SSL硬件加速 |
ssl_engine device; |
/ |
如果服务器上游SSL硬件加速设备,就可以进行配置加快SSL协议的处理。可以使用OpenSSL提供的命令查看是否有SSL硬件加速设备:openssl engine -t |
4 |
系统调用gettimeofday的执行频率 |
timer_resolution t; |
/ |
默认情况下,每次内核的事件调用(epoll、select、poll、kqueue等)返回时,都会执行一次gettimeofday,实现用内核的时钟更新一次Nginx中缓存时钟。中间有一次内核态到用户态的复制,因此,实现代价不小。可以使用该配置降低调用频率。eg:timer_resolution 100ms;表示至少每100ms才调用一次gettimeofday。但目前大多数内核中,x86-64体系架构,gettimeofday只是一次vsyscall,仅仅对共享内存页中的数据做访问,并不是通常的系统调用。一般不需使用该配置,若希望日志时间更准确可以使用。 |
5 |
Nginx worker进程优先级设置 |
worker_priority nice; |
worker priority 0; |
用于设置Nginx worker进程的nice优先级,在Linux或其他Unix操作系统中,当许多进程都处于可执行状态时,将按照所有的进程的优先级来决定本次内核选择哪一个执行。进程所分配的CPU时间片大小与进程优先级相关。成正比,即优先级越高,分配的时间片也越大。(默认最小时间片5ms,最大时间片800ms),优先级高的会占用更多的系统资源。优先级由静态优先级和内核根据进程执行情况所做的动态调整(目前只有+-5的调整)共同决定。nice值是进程的静态优先级,它的取值范围是-20~+19,从高至低。若希望Nginx占有更多资源,可以将nice值设置小一点但不建议小于内核进程nice值(通常为-5) |
4.事件类配置项
序号 |
分类 |
语法 |
默认 |
说明 |
序号 |
分类 |
语法 |
默认 |
说明 |
1 |
是否打开accept锁 |
accept_mutex[on/off]; |
accept_mutex on; |
accept_mutex是Nginx负载均衡锁。这把锁可以让多个worker进程轮流地、序列化地与新的客户端建立TCP连接。当某一个worker建立的连接数达到worker_connections配置的最大数7/8时会大大减小该worker试图建立TCP连接的机会。以此实现所有worker进程之上处理的客户端请求数尽量接近。该锁默认打开。若关闭,建立TCP耗时会更短,但worker进程之间的负载会非常不均衡,不建议关闭。 |
2 |
lock文件的路径 |
lock_file path/file; |
lock_file logs/nginx.lock |
accept锁可能需要这个lock文件,如果accept锁关闭,lock_file配置完全不生效。若打开锁,且由于编译程序、操作系统结构等因素导致Nginx不支持原子锁,这时才会用文件锁实现accept锁,lock_file指定的lock文件才会生效。 |
3 |
使用accept锁到真正建立连接之间的延迟时间 |
accept_mutex_delay Nms; |
accept_mutex_delay 500ms; |
使用accept锁,同一时间只有一个worker进程能够取到accept锁。该锁不是阻塞锁,若娶不到立刻返回,若一个worker视图取accept锁,取不到需要等accpet_mutex_delay定义的时间间隔后才能再次取锁。 |
4 |
批量建立新连接mult_accept [on/off]; |
multi_accept off; |
当事件模型通知有新连接时,尽可能对本地调度中客户端发起的所有TCP请求都建立连接。 |
|
5 |
选择事件模型 |
use [kqueue/rtsig/epoll/ /dev/poll /select/poll/eventport]; |
Nginx会自动使用最合适的事件模型 |
对于Linux操作系统,可供选择的事件驱动模型有poll、select和epoll三种。epoll当然是性能最高的。 |
6 |
每个worker的最大连接数 |
worker_connections number; |
/ |
每个worker进程可以同时处理的最大连接数。 |
用HTTP核心模块配置一个静态Web服务器
静态Web服务器的主要功能由ngx_http_core_module模块(HTTP框架的主要成员)实现。
http {
gzip on;
upstream {
...
}
...
server {
listen localhost:80;
...
location /webstatic {
if ... {
}
root /opt/webresource;
...
}
location ~*.(jpg|jpeg|png|jpe|gif)$ {
...
}
}
server {
...
}
}
所有HTTP配置项都必须直属于http块、server块、location块、upstream块或if块等(HTTP配置项自然必须会在http{}块之内)。
Nginx为配置一个完整的静态Web服务器提供了非常多的功能,分为以下8类:虚拟主机与请求的分类、文件路径的定义、内存及磁盘资源的分配、网络连接的设置、MIME类型的设置、对客户端请求的限制、文件操作的优化、对客户端请求的特殊处理。
1.虚拟主机与请求的分发
经常有多个主机域名对应着同一个IP地址情况,这时在nginx.conf中就可以按照server_name(对应用户请求的主机域名)并通过server块来定义虚拟主机,每个server块就是一个虚拟主机,它只处理与之对应的主机域名请求。
一台服务器上的Nginx以不同的方式处理访问不同主机域名的HTTP请求。
序号 |
分类 |
语法 |
默认 |
配置块 |
说明 |
序号 |
分类 |
语法 |
默认 |
配置块 |
说明 |
1 |
监听端口 |
listen address:port[default(在0.8.21已废弃)]/[default_server]/[bcaklog=num]/[rcvbuf=size]/[sndbuf=size]/[accept_filter=filter]/[deferred]/[bind]/ [ipv6only=[on/off]] /[ssl] |
listen 80; |
server |
listen参数决定Nginx服务如何监听端口。在listen后可以只加IP地址、端口号或主机名。不加端口号,默认监听80端口。参数说明:default/default_server--将所在的server块作为整个Web服务默认server块。如果没有设置该参数,将在nginx.conf配置文件中找到第一个server作为默认server块。如果无法匹配配置文件中的所有主机域名时,则会使用默认虚拟主机; backlog=num--表示TCP中backlog队列的大小。默认为-1,表不予设置。若设置队列满了,客户端建立连接将会失败; revbuf=size--表设置监听句柄的SO_RCVBUF参数; sndbuf=size--表设置监听句柄的SO_SNDBUF参数; accept_filter--设置accept过滤器,只对FreeBSD操作系统有用;deffered--在设置参数后,若用户发起连接请求,且完成了TCP的三次握手,内核也不会为这次的连接调度worker进程来处理,只有用户真的发生数据(内核已经在网卡中收到请求数据包),内核才会唤醒worker进程处理这个连接。【这个参数适用于大并发情况下,减轻worker进程的负担。】;bind--绑定当前端口/地址对,如127.0.0.1:8000,只有同时对一个端口监听多个地址时才会生效;ssl--在当前监听的端口上建立连接必须基于SSL协议。 |
2 |
主机名称 |
server_name name[...]; |
server_name ""; |
server |
server_name后可跟多个主机名称,如server_name wwww.testweb.com、download.testweb.com;在处理一个HTTP请求时,Nginx会取出header头中的Host与每个server中的server_name进行匹配,以此决定到底由哪一个server来处理这个请求。有可能一个Host与多个Server块中的server_name都匹配,这时会根据匹配优先级选择实际处理的server块。server_name与Host的匹配优先级:1)首先匹配选择所有字符串完全匹配的server_name,如www.testweb.com 2)其次选择通配符在前面的server_name,如.testweb.com 3)再次选择通配符在后面的server_name,如www.testweb. 4)最后选择使用正则表达式才匹配的server_name,如~^.testweb.com$;若都不匹配,会按下列顺序选择处理server块:1)优先选择listen配置项后加入[default |
3 |
server_names_hash_bucket_size |
server_names_hash_bucket_size size; |
server_names_hash_bucket_size 32 |
64 |
128; |
4 |
server_names_hash_max_size |
server_names_hash_max_size size; |
server_names_hash_max_size 512; |
http、server、location |
该配置项会影响散列表的冲突率,值越大消耗的内存越多,但散列key的冲突率越低,检索速度更快;值越小,消耗内存越小,但散列key的冲突率可能增高 |
5 |
重定向主机名称的处理 |
server_name_in_redirect on/off; |
server_name_in_redirect on; |
http、server或location |
该配置需配合server_name使用,on打开时,表示重定向请求时会使用server_name里配置的第一个主机名代替原先请求的Host头部;使用off时,则重定向请求时使用请求本身的Host头部 |
6 |
location |
location[=//*/^~/@]/uri/ |
/ |
server |
该配置会根据用户请求中的url来匹配上面的/uri表达式,如果可以配置则选择location{}块中的配置来处理用户请求。location匹配规则:1)=表示把uri作为字符串,完全匹配 2)~表示uri是大小写敏感的 3)~*表示忽略字母大小写问题 4)^~表示匹配uri只需前半部分与uri匹配即可,如location ~^ /image/{# 以/image/开始的请求都会匹配上} 5)@表示仅用于Nginx服务内部请求之间的重定向,带有@的location不直接处理用户请求。location是有顺序的,当一个请求匹配多个时,实际这个请求是被第一个处理 |
Nginx正是使用server_name配置项针对特定Host域名的请求提供不同的服务,以此实现虚拟主机功能。