解读nginx配置

nginx配置指令

　　main配置段常见的配置指令
　　分类：
　　　　正常运行必备的配置
　　　　优化性能相关的配置
　　　　用于调试及定位问题相关的配置
　　　　事件驱动相关的配置

　　正常运行必备的配置
　　　1、user
　　　　Syntax:user user [group]:运行nginx所使用的用户
　　　　Default:user nobody nobody
　　　　Context:main

　　　2、pid /PATH/TO/PID_FILE
　　　　指定存储nginx主进程进程号码的文件路径

　　　3、include file | mask;
　　　　指明包含进来的其他配置文件片段；

　　　4、load_module file;
　　　　指明要装载的动态模块

　　性能优化相关的配置：
　　　1、worker_processes number | auto;
　　　　worker进程的数量，通常应该等于小于当前主机的cpu的物理核心数
　　　　auto:当前主机物理CPU核心数；

　　　2、work_cpu_affinity cpumask...;
　　　　work_cpu_affinity auto [cpumask];

nginx进程的cpu亲缘性；
　　CPU MASK:
　　00000000；
　　0000 0001:0号CPU
　　0000 0010:1号CPU
　　0000 0100:2号CPU
　　0000 1000:3号CPU
　　0001 0000:4号CPU
　　...
　　0000 0011:0、1号CPU

　　　　3、work_priority number;
　　　　　　指定worker进程的nice值，设定worker进程优先级[-20,20]，一般为负值，提示优先级

　　　　4、worker_rlimit_nofile number;
　　　　　　worker进程所能够打开的文件数量上限；(大多数设置为65535)，提醒|对于高并发的服务器配置 至关重要

　　调试、定位问题：
　　　　1、daemon on|off;
　　　　　　是否以守护进程方式运行nginx；

　　　　2、master_process on|off；
　　　　　　是否已master/worker模型运行nginx；默认为on；

　　　　3、error_log file [level];

　　事件驱动相关的配置
　　　　events {
　　　　　　...
　　　　}

　　　　1、worker_connections number;
　　　　　　每个worker进程所能够打开的最大并发连接数数量；

　　　　　　worker_processes * worker_connections

　　　　2、use method
　　　　　　指明并发连接请求的处理方法；

　　　　　　usr epoll;

　　　　3、accept_mutex on | off;（互斥锁）
　　　　　　处理新的连接请求的方法;on意味着由各worker轮流处理新请求，off意味着每个新请求的到达都会通知所有的worker进程；

　　http协议的相关配置：
　　　　http {
　　　　　　...
　　　　　　server {
　　　　　　　　...
　　　　　　　　server_name
　　　　　　　　root
　　　　　　　　location [operator] /url {
　　　　　　　　...
　　　　　　　　}
　　　　　　}
　　　　　　server {
　　　　　　　　...
　　　　　　}
　　　　}

<Directoty "">
可定义访问权限
<Directoty>

<Location "">
<Location>

与套接字相关的配置；

　　1、server {...}
　　　　配置以各虚拟主机；

server {
　　listen PORT;
　　server_name localhost;
　　root /PATH/TO/DOCUMENT_ROOT;
　　（如果是作为代理服务器，那么需要将root选项改为proxy ）
}

　　　　2、listen PORT|address[port]|unix:/PATH/TO/SCCKET_FILE
　　　　　　listen address[:port] [default_server] [ssl] [http2 | spdy] [backlog=number] [rcvbuf=size][sndbuf=size]
　　　　　　degault_server:设定为默认虚拟主机；
　　　　　　ssl：限制仅能够通过ssl连接提供服务；
　　　　　　backlog=number:后援队列长度;
　　　　　　rcvbuf=size:接受缓冲区大小；
　　　　　　sndbuf=size：发送缓冲区大小；

3、server_name name...;
　　指明虚拟主机的主机名称；后可跟多个由空白字符分隔的字符串；
　　支持*通配任意长度的任意字符;server_name *.fqszywz.top www.fqszywz.*
　　支持~起始的字符做正则表达式模式匹配；server_name ~,^wwwd+.fqszywz.com$

　　匹配机制：
　　（1）首先是字符串精确匹配；
　　（2）左侧*通配符
　　（3）右侧*通配符
　　（4）正则表达式

4、tcp_nodelay on | off；
　　在keepalived模式下的连接是否启用TCP_NODELAY选项；

　　tcp_nopush on | off;
　　在sendfile模式下，是否启用TCP_CORK选项；

5、sendfie on | off；
　　是否启用sendfile功能；

　　定义路径相关的配置
6、root_path;
　　设置web资源路径映射；用于指明用户请求的url所对应的本地文件系统上的文档所在目录路径；可用的位置有http、server、location,if in location;

7、location [= | ~ | ~* | ^~ ] uri {...}

　　在一个server中location配置段可存在多个，用于实现从uri到文件系统的路径映射；nginx会根据用户请求的URI来检查定义的所有location,并找出一个最佳匹配，而后应用其配置；

