nginx 配置参数说明

Love The Way You Lie 2022-05-24 05:12 239阅读 0赞

一、主配置段  
1、正常运行必备的配置  
\#运行用户和组，组身份可以省略  
user nginx nginx;  
  
\#指定nginx守护进程的pid文件  
pid path/to/nginx.pid;  
  
\#指定所有worker进程所能打开的最大文件句柄数  
worker\_rlimit\_nofile 100000;  
  
2、性能优化相关的配置  
\#worker进程的个数，通常应该略少于CPU物理核心数，也可以使用auto自动获取  
worker\_processes auto;  
  
\#CPU的亲缘性绑定(同样是无法避免CPU的上下文的切换的)  
\#优点：提升缓存的命中率  
\#context switch：会产生CPU不必要的消耗  
work\_cpu\_affinity 00000001 00000010 00000100 00001000 00010000 00100000 01000000 10000000;  
  
\#计时器解析度(请求到达nginx,nginx相应用户请求后，要获取系统时间并记录日志，高并发的时候可能每秒钟获取很多很多次)  
\#降低此值，可以减少gettimeofday()系统调用的次数  
timer\_resolution 100ms;  
  
\#指明worker进程的nice值：数字越小,优先级越高  
\#nice值范围：-20,19  
\#对应的优先级：100，139  
worker\_priority number;  
  
二、事件相关的配置  
events \{   
 \#master调度用户请求至个worker进程时使用的负载均衡锁:on表示能让多个worker轮流地、序列化的响应新请求  
 accept\_mutex \{off|on\}  
  
 \#延迟等待时间，默认为500ms  
 accept\_mutex\_delay time;  
  
 \#accept\_mutex用到的锁文件路径  
 lock\_file file;  
  
 \#指明使用的时间模型：建议让Nginx自行选择  
 use \[epoll|rtsig|select|poll\];  
  
 \#单个worker进程打开的最大并发连接数，worker\_processes\*worker\_connections  
 worker\_connections 2048;  
  
 \#告诉nginx收到一个新链接通知后接受尽可能多的链接  
 multi\_accept on;   
\}  
  
三、用于调试、定位问题  
\#是否以守护进程方式运行nginx；调试时应该设置为off  
daemon \{on|off\}  
  
\#是否以master/worker模型来运行；调试时可以设置为off  
master\_process \{on|off\}  
  
\#error\_log 位置 级别,若要使用debug，需要在编译nginx时使用--with-debug选项  
error\_log file | stderr | syslog:server=address\[,parameter=value\] | memory:size \[debug|info|notice|warn|error|crit|alert|emerg\];  
  
总结：常需要调整的参数:worker\_processes, worker\_connections,work\_cpu\_affinity,worker\_priority  
新改动配置生效方式：  
nginx -s reload其他参数stop，quit，reopen也可以使用nginx -h查看到  
  
四、nginx作为web服务器使用的配置  
http \{\}:由ngx\_http\_core\_module模块所引入  
配置框架：  
http \{   
 upstream \{   
 ...  
 \}  
 server \{   
 location URL \{   
 root "/path/to/somedir"  
 ...  
 \}\#类似于httpd中的<Location>,用于定义URL与本地文件系统的映射关系  
 location URL \{   
 if ... \{   
 ...  
 \}  
 \}  
 \}\#每个server类似于httpd中的一个<VirtualHost>  
 server \{   
 ...  
 \}  
\}  
注意：与http相关的额指令仅能够防止与http、server、location、upstream、if上下文，但有些指令仅应用于这5种上下文的某些种。  
  
