Nginx 配置文件说明
Posted
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了Nginx 配置文件说明相关的知识,希望对你有一定的参考价值。
nginx.conf
user www www; # Nginx的worker进程运行用户以及用户组
worker_processes 4; # 启动进程数,通常设置成和cpu的数量相等 或 auto
#worker_processes auto;
#以下参数指定了哪个cpu分配给哪个进程,一般来说不用特殊指定。如果一定要设的话,用0和1指定分配方式.
#这样设就是给1-4个进程分配单独的核来运行,出现第5个进程是就是随机分配了。
#worker_processes 4 #4核CPU
#worker_cpu_affinity 0001 0010 0100 1000
worker_cpu_affinity auto; # 也可直接设置为 auto
error_log /home/wwwlogs/nginx_error.log crit; # 定义全局错误日志定义类型,[debug|info|notice|warn|crit]
pid /usr/local/nginx/logs/nginx.pid; # PID文件
#Specifies the value for maximum file descriptors that can be opened by this process.
# 一个nginx进程打开的最多文件描述符数目,理论值应该是最多打开文件数(ulimit -n)与nginx进程数相除,
# 但是nginx分配请求并不是那么均匀,所以最好与ulimit -n的值保持一致。
worker_rlimit_nofile 51200;
# 工作模式及连接数上限
events
# use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
# epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型,如果跑在FreeBSD上面,
# 就用kqueue模型。
use epoll;
worker_connections 51200; # 单个后台worker process进程的最大并发链接数
# worker工作方式:串行(一定程度降低负载,但服务器吞吐量大时,设置on使用并行方式)
# 默认 off 串行即可
multi_accept off;
# 当一个新连接到达时,如果激活了accept_mutex,那么多个Worker将以串行方式来处理,
# 其中有一个Worker会被唤醒,其他的Worker继续保持休眠状态;
# 如果没有激活accept_mutex,那么所有的Worker都会被唤醒,不过只有一个Worker能获取新连接,其它的Worker会重新进入休眠状态,这就是「惊群问题」。
# 其实对于nginx来说,不需要考虑惊群问题,进程数就那么多,默认设置为 off 即可,不需要调成
accept_mutex off;
http
#文件扩展名与文件类型映射表
include mime.types;
#默认文件类型
default_type application/octet-stream;
# 服务器名字的hash表大小
server_names_hash_bucket_size 128;
#指定来自客户端请求头的hearerbuffer大小
client_header_buffer_size 32k;
#指定客户端请求中较大的消息头的缓存最大数量和大小。
large_client_header_buffers 4 32k;
#客户端请求单个文件的最大字节数
client_max_body_size 50m;
sendfile on; #开启高效传输模式。
#防止网络阻塞
tcp_nopush on;
keepalive_timeout 60; # 连接超时时间 ,单位是秒
tcp_nodelay on;
#FastCGI相关参数是为了改善网站的性能:减少资源占用,提高访问速度。
fastcgi_connect_timeout 300;
fastcgi_send_timeout 300;
fastcgi_read_timeout 300;
fastcgi_buffer_size 64k;
fastcgi_buffers 4 64k;
fastcgi_busy_buffers_size 128k;
fastcgi_temp_file_write_size 256k;
gzip on; # 开启gzip压缩
gzip_min_length 1k; #最小压缩文件大小
gzip_buffers 4 16k; #压缩缓冲区
gzip_http_version 1.1; #压缩版本(默认1.1,前端如果是squid2.5请使用1.0)
gzip_comp_level 2; #压缩等级 1-9 等级越高,压缩效果越好,节约宽带,但CPU消耗大
gzip_types text/plain application/javascript application/x-javascript text/javascript text/css application/xml application/xml+rss application/json;
#压缩类型,默认就已经包含text/html,所以下面就不用再写了,
#写上去也不会有问题,但是会有一个warn。
#前端缓存服务器缓存经过压缩的页面
gzip_vary on;
gzip_proxied expired no-cache no-store private auth;
gzip_disable "MSIE [1-6]\\."; # IE6浏览器不启用压缩
#limit_conn_zone $binary_remote_addr znotallow=perip:10m;
##If enable limit_conn_zone,add "limit_conn perip 10;" to server section.
server_tokens off;
access_log off;
# 定义日志格式
log_format up_head $remote_addr - $remote_user [$time_local] "$request"
$status $body_bytes_sent "$http_referer"
"$http_user_agent" "$http_x_forwarded_for" "deviceid: $http_deviceid"
"$request_body" $upstream_response_time "$request_time";
include vhost/*.conf;
vhost/test.conf
server
listen 80;
listen 443 ssl;
server_name www.test.com;
ssl_certificate /nginx/conf/https/www.test.com.crt;
ssl_certificate_key /nginx/conf/https/www.test.com.key;
root /www/www.test.com;
index index.html index.htm index.php;
location ~^/test.php
default_type application/json;
return 404 404;
access_log off;
location ~ ^/test/status(.*)$
default_type text/html;
access_log /log/nginx/access/dot.log;
return 200 ;
location /
try_files $uri $uri/ /index.php?$query_string;
location ~\\.php$
# 如果用到 sock 则值参考 unix:/var/run/php/php7.0-fpm.sock
fastcgi_pass unix:/tmp/php-cgi.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
access_log /log/nginx/access/access.log up_head;
# 静态文件
location ~ .*\\.(gif|jpg|jpeg|png|bmp|swf)$
expires 30d; # 对于静态文件,需要设置一个过期时间,
# 这样可以让这些资源缓存到客户端浏览器,
# 在缓存未失效前,客户端不再向服务期请求相同的资源,
# 从而节省带宽和资源消耗。
location ~ .*\\.(js|css)?$
expires 12h;
location ~ /.well-known
allow all;
location ~ /\\.
deny all;
# 隐藏敏感文件
location ~ .*\\.(txt|sql|md|json|lock)$
deny all;
access_log /alidata/log/nginx/127.0.0.1.log up_head; # 日志存储路径和日志格式,对应 log_format
error_log /alidata/log/nginx/nginx_error.log;
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 配置文件说明的主要内容,如果未能解决你的问题,请参考以下文章