　　#：对URI做精确匹配；例如：http://www/fqszywz.com/,http://www.fqszywz.com/index.html
　　location = /{
　　...
　　}
　　~:对URI做正则表达式模式匹配，区分字符大小写；
　　~*:对URI做正则表达式模式匹配，不区分字符大小写；
　　^~:对URI的左边部分做匹配检查，不区分字符大小写；
　　不带符号：以URI为前缀的所有uri；

　　匹配优先级:=，^~,~/~*，不带符号；

　　root /vhosts/www/htdocs/
　　http://www.fqszywz.com/index.html --> /vhosts/www/htdocs/index.html

8、alias path;
　　定义路径别名，文档映射的另一种机制；仅能用于location上下文

　　注意：location中使用root指定和alias指令的意义不同；
　　local /images/ {
　　root /nginx/html/;
　　alias /nginx/html/
　　}
　　（a）root，给定的路径对于location中的/uri/左侧的/;
　　　　即 访问的路径为/nginx/html/images/index.html
　　（b）alias,给定的路径对应于location中的/uri/右侧的/;
　　　　即 访问的路径为/nginx/html/index.html

9、index file ...;
　　默认资源:http,server,location;

10、error_page code ...[=[response]] uri;

　　error_page 404 /404.html;
　　location = /404.html {
　　root /www/error_pages;
　　}

11、client_body_temp_path path[level1 [level2 [level3]]];
　　设定用于村粗客户端请求报文的body部分的临时存储路径及子目录结构和数量；

　　16进制的数字
　　client_body_temp_path /var/tmp/client_body 1 2 2
　　1：表示用一位16进制数字表示一级子目录:0-f
　　2：表示用2位16进制数字表示二级子目录:00-ff
　　3：表示用2位16进制数字表示三级子目录:00-ff

　　对客户端进行限制的相关配置
12、limit_rate rate;
　　限制响应给客户端的传输速率，单位是bytes/second，0表示无限制；

13、limit_except method ...{...}
　　限制对指定的请求方法之外的其他方法的使用客户端

　　limit_except GET{
　　allow 192.168.1.0/24;
　　deny all;
　　}

　　文件操作优化的配置
14、aio on | off |threads=[pool]
是否启用aio功能

15、directio size |off;
　　在Linux主机启动O_DIRECT标记，此处意味文件大于等于给定的大小时使用，例如directio 4m;

16、open_file_cache off;
　　open_file_cache max=N [inactive=time];

　　nginx可以缓存一下三种信息
　　（1）文件的描述符、文件大小和最近一次的修改时间
　　（2）打开的目录结构；
　　（3）没有找到的或者没有权限访问的文件的相关信息；

　　max=N:可混村的缓存项上限；达到上限后会使用LRU算法实现缓存管理；

　　inactive=time：缓存想的非活动时长，在此处指定的时长内未被命中的或命中的次数少于open_file_cache_min_uses指令所指定的次数的缓存项即为非活动项；

17、open_file_cache_valid time;
　　缓存项有效性的检查频率；默认为60s;

18、open_file_cache_min_uses number;
　　在open_file_cache指令的inactive参数指定的时长内，至少应该被命中多少次方可被认为是活动项

19、open_file_cace_error on | off
　　是否缓存查找时发生错误的文件一类的信息；

　　ngx_http_access_module模块
　　实现基于IP的访问控制功能

20、allow address | CIDR |unix:|all;
21、deny address | CIDR |unix: |all;

　　http,server,location,limit_except

　　ngx_http_auth_basic_module模块
　　实现基于用户的访问控制，使用basic机制进行用户认证；

22、auth_basic string | off;
23、auth_basic_user_file file;

location /admin/ {
alias /webapps/app1/data/;
auth_basic "Admin Area"
auth_basic_user_file /etc/nginx/.ngxpasswd;
}
注意：htpasswd命令由httpd-tools所提供；

ngx_http_stub_status_module模块
用于输出nginx的基本状态信息；

Active connectopns:291
server accepts handled requests
16630948 16630948 31070465
Reading:6 Writing:179 Waiting:106

Active connections:活动状态的连接数
accepts:已经接受的客户端请求的总数；
handled:已经处理完成的客户端请求的总数；
requests:客户段发来的总的请求数；
Reading:处于读取客户端请求报文首部的连接的连接数；
Writing:处于想客户端发送响应报文过程中的连接数；
Waiting:处于等待客户端发出请求的空闲连接数；

24、stub_status；

配置实例：
location /basic_status{
stub_status;
}

ngx_http_log_module模块
he ngx_http_log_module module writes request log in the specified formad

25、log_format name string ...;
　　string可以使用nginx核心模块及其他模块内嵌的变量；

26、access_log path [format [buffer=size] [gzip[=level]] [flush=time] [if=condition]];
　　access_log off;

访问日志文件路径，格式及相关的缓冲的配置；
buffer=size
flush=time

