Nginx核心配置文件常用参数详解

时间:2021-12-23 01:59:43

                    Nginx核心配置文件常用参数详解

                                        作者:尹正杰

版权声明:原创作品,谢绝转载!否则将追究法律责任。

  关于Nginx权威文档的话童鞋们可以参考Nginx官方文档介绍:http://nginx.org/en/docs/http/ngx_http_core_module.html。本篇博客只列出来了常用的参数介绍,用这些参数说明来定制化我们自己的nginx的web服务器等等。

一.正常运行的必备配置
1>.user username [groupname];
  #以那个用户身份运行,以在configure指定的用户为准
2>.pid /path/to/pid_filename;
  #指定nginx的pid文件
3>.worker_rlimit_nofile ;
  #指定一个worker进程所能够打开的句柄数
4>.worker_rlimit_sigpending ;
  #设定每个用户能够发往worker进程的信号的数量
二.优化性能相关的配置
1>.worker_procrsses 1;
  #work进程的个数 ,通常其数值应该为cpu的物理核心数减1
2>.worker_cpu_affinity cpumask ....;
  0000 #假设有4个CPU,那么就用4个0来进行占位
  0001 #表示第一个CPU
  0010 #表示第二个CPU
  0100 #表示第三个CPU
  1000 #表示第四个CPU
  对应位上使用cpu,要做单独绑定
  work_procrsses 6; #表示开启6个进程,6个进程分别绑定在以下的6颗不同的CPU之上。(这种方式可以提升Nginx的性能,但是要注意的是,每个进程绑定了CPU之后,这些CPU仍然可以被系统调用去执行其他的指令,换句话说,这些CPU有可能还是会做上下文切换哟。)
  worker_cpu_affinity 00000001 00000010 00000100 00001000 00010000 00100000; #我们使用类似这种方式来绑定上面所指定的6颗CPU.
3>.ssl_engine device;
  #在存在ssl硬件加速器的服务器上,指定所使用的ssl硬件加速设备,从而降低对web服务器的系统资源消耗。
4>.timer_resolution t;
  #每次内核事件调用返回时,都会使用gettimeday()来更新nginx缓存时钟;timer_resolution用于定义每隔多久才会由gettimeday()更新一次缓存时钟;x86-64系统上,gettimeday()代价已经很小,可以忽略此配置.
5>.worker_priority nice;
  # -20到19之间的值,值越小越优先调用
三.跟事件相关的配置
1>.accept_mutex [on|off];
  # 是否打开nginx的负载均衡锁;此锁能够让多个worker进行轮流地、序列化地与新的客户端建立连接;而通常当一个worker进程的负载达到其上限的7/8,master就尽可能不将请求调度至worker.
2>.lock_file /path/to/lock_file;
  #定义锁文件,如果上面的参数为accept_mutex off,那么这个锁文件就无效啦。
