NGINX配置文件详解
nginx配置文件详解
1. 配置文件结构
... #全局块
events { #events块
...
}
http #http块
{
... #http全局块
server #server块
{
... #server全局块
location [PATTERN] #location块
{
...
}
location [PATTERN]
{
...
}
}
server
{
...
}
... #http全局块
}
-
1、全局块：配置影响nginx全局的指令。一般有运行nginx服务器的用户组，nginx进程pid存放路径，日志存放路径，配置文件引入，允许生成worker process数等。
-
2、events块：配置影响nginx服务器或与用户的网络连接。有每个进程的最大连接数，选取哪种事件驱动模型处理连接请求，是否允许同时接受多个网路连接，开启多个网络连接序列化等。
-
3、http块：可以嵌套多个server，配置代理，缓存，日志定义等绝大多数功能和第三方模块的配置。如文件引入，mime-type定义，日志自定义，是否使用sendfile传输文件，连接超时时间，单连接请求数等。
-
4、server块：配置虚拟主机的相关参数，一个http中可以有多个server。
-
5、location块：配置请求的路由，以及各种页面的处理情况
2. 配置文件详解
#---- 全局配置区域 ----
#定义Nginx运行的用户和用户组
user nginx nginx;
#进程文件
pid /var/run/nginx.pid;
#worker工作进程的个数，master进程是接收并分配请求给worker处理。这个数值简单一点
#可以设置为cpu的核数grep -c ^processor /proc/cpuinfo，也是 auto 值
worker_processes 4;
#在高并发情况下，通过设置cpu粘性来降低由于多CPU核切换造成的寄存器等现场重建带来的性能损耗。
#如worker_cpu_affinity 0001 0010 0100 1000; （四核）
worker_cpu_affinity 0001 0010 0100 1000;
#一个nginx进程打开的最多文件描述符数目,理论值应该是最多打开文件数（系统的值ulimit -n）
#与nginx进程数相除,但是nginx分配请求并不均匀,所以建议与ulimit -n的值保持一致.
worker_rlimit_nofile 65535;
#全局错误日志定义类型,[ debug | info | notice | warn | error | crit ]
error_log /var/log/nginx/error.log info;
#---- events配置区域 ----
events {
#参考事件模型,use [ kqueue | rtsig | epoll | /dev/poll | select | poll ];
#epoll模型是Linux 2.6以上版本内核中的高性能网络I/O模型,如果跑在FreeBSD上面,就用kqueue模型
use epoll;
#单个进程最大连接数（最大连接数=连接数*进程数）
worker_connections 1024;
#打开同时接受多个新网络连接请求的功能
multi_accept on;
}
#---- http配置区域 ----
http {
#文件扩展名与文件类型映射表
include mime.types;
#默认文件类型
default_type application/octet-stream;
#默认编码
charset utf-8;
#隐藏版本号
server_tokens off;
#服务器名字的hash表大小
server_names_hash_bucket_size 128;
#客户端请求头部的缓冲区大小。这个可以根据你的系统分页大小来设置，一般一个请求的头部大小不会超过1k
client_header_buffer_size 32k;
#客户端请求中较大的消息头的缓存最大数量和大小
large_client_header_buffers 4 64k;
#客户端请求体数据的Buffer大小
client_body_buffer_size 128k;
#客户端请求体数据最大值,例如上传文件
client_max_body_size 8m;
#长连接持续时间,客户端连接超时该值时会断开,为0禁用长链接
keepalive_timeout 65;
#客户端请求头读取超时时间
client_header_timeout 10;
#设置客户端请求主体读取超时时间
client_body_timeout 10;
#响应客户端超时时间
send_timeout 10;
# sendfile指令指定nginx是否调用sendfile函数（zero copy 方式）来输出文件，对于普通应用，必须设为on。
#如果用来进行下载等应用磁盘IO重负载应用，可设置为off，以平衡磁盘与网络IO处理速度，降低系统uptime。
sendfile on;
# 开启或者关闭nginx在FreeBSD上使用TCP_NOPUSH套接字选项， 在Linux上使用TCP_CORK套接字选项。
#选项仅在使用sendfile的时候才开启。
tcp_nopush on;
# 开启或关闭nginx使用TCP_NODELAY选项的功能。 这个选项仅在将连接转变为长连接的时候才被启用。
tcp_nodelay on;
#---- gzip压缩模块配置 ----
# 开启gzip压缩输出，减少网络传输
gzip on;
# 设置允许压缩的页面最小字节数，页面字节数从header头得content-length中进行获取。默认值是20。
#建议设置成大于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;
# ---- 反向代理配置 ----
#nginx跟后端服务器连接超时时间(代理连接超时)
proxy_connect_timeout 5;
#代理发送超时
proxy_send_timeout 5;
#代理接收超时
proxy_read_timeout 60;
#启动代理缓存功能
proxy_buffering on;
#设置代理服务器（nginx）保存用户头信息的缓冲区大小
proxy_buffer_size 16k;
#设置用于读取应答（来自被代理服务器）的缓冲区数目和大小
proxy_buffers 4 32k;
#高负荷下缓冲大小（proxy_buffers*2）
proxy_busy_buffers_size 64k;
#设定缓存文件夹大小，大于这个值，将从upstream服务器传
proxy_temp_file_write_size 64k;
#反向代理缓存目录
#levels=1:2 设置目录深度，第一层目录是1个字符，第2层是2个字符
#keys_zone:设置web缓存名称和内存缓存空间大小
#inactive:自动清除缓存文件时间。
#max_size:硬盘空间最大可使用值。
proxy_cache_path /data/proxy/cache levels=1:2 keys_zone=cache_one:500m inactive=1d max_size=1g;
#指定临时缓存文件的存储路径(必须在同一分区)
proxy_temp_path /data/proxy/temp;
# ---- 负载均衡服务器池配置 ----
upstream server_pool {
#调度算法
#1.轮循（默认）（weight轮循权值）
#2.ip_hash：根据每个请求访问IP的hash结果分配。（会话保持）
#3.fair:根据后端服务器响应时间最短请求。（upstream_fair模块）
#4.url_hash:根据访问的url的hash结果分配。（需hash软件包）
#参数：
#down：表示不参与负载均衡
#backup:备份服务器
#max_fails:允许最大请求错误次数
#fail_timeout:请求失败后暂停服务时间。
server 192.168.1.109:80 weight=1 max_fails=2 fail_timeout=30;
server 192.168.1.108:80 weight=2 max_fails=2 fail_timeout=30;
}
#负载均衡调用
server {
...
location / {
proxy_pass http://server_pool;
}
}
#---- 虚拟主机配置反向代理 ----
server {
#侦听的80端口
listen 80;
server_name localhost;
location / {
#反向代理缓存设置命令(proxy_cache zone|off,默认关闭所以要设置)
proxy_cache cache_one;
#对不同的状态码缓存不同时间
proxy_cache_valid 200 304 12h;
#设置以什么样参数获取缓存文件名
proxy_cache_key $host$uri$is_args$args;
#后端的Web服务器可以通过X-Forwarded-For获取用户真实IP
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
#代理设置
proxy_pass http://IP;
# 图片缓存时间设置
location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$ {
expires 10d;
}
# JS和CSS缓存时间设置
location ~ .*\.(js|css)?$ {
expires 1h;
}
#文件过期时间控制
expires 1d;
}
#配置手动清楚缓存(实现此功能需第三方模块 ngx_cache_purge)
#http://www.123.com/2017/0316/17.html访问
#http://www.123.com/purge/2017/0316/17.html清楚URL缓存
location ~ /purge(/.*) {
allow 127.0.0.1;
deny all;
proxy_cache_purge cache_one $host$1$is_args$args;
}
#设置扩展名以.jsp、.php、.jspx结尾的动态应用程序不做缓存
location ~.*\.(jsp|php|jspx)?$ {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_pass http://IP;
}
}
#虚拟主机的配置
server
{
# 监听端口
listen 80;
# 域名可以有多个,用空格隔开
server_name 127.0.0.1;
#编码格式，若网页格式与此不同，将被自动转码
#charset koi8-r;
#日志相关定义
log_format main '$remote_addr - $remote_user [$time_local] "$request" '
# '$status $body_bytes_sent "$http_referer" '
# '"$http_user_agent" "$http_x_forwarded_for"';
#定义日志的格式。后面定义要输出的内容。
#1.$remote_addr 与$http_x_forwarded_for 用以记录客户端的ip地址；
#2.$remote_user ：用来记录客户端用户名称；
#3.$time_local ：用来记录访问时间与时区；
#4.$request ：用来记录请求的url与http协议；
#5.$status ：用来记录请求状态；
#6.$body_bytes_sent ：记录发送给客户端文件主体内容大小；
#7.$http_referer ：用来记录从那个页面链接访问过来的；
#8.$http_user_agent ：记录客户端浏览器的相关信息
#虚拟主机访问日志定义
access_log logs/host.access.log main;
#对URL进行匹配
location / {
#访问路径，可相对也可绝对路径
root html;
#首页文件。以下按顺序匹配
index index.html index.htm;
}
#错误信息返回页面
error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root html;
}
#php脚本请求全部转发给FastCGI处理
location ~ \.php$ {
root html;
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
include fastcgi_params;
}
#限制IP访问
location / {
deny 192.168.0.2；
allow 192.168.0.0/24;
allow 192.168.1.1;
deny all;
}
location /images {
root /var/www/nginx-default/images;
# 开启目录列表访问,合适下载服务器,默认关闭.
autoindex off;
# 显示文件大小,默认为on,显示出文件的确切大小,单位是bytes 改为off后,显示出文件的大概大小,单位是kB或者MB或者GB
autoindex_exact_size on;
# 显示文件时间 默认为off,显示的文件时间为GMT时间 改为on后,显示的文件时间为文件的服务器时间
autoindex_localtime on;
}
#Nginx运行状态，StubStatus模块获取Nginx自启动的工作状态（编译时要开启对应功能）
location /NginxStatus {
#启用StubStatus的工作访问状态
stub_status on;
#指定StubStaus模块的访问日志文件 可off
access_log logs/Nginxstatus.log;
#Nginx认证机制（需Apache的htpasswd命令生成）
#auth_basic "NginxStatus";
#用来认证的密码文件
#auth_basic_user_file ../htpasswd;
}
#根据不同的浏览器URL重写
if($http_user_agent ~ Firefox){
rewrite ^(.*)$ /firefox/$1 break;
}
if($http_user_agent ~ MSIE){
rewrite ^(.*)$ /msie/$1 break;
}
#实现域名跳转
location / {
rewrite ^/(.*)$ https://web8.example.com$1 permanent;
}
#控制跳转https
rewrite ^(.*) https://$server_name$1 permanent;
}
server {
# 1.1版本后这样写
listen 443 ssl;
#填写绑定证书的域名
server_name www.domain.com;
# 指定证书的位置，绝对路径
ssl_certificate 1_www.domain.com_bundle.crt;
ssl_certificate_key 2_www.domain.com.key;
ssl_session_timeout 5m;
ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:HIGH:!aNULL:!MD5:!RC4:!DHE;
ssl_prefer_server_ciphers on;
location / {
root html;
index index.html index.htm;
}
}
}
纸上得来终觉浅，绝知此事要躬行