$remote_addr 客户端地址 219.227.111.255
$remote_user 客户端用户名称 —
$time_local 访问时间和时区 18/Jul/2014:17:00:01 +0800
$request 请求的URI和HTTP协议 “GET /article-10000.html HTTP/1.1”
$http_host 请求地址，即浏览器中你输入的地址（IP或域名） www.ha97.com 198.98.120.87
$status HTTP请求状态 200
$upstream_status upstream状态 200
$body_bytes_sent 发送给客户端文件内容大小 1547
$http_referer url跳转来源 https://www.google.com/
$http_user_agent 用户终端浏览器等信息 “Mozilla/4.0 (compatible; MSIE 8.0; Windows NT 5.1; Trident/4.0; SV1; GTB7.0; .NET4.0C;
$ssl_protocol SSL协议版本 TLSv1
$ssl_cipher 交换数据中的算法 RC4-SHA
$upstream_addr 后台upstream的地址，即真正提供服务的主机地址 10.36.10.80:80
$request_time 整个请求的总时间 0.165
$upstream_response_time 请求过程中，upstream响应时间

27、open_log_file_cache max=N [inactive=time] [min_uses=N] [Valid=time]

open_log_file_cache off;

缓存各日志文件相关的元数据信息；

max:缓存的最大文件描述符数量；
min_uses:在inactive指定的时长内访问大于等于此值方可被当作活动项；
inactive:非活动时长
valid:验证缓存中个缓存项是否为活动项的时间间隔；

nginx(3)
ngx_http_referer_module模块（防盗链）

1、valid_referers none | blocker |server_names | string...;
定义referer首部的合法可用值

none:请求报文首部没有referer首部;
blocked:请求报文的referer首部没有值；
server_name:参数，其可以有值作为主机名或主机名模式；
arbitrary_string：直接字符串，但可使用*作通配符；
regular expression:被指定的正则表达式模式匹配到的字符串；要使用~打头，例如：~.*.fqszywz.com;
配置实例：
valid_referers none block server_names *.fqszywz.com *.ssz.com fqszywz.* ssz.* ~.fqszywz.;
if ($invalid_referer) {
return http://www.fqszywz.top
}

ngx_http_proxy_module模块

　　　　The ngx_http_proxy_module module allows passing requests to another server.

1、proxy_pass URL;

Context:location,if in location,limit_except

注意：proxy_pass后面的路径不带uri时，其会将location的uri传递给后端主机
server {
...
server_name HOSTNAME;
location ~|~* /uri/{
proxy http://host;
}
...
}

http://HOSTNAME/uri/-->http://host/uri/;

2、proxy_set_header field value;
　　设定发往后端主机的请求报文的请求首部的值；Context:http,server,locationl

　　proxy_set_header X-Real-IP $rempte_addr;
　　proxy_set_header X-Forwarded-For $proxy-add_x_forwarded_for;

3、proxy_cache_path
　　定义可用于proxy功能的缓存；Context:http

proxy_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_file=number][loader_sleep=time]
[lader_threshold=time][purger=on|off][purger_file=number][purger_sleep=time][purger_thresgold=time];

4、proxy_cache zone |off;
　　指明要调用的缓存，或关闭缓存机制；Context:http,server,location

5、proxy_cache_key string;
　　缓存中用于"键"的内容；

　　默认值：proxy_cache_key $scheme$proxy_host$request_uri;

6、proxy_cache_purge string;
　　清理缓存

　　ngx_http_headers_module模块

　　向由代理服务器响应给客户端的响应白问添加自定义首部，或修改指定首部的值；

1、add_header name value [always];
　　添加自定义首部；

　　add_header X-Via $server-addr;
　　add_header X_Accel $server_name;

2、expires [modified] time;
　　expores epoch | max | off;

用于定义Expire或Cache-Control首部的值；

ngx_http_upstream_module模块

1、upstream name {...}
定义后端服务器组；引入一个新的上下文；只能用于http{}上下文中；

默认的调度方法是wrr;

2、server address [permeters];

定义服务器地址和相关的参数；
地址格式：
IP[:PORT]
HOSTNAME[:PORT]
unix:/PATH/TO/SOME_SOCK_FOLE

参数
weighe=number
权重，默认1
max_fails=number
失败尝试的最大次数
fail_timeout=time
设置服务器为不可用状态的超时时长
backup
把服务器标记为"备用"状态；
down
手动标记其为不可用；

3、least_conn;
　　最少连接调度算法；当server拥有不同的权重时为wlc;当所有后端主机的连接数相同时，则使用wrr进行调度；

4、ip_hash;
　　源地址hash算法;能够将来自同一个源IP地址的请求始终发往同一个upstream server;

5、hash key[consistent];
　　基于指定的key的hash表实现请求调度，此处的key可以文本、变量或二者的组合

consistent:参数，指定使用一致性hash算法；

示例：
hash $request_uri consistent
hash $remote_addr
hash $cookie_name

6、keepalive connections;
　　可使用长连接的连接数量:每worker与后端服务保持的最大空闲长连接数量；