Nginx的几个重要模块
ngx_http_ssl_module
让Nginx可以支持HTTPS的模块，此模块下的大多数指令都应用在http,server上下文
①ssl on | off;
是否开启ssl功能
②ssl_certificate file;
当前虚拟主机使用的PEM格式的证书文件
③ssl_certificate_key file;
当前虚拟主机使用的证书中与公钥配对的私钥文件
④ssl_protocols [SSLv2] [SSLv3] [TLSv1] [TLSv1.1] [TLSv1.2];
ssl协议的版本，SSLv2不安全，建议使用TLS，默认使用的是TLS
⑤ssl_session_timeout time;
ssl会话超时时长，指ssl会话中缓存条目的有效时长，默认为5m
⑥ssl_session_cache off | none | [builtin[:size]] [shared:name:size];
指明ssl会话的缓存机制，默认是关闭的
builtin //使用openssl内建的缓存机制，为worker独有 shared //由各worker共享的缓存 name //缓存空间的名称 size //缓存空间的大小/单位字节，每1MB内存空间可缓存4000个会话
⑦ssl_prefer_server_ciphers on | off;
倾向于使用服务器端的加密算法，默认是关闭的
ngx_http_log_module
此模块可以基于给定的格式记录请求于日志中
①access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
access_log off;
用在http,server,location,if in location,limit_except上下文
默认值是access_log logs/access.log combined;
②log_format name string ...;
定义日志格式
用在http上下文中
③open_log_file_cache max=N [inactive=time] [min_uses=N] [valid=time];
open_log_file_cache off;
定义开启日志文件缓存功能
用于http,server,location上下文，默认是关闭的
max //最大缓存条目 inactive=time //非活动时长，默认为10s min_uses //最少使用次数，默认为1次 valid=time //验证缓存条目有效性的时长，默认为60s
ngx_http_rewrite_module
基于此模块实现对请求的URL进行重写、重定向
①rewrite regex replacement [flag];
用在server,location,if上下文中
/*①把用户请求的URI基于regex做检查，匹配到时将替换为replacement指定的字符串 ②在同一个location中存在多个rewrite规则会自上而下逐个被检查(最多循环10次)，可以使用flag控制此循环功能 ③如果replacement中有以http或https开头，则替换结果会直接以重定向的方式返回客户端*/ [flag]: last //重写完成后停止对当前url在当前Location中的后续其他重写操作，改为对新url的新一轮处理； break //重写完成后停止对当前url在当前Location中的后续其他重写操作;(退出rewrite中的规则) redirect //重写完成后以临时重定向方式直接返回重写后生成的新的URL给客户端，由客户端对新的URL再次请求(响应码：302) permanent //重写完成后以永久重定向方式直接返回重写后生成的新的URL给客户端，由客户端对新的URL再次请求(响应码：301)
②rewrite_log on | off;
是否启用重写日志；启用时，日志信息被发往错误日志，默认是关闭的
用在http,server,location,if上下文
③if (condition) { ... }
条件判断机制，在条件满足时，执行配置块中的配置，引入了一个新的配置上下文
仅用在server,location上下文中
condition: //比较表达式： ==，!= ~ //模式匹配，区分字符大小写 ~* //模式匹配，不区分字符大小写 !~ //模式不匹配，区分字符大小写 !~* //模式不匹配，不区分字符大小写 //文件及目录存在性判断： -f,!-f //文件 -d,!-d //目录 -e,!-e //存在 -x,!-x //执行权限 //示例： if ($http_user_agent ~ MSIE) { rewrite ^(.*)$ /msie/$1 break; } if ($http_cookie ~* "id=([^;]+)(?:;|$)") { set $id $1; } if ($request_method = POST) { return 405; } if ($slow) { limit_rate 10k; } if ($invalid_referer) { return 403; }
④return code [text];
return code URL;
return URL;
以指定的响应码和URL回应客户端
用在server,location,if上下文中
⑤set $variable value;
用户自定义变量
用在server,location,if上下文中
ngx_http_gzip_module
过滤器，对指定类型的资源压缩传输以节约带宽
①gzip on | off;
启用或禁用gzip压缩响应报文
用在http,server,location,if in location上下文中
②gzip_comp_level level;
指定压缩比(1-9),默认为1
用在http,server,location上下文
③gzip_disable regex ...;
regex是匹配客户端浏览器类型的模式，表示对匹配到的浏览器不执行压缩响应报文
用在http,server,location上下文
④gzip_min_length length;
触发启用压缩功能的响应报文的最小长度
用在http,server,location上下文
⑤gzip_http_version 1.0 | 1.1;
设定启用压缩功能时，协议的最小版本，如果设置为1.1，1.0则不压缩
用在http,server,location上下文
⑥gzip_types mime-type ...;
指定仅执行压缩的资源内容类型，默认为text/html
用在http,server,location上下文
⑦gzip_proxied off | expired | no-cache | no-store | private | no_last_modified | no_etag | auth | any ...;
对代理的请求基于何种属性判断其是否应该启用压缩功能
用在http,server,location上下文
ngx_http_fastcgi_module
基于此模块实现与php-fpm结合
①fastcgi_pass address;
指明后端的服务器，address是fpm服务器监听的地址和端口
用在location和if in location上下文
②fastcgi_index name;
fastcgi应用的主页名称
用在http,server,location上下文
③fastcgi_param parameter value [if_not_empty];
传递给fpm服务器的参数及其值
用在http,server,location上下文
fastcgi_param SCRIPT_FILENAME /home/www/scripts/php$fastcgi_script_name; fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; //更多参数查阅fastcgi_params
④fastcgi_cache_path path [levels=levels] [use_temp_path=on|off] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
定义fastcgi的缓存相关，仅能定义在http上下文
path //文件系统路径，用于存储缓存的文件数据 max_size=size //定义此路径下的多大空间用于存储缓存数据 levels=#[:#[:#]] //缓存目录层级定义 //如：levels=1:2 keys_zone=name:size //内存空间中用于缓存k/v映射关系的空间名称及大小 inactive=time //非活动时间
⑤fastcgi_cache zone | off;
启用缓存功能，存于哪个zone中，依赖于上个配置中的定义
用在http,server,location上下文
⑥fastcgi_cache_key string;
定义要使用的缓存键
用在http,server,location上下文
//示例 fastcgi_cache_key localhost:9000$request_uri;
⑦fastcgi_cache_methods GET | HEAD | POST ...;
缓存基于哪些请求方法的相关数据
用在http,server,location上下文
⑧fastcgi_cache_min_uses number;
指定时间内缓存的最少使用次数
用在http,server,location上下文
⑨fastcgi_cache_valid [code ...] time;
对不同响应码设定其可缓存时长
//示例 fastcgi_cache_valid 200 302 10m; fastcgi_cache_valid 404 1m;
注意：启用缓存功能时，至少应该指定的三个参数：fastcgi_cache，fastcgi_cache_key，fastcgi_cache_valid
/* Nginx缓存的实现机制 分两部分存储缓存信息， 一部分放于内存中：key-value形式 其中key是url,value是缓存信息文件的校验码(md5) 另一部分是将缓存信息的文件置于磁盘上，并基于md5校验码实现分级存储，以便查找 */
ngx_http_proxy_module
基于此模块实现反代客户端请求至后端服务器
①proxy_pass URL;
代理指令，后跟后端主机的URL
用在location,if in location,limit_except上下文
//①proxy_pass后面的路径不带uri时，会把location的uri传递给后端主机 location /uri/ { proxy_pass http://HOST; } //假如location中的/uri/是/bbs/,访问的站点是www.a.com,则通过proxy_pass传递给后端主机的URL是：http://www.a.com/bbs/ //②proxy_pass后面路径是一个uri时，其会将location的uri替换为proxy_pass后端主机的uri location /uri/ { proxy_pass http://HOST/new_uri/; } //假如location中的/uri/是/bbs/,访问的站点是www.a.com,proxy_pass后面的new_uri是/BBS/，则通过proxy_pass传递给后端主机的URL是：http://www.a.com/BBS/； //③如果location定义uri时使用了正则表达式匹配机制，则proxy_pass后的路径必须不能使用uri location ~|~* PATTERN { proxy_pass http://HOST; }
②proxy_set_header field value;
设定向后端主机发送的请求报文的首部及其值
用在http,server,location上下文
proxy_set_header Real_Client $remote_addr(client addr); proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; //保留原来的值再附加新值(建议使用)
③proxy_cache_path path [levels=levels] keys_zone=name:size [inactive=time] [max_size=size] [manager_files=number] [manager_sleep=time] [manager_threshold=time] [loader_files=number] [loader_sleep=time] [loader_threshold=time] [purger=on|off] [purger_files=number] [purger_sleep=time] [purger_threshold=time];
定义缓存路径
只能定义在http上下文
//示例 proxy_cache_path /var/cache levels=2:1 keys_zone=mycache:10m max_size=10m;
④proxy_cache zone | off;
调用缓存，默认为off
用在http,server,location上下文
⑤proxy_cache_key string;
定义缓存键；
用在http,server,location上下文
//示例 proxy_cache_key $request_uri(一般是请求uri) proxy_cache_key $scheme$proxy_host$request_uri
⑥proxy_cache_valid [code ...] time;
为不同的响应码设定其缓存的时长
用在http,server,location上下文
//示例 proxy_cache_valid 200 302 10m; proxy_cache_valid 404 1m;
⑦proxy_cache_use_stale error | timeout | invalid_header | updating | http_500 | http_502 | http_503 | http_504 | http_403 | http_404 | off ...;
向后端请求不到相应资源时基于哪种响应码或错误，使用过期缓存响应客户端
用在http,server,location上下文
⑧proxy_connect_timeout time;
与后端建立连接的超时时长，默认60s，最长为75s
用在http,server,location上下文
⑨proxy_read_timeout time;
等待后端主机发送响应报文的超时时长，默认为60s
用在http,server,location上下文
⑨+①proxy_send_timeout time;
向后端服务器发送请求报文的超时时长，默认为60s
用在http,server,location上下文
ngx_http_headers_module
基于此模块在响应给客户端的报文中添加首部
①add_header name value [always];
向响应报文添加自定义首部，并赋值
用在http,server,location,if in location上下文
add_header X-Cache $upstream_cache_status; //可查看是否命中缓存
//示例： add_header x-via $server_addr(接收请求报文的服务器地址)
②expires [modified] time;
expires epoch | max | off;
用于添加Expire及Cache-Control首部或修改其值
用在http,server,location,if in location上下文
ngx_http_upstream_module
基于此模块实现nginx的负载均衡：定义服务器组，将多个后端主机定义为服务器组，而后可由proxy_pass，fastcgi_pass,memcached_pass等调用
①upstream name { ... };
定义后端服务器组，引入新的上下文，只能用于http上下文
②server address [parameters];
定义后端服务器的地址和相关参数
仅用于在upstream上下文
地址格式： IP[:port] HOSTNAME[:port] unix:/PATH/TO/SOME_SOCK_FILE 参数： weight=number //服务器调度权重 max_fails=number //最大失败尝试次数 fail_timeout=time //设置服务器失败(不可用)的超时时长 backup //备用主机，相当于sorry_server down //手动标记其不再处理任何用户请求
③ip_hash;
指定调度算法：源地址哈希
仅用于在upstream上下文
④least_conn;
指定调度算法：最少连接
仅用于在upstream上下文
⑤keepalive connections;
保持连接的个数
仅用于在upstream上下文
⑥health_check [parameters];
定义后端主机的健康状态检测
只能在location中使用
//可用参数： interval=# //检测的频度，默认为5s fails=# //判定为失败的检测次数 passes=# //判定为成功的检测次数 uri=uri //执行检测时请求的uri，默认为主页 match=name //基于那个match做检测结果为'ok'或'not ok'的判定 port=# //向服务器的那个端口发起检测请求
⑦match name {...};
对后端主机做检测时，定义其结果的判断标准,nginx2.0+才支持
仅用于http上下文
//专用指令： status:期望的响应码 status CODE status !CODE status CODE-CODE header:基于响应首部进行判断 header HEADER=VALUE header HEADER!=VALUE header [!]HEADER header HEADER~VALUE body:期望的响应报文的主体部分该有的内容 body ~"CONTENT" body !~"CONTENT"
⑧hash key [consistent];
定义调度方法，可自定义基于何种信息(key)进行绑定
仅用于在upstream上下文
hash $remote_addr hash $request_uri hash $cookie_username