http \{   
 \#打开或关闭错误页面中的nginx版本号  
 server\_tokens on;  
 \#!server\_tag on;  
 \#!server\_info on;  
  
 \#优化磁盘IO设置，指定nginx是否调用sendfile函数来输出文件，普通应用设为on，下载等磁盘IO高的应用，可设为off  
 sendfile on;  
 \#设置nginx在一个数据包里发送所有头文件，而不是一个接一个的发送  
 tcp\_nopush on;  
 \#设置nginx不要缓存数据，而是一段一段的发送，  
  
 \#长连接的超时时长，默认为75s  
 keepalive\_timeout 30;  
 \#在一个长连接所能够允许请求的最大资源数  
 keepalive\_requests 20;  
 \#为制定类型的User Agent禁用长连接  
 keepalive\_disable \[msie6|safari|none\];  
 \#是否对长连接使用TCP\_NODELAY选项,不将多个小文件合并传输  
 tcp\_nodelay on;  
 \#读取http请求报文首部的超时时长  
 client\_header\_timeout \#;  
 \#读取http请求报文body部分的超时时长  
 client\_body\_timeout \#;  
 \#发送响应报文的超时时长  
 send\_timeout \#;  
  
 \#设置用户保存各种key的共享内存的参数，5m指的是5兆  
 limit\_conn\_zone $binary\_remote\_addr zone=addr:5m;  
 \#为给定的key设置最大的连接数，这里的key是addr，设定的值是100，就是说允许每一个IP地址最多同时打开100个连接  
 limit\_conn addr 100;  
  
 \#include指在当前文件中包含另一个文件内容  
 include mime.types;  
 \#设置文件使用默认的mine-type  
 default\_type text/html;  
 \#设置默认字符集  
 charset UTF-8;  
  
 \#设置nginx采用gzip压缩的形式发送数据，减少发送数据量，但会增加请求处理时间及CPU处理时间，需要权衡  
 gzip on;  
 \#加vary给代理服务器使用，针对有的浏览器支持压缩，有个不支持，根据客户端的HTTP头来判断是否需要压缩  
 gzip\_vary on;  
 \#nginx在压缩资源之前，先查找是否有预先gzip处理过的资源  
 \#!gzip\_static on;  
 \#为指定的客户端禁用gzip功能  
 gzip\_disable "MSIE\[1-6\]\\.";  
 \#允许或禁止压缩基于请求和相应的响应流，any代表压缩所有请求  
 gzip\_proxied any;  
 \#设置对数据启用压缩的最少字节数，如果请求小于10240字节则不压缩，会影响请求速度  
 gzip\_min\_length 10240;  
 \#设置数据压缩等级，1-9之间，9最慢压缩比最大  
 gzip\_comp\_level 2;  
 \#设置需要压缩的数据格式  
 gzip\_types text/plain text/css text/xml text/javascript application/json application/x-javascript application/xml application/xml+rss;   
  
 \#开发缓存的同时也指定了缓存文件的最大数量，20s如果文件没有请求则删除缓存  
 open\_file\_cache max=100000 inactive=20s;  
  
 \#指多长时间检查一次缓存的有效信息  
 open\_file\_cache\_valid 60s;  
  
 \#文件缓存最小的访问次数，只有访问超过5次的才会被缓存  
 open\_file\_cache\_min\_uses 5;  
  
 \#当搜索一个文件时是否缓存错误信息  
 open\_file\_cache\_errors on;  
  
 \#允许客户端请求的最大单文件字节数  
 client\_max\_body\_size 8m;  
  
 \#冲区代理缓冲用户端请求的最大字节数  
 client\_header\_buffer\_size 32k;  
  
 \#引用/etc/nginx/vhosts下的所有配置文件，如果主机名众多的情况下可以每个主机名建立一个文件，以方便管理  
 include /etc/nginx/vhosts/\*;  
\}  
  
