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存放路径、日志存放路径和类型以及配置文件的引入
#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可以同时支持的并发数
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传输文件、连接超时时间、单链接请求上限等
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全局块中常见的配置就是虚拟主机监听配置以及虚拟主机的名称
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/
-
没有修饰符表示必须以指定模式开头
# 匹配以/abc开头的 location /abc { } # 以/abc开头的 http://zhhll.icu/abc http://zhhll.icu/abc?id=11 http://zhhll.icu/abc/ http://zhhll.icu/abcd -
=表示精确匹配，优先级最高
# 仅匹配/abc，可以有参数 location = /abc { } # 可以匹配 http://zhhll.icu/abc http://zhhll.icu/abc?id=11 # 不能匹配 http://zhhll.icu/abc/ http://zhhll.icu/abcd -
^~ 类似于无修饰符，表示uri以某个字符串开头，即^~/spring/ 可以被所有以/spring/开头的匹配到
-
~为区分大小写的正则匹配，如果使用!~则表示取反，不匹配的正则
location ~ /abc { } # 可以匹配 http://zhhll.icu/abc http://zhhll.icu/abc?id=11 # 不能匹配 http://zhhll.icu/Abc http://zhhll.icu/abc/ http://zhhll.icu/abcd -
~*为不区分大小写的正则匹配，如果使用!~*则表示取反，不匹配的正则
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
location /pic/ {
root /data/www/web;
}
alias
alias会将location中配置的路径丢弃掉，即如果请求使用的uri是/pic/index.html的话，使用alias实际获取的是/data/www/web/index.html
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时间内一次没被使用，将被移除
events {
use epoll; # IO模型
worker_connections 20000; # 一个nginx进程的连接数，nginx服务器允许的同事连接的客户端最大数量Client = worker_processes * worker_connections/2;
}
Nginx常见用法
依据UA屏蔽爬虫
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访问
allow 133.27.182.82;
allow 113.106.18.0/24;
allow 121.201.104.0/24;
deny all;
使用Auth权限访问
auth_basic "bbs-auth";
auth_basic_user_file /usr/local/nginx/conf/bbsauthpwd;
限制带宽
# 用户下载达到 500k 后，便控制其速度在 50k 以内
location /download/ {
limit_rate_after 500k;
limit_rate 50k;
}
限制连接
# 定义了一个名为“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的时候日志打印级别
限制请求
# 定义一个名为”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
location /ngx_status {
stub_status on;
access_log on;
}
设置错误页面
error_page 404 /404.html
在负载均衡里面，实现后端服务器故障转移的配置
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超时，请求过多，工作进程不足
https://zhhll.icu/2021/服务器/Nginx/4.Nginx配置详解/
本文由 mdnice 多平台发布