nginx的配置及模块详解

Posted

tags:

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

nginx

      nginx是俄罗斯软件工程师Igor Sysoev开发的免费开源web服务器软件,nginx采用了模块化、事件驱动、异步、单线程及非阻塞的架构,并大量采用了多路复用及事件通知机制来实现高并发和高性能,解决C10K的问题,主要功能就是提供http和反向代理服务,以及邮件服务及反向代理等,并且具有多种web服务器功能特性:负载均衡,缓存,访问控制,带宽控制,以及高效整合各种应用的能力。

      在nginx中,连接请求由为数不多的几个仅包含一个线程的进程worker以高效的回环(run-loop)机制进行处理,而每个worker可以并行处理数千个的并发连接及请求。

     nginx特性:

        1、 模块化设计,较好的扩展性;

        2、 高可靠性:由一个master主进程和多个worker子进程

        3、 支持热部署:平滑升级版本

               不停机更新配置文件、更换日志文件、更新服务器程序版本

        4、 低内存消耗

               10000个keep-alive连接模式下的非活动连接仅消耗2.5M内存

      nginx的基本功能:

           静态资源的web服务器;

           http协议的反向代理服务器

           pop3/imap4协议反向代理服务器

           FastCGI,uWSGI等协议;

           模块化(非DSO),不支持动态装卸载

  

 一、nginx的配置详解(用淘宝研发的tengine作为例子):  

user  nginx nginx;     //指定用于运行worker进程的用户和组
worker_processes  4;   //指定nginx运行的子进程数,通过时CPU核心数-1

error_log  logs/error.log  info;  //全局错误日志,类型为info

pid        logs/nginx.pid;    //nginx运行时的PID

worker_rlimit_nofile_number 2048; //当个worker进程所能打开的最大连接数
worker_rlimit_sigpending 100;      //指定每个用户能够发往worker进程的信号的数量
worker_cpu_affinity cpumask ...;   和cpu做绑定,主要作用是均衡的使用cpu
        4颗cpu的话:
        worker_cpu_affinity 0001 0010 0100 1000;
worker_priority nice :  调整work子进程的nice值

 设定工作模式及连接数:

events {
    worker_connections  1024;         //单个worker能响应的最大并发连接数
    use [epoll|rgsig|select|poll];    //定义使用的事件模型;建议让Nginx自动选择
    accept_mutex [on|off];
        //内部调用用户请求至各worker时用的负载均衡锁;打开时表示能让多个worker轮流地、序列化地与响应新请求;
    lock_file /path/to/lock_file;  //锁文件,
    accept_mutex_delay #ms;        //内部调用用户请求至各worker时的延迟时间 
}

