Nginx:nginx.conf配置文件说明 配置参数说明

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Nginx:nginx.conf配置文件说明 配置参数说明相关的知识,希望对你有一定的参考价值。

nginx配置文件说明,不一定最全,但是最细,适合初学者或者概念不清晰者,如有理解错误的地方请指正。


#nginx的worker进程用哪个用户和组进行登录,如果在编译时指定了,这里是禁用的,而且不会显示
#你的设置,为了便于识别,在保持禁用的同时你修改为实际用户和组
#user  nginx nginx;

#【和优化有关】
#启动几个worker进程,从Nginx1.9.10开始可以使用auto值,进行自动设置
#每个worker进程都是单线程进程,所以你叫它进程或者线程都行。这个值最大设置
#为系统显示的CPU核心总数-1,当然你超过也行,但是这样就出现CPU的进程切换,影响性能
worker_processes  2;

#【和优化有关】
#设定nginx的worker进程工作在哪几个CPU核心上,上面的worker进程数量最好和这里的数量对应
#也就是1对1,也可以2对1,2对2,2对4。下面0和1表示CPU掩码,4核心就是4位,2核心就是2位
#如果是4核心的话,0001表示第一个核心 0010表示第二个核心,如果你是2核心呢,就用 01 10 来表示
#几核心就是几位数,1表示使用,0表示不使用,从Nginx1.9.10可以使用auto值,进行自动设置
#你这样绑定只是说明每个CPU只运行一个Nginx进程,但是并不能保证其他进程不会跑到这些CPU核心上去
#再说白一点就是你现在了worker进程的范围,但是你没有限制其他进程,如果想限制这些CPU核心不能被其他进程使用
#你就只能做CPU隔离,在操作系统启动的时候就隔离出去。但这样对于内核级别的进程比如中断还是可能会跑过去,所以
#真正做到严格隔离也可以,就是比较麻烦。
worker_cpu_affinity 0100 1000;


#【和优化有关】
#用于指定单个worker进程可以打开最大文件描述符数量,每个连接都会打开一个文件,所以对于并发非常大的
#场景这个值应该设置的大一点,默认配置文件中没有,但是受限于Linux系统设置,默认是1024个,所以你
#可以修改,比如改成10000个。
worker_rlimit_nofile 5000;

#【和优化有关】
#worker进程的优先级,指的是系统的nice值,-20到+19.默认是0,nice值越小,优先级越高。
worker_priority -10;

#定义SSL硬件加速器,如果支持HTTPS的话,每一个都创建SSL会话,加密、解密、会话建立和断开等这些对CPU的占用率
#非常高,一个服务器可以承载的HTTPS会话大概是HTTP会话的1/5左右。服务器可以安装硬件的SSL会话加速器,那么
#你这里就可以指定,这样SSL会话就不会占用CPU资源。这个就跟高端服务器网卡带特殊芯片一样都是为了减轻CPU负担。
#ssl_engine device;

#时间解析度,默认情况下每次内核事件的调用,在返回时都会执行一次gettimeofday(),表示获取一下系统当前时间
#也就是自1970年1月1日到现在,而且是微秒级别的。以实现内核时钟来更新Nginx缓存时钟的,
#早期Linux系统执行gettimeofday()的代价很大,所以频繁执行则会导致系统性能降低,
#这里这个值就是设置多久调用一次gettimeofday(),而不管这段时间内有多少次系统事件调用。不过现在的计算机
#在执行gettimeofday()时代价已经很小了,所以可以不用设置。
#timer_resolution 100ms;

# 错误日志路径,这个error_log变量可以设置在任何地方,可以在main主配置文件中
#可以在http配置段中,可以在location配置段中,可以在stream配置段中以及server和mail配置段中
#这个如果在编译时指定了,那么也是禁用的,而且不会显示具体路径,所以为了便于识别你最好保持禁用
#同时把后面的值设置为你实际的路径,后面为日志级别,debug级别必须在编译安装时要--with-debug启用debug功能
#它有debug、info、notice、warn、error、crit、alert、emerg,默认级别是error。
#error级别包括error、crit、alert、emerg级别的信息。
error_log  /var/log/nginx/error.log error;
#error_log  logs/error.log  notice;
#error_log  logs/error.log  info;

#PID文件,Nginx进程作为系统的守护进程运行,就需要在某个文件中保存进程的ID号。
#路径编译时指定则这里会被禁用,同时不会显示实际路径,为了便于识别在保持禁用的同时你修改为实际路径
#pid        /var/run/nginx/nginx.pid;

#锁文件,这个和events中的accept_mutex有关,如果这个参数是off,那么就不会出现锁文件。这个文件位置
#如果在编译安装时指定,则配置文件中就不会出现这个lock_file参数。不过为了便于识别,你可以加上但是
#请保持注释状态。
#lock_file /var/lock/nginx.lock

#【和调试有关】
#设置Nginx是否工作在单进程模式下,默认为on,通常Nginx工作在一个master进程和N个worker进程模式中
#在这种模式下定位问题比较困难,所以可以设置为off,这样让Nginx工作在单进程模式下。也就是不让worker
#在后台运行,也就是不让worker进程工作在守护进程模式,而是工作在前台,所有信息都输出到标准输出,也就是
#终端。
#daemon [on|off];

