0%

Nginx配置详解

Nginx配置详解

Nginx常见的配置文件有以下几个

  • nginx.conf:应用程序的基本配置文件
  • mime.types:MIME类型关联的扩展文件
  • fastcgi.conf:与fastcgi相关的配置
  • proxy.conf:与proxy相关的配置
  • sites.conf:配置Nginx提供的网站,包括虚拟主机

nginx.conf配置

Nginx的配置是在nginx.conf中进行配置的

主要由三部分组成

  • 全局块
  • events块
  • http块

全局块

从配置文件开始到events块之间的内容是全局块,主要用来配置Nginx服务器整体运行的配置指令,主要包括配置运行Nginx的用户组、允许生成的worker process数,进行PID存放路径、日志存放路径和类型以及配置文件的引入

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#nginx中worker进程的用户和用户组
#user nobody;
# worker进程启动的数量,值越大,处理并发数量越多
# worker进程用于处理客户的连接
# 通常为cpu数量
worker_processes 1;
#全局错误日志定义 位置 级别([ debug | info | notice | warn | error | crit ])
#error_log logs/error.log;
#error_log logs/error.log notice;
#error_log logs/error.log info;
#进程文件存放位置
#pid logs/nginx.pid;

#一个nginx进程打开的最多文件描述符数目,理论值应该是最多打开文件数(系统的值ulimit -n)与nginx进程数相除,但是nginx分配请求并不均匀,所以建议与ulimit -n的值保持一致.
worker_rlimit_nofile 65535;

error_log off不是禁用日志,而是创建一个名为off的日志,要禁用日志,可以这么写:error_log /dev/null crit;

events块

主要是影响Nginx服务器与用户网络的连接,常用的配置包括是否开启对多worker process下的网络连接进行序列化,是否允许同时接受多个网络连接,选取哪种事件驱动模型来处理连接请求,每个worker process可以同时支持的并发数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
events {
# 使用连接方式
#use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
#epoll模型是Linux内核中的高性能网络I/O模型,如果在mac上面,就用kqueue模型。
use kqueue;
# 每个worker进程可以同时支持的连接数为1024
# nginx支持的最大并发数是worker_processes*worker_connections
#如果是作为反向代理服务器的话,最大并发数是worker_processes*worker_connections/2,因为反向代理服务器,每个并发会建立与客户端的连接和与后端的连接,会占用两个连接
worker_connections 1024;

# on|off,默认为on,将会对多个nginx进程接收连接进行序列化,防止多个进程对连接的争抢
accept_mutex on;
# on|off,默认为off, 若为on,则每个nginx服务器的进程都可以接收多个新到达的网络连接
multi_accept on;
}

http块

Nginx配置中修改最频繁的配置就是http块的配置,代理、缓存和日志定义等绝大多数功能和第三方模块的配置都在这个模块

http块又分为了http全局块和server块

http全局块