设定http服务:

 http {
    include       mime.types;     //设定mime类型,类型由mime.type文件定义
    default_type  application/octet-stream;
    #log_format  main  ‘$remote_addr - $remote_user [$time_local] "$request" ‘
    #                  ‘$status $body_bytes_sent "$http_referer" ‘
    #                  ‘"$http_user_agent" "$http_x_forwarded_for"‘;
           //日志的格式
    access_log  logs/access.log  main;   //访问日志的存放路径 
    
    sendfile        on;    //sendfile函数,对于普通应用,必须设为on,如果用来进行下载等应用磁盘IO重负载应用,可设置为off,以平衡磁盘与网络I/O处理速度,降低系统的uptime.
    tcp_nopush     on;     // 是否启用TCP_NOPUSH(FREEBSE)或TCP_CORK(Linux)选项;仅在sendfile为on时有用;   
    
    keepalive_timeout  65;  // 设定keepalive连接的超时时长;0表示禁止长连接;默认为75s;
    tcp_nodelay on|off;     // 对keepalive模式下的连接是否使用TCP_NODELAY选项; 
    gzip  on;              // 是否启用gzip压缩报文的body  
    
    keepalive_requests number; //在keepalived连接上所允许请求的最大资源数量;默认为100;
    keepalive_disable none | browser ...;  //指明禁止为何种浏览器使用keepalive功能; 
    send_timeout 60;     //向客户端发送响应报文的超时时长,默认为60s
    
    client_body_buffer_size 512k;  //接收客户请求报文body的缓冲区大小;默认为16k;超出此指定大小时,其将被移存于磁盘上
    client_body_temp_path path [level1 [level2 [level3]]]; //设定用于存储客户端请求报文的body的临时存储路径及子目录结构和数量;
   
    client_header_buffer_size    1k;     //设置客户请求报文首部的缓冲区大小
    large_client_header_buffers  4 4k;   //设置请求报文大首部的缓冲区大小
    
    aio  on|off;                        //是否打开异步传输的功能,默认是关闭的
    directio  size|off;                 //设置直接IO的大小及是否关闭
    open_file_cache max=65535 inactive=20s;                //是否开启文件描述符缓存
    open_file_cache_errors on | off     //是否缓存找不到其路径的文件,或没有权限没有权限访问的文件相关信息
    open_file_cache_valid 30s;       //每隔多久检查一次缓存中缓存项的有效性;默认为60s; 
    open_file_cache_min_uses number 1  //缓存项在非活动期限内最少应该被访问的次数,指定被访问次数的多少才算是最少访问	

server服务:

server {
        listen       80;              //监听的端口
        server_name  localhost;       //虚拟主机名称
        access_log  logs/host.access.log  main;  //访问本虚拟机服务的日志
        
        location /admin/ {                  //匹配客户端请求的URL
            root   html;              //指定Document的路径,在安装目录的html目录下
            index  index.html index.htm;  //默认主页
        }
        =: URI的精确匹配;         location = /admin/
	~: 做正则表达式匹配,区分字符大小写;
	~*:做正则表达式匹配,不区分字符大小写;
	^~:对URI的左半部分匹配,不区分字符大小写;
			
	匹配优先级:精确匹配= > ^~ > ~或~* > 不带符号的URI;
	
	location  /images/  {
	     alias /data/imgs/;   //定义location匹配的别名
	}
	error_page  404              /404.html;  //错误页面
	error_page   500 502 503 504  /50x.html;  //服务器端错误页面
        location = /50x.html {       
            root   html;
        }
	location /download/ {
	   imit_except  GET {
	     allow  172.16.0.0/16;  //只有172.18.0.0的主机能用其他方法,其他主机只能get
		deny all;
           }
	}	
	location /download/ {
	limit rate 20480;   //限制客户端每秒钟所能够传输的字节数,默认为0表示无限制
	}

 二、nginx的模块详解:          

1、ngx_http_access_module            (实现访问控制)

           allow address | CIDR | unix: | all;

           deny address | CIDR | unix: | all;

     

2、ngx_http_auth_basic_module    (实现basic认证)          

    2.1 auth_basic string | off     使用http basic认证协议对用户进行认证;
    2.2 auth_basic_user_file file;  实现用户认证的账号文件
  
  location /admin/ {
	auth_basic "Admin Area";
	auth_basic_user_file /etc/nginx/.ngxhtpasswd;
  }	

 技术分享

3、ngx_http_log_module  (现实日志功能的模块)

    3.1  log_format  name  string  ...;   定义日志格式及其名称
         log_format compression ‘$remote_addr - $remote_user [$time_local] ‘
                                ‘"$request" $status $bytes_sent ‘
                                ‘"$http_referer" "$http_user_agent" "$gzip_ratio"‘;
    3.2  access_log path [format [buffer=size [flush=time]]];
           path:  日志存放路径
           format: 日志格式  默认为combined格式	                            
           buffer: 日志缓存大小
           flush:  刷写时间间隔
   
    3.3 open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time]
           open_log_file_cache off   关闭日志缓存功能
           max:      最大缓存的条目
           inactive:缓存的活动时间
           min_user: 在缓存时间内的最小使用次数
           valid:    检查缓存里文件描述符的有效性

4、ngx_http_stub_status_module  (实现显示nginx的状态)

    location /status {
             stub_status;
     }    
     Active connections:当前活动的客户端连接数;
     accepts:已经接受的客户端连接总数;
     handled:已经处理过后客户端连接总数;
     requests:客户端的总的请求数;
     Readking:正在读取的客户端请求报文首部的连接数;
     Writing:正向其发送响应报文的连接数;
     Waiting:等待客户端发出请求的空闲连接数;

   技术分享

5、ngx_http_referer_module (基于请求报文中的Referer首部的值做访问控制)

   valid_referers  none | blocked | server_names | string ...; 定义合法的请求
      none:请求报文不存在referer首部;
      blocked:请求报文中存在referer首部,但其没有有效值,或其值非以http://或https://开头
      server_names:其值为一个主机名;
      arbitrary string:直接字符串,可以使用*通配符;
      regular expression:以~起始的正则表达式;
  内置变量:$invalid_referer(所有不能符合valid_referer指定定义的引用请求均为不合法引用)

  valid_referers   none   blocked   server_names   *.,magedu.com   magedu.*  www.magedu.com/galleries/   ~\.magedu\.;	
       if ($invalid_referer) {
	   return  403;
       }	

6、ngx_http_ssl_module  (实现http的加密)

        ssl on|off                 是否启用SSL
        ssl_certificate file;      证书文件路径;
        ssl_certificate_key file;  证书对应的私钥文件;
        ssl_ciphers ciphers;       指明由nginx使用的加密算法,可以是OpenSSL库中所支持各加密套件;
        ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2];
          //指明支持的ssl协议版本,默认为后三个;
        ssl_session_cache off | none | [builtin[:size]] [shared:name:size];
	  //指明ssl会话缓存机制;
	  off:  不使用session会话  
	  none: 温和禁止
	  builtin:使用OpenSSL内置的ssl会话缓存,对机制为各worker私有;
	  shared:在各worker之间使用一个共享的缓存;
	      name  缓存空间的名称
	      size:缓存空间的大小,字节为单位,每1MB内存空间可缓存4000个会话
	  ssl_session_timeout time;
	  //ssl会话超时时长;即ssl session cache中的缓存有效时长;默认5分钟	