#【和调试有关】
#是否以一个master和多个worker模式运行,默认为on,正常情况下就是这样。为了调试和追踪问题,可以不启动
#master,而只开启一个worker,以方便追踪问题。然后在配合daemon off来让所有信息输出到前台。
#master_process [on|off];

#事件配置段,主要影响Nginx服务器与用户的网络连接。
events {
    #设置使用事件模型,一般不用设置,因为Nginx会自动选择当前系统中所支持的最有效率的IO模型。
	#select、poll是标准方法大多系统都支持。
	#kqueue:是FreeBSE 4.1+  OpenBSD 2.9+和Mac OS X上用的
	#epool:在Linux 2.6+开始支持
	#/dev/poll:这个和select、poll是同一种机制,在Solaris和HP Unix上select或者poll被称作/dev/poll
    #use [epoll|rtsig|select|poll|kqueue|/dev/poll]
	
    #一个worker可以接受多个请求,如果一下来了几百个请求,是否允许一个worker全接受。
	#如果该参数被设为OFF,那么一个worker process进程一次只接收一个请求,如果是ON,则一次接收所有请求
	#设置为on显然就快的多,如果是off,则还需要master进程额外调度。默认是off。
    multi_accept on;
	
	#是否打开负载均衡锁,一个master进程,多个worker进程,由master调度请求给worker,一个请求进来该分配给哪个worker呢?所以这个就
	#是实现多个worker进程负载均衡的,on为开启这个功能。但是做负载均衡调度是有开销的,主进程进行调度,CPU上下文切换,所以关闭虽然会导致
	#worker的负载不均衡,但是减少不必要的开销,反而会更快。此功能默认是OFF的。如果是OFF,也就关闭负载均衡,那么一个新请求进来时
	#所有的工作进程都会收到通知,如果连接数量小于工作进程数量时,则会出现资源争抢(惊群概念,抢的是互斥锁,持有锁的进程可以处理请求)。
	#如果设置为ON由于使用负载均衡所以就不会出现锁文件;如果设置为OFF,也就不均衡,则会出现锁,
	#那锁文件和worker接受请求有什么关系?锁文件只有一个,worker进程有多个
	#当前哪一个worker持有锁文件,那么哪一个worker就可以接收用户请求。所以关闭这个功能就不会有锁,那么任何
	#worker进程都可以接受请求,这样master才能针对worker进程做负载均衡。
	#所以这个参数设置为OFF时,都会把multi_accetp设置为on,避免争抢过度,尽量让一个工作进程接收请求,那么当一个worker所接受的连接数
	#达到其设置的最大值的7/8时,master进程就尽可能的把后续请求分配给其他worker进程。
	accept_mutex off;
	
	#因为只有一个锁,所以其他worker进程持有这个锁的时候,其他worker进程如果也想要这个锁,那么它就要等待
	#那么它最大等待多久呢?就是这个参数设定的。单位为毫秒。也就是说锁被别的worker进程持有,其他的worker
	#请求锁失败后,间隔多少毫秒可以发起第二次请求。默认500ms,不过如果accept_mutex是off,那就没有必要设置
	#这个参数了。
	#accept_mutex_delay NNms
	
	#设置每个worker进程最大连接数,一个连接就是一个socket套接字,一个套接字请求就需要打开一个文件,
	#如果Nginx作为web服务器,worker_rlimit_nofile要大于等于worker_connections,因为Nginx自己也要打开一些文件。
	#如果Nginx作为代理服务器,worker_rlimit_nofile要是worker_connections的2倍,原因是Nginx作为代理的时候
	#面向请求是一个套接字,面向后端应用服务器也是一个套接字,所以一个请求在Nginx上要使用2个套接字,所以
	#worker_rlimit_nofile要是worker_connections的2倍
	#你修改了这个值可能会收到一个错误信息就是open file resource limit:1024,虽然查看cat /proc/sys/fs/file-max看到
	#的值比较大,但是这个是针对系统来说的,系统可以打开最多的fd数量,默认的进程最大打开文件数还是1024,ulimit -n来查看。
	#你调高了系统的并不代表改变了进程可以打开的个数。修改方法可以在/etc/rc.local脚本,加上ulimit -n NUMBER来让系统启动后就
	#使用这个值。或者修改/etc/secrity/limits.conf,增加 noproc和nofile的值。如果不想修改系统,你就修改Nginx的worker_rlimit_nofile。
    worker_connections  4096;
}