主要配置的是文件的引入、MIME-TYPE定义、日志自定义、是否使用sendfile传输文件、连接超时时间、单连接请求上限等

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
http { #协议级别
# 文件扩展名与文件类型映射表
include mime.types;
# 默认文件类型
default_type application/octet-stream;
# 在发送给客户端响应中允许禁用Http1.1标准的块传输编码
chunked_transfer_encoding

#默认编码
#charset utf-8;
#服务器名字的hash表大小
server_names_hash_bucket_size 128;
#请求头大小限制
client_header_buffer_size 32k;
#设定请求缓冲,请求的头信息不能大于该值,否则会报Request URI too Large 414
large_client_header_buffers 4 64k;
#上传文件大小限制
client_max_body_size 8m;

# 开启目录列表访问,合适下载服务器,默认关闭.
# 显示目录
autoindex on;
# 显示文件大小 默认为on,显示出文件的确切大小,单位是bytes 改为off后,显示出文件的大概大小,单位是kB或者MB或者GB
autoindex_exact_size on;
# 显示文件时间 默认为off,显示的文件时间为GMT时间 改为on后,显示的文件时间为文件的服务器时间
autoindex_localtime on;


#日志格式化 main是日志格式的名称
#log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
# 日志位置 日志的格式使用main
# access_log path [format]
# path 是文件存放的位置 format为可选,指定日志的格式,使用log_format来进行格式的配置
#access_log logs/access.log main;
# 配置日志是否开启 on|off
access_log off;


# sendfile 高效传输文件的模式
sendfile on;
# 默认为0,每次调用sendfile()传输的数据量最大值,如果设置为0,则没有限制
sendfile_max_chunk 128k;
# 将文件一次性一起传输给客户端,提高网络包的传输效率,建议开启
#tcp_nopush on;
# 开启实时传输,与tcp_nopush相反,只在长连接下有效,此时nginx不缓存数据,一段一段的发送
#tcp_nodelay on;

#连接超时时间
keepalive_timeout 65;
# 用于限制用户通过某一连接向nginx服务器发送请求的次数
keepalive_requests 100;

# 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 128k;

#gzip压缩
#gzip on;
#允许压缩的页面的最小字节数,页面字节数从header偷得content-length中获取.默认是0,不管页面多大都进行压缩.建议设置成大于1k的字节数,小于1k可能会越压越大
gzip_min_length 1k;
#表示申请4个单位为16k的内存作为压缩结果流缓存,默认值是申请与原始数据大小相同的内存空间来存储gzip压缩结果
gzip_buffers 4 16k;
#压缩版本(默认1.1,目前大部分浏览器已经支持gzip解压.前端如果是squid2.5请使用1.0)
gzip_http_version 1.1;
#压缩等级.1压缩比最小,处理速度快.9压缩比最大,比较消耗cpu资源,处理速度最慢,但是因为压缩比最大,所以包最小,传输速度快
gzip_comp_level 2;
#压缩类型,默认就已经包含text/html,所以下面就不用再写了,写上去也不会有问题,但是会有一个warn.
gzip_types text/plain application/x-javascript text/css application/xml;
#选项可以让前端的缓存服务器缓存经过gzip压缩的页面.例如:用squid缓存经过nginx压缩的数据
gzip_vary on;

#实际的服务器列表
#upstream myserver {
# server 127.0.0.1:8080;
# server 127.0.0.1:8082;
#}

# 虚拟主机设置
server{

}

include servers/*;
}
server块配置虚拟主机

一个http块可以包含多个server块,每个server块就相当于一台虚拟主机

server块主要是虚拟主机的配置,为了充分利用服务器资源,一台nginx服务器一般都同时配置N个虚拟域名主机,即多个域名对应同一个80端口,每台虚拟主机都可以是一个独立的网站

Nginx可以配置多种类型的虚拟主机

  • 基于IP
  • 基于域名
  • 基于端口

又分为了server全局块和location块,在server全局块中常见的配置就是虚拟主机监听配置以及虚拟主机的名称

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
server { # 服务器级别
#监听的端口号 (可以配置监听 ip、端口)
listen 8080;
#虚拟主机的名称,访问域名
server_name localhost;
#编码格式
#charset koi8-r;
#虚拟主机访问日志定义
#access_log logs/host.access.log main;
# url匹配
location / { #请求级别
root html;
index index.html index.htm;
}

#error_page 404 /404.html;

# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}

# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
# 禁止访问.ht文件
#location ~ /\.ht {
# 禁止下载
# deny all;
#}
}
location块

每个server块可以包含多个location块,允许对不同的uri进行不同的配置,对特定的请求进行处理,如进行地址定向、数据缓存等功能

匹配规则

location有多种匹配规则[=|~|~*|^~|@] /url/

  • 没有修饰符表示必须以指定模式开头

    1
    2
    3
    4
    5
    6
    7
    8
    9
    # 匹配以/abc开头的
    location /abc {

    }
    # 以/abc开头的
    http://zhhll.icu/abc
    http://zhhll.icu/abc?id=11
    http://zhhll.icu/abc/
    http://zhhll.icu/abcd
  • =表示精确匹配,优先级最高

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    # 仅匹配/abc,可以有参数
    location = /abc {

    }
    # 可以匹配
    http://zhhll.icu/abc
    http://zhhll.icu/abc?id=11
    # 不能匹配
    http://zhhll.icu/abc/
    http://zhhll.icu/abcd
  • ^~ 类似于无修饰符,表示uri以某个字符串开头,即^~/spring/ 可以被所有以/spring/开头的匹配到

  • ~为区分大小写的正则匹配,如果使用!~则表示取反,不匹配的正则

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    location ~ /abc {

    }
    # 可以匹配
    http://zhhll.icu/abc
    http://zhhll.icu/abc?id=11
    # 不能匹配
    http://zhhll.icu/Abc
    http://zhhll.icu/abc/
    http://zhhll.icu/abcd
  • ~*为不区分大小写的正则匹配,如果使用!~*则表示取反,不匹配的正则

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    location ~* /abc {

    }
    # 可以匹配
    http://zhhll.icu/abc
    http://zhhll.icu/abc?id=11
    http://zhhll.icu/Abc
    # 不能匹配
    http://zhhll.icu/abc/
    http://zhhll.icu/abcd
  • / 通用匹配,任何请求都会匹配到

  • @ 客户端不能访问,只能由内部产生的请求来访问

静态文件路径

可以使用root或alias来指定静态资源文件路径,root可以配置在http块、server块、location块以及if块中,alias只能配置在location块中

root

使用root来表示请求的url时会进行完整的拼接,即如果请求使用的uri是/pic/index.html的话,使用root实际获取的是/data/www/web/pic/index.html

1
2
3
location /pic/ {
root /data/www/web;
}

alias

alias会将location中配置的路径丢弃掉,即如果请求使用的uri是/pic/index.html的话,使用alias实际获取的是/data/www/web/index.html

1
2
3
location /pic/ {
alias /data/www/web;
}

Nginx常见配置参数

  • server_names_hash_max_size 1024;
  • server_names_hash_bucket_size 512;
  • client_header_buffer_size 32k; # 客户端请求头部的缓冲区大小,有时候请求头过大,可以适时增大该配置
  • large_client_header_buffers 4 32k;
  • client_max_body_size 10m;#设置最大的允许客户端请求主体的大小(上传文件大小限制), 默认为1m,如果大于该设置,会返回413
  • client_body_buffer_size 128k; 为了阻止临时文件写到磁盘,可以通过该指令为客户端请求体设置缓存大小
  • client_body_in_single_buffer 为了减少拷贝操作,该指令强制nginx将整个客户端请求体保存在单个缓存中
  • client_body_temp_path 定义一个路径用于保存客户端请求体
  • keepalive_timeout 60; #客户端连接超时时间,单位是秒, 默认是75秒
  • client_header_timeout #设置请求头的超时时间,可以设置低些,如10秒
  • client_body_timeout #设置请求体的超时时间,可以设置低些,如10秒
  • reset_timeout_connection #关闭不响应的客户端连接,这将会释放那个客户端所占有的内存空间,建议开启
  • send_timeout #指定客户端的响应超时时间,如果在两次客户端读取操作之间,客户端没有读取任何数据,Nginx就会关闭连接,默认是60秒,可以设置小一些,如10秒
  • sendfile on; # 开启高效传输模式(开启或禁用sendfile函数),默认为off
  • tcp_nopush on; #将文件一次性一起传输给客户端,提高网络包的传输效率,建议开启
  • tcp_nodelay on; #此时nginx不缓存数据,一段一段的发送(允许或禁止TCP_NODELAY),仅适用于keep-alive连接
  • ssi on; # 开启ssi支持,默认为false
  • ssi_silent_errors on; # 设置为on表示在处理ssi文件时不输出错误信息,默认为false
  • ssi_types text/html; # 默认支持html ,如果需要支持shtml(服务器执行脚本),需要设置为ssi_types text/shtml
  • server_tokens off; # 关闭nginx版本号的显示,默认为on

Nginx优化相关参数

  • worker_processes 2; # 配置生成的worker process数量,进程数,一般为cpu核数
  • worker_rlimit_nofile 65536; # 一个nginx进程打开的最多文件描述符数目,一般设置为与系统设定的值相同(ulimit -n)
  • worker_cpu_affinity 01 10;# 为每个进程分配CPU的工作内核
  • use epoll; # 使用epoll的IO模型,epoll是linux内核为处理大量文件描述符而做了改进的poll,它能显著提高程序在大量连接中只有少数活跃的情况下的CPU利用率
  • worker_connections 1024 # 每个进程允许的最多连接数,理论上每台nginx服务器的最大连接数为worker_processes*worker_connections
  • keepalive_timeout 60 #keepalive超时时间,客户端到服务端的连接持续有效时间,当出现对服务器的后继请求时,可以避免重新建立连接
  • client_header_buffer_size 4k 客户端请求头部的缓冲区大小,可以根据系统分页大小来设置,一般一个请求的头部大小不会超过1k
  • open_file_cache max=102400 inactive=20s 为打开文件指定缓存,默认没有启用,max指定缓存数量,建议和打开文件数一致,inactive是指经过多长时间文件没有请求后删除缓存
  • open_file_cache_vaild 30s 这个是指多长时间检查一次缓存的有效信息
  • open_file_cache_min_uses 1 open_file_cache指令中的inactive参数时间内文件的最少使用次数,如果超过这个数字,文件描述符一直是在缓存中打开的,如上例,如果有一个文件在inactive时间内一次没被使用,将被移除
1
2
3
4
events {
use epoll; # IO模型
worker_connections 20000; # 一个nginx进程的连接数,nginx服务器允许的同事连接的客户端最大数量Client = worker_processes * worker_connections/2;
}

Nginx常见用法

依据UA屏蔽爬虫

1
2
3
4
if ($http_user_agent ~* "qihoobot|Baiduspider|Googlebot|Googlebot-Mobile|Googlebot-Image|Mediapartners-Google|Adsbot-Google|Feedfetcher-Google|Yahoo! Slurp|Yahoo! Slurp China|YoudaoBot|Sosospider|Sogou
spider|Sogou web spider|MSNBot|ia_archiver|Tomato Bot") {
return 403;
}

屏蔽IP访问

1
2
3
4
allow 133.27.182.82;
allow 113.106.18.0/24;
allow 121.201.104.0/24;
deny all;

使用Auth权限访问

1
2
auth_basic "bbs-auth";
auth_basic_user_file /usr/local/nginx/conf/bbsauthpwd;

限制带宽

1
2
3
4
5
# 用户下载达到 500k 后,便控制其速度在 50k 以内
location /download/ {
limit_rate_after 500k;
limit_rate 50k;
}

限制连接

1
2
3
4
5
6
7
8
9
10
# 定义了一个名为“down”,10M大小,以连接IP为key的连接数据存储空间
limit_conn_zone $binary_remote_addr zone=down:10m;

# 读取名为`down`连接数据存储空间的数据,限制每个key(上面是以ip作为IP) 最大同时连接数为4
location ~ .*\.(rar|zip|apk)?$ {
limit_conn down 4;
limit_rate 150k;
}

limit_conn_log_level notice: 指定当触发limit的时候日志打印级别

限制请求

1
2
3
4
5
6
# 定义一个名为”one”, 10M大小,每秒1个请求的请求数据存储空间
limit_req_zone $binary_remote_addr zone=one:10m rate=10r/s;

# 引用名为“one”的存储空间,burst为等待请求数量数,当等待请求数量超过50个时,则抛出503错误,nodelay 针对的是 burst 参数,burst=50 nodelay 表示这50个请求立马处理,不能延迟,相当于特事特办。不过,即使这20个突发请求立马处理结束,后续来了请求也不会立马处理。burst=50 相当于缓存队列中占了50个坑,即使请求被处理了,这20个位置这只能按 100ms一个来释放
limit_req zone=one burst=50 nodelay;
limit_req_log_level notice: 指定当触发limit的时候日志打印级别

实时显示Nginx运行状况

在安装nginx是编译http_stub_status_module即可,使用参数为–with-http_stub_status_module

1
2
3
4
location /ngx_status {
stub_status on;
access_log on;
}

设置错误页面

1
error_page 404 /404.html

在负载均衡里面,实现后端服务器故障转移的配置

1
2
3
4
5
6
location ~ \.(jsp)$ {
proxy_next_upstream http_502 http_504 timeout;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_pass http://server_pool;
}

Nginx 常见错误码

  • 301 永久重定向
  • 302 临时重定向
  • 403 禁止访问
  • 404 文件不存在
  • 413 文件上传超过限制
  • 500 服务器错误
  • 502 后台服务器无响应
  • 504 Nginx超时,请求过多,工作进程不足

欢迎关注我的其它发布渠道