示例:

server {
        listen       443;
        server_name  localhost;
 
        ssl                  on;
        ssl_certificate      /usr/local/nginx/conf/ssl/nginx.pem;
        ssl_certificate_key  /usr/local/nginx/conf/ssl/nginx.key;
 
        ssl_session_timeout  5m;
 
        ssl_protocols  SSLv2 SSLv3 TLSv1;
        ssl_ciphers  HIGH:!aNULL:!MD5;
        ssl_prefer_server_ciphers   on;
 
        location / {
            root   html;
            index  index.html index.htm;
        }
    }

技术分享

7、ngx_http_rewrite_module  (将请求的url基于正则表达式进行重写)

  rewrite  regex  replacement [flag];
      regex:正则表达式,用于匹配用户请求的url;
      replacement:重写为的结果;
  [flag]:		
  last:重写完成之后停止对当前uri的进一步处理,改为对其他location的url的新一轮处理;
  break:重写完成之后停止对当前uri的处理,转向其后面的其它配置;
  redirect:重写完成之后会返回客户端一个临时的重定向,由客户端对新的url重新发起请求(302);
  permanent:重写完成之后会返回客户端一个永久的重定向,由客户端对新的url重新发起请求(301);

示例:所有请求http服务下admin的目录的都重定向到https。

location /admin/ {
              rewrite /admin/.*  redirect ;
    }

    技术分享

8、ngx_http_gzip_module  (实现对响应报文的压缩,节省资源和带宽)

    gzip on | off;                 启用或禁用gzip压缩响应报文;
    gzip_comp_level level;         压缩比,1-9,默认为1; 
    gzip_disable regex ...;    regex是为用于匹配客户端响应器类型的正则表达式;表示对何种浏览器禁止使用压缩功能;
    gzip_min_length length;         触发压缩功能的响应报文的最小长度;
    gzip_http_version 1.0 | 1.1;    设定启用压缩功能时,协议的最小版本;
    gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any ...;           定义对客户端请求的具有何种请求属性的资源启用压缩功能;如expired则表示对由于使用了expire首部而无法缓存的对象启用压缩功能;
    gzip_types mime-type ...;  指明仅对哪些类型的资源执行压缩操作;即压缩过滤器;默认为txt/html