#http配置段,用于定义web服务的一些重要属性,代理、缓存、日志以及其他HTTP有关的特性等。
http {
    #包含外部文件路径
	#include sites/.*  表示包含当前路径下的sites目录中的所有文件。 
    include       mime.types;
    default_type  application/octet-stream;
    
	#定义日志格式,main是一个日志格式名称,后面都是服务器端变量组成的
    #log_format  main  ‘$remote_addr - $remote_user [$time_local] "$request" ‘
    #                  ‘$status $body_bytes_sent "$http_referer" ‘
    #                  ‘"$http_user_agent" "$http_x_forwarded_for"‘;
	
	log_format detaile    ‘[$time_local] [$http_x_forwarded_for] [$http_x_via]‘
                          ‘[$http_x_hm_trace_id] [$cookie_x_hm_tuid] [$http_x_hm_tuid] [$sent_http_x_damai_lk] [nginx] [$host] ‘
                          ‘[$server_addr] [$request_method] [$http_referer] [http://$host$uri] [$args] [$status] ‘
                          ‘[$body_bytes_sent] [$request_time] [$upstream_addr] [$upstream_status] [$upstream_response_time] ‘
                          ‘[$http_user_agent] [$http_rule_name]‘;
	#以下为主要变量说明
	# $http_x_forwarded_for:保存的就是X-Forwarded-For信息
	# $host:客户端请求的Host头域值
	# $server_add:服务器IP地址
	# $request_method:请求方法
	# $http_referer:表示从哪个链接跳转过来
	# $status:服务器响应代码
	# $request_time:从接受用户请求的第一个字节到发送完响应数据的实际,包括接受请求数据的实际、程序响应时间、输出数据时间
	# $upstream_add:后端被代理服务器的地址
	# $upstream_response_time:表示Nginx向被代理服务器建立连接开始到接收完数据然后断开连接的时间,这个时间肯定比$request_time的时间短
	
    
	#这个访问日志如果在编译时指定则这里会被禁用,同时不会显示实际路径,为了便于识别
	#在保持禁用的同时你修改为实际路径。这个访问日志格式使用的是上面定义的main格式。
    access_log  /var/log/nginx/access.log  detaile;
	#下面这个加了一个 buffer 参数,含义是日志先同步到缓存中,这样提升性能,避免每产生
	#一条日志都立即写入磁盘文件。
	#access_log /var/log/nginx/access.log  main buffer=32k
    
	#是否启用sendfile功能
    sendfile        on;
	
	#只有在sendfile启用时,改参数启用才生效
	#该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
    #tcp_nopush     on;
	
	#是否启用AIO机制,默认是OFF,在Linux 2.6.22内核及后续版本才支持。
	#该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
	#aio on|off 

    #保持长连接的时长默认为75秒,指定客户端连接保持活动的超时时间,超过这个时间服务器就自动断开连接
	#这个选项有2个值 keepalive_timeout ARG1 ARG2;第二参数是可选项,其指定使用keep-alive消息头保持活动连接的有效时间
	#如果不设置第二个参数那么Nginx不会向客户端某些浏览器(如火狐)发送keep-alive消息头以保持活动连接,
	#超时之后客户端就自动断开连接。该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
    keepalive_timeout  75;
	
	#一次长连接允许发起的最大请求数量,用户与服务器建立连接后,通过此连接可以发起的最多多少次请求
	#该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
	keepalive_request 100;
	
	#对某些老版本的浏览器不使用长连接,none表示对老版本浏览器不做禁用 msie6 表示对微软的IE6禁用长连接
	#该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
	#keepalive_disable [msie6|safari|none]
    
	#对keepalive连接是否使用TCP_NODELAY选项,因为TCP传输数据接收端没接收到一个报文都会发确认信息
	#这个确认信息很小,这个信息大小通常比tcp一个段还小,所以在一个TCP段中,没有被填充的就用0代替,
	#这样其实是比较浪费的,所以为了提升TCP性能,通常会采用延迟确认,也就是几个确认信息打包一起发送
	#如果你开启了keepalive那么就压禁用tcp_nodelay,因为一旦开启,浏览器请求
	#的内容发送到服务器,服务器不马上确认,那么浏览器就会以为资源找不到。
	#该功能是TCP不延迟确认,ON为启用,OFF是不启用。默认是启用,也就是不延迟确认。
	#该参数可以定义在http{}段中,也可以定义在server{}段中、location{}段中
	tcp_nodelay on
	
	#客户端请求首部超时时间,定义服务器读取客户端请求首部的最长时间,如果在段时间内
	#客户端无法完成发送完整的客户端请求首部信息,则返回给客户端408超时错误信息。默认60秒。
	#该参数可以定义在http{}段中,也可以定义在server{}段中。
	client_header_timeout 60s;
	
	#读取HTTP请求的包体的超时时长,道理和上面一样。默认也是60秒
	#该参数可以定义在http{}段中,也可以定义在server{}段中。
	client_body_timeout 60s;
	
	#发送响应超时时长,服务器端要发送响应数据给客户端,客户端不接收或者因某种原因客户端没有收到,那么服务端最多等多久
	#这个不是说整个响应的传输时长。这个超时时间生效条件是在客户端和服务器成功建立连接之后,
	#这个参数可以设置在在http{}段中、server{}段中以及location {}段中
	send_timeout 60s;
	
	#设置读取客户端请求头的缓冲区大小,通常来说1K就够用,但是如果客户端请求中包含一个比较大的cookies或者是来自WAP客户端,
	#那么1K就不够了,这是可能收到Nginx 400的错误,而且不是每次都收到,所以排查困难。一般这个大小都是系统分页的倍数。可用
	#getconf PAGESIZE来获取。
	client_header_buffer_size 4k;
	
	#设置允许的客户端最大请求包体大小,客户端发一个特别大的请求,服务器拒绝。默认1M。
	#这个参数可以设置在http{}段中、server{}段中以及location {}段中。
	#在允许用户上传时的场景下,设置这个很有用。用户上传时它的body首部中的Content-length就会
	#有上传的这个包的大小。
	client_max_body_size 1m;
	
	#限制客户端每秒上传的字节数量,就是为了避免把服务器带宽都占用了。默认0,无限制。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中以及if in location中
	limit_rate 0;
	
	#nginx向客户端发送响应报文时,如果超出了设定的时长,那么就开始限速,这里限制的是
	#客户端的下载速率,这个速率是从limit_rate中获取的。所以这里不需要指定,只需要指定
	#超时时间就可以,默认是0,也就是没有时长限制。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中以及if in location中
	limit_rate_after 0;
	
	#是否开启gzip功能,也就是在服务器响应客户端是是否把响应数据进行压缩,默认为off
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
    gzip  on;
	
	#gzip实现压缩的时候使用缓冲的大小,第一个参数是缓存空间个数,第二个是缓存大小。默认情况下
	#size大小为一个内存页,4K或者8K,取决不同平台。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	gzip_buffers 32 4k;
	
	#压缩级别,默认为1,表示压缩程度最低,压缩率高。9表示压缩程度最高,压缩率最低,也最浪费时间。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	gzip_comp_level 1;
	
	#对哪种浏览器不压缩,因为有些不支持。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	gzip_disable msie6;
	
	#对哪些格式内容使用压缩,默认为text/html,但实际上你开启压缩功能,Nginx会对所有text/html页面进行压缩。
	gzip_types text/plain text/css application/x-javascript text/xml application/xml application/xml+rss text/javascript application/javascript
	
	#用于设置在使用压缩功能时,是否发送带有Vary:Accept-Econding头的响应信息。该参数主要是告诉数据接收方,数据经过了压缩
	#开启效果是客户端接收的响应头部中增加了 Accept-Ecoding:gzip的信息。
	gzip_vary on;
	
	#内容长度大于多少字节时才压缩,默认20。因为对于数据量大压缩才明显,小数据压缩不明显而且还消耗资源。也就是
	#当响应页面大于该值时才启用压缩。响应页面大小可以通过HTTP响应头中的Content-Length指令获取。不过由于ngx_http_gzip_module
	#通常使用Chunked动态编码压缩,所以Conten-Length或不存在或者被忽略,该指令不起作用。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	gzip_min_length 20;
	
	#因为早期的浏览器不支持HTTP客户端不支持压缩,因此用户会看到乱码,可以针对不同HTTP协议版本选择性开启
	#默认是针对http 1.1协议开启。也就是只有客户端使用http 1.1及以上版本的才进行压缩。这个是针对客户端使用
	#的HTTP协议版本做选择性开启的。上面的gzip_disable是针对客户端。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	gzip_http_version 1.1
	
	#当开启是,如果客户端浏览器不支持压缩,那么Nginx将返回解压后的数据;如果支持压缩将忽略此选项。
	gunzip_static on;
	
	#开启压缩功能的一些问题:很多WEB服务器都支持压缩比如IIS、Tomcat、Apache等。如果前端Nginx也开启了压缩,就相当于数据经过了
	#2层压缩,比如如果Nginx和Tomcat都开启对JavaScript脚本进行压缩的话,在很多浏览器都会出现脚本运行异常的情况,只有在chrome
	#浏览器正常。表现的现象是首次运行正常,再次刷新就304.你把其中一台服务器的压缩功能关闭就可以了。
	
	#是否打开文件缓存功能,它缓存的是文件描述符、大小、修改时间、目录结构以及查找文件时的错误,比如文件没有找到
	#如果要开启的话 open_file_cache max=N [inactive=time],设置一个最大缓存条目,如果满了则根据LNU算法进行置换,
	#以及每个缓存元素的活动时长,默认60秒,也就是说在指定时间内没有被访问过,就会被从缓存中移除。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	open_file_cache off;
	
	#设置是否缓存在文件查找是出现的文件查找错误信息。这些错误信息是因为启用了open_file_cache功能才会有的
	#默认是OFF则表示不缓存错误信息,这个参数可以设置在在http{}段中、server{}段中、location {}段中
	#该参数要在open_file_cache on时才有意义
	open_file_cache_errors off;
	
	#设置多久检测一次缓存内容的是否有效,默认60秒,该参数要在open_file_cache on时才有意义
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	open_file_cache_valid 60s;
	
	#在非活动时长内,一个缓存条目被访问的次数超过这里定义的次数,那么这个条目即便超过了非活动时长
	#也不会被删除。这个非活动时长就是open_file_cache max=N inactive=60s;中定义的。
	open_file_cache_min_use 1;
	
	#控制如果客户端请求首部是一个无效信息,服务器是否忽略。默认是on,就是忽略。
	ignore_invalid_headers on;
	
	#当用户访问一个文件,如果该文件不存在,是否把这个信息记录到错误日志中。默认是开启。on。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	log_not_found on;
	
	#设置Nginx使用的DNS服务器地址,默认使用本机网络中设置的
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	#resolver 127.0.0.1
	
	#设置DNS解析超时时长,默认是30秒。
	#这个参数可以设置在在http{}段中、server{}段中、location {}段中
	#resolver_time 30s;
	
	#是否在错误页面中显示Nginx版本号,默认是显示的,也就是ON
    #这个参数可以设置在在http{}段中、server{}段中、location {}段中
	server_tokens off;
	
	
	#用于更改Nginx服务接收到的客户端请求的头信息,然后将新的请求头发送后端被代理服务器,
	#下面的含义是把请求发送给后端时,该请求的头中的Host,设置为客户端原始请求时的Host头
	proxy_set_header Host $host;
	#用客户端请求时的location返回响应头信息
	proxy_redirect default;
	#
	proxy_set_header X-Real-IP $remote_addr;
	#Nginx与后端被代理服务器尝试建立连接的超时时间,默认为60秒
	proxy_connect_timeout 600; 
	#Nginx向后端被代理服务器发送read请求后,等待响应的超时时间,默认60秒
    proxy_read_timeout 600; 
	#Nginx向后端被代理服务器发送write请求后,等待响应的超时时间,默认60秒
    proxy_send_timeout 600; 
	#用于配置存放HTTP报文头的哈希表容量,默认为512个字符。一般都设置为1024,这个大小是哈希表的总大小,
	#并不是设定了这个参数Nginx就会一次全部申请出来。需要用的时候才会申请,但是当真正需要使用的时候也不是一次全部申请,
	#而是会设置一个单次申请最大值,就是后面的参数。
	proxy_headers_hash_max_size 1024;
	#用于设置Nginx服务器申请存放HTTP报文头的哈希表容量的单位大小,默认为64个字符。一般配置为128。
	#这个大小是单次申请最多申请多大,也就是每次用需要申请,但是每次申请最大申请多少,整个哈希表大小不可超过上面设置的值。
	proxy_headers_hash_bucket_size 128;
	
	#用于开启cache功能,同时给cache起一个名字。cache功能默认是关闭的。开启之后Nginx会检查被代理服务器响应数据HTTP头中的
	#Cache_Control、Expirex头域信息。当Cache_Control被设置为no-cache、no-store、private或者max-age=0时并且Expires包含一个
	#过期时间时,Nginx不会缓存这些数据。这个通常定义在某个location中,表示对特定location的开启缓存。
	proxy_cache mycache;
	#开启Cache功能后,客户端请求Nginx代理服务器先从本地Cache中查询,如果想忽略哪些数据不从缓存中查找,就可以设置这个参数。
	proxy_cache_bypass $cookie_nocache;
	#是否开启缓存锁功能。某些数据项可以同时被多个请求返回的响应数据填充。开启之后,Nginx服务器同时只能有一个请求填充缓存中
	#的某一项数据,不允许其他请求操作。其他请求如果也想填充就必须等到锁释放,可以这样理解就是多个客户端请求一个缓存中不存在
	#的内容,因为请求都要先去缓存中查找,没有才会去后端服务器,所以多个客户端同时请求一个内容,但是发现缓存缓存中没有,
	#如果开启这个参数,那么这些请求中只有第一个请求被允许发往后端服务器,当它得到返回结果后,缓存中这时候就有内容了,
	#然后Nginx用这个内容响应给其他请求。如果不启用的话,那么Nginx就会把请求相同内容的多个请求都代理到后端。
	proxy_cache_lock on;
	#设置上面那个锁定时长,默认5秒。
	proxy_cache_lock_time 5s;
	#设置用户请求相同内容达到多少次Nginx才缓存,默认是1次。
	proxy_cache_min_uses 2;
	#设置缓存路径和缓存策略。第一个参数是路径、第二个是缓存目录为几级,一般为2级、第三个参数是定义一个共享内存区用于存储键和元数据
	#检索键从内存中查找并定义内存大小,1M内存可以缓存8000个键、第四个参数是缓存数据的磁盘空间最大可使用多少、最后一个是定义非活动
	#时长,在该时长内一个数据没有被访问则进行删除而无论数据是否过期。
	proxy_cache_path /var/temp/nginx/ levels=1:2 key_zone=mycache:10m max_size=1g inactive=60m;
	#关闭把数据写入缓存前写入其他临时目录,关闭后则写入同一目录。建议关闭。
	use_temp_path off;
	
    
	#该指令设置后端服务器指令,NAME为自定义名称,默认是轮询方式调度,如果某个服务器出现错误,请求将会依次交给组内
	#下一个服务器进行处理,直到返回正常响应,如果都失败了,就返回最后一个服务器的响应。HTTP 404不算请求失败。
	#通常这些都配置在单独的文件中,通过include指令引入到主配置文件中。upstream只能配置在http段中。
	upstream UPSTREAM_NAME {
	   #下面三种都是调度方式,默认不配置任何调度方式的话则为轮询,
	   #ip_hash表示同一IP的调度到同一服务器,如果有此参数,则wight失效。不能一起使用。
	   ip_hash;
	   #最少连接负载算法,在考虑权重的同时也考虑后端哪个服务器当前连接最少,最少的优先,如果这样的服务器有多台,则按加权轮询,选择权重最大的
	   least_conn;
	   #按URL的哈希值来分配,相同的分配到同一服务器,如果有此参数,则wight失效。不能一起使用。
	   url_hash;
	   
	   server IP:[PORT] weight=NUMBER max_fails=NMBER fail_timeout=NUMBER;
	   #后端服务器2台,IP地址为50.1和50.2,权重均为10,如果30s内连续请求3次失败,则该服务器在之后的30秒内被认为是无效
	   #也就是down状态。
	   server 192.168.50.1 wight=10 max_fails=3 fail_timeout=30s;
	   server 192.168.50.2 wight=10 max_fails=3 fail_timeout=30s;
	   
	   #max_fails=number:表示请求失败次数,在一定时间内(由fail_timeout指定),请求失败几次则该服务器被认定为无效。
	   #fail_timeout=time:除了上面那个作用以为,还有一个作用就是,如果服务被认定无效,则无效时间为多久,在这个时长内则不进行检查。
	   #backup:标记该服务器为备用服务器,其他服务器正常是被标记为backup的服务器不做请求处理,只有其他都失效或者繁忙时才会分配到这里
	   #down:标记该服务器为永久失效
	   #resolve:
	   #route=string:设置路由名称
	   #service=name:设置SRV记录名称
	}
	
	#用于自行设定健康标准,该参数与health_check配合使用,在health_check中指定
	match MATCH_NAME {
	   #status 、header这些都是设定测试标准的,如果设置了多条,那么只有全部满足才算健康
	   #表示状态码是什么
	   status 200;
	   status ! 500;
	   status 200 204;
	   status ! 301 302;
	   status 301-303 307;
	   #表示响应头中的字段包含什么值
	   header Content-Type = text/html;
	   header Connection ~ close;
	   header Host;
	   #表示响应body中包含什么内容
	   body ~ "Welcome to nginx";
	   body !~ "maintenance mode";
	   
	}
	
	#虚拟主机配置,Nginx中没有Apache那种中心主机概念,它所有的主机都是虚拟主机,如果是多站点
    #我们通常会把主配置文件中的server {}全部注释,把虚拟主机单独建立配置文件,里面只需要包含
	#server {}段即可,然后在主配置文件中引用。至于所有虚拟主机共享的配置,就放在主配置文件的
	#http{}段中定义。如果要单独为某个虚拟主机设置,那么你就写在server}{}中。
    server {
	    #监听端口 格式 IP:PORT PORT *:PORT,另外端口后面还可以加一些其他参数
		#default_server,定义此server为http中的默认server
		#ssl,表示建立连接的时候必须使用ssl,这个一般定义在443上
		#http2 ,表示支持http2
		#rcvbuf=size sndbuf=sized  接收和发送缓冲大小
		#backlog=num 设置监听函数listen()允许多少连接处于挂起状态也就是SYN队列有多大,FreeBSD默认为-1,其他为511
		#listen 80 default_server rcvbuf=1024 sndbuf=1024
		#reuseport 允许多个套接字监听在同一IP+PORT上,内核能够在这些套接字中对连接请求进行负载均衡。原有的模式是一个套接字连接请求
		#所有工作进程进行争抢锁(当accept_mutex off时),也就是多个工作进程都盯着这一个套接字,当使用reuseport时,每个工作进程都盯着
		#属于自己的套接字,这样就减少了争抢锁,然后系统内核决定把连接请求分配给哪个工作进程。设置了该项,accept_mutex会无效。
        listen       80;
		
		#主机名称,后面可以配置多个主机名
		#server_name www.a.com www.b.com www.c.com 那么多个名称如何匹配呢?首先取出请求首部信息,然后进行
		#精确匹配,匹配到了就响应。支持使用通配符和正则表达式。比如 *.a.com  www.a.* 但是通配符只能用在
		#三或者两段字符串组成的域名的首部或者尾部。
        server_name  localhost;
		
		#这里的root和location中的root是一个意思,就是去哪里找资源。但是如果定义在http段中,
		#那么这个root对所有location都是有效,也就是会继承。但是通常都会定义在location中。
		#root html;
		
		#为了实现快速主机名查找,Nginx使用HASH来保存主机名,这里就是定义HASH表的大小
		#server_names_hash_bucket_size 32|64|128;

        #charset koi8-r;

        #access_log  logs/host.access.log  main;
        
		#定义location段。
		#location后面写的匹配规则,而{}里面写的是匹配后怎么办。
		# = 表示精确匹配,用于匹配标准URI,也就是不带正则的URI换句话说URI是以正常字符出现;^~ 非精确匹配,用户匹配标准URI,也就是不带正则的URI
		# ~ 表示匹配带正则的URI,但是区分大小写; ~* 表示匹配带正则的URI,但是不区分大小写。
		# = 大于 没有修饰符的 大于 ^~ 大于 ~ 或 ~*
        location / {
		    #匹配location之后,去本地哪里找请求资源,默认是/usr/nginx/html/
			#root /var/html; 你自己也可以指定路径而不用默认的。但是你要知道 / 符号表示的是
			#root所指定的路径, / 符号后面的路径你还需在 root所定义的路径下面再建立。
            root   html;
			#定义主页文件名称
            index  index.html index.htm;
			
			#是否允许目录形式显示,默认是OFF为不允许。除非你是一个可以让下载的网址。
			#这个参数可以设置在在http{}段中、server{}段中、location {}段中
			autoindex off;
			
			#在一个location内用于限定客户端可以使用的HTTP方法,get、head是安全方法通常不做限制,但是对于其他的
			#比如PUT、POST、DELETE等都是危险方法,通常只允许特定主机使用这些方法访问服务器。
			#下面的意思是说除了GET、POST方法其他都拒绝,但是来自192.168.154.0网段的可以使用任何方法,换句话说
			#就是除了来自192.168.154.0网段的请求可以使用任何HTTP方法之外,其他网络只能使用GET POST 方法
			limit_except GET POST {
			    #访问控制,由于默认是允许,所以你设置白名单的时候,最后一定要加deny all; 它子上而下进行匹配
				#allow deny 可以用在location{}段中,server{}段中,limit_except GET POST{}段中。
			    allow 192.168.154.0/24;
				deny all;
			}
        }
		
		location /aaa {
		  #针对match配置段中的服务器组做健康检查,如果不加参数在均保持默认值,该功能只能设置在location中
		  health_check [可选参数];
		  health_check match=MATCH_NAME;
		  # interval=time 表示2次健康检查之间的时间间隔,默认5秒
		  # jitter=time   表示
		  # fails=number  表示检查几次失败,则标记该服务器为不健康的,默认1次
		  # uri=uri   表示定义健康检查的uri,默认为/
		  # passes=number 表示几次检查成功后,则标记该服务器为健康的,默认为1次
		  # match=name   表示设置用哪个标准来确定服务器健康与否,默认为状态码2xx或3xx,这个NAME是标准名称,为match段定义的名字。
		  # port=number  表示健康检查时用哪个端口去检查后端服务器的健康状态,默认和server里的端口相同
		  
		  #代理到UPSTREAM_NAME中所定义的后端服务器上
		  proxy_pass http://UPSTREAM_NAME;
		  
		  #X-Real-Ip和X-Forwarded-For没有具体含义,实际上叫什么名字都是行
		  #获取用户真实IP放到X-Real-IP变量中,传递给被代理服务器
		  proxy_set_header X-Real-IP $remote_addr;
		  #再设置一次X-Forwarded-For头,让后端被代理服务器可以获取这个头域信息。
		  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		}
		
		location ^~ /documents/ {
		    #配置根,访问http://www.a.com/documents 对应实际磁盘路径为/web/documents
		    root /web/;
			#一次查找,如果都找不到就使用最后定义的uri来响应用户,$uri表示用户请求的任何内容
			#/404.html表示最后的uri,这个必须存在。
			try_files $uri /documents/bbb.html /404.html
		}
		
		location ^~ /book/ {
		    root /web;
			#所有请求/book/任意内容并且以.doc .docx .pdf 的都重定向到/libary下面,一般在location中
			#使用rewrite会使用break作为标识符,避免死循环,另外还可以写在IF字句中。
			rewrite ^/book/(.*\.(doc|docx|pdf))$ /libary/$1 break;
			#访问/book/下面的任何内容都重定向到/libary/下面
			rewrite ^/book/(.*)$ /libary/$1 break;
			#这个的意思其实可以上面的意义,但是不同的是它没有具体匹配什么东西,只要是/结尾就重定向
			#这个一般用在反向代理比较多,或者用在 location / {} 里面,比如80强制443访问。
			#rewrite ^/.*$ http://www.a.com 
			
			#是否把重写内容写入错误日志,默认为notice级别,默认是OFF
			#在很繁忙的服务器不建议打开,拍错的时候可以。
			rewrite_log on;
			#给这个location配置一个错误日志输出文件,于此location有关的错误日志都输出到这里
			#因为上面开启了 rewrite_log 所以重定向的也会到这里,但日志级别需要是notice才可以。如果
			#是error则不会记录,因为重定向这种事件本身就达不到error这个级别,所以不会记录。
			error_log /var/log/nginx/error1.log notice;
		}
		
		location ^~ /images/ {
		    #配置别名,访问http://www.a.com/images/ 对应实际磁盘路径为/web
		    alias /web/;
		}
        
        error_page  404  /404.html;
		location = /404.html {
		    root /web/error_page;
		}

        # redirect server error pages to the static page /50x.html
        #重定向错误页面用的,这里定义错误代码 以及定向为那个页面
        error_page   500 502 503 504  /50x.html;
		#定义错误代码页面资源存放位置,精确匹配/50x.html
        location = /50x.html {
            root   html;
        }
        
		#启用状态页面
		location /status {
		    stub_status;
			#对状态页的访问不记录到
			access_log off;
		}
        # proxy the php scripts to Apache listening on 127.0.0.1:80
        #
        #location ~ \.php$ {
        #    proxy_pass   http://127.0.0.1;
        #}

        # pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
        #
		#表示定义处理任何以.php结尾的请求
        location ~ \.php$ {
		    #这里这个root是你实际php页面或者程序存放的目录,如果你的Nginx和PHP-FPM不在一台服务器上
			#那这里的root就是你PHP-FPM服务器上存放php文件的目录。如果Nginx和PHP-FPM在一台服务器上
			#这里的root也是你PHP页面存放目录,这里只是让你概念上有个明确的区分。
            root           /srv/phpScripts;
			#后端PHP-FPM服务器地址和端口
            fastcgi_pass   127.0.0.1:9000;
			#启用或禁用响应缓冲区,默认为on
			fastcgi_buffering on;
			#定义用Nginx用多大的缓冲区来接收FastCGI的应答头,也就是响应的第一部分,这部分通常包含很小的头信息
			#,默认情况下这个大小等于一个内存页,4K或者8K,取决不同平台,当然也可以设置的更小一点。
			#可以配置在http、server、location段中
			fastcgi_buffer_size 4K;
			#这个和上面的有区别,这里有数量和大小。这个是设置从FastCGI来的应答,本地用多少和多大缓冲区读取。
			#这样可以处理大部分请求,比较的请求将被缓冲到磁盘。fastCGI_buffer=fastcgi_buffer_size+number*size
			fastcgi_buffers 8 4k;
			#定义一个共享内存区域用于做缓存。相同区域可以分布在不同的地方。参数值可以包含变量。
			#默认为off。可以配置在http、server、location段中,这里只定义缓存名称,没有定义大小。
			fastcgi_cache zone1;
			#定义缓存关键字,针对这些关键字进行缓存,关键字也可以包含变量。默认为none.
			fastcig_cache_key none;
			#定义缓存路径(磁盘),levels设置的是缓存目录的目录分级和子目录数量。keys_zone的值是
			#fastcgi_cache定义的共享内存,用于存放所有活动的关键字以及数据。这里10m表示共享内存大小
			#为10M。非活动数据是指10分钟内没有用到的。这个时间可以设置 inactive=time
			fastcgi_cache_path /data/nginx/cache levels=1:2 keys_zone=zone1:10m;
			#设置用户请求的URL请求几次才被缓存,默认为1次
			fastcgi_cache_min_uses 1;
			#设置建立与fastcgi的连接时的超时时间默认60秒,最大不能设置超过75秒。
			fastcgi_connect_timeout 
			#这里是定义默认fastcig的默认主页,也就是自动在用户请求的路径后面添加index.php,这个值将
			#存储在变量$fastcgi_script_name中
            fastcgi_index  index.php;
			#这里是脚本文件请求的路径,$document_root则表示用户请求的uri。
			#SCRIPT_FILENAME这是参数,后面的是值,参数可以被PHP所读取。所以fastcgi_parm就是为了
			#给PHP内置的这些参数传递变量的。
            fastcgi_param  SCRIPT_FILENAME  $document_root$fastcgi_script_name;
			#请求参数
			fastcgi_param  QUERY_STRING    $query_string;
			#请求头中的方法
            fastcgi_param  REQUEST_METHOD  $request_method;
			#请求头中的Content-Type字段
            fastcgi_param  CONTENT_TYPE    $content_type;
			#请求头中的Content-length字段
            fastcgi_param  CONTENT_LENGTH  $content_length;
			#客户端IP
			fastcgi_param  REMOTE_ADDR     $remote_addr; 
			#客户端端口
            fastcgi_param  REMOTE_PORT     $remote_port;
            #服务器IP地址			
            fastcgi_param  SERVER_ADDR     $server_addr; 
			#服务器端口
            fastcgi_param  SERVER_PORT     $server_port;
            #服务器名,域名在server配置中指定的server_name			
            fastcgi_param  SERVER_NAME     $server_name; 
            include        fastcgi_params;
        }

        # deny access to .htaccess files, if Apache‘s document root
        # concurs with nginx‘s one
        #
        #location ~ /\.ht {
        #    deny  all;
        #}
    }


    # another virtual host using mix of IP-, name-, and port-based configuration
    #
    #server {
    #    listen       8000;
    #    listen       somename:8080;
    #    server_name  somename  alias  another.alias;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}


    # HTTPS server
    #
    #server {
    #    listen       443 ssl;
    #    server_name  localhost;
	
    #    SSL证书
    #    ssl_certificate      cert.pem;
	#    SSL证书的私钥
    #    ssl_certificate_key  cert.key;

    #    ssl_session_cache    shared:SSL:1m;
	#    支持什么协议,下面这些也都是默认支持的
	#    ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
	
	#    SSL超时时间,如果服务器性能比较好可以把时间调整长一点。但是也要看具体应用
	#因为SSL建立和释放更消耗资源,可以评估一下,是频繁的建立和断开更消耗资源,还是长一点
	#的超时时间更消耗。通常也要看具体场景,如果用户打开网站通常都是需要浏览一会儿,比如购物网站
	#那么超时时间建议设置长一点,但是付款环节通常都是比较快速,通常这个页面没有长时间浏览的必要,
	#另外为了安全考虑这个阶段的超时时间要短一点。
    #    ssl_session_timeout  5m;

	#    加密选项
    #    ssl_ciphers  HIGH:!aNULL:!MD5;
	#    是否允许服务器来挑选使用什么加密
    #    ssl_prefer_server_ciphers  on;

    #    location / {
    #        root   html;
    #        index  index.html index.htm;
    #    }
    #}

}


本文出自 “小恶魔的家” 博客,请务必保留此出处http://littledevil.blog.51cto.com/9445436/1901390

以上是关于Nginx:nginx.conf配置文件说明 配置参数说明的主要内容,如果未能解决你的问题,请参考以下文章

Nginx nginx.conf配置文件说明

Nginx:nginx.conf配置文件说明 文件结构和配置高亮

Nginx配置文件说明

Nginx配置文件nginx.conf详细说明文档

nginx 配置说明

nginx.conf配置说明