3>.accept_mutex_delay [#ms]
  #使用accept锁以后,只有一个worker能取得锁,另一个worker进程为取得accept锁的等待时长,即用户建立等待的时间,如果某worker进程在某次试图取得锁时失败了,至少要等待#ms才能在一次请求锁。默认是500毫秒。
4>.multi_accept [on|off]
  #是否允许一次性地响应多个用户请求,默认为off。
5>.use [epoll|rtsig|select|poll]
  #指定使用那种事件模型,建议让nginx自动选择。
6>.worker_commections
  #每个worker能够并发响应的最大请求数,如果为代理服务器(因为它需要与客户端连接,并且将这个连接转发给后端真正提供服务的服务器哟)的话:worker_rlimit_nofile=worker_commections*2.
四.用于调试、定位问题:只调试nginx时使用
1>.daemon [on|off];
  #关闭提供守护进程的模式,是否让nignx运行于后台;调试时应该为off,使得所有信息直接输出在控制台,默认为on。
2>.master_process on|off;
  #是否以master/worker(一个master管理多个worker)模式运行nginx,默认为on,调试时可以设置为off(关闭master,至启动一个master)以方便追踪。
3>.error_log /path/to/error_log level;
  #错误日志文件及其级别,调试时可以使用debug级别,但要求在编译时必须使用--with-debug启用debug功能,默认通常为error级别。
五.Nginx的http的web功能
1.Nginx的web基本配置格式:
 http{                    #Nginx的http web功能,并不包含邮件的配置,如果需要nginx支持mail的支持,需要在编译的时候配置mail模块哟。
directive value; #非虚拟主机的配置和公共选项,需要定义在server之外,http之内
.... server{ #必须使用虚拟机来配置站点:每个虚拟主机使用一个server{}段来配置 }
server{ }
......
}
2.server{}
  定义一个虚拟主机:nginx支持使用基于主机名或IP的虚拟主机
3.listen [...]
  a>.listen address[:port] #只监听指定IP的端口;
  b>.listen prot #监听主机上的所有IP的端口;
  c>.listen unix:socket #监听在socket文件上,对于我们而言,这种监听方式我们不常用;
  d>.default_server #定义此server为http中默认的server;如果所有的server中任何一个listen使用此参数,那么第一个server即为默认server;
  e>.rcvbuf=SIZE #接收缓存大小;
  f>.sndbuf=SIZE #发送缓存大小;
  g>.ssl:https server #必须以ssl建立连接;
4.server_name [...];
  server_name可以跟多个主机名,名称可以使用通配符和正则表达式(通常以~开头):当nginx收到一个请求时,会取出其首部的server的值,而后跟众server_name进行比较,比较方式如下:
  a>. 先做精确匹配,如:www.yinzhengjie.org.cn
  b>. 左侧通配符匹配,如:*.yinzhengjie.org.cn
  c>. 右侧通配符匹配,如:www.*
  d>.正则表达式匹配,如:~^.*\.yinzhengjie\.org.cn$
5.server_name_hash_bucket_size 32|64|128
  为了实现快速主机查找,nginx使用hash表来保存主机名,后面的数字表示可以保存的主机名个数。
6.location [ =|~|~*|^~] uri { ... }或location @name { ... }
  location是定义请求的上下文的,location可以放在server虚拟主机中也可以放在location之中(也就是location嵌套location)。它允许根据用户请求的URI来匹配指定的各location以进行访问配置;匹配到时,将被location块中的配置所处理。匹配规则如下:
    a>. =:精确匹配,
    b>.~:正则表达式模式匹配,匹配时区分字符大小写
    c>.~*:正则表达式模式匹配,匹配时忽略字符大小写
    d>.^~:只需要前半部分与uri匹配即可,不检查正则表达式
  匹配的优先级:字符字面量最精确匹配、正则表达式检索(由多个时,由第一个匹配到的所处理),按字符字面量。
7.location的文件路径定义
a>.root path
  设置web资源路径,用于指定请求的根文档目录,从跟开始匹配,当然root这个参数也可以不再location标签中,但是为了实现对目录的访问控制,我们一般把该参数放在location里面哟。如:
 location / {
root /web/htdocs; #注意,它指的是location的根目录,用户访问的应该是 /web/htdocs下的文件。
}
location ^~ /images{
root /web; #它指定的也是跟目录,用户访问的文件应该是/web/images下的文件
}
b>.alias path
  指定路径别名,只能用于location中,从最后一个/开始匹配
 location / {
root /web/htdocs; #注意,它指的是location的根目录,用户访问的应该是 /web/htdocs下的文件。
}
location ^~ /images{
alias /web; #注意,alias后面的参数“/web”表示是images的一个别名。也就是说用户访问 /web其实就是访问 /images这个目录下的文件哟。它是指多一个路径别名而已。
}
c>.index file....
  定义默认页面,可以跟多个值。自左向右匹配。
 location / {
root /web/htdocs; #注意,它指的是location的根目录,用户访问的应该是 /web/htdocs下的文件。
index index.html index.htm; #设置首页文件的名称,我们可以设置多个,用空格隔开即可。
}
d>..error_page code ... [=[response]] uri
  它是用来错误页面重定向的。简单的说,当对于某个请求发回错误时,如果匹配上了error_page指令中设定的code,则从定向至新的新URI中。它通常放在server虚拟主机配置里面哟。
 server{
error_page /.html; #error_page 后面的第一个参数表示返回错误状态,第二个参数是根据第一个参数的返回状态返回给用户的文件的路径。
location / {
......
}
......
}
e>.try_files path1 [path2...] uri;
他也是一种重定向,它和error_page 相比,其会先进行判断页面是否存在,如果不存在,可以给用户返回默认的页面。简单的说,它是自左向右尝试读取有path所指定路径,在第一找到即停止并返回,如果所有path均不存在,则返回最后一个uri
 location ~* ^/documents/(.*)${
root /www/htdocs
try_files $uri /docu/$ /temp.html #它表示当用户访问一个路径是,它会优先去/www/htdocs/documents目前去找这个文件,如果这个目录中没有的话,它就会去找 /www/htdocs/docu目录下去找用户请求的文件,如果还是找不到的话就会给用户返回/www/htdocs/temp.html这个文件哟。
}
8.网络连接相关的设置
a>.keepalive_timeout time;
  #保持连接的超时时长,默认为65s(nginx-1.12.x版本);
b>.keepalive_requests n;
  #在一次长连接上允许承载的最大请求数;
c>.keepalive_disable [msie6|safari |none];
  #对指定的浏览器禁止使用长连接,比如微软的IE6(msie6),苹果的浏览器(safari ),当然你也可以不做任何禁用(none);
d>.tcp_nodelay on|off ;
  #对keepalive连接是否使用TCP_NODELAY选项,默认是on,TCP为了提高其性能,通常会把多个报文合并在一起传给对方,我们简称为延迟确认;
e>.client_header_timeout time;
  #读取http请求首部的超时时长;
f>.client_body_timeout time;
  #读取http请求包体的超时时间;
g>.send_timeout time;
  #发送响应的超时时长;
9.对客户端请求的限制:
a>.limit_except method ...{ ... }
  # 指定范围之外的其他方法的访问控制,只能用于location中,用法如下:
 limit_except GET {
allow 172.16.0.0/; #表示除了GET方法,想要访问其他方法,如PUT,DELETE等只允许172.16.0./16这个网段。
deny all; #表示用户处理访问GET方法外,其他的方法默认都是被拒绝的哟。
}
b>.client_max_body_size size
  #http请求包体的最大值,常用于限定客户端所能够请求的最大包体,根据请求首部中的Content-Length来检查,以避免无用的传输。换句话说,这个参数用来限定用户能上传文件的大小很有用。
c>.limit_rate speed
  #限制客户端每秒传输的字节数,默认为0,表示没有限制。
d>.limit_rate_after time
  #nginx向客户端发送响应报文时,如果时长超过了此处指定的时长,则后续的发送过程开始限速。用limit_rate来实行限速功能。
10.文件操作的优化
a>.sendfile on|off;
  #是否启用sendfile功能
b>.aio on|off;
  #是否启用aio功能,如果系统支持的话建议启用。
c>.open_file_cache max=N [incative=time]|off ;
  #是否打开文件缓存功能,
    max:用于缓存条目的最大值,允许打开的缓存条目最大数,当满两类以后将根据LRU(最小最少连接数)算法进行置换,
    inactive:某缓存条目在指定时长内没有被访问过时,将自动被删除;通常默认为60s
  缓存的信息包括:
    文件句柄、文件大小和上次修改时间;
    已经打开的目录结构;
    没有找到或没有访问权限的信息;
d>.open_file_cache_errors on|off
  #是否缓存文件找不到或没有权限访问等相关信息
e>.open_file_cache_valid time
  #多长时间检查一次缓存中的条目是否超出非活动时长,默认为60s
f>.open_file_cache_min_use
  #在inactive指定的时长内被访问超过此处指定的次数时,才不会被删除.
11.对客户端请求的特殊处理
a>.ignore_invalid_headers on|off;
  #是否忽略不合法的http首部,默认为on,off意味着请求首部中出现不合规的首部将拒绝响应,只能用于server和http。
b>.log_not_found on|off;
  #用户访问的文件不存在时,是否将其记录到错误日志中。
c>.resolver address;
  #指定nginx使用的dns服务器地址。
d>.resolve timeout;
  #指定DNS解析超时时长,默认为30s。
e>.server_tokens on|off;
  #是否在错误页面中显示nginx的版本号。
六.http核心模块的内置变量:
  $uri:当前请求的uri,不带参数
  $request_uri:请求的uri,带完整参数
  $host:http请求报文中host首部;如果请求中没有host首部,则以处理此请求的主机的主机名代替
  $hostname:nginx服务运行所在主机的主机名
  $remote_addr:客户端IP
  $remote_port: 客户端port
  $remote_user:使用用户认证时客户端用户输入的用户名
  $request_filename:用户请求中的URI经过本地root或alias转换后映射的本地的文件路径
  $request_method:请求方法
  $server_addr:服务器地址
  $server_name: 服务器名称
  $server_port:服务器端口
  $server_protocol:服务器向客户端发送响应时的协议,如http/1.1,http/1.0
  $scheme:在请求中使用的scheme 映射协议本身的协议
  $http_HEADER:匹配请求报文中指定的HEADER,$http_host匹配请求报文中的host首部
  $sent_http_HEADER:匹配响应报文中指定的HERDER,例如$http_content_type匹配相应报文中的content-type首部
  $document_root:当前请求映射到的root配置