示例:

gzip  on;
gzip_http_version 1.0;
gzip_comp_level 6;
gzip_disable msie6;
gzip_min_length 2;
gzip_types text/plain text/css text/xml application/x-javascript application/xml application/json application/java-script;			

技术分享     

9、ngx_http_fastcgi_module   (实现fastcgi协议)

  fastcgi_pass address;       fastcgi监听的地址
  fastcgi_index name;         定义fastcgi应用的默认主页
  fastcgi_param parameter value [if_not_empty]   设定传递给后端fastcgi server参数及其值
  fastcgi_cache_path path  [levels=levels] keys_zone=name:size [inactive=time] [max_size=size];  定义缓存:缓存空间等; 只能用于的上下文 :http 
      path:                    文件系统路径,用于存储缓存的文件数据   
      levels=#[:#[:#]]         缓存目录层级定义
      keys_zone=name:size      内存中用于缓存K/V映射关系的空间名称及大小
      name:                    cache的标识符;
      size:                   元数据cache大小;
      inactive=time:          缓存的非活动的时间 
      max_size:               缓存空间上限;
  fastcgi_cache zone | off;    调用定义过的缓存;      
  fastcgi_cache_key string;    定义要使用的缓存键
  fastcgi_cache_methods GET | HEAD | POST ...;      为请求方法对应的请求进行缓存,默认为GET和HEAD; 
  fastcgi_cache_min_uses number;           在指定时间内缓存项的最少使用次数
  fastcgi_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_503 | http_403 | http_404 | off ...;        是否可使用过期的缓存项响应用户请求;
  fastcgi_cache_valid [code ...] time;     对不同响应码的响应设定其可缓存时长;

示例:

fastcgi_cache_path /var/cache/nginx levels=2:1 keys_zone=fscache:10m inactive=30 max_size=1G;      //注意,这个不是定义在server中,而是定义在http中
location ~ \.php$ {
            root           html;
            fastcgi_pass   172.18.250.77:9000;
            fastcgi_index  index.php;
            fastcgi_param  SCRIPT_FILENAME  $fastcgi_script_name;
            include        fastcgi_params;
            fastcgi_cache fscache;
            fastcgi_cache_key $request_uri;
            fastcgi_cache_min_users 1;
            fastcgi_cache_valid 200 302 10m;
            fastcgi_cacge_valid 403  5m;             
}

技术分享

]# tree .     查看缓存的分级目录
.
├── 9e
│   └── 3
│       └── f46b8508aa08a6f8670fb088b8a9739e
├── eb
│   └── f
│       └── c86156f7dcfecf44876ca30d1bac7feb
└── f1
    └── a
        └── e251273eb74a8ee3f661a7af00915af1

10、ngx_http_proxy_module (反向代理模块)

proxy_pass URL ;请求转向的服务器
     1、proxy_pass后面的路径不带URI时,其会将location的uri传递给
     location /uri/ {
             proxy_pass     访问后端主机时请求的是DocumentRoot目录下的/uri/ 
     }
     2、location定义其uri时使用了正则表达模式匹配机制,则proxy_pass后的路径必须不能使用uri;           
     location ~|~* PATTERN {
              proxy_pass http://host;
     }
     3、 proxy_pass后面路径是一个uri时,会将location的uri替换为proxy_pss后端主机的uri
     location /uri/ {
              proxy_pass http://host/new_uri/  相当于/uri/映射为后端主机的/new_uri            }
proxy_set_header field value;    设定向后端主机发送的请求报文的首部及其值
    proxy_set_header X-Real-IP $remote_addr;  向后端主机传递客户端IP
proxy_cache_path path [levels=levels] keys_zone=name:size inactive=time [max_size=size];     //定义缓存代理   只能应用在http中 
proxy_cache zone |off;   调用缓存
proxy_cache_key string;  定义缓存键
prox_cache_valid;      为不同的状态码提供缓存
proxy_cache_use_stale error |timeout |invalid_header |updating  使用过期内容来响应客户端,默认为关闭
proxy_cache_purge sting   清理缓存
proxy_cache_methods       为哪种请求方法缓存,默认为get,head
proxy_connect_timeout     与后端服务器建立连接的超时时长,默认为60s,最长为75s
proxy_read_timeout        等待后端发送响应报文的超时时长,默认为60s,两次之间的时长
proxy_send_timeout        向后端服务器发送请求报文的超时时长,默认为60S

技术分享

]# tree .            代理缓存
.
├── 9e
│   └── 3
│       └── f46b8508aa08a6f8670fb088b8a9739e
├── eb
│   └── f
│       └── c86156f7dcfecf44876ca30d1bac7feb
└── f1
    └── a
        └── e251273eb74a8ee3f661a7af00915af1