五、虚拟主机设定模块  
\#负载均衡服务器列表(本人通常把负载均衡类别配置在相应的虚拟主机的配置文件中)  
upstream fansik \{   
 \#后端服务器访问规则  
 ip\_hash;  
 \#weight参数表示权重值，权值越高被分配到的几率越大  
 server 192.168.1.101:8081 weight=5;  
 server 192.168.1.102:8081 max\_fails=3 fail\_timeout=10s;  
\}  
server \{   
 \#监听80端口  
 listen 80;  
 \#定义主机名，主机名可以有多个，名称还可以使用正则表达式(~)或通配符  
 \#(1)先做精确匹配检查  
 \#(2)左侧通配符匹配检查：\*.fansik.com  
 \#(3)右侧通配符匹配检查：mail.\*  
 \#(4)正则表达式匹配检查：如~^.\*\\.fansik\\.com$  
 \#(5)detault\_server  
 server\_name fansik.fansik.com;  
 \#设定本虚拟主机的访问日志  
 access\_log logs/fansik.fansik.com.access.log;  
  
 location \[=|~|~\*|^~\] uri \{...\}  
 功能：允许根据用户请求的URI来匹配定义的个location，匹配到时，此请求将被相应的location配置块中的配置所处理  
 =：表示精确匹配检查  
 ~：正则表达式模式匹配检查，区分字符大小写  
 ~\*：正则表达式模式匹配检查，不区分字符大小写  
 ^~：URI的前半部分匹配，不支持正则表达式  
 !~：开头表示区分大小写的不匹配的正则  
 !~\*：开头表示不区分大小写的不匹配的正则  
 /：通用匹配，任何请求都会被匹配到  
 location / \{   
 \#定义服务器的默认网站根目录位置  
 root html;  
 \#定义首页索引文件的名称  
 index index.html index.htm;  
 \#引用反向代理的配置，配置文件目录根据编译参数而定  
 \#如果编译时加入了--conf-path=/etc/nginx/nginx.conf指定了配置文件的路径那么就把proxy.conf放在/etc/nginx/目录下  
 \#如果没有制定配置文件路径那么就把proxy.conf配置放到nginx的conf目录下  
 include proxy.conf;   
 \#定义后端负载服务器组  
 proxy\_pass http://fansik;  
 \}  
 alias path和root path的区别；  
 location /images/ \{   
 root "/data/images"  
 \}  
 http://fansik.fansik.com/images/a.jpg <-- /data/images/images/a.jpg  
 location /images/ \{   
 alias "/data/images/"  
 \}  
 http://fansik.fansik.com/images/a.jpg <-- /data/images/a.jpg  
  
  
 \#定义错误提示页面  
 error\_page 500 502 503 504 /50x.html;  
 location = /50x.html \{   
 root html;  
 \}  
  
 \#设定查看Nginx状态的地址  
 \#只能定义在location中  
 \#htpasswd -c -m /etc/nginx/.htpasswd fansik(-c 参数第一次创建时使用)  
 location /Status \{   
 stub\_status on;  
 allow all;  
 \#access\_log off;  
 \#allow 192.168.1.0/24;  
 \#deny all;  
 \#auth\_basic "Status";  
 \#auth\_basic\_user\_file /etc/nginx/.htpasswd;  
 \}  
 status结果实例说明：  
 Active connections: 1 (当前所有处于打开状态的连接数)  
 server accepts handled requests  
 174(已经接受进来的连接) 174(已经处理过的连接) 492(处理的请求，在保持连接模式下，请求数可能会多于连接数量)  
 Reading: 0 Writing: 1 Waiting: 0   
 Reading:正处于接受请求状态的连接数  
 Writing:请求接受完成，正处于处理请求或发送相应的过程中的连接数  
 Waiting:保持连接模式，且处于活动状态的连接数  
  
 \#基于IP的访问控制  
 allow IP/Netmask  
 deny IP/Netmask  
 location ~ /\\.ht \{   
 deny all;  
 \}  
\}  
  
  
六、反向代理的配置(反向代理的配置通常放在单独的配置文件中proxy.conf，通过include引用)  
proxy\_redirect off;  
\#后端的Web服务器可以通过X-Forwarded-For获取用户真实IP  
proxy\_set\_header Host $host;  
proxy\_set\_header X-Real-IP $remote\_addr;  
proxy\_set\_header X-Forwarded-For $proxy\_add\_x\_forwarded\_for;  
\#nginx跟后端服务器连接超时时间(代理连接超时)  
proxy\_connect\_timeout 60;  
\#连接成功后，后端服务器响应时间(代理接收超时)  
proxy\_read\_timeout 120;  
\#后端服务器数据回传时间(代理发送超时)  
proxy\_send\_timeout 20;  
\#设置代理服务器（nginx）保存用户头信息的缓冲区大小  
proxy\_buffer\_size 32k;  
\#proxy\_buffers缓冲区，网页平均在32k以下的设置  
proxy\_buffers 4 128k;  
\#高负荷下缓冲大小（proxy\_buffers\*2）  
proxy\_busy\_buffers\_size 256k;  
\#设定缓存文件夹大小，大于这个值，将从upstream服务器传  
proxy\_temp\_file\_write\_size 256k;  
\#1G内存缓冲空间，3天不用删除，最大磁盘缓冲空间2G  
proxy\_cache\_path /data/nginx/cache levels=1:2 keys\_zone=cache\_one:1024m inactive=3d max\_size=2g;  
  
