从一份配置清单详解Nginx服务器配置

时间 2019-11-06

原文原文链接

概述

在前面《Nginx服务器开箱体验》一文中咱们从开箱到体验，感觉了一下Nginx服务器的魅力。Nginx是轻量级的高性能Web服务器，提供了诸如HTTP代理和反向代理、负载均衡、缓存等一系列重要特性，于是在实践之中使用普遍，笔者也在学习和实践之中。html

在本文中，咱们继续延续前文，从前文给出的一份示例配置清单开始，详解一下Nginx服务器的各类配置指令的做用和用法。前端

看到了下文中的包含了 “小猪佩琪色” 的配图了吗，嘿嘿，咱们开始吧！nginx

注：本文首发于 My Personal Blog，欢迎光临小站！web

Nginx配置文件的总体结构

从图中能够看出主要包含如下几大部份内容：正则表达式

1. 全局块

该部分配置主要影响Nginx全局，一般包括下面几个部分：编程

配置运行Nginx服务器用户（组）
worker process数
Nginx进程PID存放路径
错误日志的存放路径
配置文件的引入

2. events块

该部分配置主要影响Nginx服务器与用户的网络链接，主要包括：c#

设置网络链接的序列化
是否容许同时接收多个网络链接
事件驱动模型的选择
最大链接数的配置

3. http块

定义MIMI-Type
自定义服务日志
容许sendfile方式传输文件
链接超时时间
单链接请求数上限

4. server块

配置网络监听
基于名称的虚拟主机配置
基于IP的虚拟主机配置

5. location块

location配置
请求根目录配置
更改location的URI
网站默认首页配置

一份配置清单例析

笔者按照文章：《Nginx服务器开箱体验》中的实验，给出了一份简要的清单配置举例：浏览器

配置代码以下：缓存

user  nobody  nobody;
worker_processes  3;
error_log  logs/error.log;
pid  logs/nginx.pid;

events {
	use epoll;
    worker_connections  1024;
}


http {
    include       mime.types;
    default_type  application/octet-stream;

    log_format  main  '$remote_addr - $remote_user [$time_local] "$request" '
                      '$status $body_bytes_sent "$http_referer" '
                      '"$http_user_agent" "$http_x_forwarded_for"';
    access_log  logs/access.log  main;
    sendfile  on;
    keepalive_timeout  65;

    server {
        listen       8088;
        server_name  codesheep;
        access_log  /codesheep/webserver/server1/log/access.log;
        error_page  404  /404.html;

        location /server1/location1 {
            root   /codesheep/webserver;
            index  index.server2-location1.htm;
        }

        location /server1/location2 {
	    root   /codesheep/webserver;
            index  index.server2-location2.htm;
        }

    }

    server {
        listen       8089;
        server_name  192.168.31.177;
        access_log  /codesheep/webserver/server2/log/access.log;
        error_page  404  /404.html;
		
        location /server2/location1 {
            root   /codesheep/webserver;
            index  index.server2-location1.htm;
        }

        location /srv2/loc2 {
            alias   /codesheep/webserver/server2/location2/;
            index  index.server2-location2.htm;
        }
		
        location = /404.html {
	        root /codesheep/webserver/;
	        index 404.html;
        }
		
    }

}

接下来就来详细剖析如下配置文件中各个指令的含义⬇️服务器

配置运行Nginx服务器用户（组）

指令格式：user user [group];

user：指定能够运行Nginx服务器的用户
group：可选项，能够运行Nginx服务器的用户组

若是user指令不配置或者配置为 user nobody nobody ，则默认全部用户均可以启动Nginx进程

worker process数配置

Nginx服务器实现并发处理服务的关键，指令格式：worker_processes number | auto;

number：Nginx进程最多能够产生的worker process数
auto：Nginx进程将自动检测

按照上文中的配置清单的实验，咱们给worker_processes配置的数目是：3，启动Nginx服务器后，咱们能够后台看一下主机上的Nginx进程状况：

ps -aux | grep nginx

很明显，理解 worker_processes 这个指令的含义就很容易了

Nginx进程PID存放路径

Nginx进程是做为系统守护进程在运行，须要在某文件中保存当前运行程序的主进程号，Nginx支持该保存文件路径的自定义

指令格式：pid file;

file：指定存放路径和文件名称
若是不指定默认置于路径 logs/nginx.pid

错误日志的存放路径

指定格式：error_log file | stderr;

file：日志输出到某个文件file
stderr：日志输出到标准错误输出

配置文件的引入

指令格式：include file;

该指令主要用于将其余的Nginx配置或者第三方模块的配置引用到当前的主配置文件中

设置网络链接的序列化

指令格式：accept_mutex on | off;