11、ngx_http_upstream_module   (实现负载均衡)

 1、 upstream name {...}        定义后端服务器组;引入新的上下文;只能用于http上下文
        name:名称,直接字符串
 2、 server address [parameters]    定义服务器的地址和相关的参数;  
        address格式:
                IP[:port]          //给定IP地址
                HOSTNAME[:port]    //当后端有多个虚拟主机时,应该使用HOSTNAME
                unix:/path/to/some__sock_file  
        [parameters]:参数
              weight=number      服务器权重
              max_fails=number   最大失败尝试次数
              fail_timeout=time  设置多长时间后服务器不可用
              backup             设置为sorry server
              down               手动把服务器表示为down,不在处理任何用户请求;

 示例:

upstream webserver {
    server 172.18.250.76:80 weight=1;     
    server 172.18.250.77:80 weight=1;
}
location / {
            proxy_pass http://webserver;
}   
]# curl 172.18.250.75           //实现了负载均衡        
Hello httpd
]# curl 172.18.250.75
Hello nginx
]# curl 172.18.250.75
Hello httpd
]# curl 172.18.250.75
Hello nginx

后端服务器的80端口down会自动把服务器剔除,服务起来也会自动加入继续提供服务。

]# service httpd stop
]# curl 172.18.250.75
Hello nginx
]# curl 172.18.250.75
Hello nginx
ip_hash:   源地址哈希调度算法;只能用在upstream当中
upstream webserver {
    server 172.18.250.76:80 weight=1;
    server 172.18.250.77:80 weight=1;
    ip_hash;
}

技术分享

least_conn;   最少连接调度算法:考虑了后端服务器负载,用在upstream中
upstream webserver {
    server 172.18.250.76:80 weight=1;
    server 172.18.250.77:80 weight=1;
    least_conn;
keepalive connections;
      keepalive 32;       定义和后端主机的保持连接个数,一般和后端服务器数量一样
health_check [parameters]:  定义后端主机的健康状态检测机制,只能用于location中
    参数:
    interval=#:检测的频度,默认为5秒
    fails=number: 判定为失败的检测次数,默认为1
    passes=number: 判定为成功的检测次数,默认为1
    uri=uri :  执行健康状态检测时的请求uri,默认请求主页
    match=name: 基于哪个match做检测结果"成功"或者“失败”的判断
    port=number: 向服务器的哪个端口发起健康状态检测请求,默认为服务器自己的工作端口
    
match name {....}  仅能用于http上下文;对后端主机做健康状态检测时,定义其结果判断标准
    专用指令
        status:期望的响应码
          status CODE
          status !CODE
          status CODE-CODE
        header ;基于响应首部进行判断
          header HEADER=VALUE
          header HEADER!=VALUE
          header [!]HEADER
          header HEADER ~ VALUE
        body: 期望的响应报文的主体部分应有的内容;
          body~ "BODY"
          body!~ "BODY"

注意:health_check和match name 两个选项都是只有商业版本的nginx才会支持

hash key [consistent];   定义调度方法,可自定义基于何种信息(key)进行绑定,用于upstream
    hash $remote_addr      根据客户端IP
    hash $request_uri      根据请求的URI
    hash $cookie_username  根据客户端的cookie

以上是关于nginx的配置及模块详解的主要内容,如果未能解决你的问题,请参考以下文章

Nginx 服务器安装及配置文件详解

Nginx 服务器安装及配置文件详解

nginx服务器安装及配置文件详解

nginx日志及错误日志详解

nginx

nginx