七、https服务的配置  
server \{   
 listen 443 ssl;  
 server\_name test.fansik.cn;  
 ssl\_certificate 100doc.cn.crt;  
 ssl\_certificate\_key 100doc.cn.key;   
 ssl\_session\_cache shared:SSL:1m;  
 ssl\_protocols SSLv2 SSLv3 TLSv1;  
 ssl\_session\_timeout 5m;   
 ssl\_ciphers ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP;  
 ssl\_prefer\_server\_ciphers on;   
 location / \{   
 root /data/app  
 index index.html index.htm;  
 \}  
\}  
  
八、url地址重写  
rewrite regex replacment flag  
例如：rewrite ^/images/(.\*\\.jpg)$ /imgs/$1 break;\#$1是前面括号中的内容哦  
http://fansik.fansik.com/images/a/1.jpg --> http://fansik.fansik.com/imgs/a/1.jpg  
flag:  
 last:一旦此rewrite规则重写完成后，不再被后面其他的rewrite规则进行处理，  
 而是由User Agent重新对重写后的URL再一次发起请求，并从头开始执行类似的过程。  
 break：一旦此rewrite规则重写完成之后，由User Agent对新的URL重新发起请求，  
 且不会被当前location内的任何rewrite规则过检查  
 redirect：以302响应码(临时重定向)返回新的URL  
 permanent：以301响应码(永久重定向)返回新的URL  
  
九、if判断  
语法：if (condition) \{...\}  
应用环境：server，location  
condition：  
(1)变量名：  
变量值为空串，或者以"0"开始，则为false，其他的均为true  
(2)以变量为操作数构成的比较表达式  
可以使用=，!=类似的比较操作符进行测试  
(3)正则表达式的模式匹配操作  
~：区分大小写的模式匹配检查  
~\*：不区分大小写的模式匹配检查  
!~和!~\*：对上面两种测试取反  
(4)测试路径为文件可能性：-f ,~-f  
(5)测试制定路径为目录的可能性：-d,!-d  
(6)测试文件存在性：-e,!-e  
(7)检查文件是否有执行权限：-x,!-x  
例如：  
if($http\_user\_agent ~\* MSIE)\{   
 rewrite ^(.\*)$ /msie/$1 break;  
\}  
  
十、防盗链  
location ~\* \\.(jpg|gif|jpeg|png)$ \{   
 valid\_referer none blocked www.fansik.com;  
 if ($invalid\_referer) \{   
 rewrite ^/ http://www.fansik.com/403.html;  
 \}

from:https://www.cnblogs.com/fansik/p/6952453.html