该指令默认为on状态，表示会对多个Nginx进程接收链接进行序列化，防止多个进程对链接的争抢。

说到该指令，首先得阐述一下什么是所谓的 “惊群问题”，能够参考 WIKI百科的解释。就Nginx的场景来解释的话大体的意思就是：当一个新网络链接来到时，多个worker进程会被同时唤醒，但仅仅只有一个进程能够真正得到链接并处理之。若是每次唤醒的进程数目过多的话，实际上是会影响一部分性能的。

因此在这里，若是accept_mutex on，那么多个worker将是以串行方式来处理，其中有一个worker会被唤醒；反之若accept_mutex off，那么全部的worker都会被唤醒，不过只有一个worker能获取新链接，其它的worker会从新进入休眠状态

这个值的开关与否实际上是要和具体场景挂钩的。

是否容许同时接收多个网络链接

指令格式：multi_accept on | off;

该指令默认为off状态，意指每一个worker process 一次只能接收一个新到达的网络链接。若想让每一个Nginx的worker process都有能力同时接收多个网络链接，则须要开启此配置

事件驱动模型的选择

指令格式：use model;

model模型可选择项包括：select、poll、kqueue、epoll、rtsig等......

最大链接数的配置

指令格式：worker_connections number;

number默认值为512，表示容许每个worker process能够同时开启的最大链接数

定义MIME-Type

指令格式：

include mime.types;
default_type mime-type;

MIME-Type指的是网络资源的媒体类型，也即前端请求的资源类型
include指令将mime.types文件包含进来

cat mime.types 来查看mime.types文件内容，咱们发现其就是一个types结构，里面包含了各类浏览器可以识别的MIME类型以及对应类型的文件后缀名字，以下所示：

自定义服务日志

指令格式：

access_log path [format];

path：自定义服务日志的路径 + 名称
format：可选项，自定义服务日志的字符串格式。其也可使用 log_format 定义的格式

容许sendfile方式传输文件

指令格式：

sendfile on | off;
sendfile_max_chunk size;

前者用于开启或关闭使用sendfile()传输文件，默认off
后者指令若size>0，则Nginx进程的每一个worker process每次调用sendfile()传输的数据了最大不能超出此值；若size=0则表示不限制。默认值为0

链接超时时间配置

指令格式：keepalive_timeout timeout [header_timeout];

timeout 表示server端对链接的保持时间，默认75秒
header_timeout 为可选项，表示在应答报文头部的 Keep-Alive 域设置超时时间：“Keep-Alive : timeout = header_timeout”

单链接请求数上限

指令格式：keepalive_requests number;

该指令用于限制用户经过某一个链接向Nginx服务器发起请求的次数

配置网络监听

指令格式：

第一种：配置监听的IP地址：listen IP[:PORT];
第二种：配置监听的端口：listen PORT;

实际举例：

listen 192.168.31.177:8080; # 监听具体IP和具体端口上的链接
listen 192.168.31.177;      # 监听IP上全部端口上的链接
listen 8080;                # 监听具体端口上的全部IP的链接

基于名称和IP的虚拟主机配置

指令格式：server_name name1 name2 ...

name能够有多个并列名称，并且此处的name支持正则表达式书写

实际举例：

server_name ~^www\d+\.myserver\.com$

此时表示该虚拟主机能够接收相似域名 www1.myserver.com 等的请求而拒绝 www.myserver.com 的域名请求，因此说用正则表达式能够实现更精准的控制

至于基于IP的虚拟主机配置比较简单，再也不太赘述：

指令格式：server_name IP地址

location配置

指令格式为：location [ = | ~ | ~* | ^~ ] uri {...}

这里的uri分为标准uri和正则uri，二者的惟一区别是uri中是否包含正则表达式

uri前面的方括号中的内容是可选项，解释以下：

“=”：用于标准uri前，要求请求字符串与uri严格匹配，一旦匹配成功则中止
“~”：用于正则uri前，而且区分大小写
“~*”：用于正则uri前，但不区分大小写
“^~”：用于标准uri前，要求Nginx找到标识uri和请求字符串匹配度最高的location后，当即使用此location处理请求，而再也不使用location块中的正则uri和请求字符串作匹配

请求根目录配置

指令格式：root path;

path：Nginx接收到请求之后查找资源的根目录路径

固然，还能够经过alias指令来更改location接收到的URI请求路径，指令为：

alias path;  # path为修改后的根路径

设置网站的默认首页

指令格式：index file ......

file能够包含多个用空格隔开的文件名，首先找到哪一个页面，就使用哪一个页面响应请求

后记

做者更多的SpringBt实践文章在此：

若是有兴趣，也能够抽点时间看看做者一些关于容器化、微服务化方面的文章：