Nginx--配置文件

Fong
321 阅读10分钟

我们知道Nginx的核心配置文件默认是放在/usr/local/nginx/conf/nginx.conf，nginx.conf的内容和基本配置方法。

读取Nginx自带的Nginx配置文件

 #指令名  指令值;  #全局块，主要设置Nginx服务器整体运行的配置指令
 worker_processes  1;
 ​
 #events块,主要设置,Nginx服务器与用户的网络连接,这一部分对Nginx服务器的性能影响较大
 events {
     worker_connections  1024;
 }
 ​
 #http块，是Nginx服务器配置中的重要部分，代理、缓存、日志记录、第三方模块配置...  
 http {
 ​
     #指令名  指令值;
     include       mime.types;
     default_type  application/octet-stream;
     sendfile        on;
     keepalive_timeout  65;
 ​
     #server块，是Nginx配置和虚拟主机相关的内容
     server {
         listen       80;
         server_name  localhost;
         
         #location块，基于Nginx服务器接收请求字符串与location后面的值进行匹配，对特定请求进行处理
         location / {
             
             #指令名  指令值;
             root   html;
             index  index.html index.htm;
         }
         error_page   500 502 503 504  /50x.html;
         location = /50x.html {
             root   html;
         }
     }
 ​
 }

nginx.conf配置文件中默认有三大块：全局块、events块、http块

http块中可以配置多个server块，每个server块又可以配置多个location块。

全局块

user

用于配置运行Nginx服务器的worker进程的用户和用户组。

语法user user [group]
默认值nobody
位置全局块

该属性也可以在编译的时候指定，语法如下./configure --user=user --group=group,如果两个地方都进行了设置，最终生效的是配置文件中的配置。

该指令的使用步骤：设置一个用户信息"www"

 user www;

work process

master_process:用来指定是否开启工作进程。

语法master_process on | off;
默认值master_process on;
位置全局块

worker_processes:用于配置Nginx生成工作进程的数量，这个是Nginx服务器实现并发处理服务的关键所在。理论上来说workder process的值越大，可以支持的并发处理量也越多，但事实上这个值的设定是需要受到来自服务器自身的限制，建议将该值和服务器CPU的内核数保存一致。

语法worker_processes num/auto;
默认值1
位置全局块

如果将worker_processes设置成2，则会看到如下内容:

image-20211008172835161

daemon

设定Nginx是否以守护进程的方式启动，守护式进程是linux后台执行的一种服务进程，特点是独立于控制终端，不会随着终端关闭而停止。

语法daemon on | off;
默认值daemon on;
位置全局块

pid

用来配置Nginx当前master进程的进程号ID存储的文件路径。

语法pid file;
默认值默认为:/usr/local/nginx/logs/nginx.pid
位置全局块

该属性可以通过./configure --pid-path=PATH来指定

error_log

用来配置Nginx的错误日志存放路径

语法error_log file [日志级别];
默认值error_log logs/error.log error;
位置全局块、http、server、location

该属性可以通过./configure --error-log-path=PATH来指定

其中日志级别的值有：debug|info|notice|warn|error|crit|alert|emerg，翻译过来为试|信息|通知|警告|错误|临界|警报|紧急，这块建议大家设置的时候不要设置成info以下的等级，因为会带来大量的磁盘I/O消耗，影响Nginx的性能。

include

用来引入其他配置文件，使Nginx的配置更加灵活

语法include file;
默认值无
位置any

events块

accept_mutex

用来设置Nginx网络连接序列化

| 语法 | accept_mutex on|off; | | --- | --------------------- | | 默认值 | accept_mutex on; | | 位置 | events |

这个配置主要可以用来解决常说的"惊群"问题。大致意思是在某一个时刻，客户端发来一个请求连接，Nginx后台是以多进程的工作模式，也就是说有多个worker进程会被同时唤醒，但是最终只会有一个进程可以获取到连接，如果每次唤醒的进程数目太多，就会影响Nginx的整体性能。如果将上述值设置为on(开启状态)，将会对多个Nginx进程接收连接进行序列号，一个个来唤醒接收，就防止了多个进程对连接的争抢。

multi_accept

用来设置是否允许同时接收多个网络连接

| 语法 | multi_accept on|off; | | --- | --------------------- | | 默认值 | multi_accept off; | | 位置 | events |

如果multi_accept被禁止了，nginx一个工作进程只能同时接受一个新的连接。否则，一个工作进程可以同时接受所有的新连接

worker_connections

用来配置单个worker进程最大的连接数

语法worker_connections number;
默认值worker_commections 512;
位置events

这里的连接数不仅仅包括和前端用户建立的连接数，而是包括所有可能的连接数。另外，number值不能大于操作系统支持打开的最大文件句柄数量。

use

用来设置Nginx服务器选择哪种事件驱动来处理网络消息。

语法use method;
默认值根据操作系统定
位置events

注意：此处所选择事件处理模型是Nginx优化部分的一个重要内容，method的可选值有select/poll/epoll/kqueue等，之前在准备centos环境的时候，我们强调过要使用linux内核在2.6以上，就是为了能使用epoll函数来优化Nginx。

另外这些值的选择，我们也可以在编译的时候使用

--with-select_module、--without-select_module、

--with-poll_module、--without-poll_module来设置是否需要将对应的事件驱动模块编译到Nginx的内核。

http块

定义MIME-Type

我们都知道浏览器中可以显示的内容有HTML、XML、GIF等种类繁多的文件、媒体等资源，浏览器为了区分这些资源，就需要使用MIME Type。所以说MIME Type是网络资源的媒体类型。Nginx作为web服务器，也需要能够识别前端请求的资源类型。

在Nginx的配置文件中，默认有两行配置

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

default_type:用来配置Nginx响应前端请求默认的MIME类型。

语法default_type mime-type;
默认值default_type text/plain；
位置http、server、location

在default_type之前还有一句include mime.types,include之前我们已经介绍过，相当于把mime.types文件中MIMT类型与相关类型文件的文件后缀名的对应关系加入到当前的配置文件中。

举例来说明：

有些时候请求某些接口的时候需要返回指定的文本字符串或者json字符串，如果逻辑非常简单或者干脆是固定的字符串，那么可以使用nginx快速实现，这样就不用编写程序响应请求了，可以减少服务器资源占用并且响应性能非常快。

如何实现:

 location /get_text {
   #这里也可以设置成text/plain
     default_type text/html;
     return 200 "This is nginx's text";
 }
 location /get_json{
     default_type application/json;
     return 200 '{"name":"TOM","age":18}';
 }

自定义服务日志

Nginx中日志的类型分access.log、error.log。

access.log:用来记录用户所有的访问请求。

error.log:记录nginx本身运行时的错误信息，不会记录用户的访问请求。

Nginx服务器支持对服务日志的格式、大小、输出等进行设置，需要使用到两个指令，分别是access_log和log_format指令。

1、access_log:用来设置用户访问日志的相关属性。

语法access_log path[format[buffer=size]]
默认值access_log logs/access.log combined;
位置http, server, location

2、log_format:用来指定日志的输出格式。

语法log_format name [escape=default | json | none] string....;
默认值log_format combined "...";
位置http

其他配置指令

1、sendfile:用来设置Nginx服务器是否使用sendfile()传输文件，该属性可以大大提高Nginx处理静态资源的性能

语法sendfile on | off；
默认值sendfile off;
位置http、server、location

2、keepalive_timeout:用来设置长连接的超时时间。

为什么要使用keepalive？

我们都知道HTTP是一种无状态协议，客户端向服务端发送一个TCP请求，服务端响应完毕后断开连接。 如何客户端向服务端发送多个请求，每个请求都需要重新创建一次连接，效率相对来说比较多，使用keepalive模式，可以告诉服务器端在处理完一个请求后保持这个TCP连接的打开状态，若接收到来自这个客户端的其他请求，服务端就会利用这个未被关闭的连接，而不需要重新创建一个新连接，提升效率，但是这个连接也不能一直保持，这样的话，连接如果过多，也会是服务端的性能下降，这个时候就需要我们进行设置其的超时时间。

语法keepalive_timeout time;
默认值keepalive_timeout 75s;
位置http、server、location

3、keepalive_requests:用来设置一个keep-alive连接使用的次数。

语法keepalive_requests number;
默认值keepalive_requests 100;
位置http、server、location

server块

listen

用来配置监听端口。

语法listen address[:port] [default_server]...; listen port [default_server]...;
默认值listen *:80*:8000
位置server

listen的设置比较灵活，我们通过几个例子来把常用的设置方式熟悉下：

 listen 127.0.0.1:8000; // listen localhost:8000 监听指定的IP和端口
 listen 127.0.0.1; 监听指定IP的所有端口
 listen 8000;  监听指定端口上的连接
 listen *:8000;  监听指定端口上的连接

default_server属性是标识符，用来将此虚拟主机设置成默认主机。所谓的默认主机指的是如果没有匹配到对应的address:port，则会默认执行的。如果不指定默认使用的是第一个server。

 server{
   listen 8080;
   server_name 127.0.0.1;
   location /{
     root html;
     index index.html;
   }
 }
 server{
   listen 8080 default_server;
   server_name localhost;
   default_type text/plain;
   return 444 'This is a error request';
 }

server_name指令

server_name：用来设置虚拟主机服务名称。

127.0.0.1 、 localhost 、域名[www.baidu.com | www.jd.com]

语法server_name name ...; name可以提供多个中间用空格分隔
默认值server_name "";
位置server

关于server_name的配置方式有三种，分别是：

1、精确匹配 2、通配符匹配 3、正则表达式匹配

配置方式一：精确匹配

如：

 server {
   listen 80;
   server_name www.qwer.cn www.asdf.cn;
   ...
 }

补充Tips：hosts是一个没有扩展名的系统文件，可以用记事本等工具打开，其作用就是将一些常用的网址域名与其对应的IP地址建立一个关联数据库，当用户在浏览器中输入一个需要登录的网址时，系统会首先自动从hosts文件中寻找对应的IP地址，一旦找到，系统会立即打开对应网页，如果没有找到，则系统会再将网址提交DNS域名解析服务器进行IP地址的解析。

 Windows：C:\Windows\System32\drivers\etc
 Redhat、CentOS、MacOS：/etc/hosts

因为域名是要注册、备案、收取费用的，所以我们可以使用修改hosts文件来制作一些虚拟域名来使用。需要修改 /etc/hosts文件来添加

 cat >> /etc/hosts  << EOF
 127.0.0.1 www.qwer.cn
 127.0.0.1 www.asdf.cn
 EOF

配置方式二:使用通配符配置

server_name中支持通配符"*",但需要注意的是通配符不能出现在域名的中间，只能出现在首段或尾段，如：

 server {
   listen 80;
   server_name  *.qwer.cn  www.asdf.*;
   # www.qwer.cn abc.qwer.cn www.asdf.cn www.asdf.com
   ...
 }

下面的配置就会报错

 server {
   listen 80;
   server_name  www.*.cn www.asdf.c*
   ...
 }

配置方式三:使用正则表达式配置

server_name中可以使用正则表达式，并且使用~作为正则表达式字符串的开始标记。

常见的正则表达式

代码说明
^匹配搜索字符串开始位置
$匹配搜索字符串结束位置
.匹配除换行符\n之外的任何单个字符
\转义字符，将下一个字符标记为特殊字符
[xyz]字符集，与任意一个指定字符匹配
[a-z]字符范围，匹配指定范围内的任何字符
\w与以下任意字符匹配 A-Z a-z 0-9 和下划线,等效于[A-Za-z0-9_]
\d数字字符匹配，等效于[0-9]
{n}正好匹配n次
{n,}至少匹配n次
{n,m}匹配至少n次至多m次
*零次或多次，等效于{0,}
+一次或多次，等效于{1,}
?零次或一次，等效于{0,1}

配置如下：

 server{
         listen 80;
         server_name ~^www.(\w+).com$;
         default_type text/plain;
         return 200 $1  $2 ..;
 }
 ​
 # ~后面不能加空格，括号可以取值
匹配执行顺序

由于server_name指令支持通配符和正则表达式，因此在包含多个虚拟主机的配置文件中，可能会出现一个名称被多个虚拟主机的server_name匹配成功，当遇到这种情况，当前的请求交给谁来处理呢？

 server{
   listen 80;
   server_name ~^www.\w+.com$;
   default_type text/plain;
   return 200 'regex_success';
 }
 ​
 server{
   listen 80;
   server_name www.asdf.*;
   default_type text/plain;
   return 200 'wildcard_after_success';
 }
 ​
 server{
   listen 80;
   server_name *.asdf.com;
   default_type text/plain;
   return 200 'wildcard_before_success';
 }
 ​
 server{
   listen 80;
   server_name www.asdf.com;
   default_type text/plain;
   return 200 'exact_success';
 }
 ​
 server{
   listen 80 default_server;
   server_name _;
   default_type text/plain;
   return 444 'default_server not found server';
 }

结论：

exact_success

wildcard_before_success

wildcard_after_success

regex_success

default_server not found server!!

No1:准确匹配server_name

No2:通配符在开始时匹配server_name成功

No3:通配符在结束时匹配server_name成功

No4:正则表达式匹配server_name成功

No5:被默认的default_server处理，如果没有指定默认找第一个server

location块

location:用来设置请求的URI

语法location [ = | ~ | ~* | ^~ | @ ] uri{...}
默认值—
位置server,location

uri变量是待匹配的请求字符串，可以不包含正则表达式，也可以包含正则表达式，那么nginx服务器在搜索匹配location的时候，是先使用不包含正则表达式进行匹配，找到一个匹配度最高的一个，然后在通过包含正则表达式的进行匹配，如果能匹配到直接访问，匹配不到，就使用刚才匹配度最高的那个location来处理请求。

属性介绍:

不带符号，要求必须以指定模式开始

 server {
   listen 80;
   server_name 127.0.0.1;
   location /abc{
     default_type text/plain;
     return 200 "access success";
   }
 }
 # 以下访问都是正确的
 # http://192.168.31.101/abc
 # http://192.168.31.101/abc?p1=TOM
 # http://192.168.31.101/abc/
 # http://192.168.31.101/abcdef

= : 用于不包含正则表达式的uri前，必须与指定的模式精确匹配

 server {
   listen 80;
   server_name 127.0.0.1;
   location =/abc{
     default_type text/plain;
     return 200 "access success";
   }
 }
 # 可以匹配到
 # http://192.168.31.101/abc
 # http://192.168.31.101/abc?p1=TOM
 # 匹配不到
 # http://192.168.31.101/abc/
 # http://192.168.31.101/abcdef

~ ： 用于表示当前uri中包含了正则表达式，并且区分大小写 ~*: 用于表示当前uri中包含了正则表达式，并且不区分大小写

换句话说，如果uri包含了正则表达式，需要用上述两个符合来标识

 server {
   listen 80;
   server_name 127.0.0.1;
   location ~^/abc\w${
     default_type text/plain;
     return 200 "access success";
   }
 }
 server {
   listen 80;
   server_name 127.0.0.1;
   location ~*^/abc\w${
     default_type text/plain;
     return 200 "access success";
   }
 }

^~: 用于不包含正则表达式的uri前，功能和不加符号的一致，唯一不同的是，如果模式匹配，那么就停止搜索其他模式了。

 server {
   listen 80;
   server_name 127.0.0.1;
   location ^~/abc{
     default_type text/plain;
     return 200 "access success";
   }
 }

设置请求资源的目录root / alias

root：设置请求的根目录

语法root path;
默认值root html;
位置http、server、location

path为Nginx服务器接收到请求以后查找资源的根目录路径。

alias：用来更改location的URI

语法alias path;
默认值—
位置location

path为修改后的根路径。

以上两个指令都可以来指定访问资源的路径，那么这两者之间的区别是什么?

举例说明：

（1）在/usr/local/nginx/html目录下创建一个 images目录,并在目录下放入一张图片mv.png图片

 location /images {
   root /usr/local/nginx/html;
 }

访问图片的路径为:

 http://192.168.31.101/images/mv.png

（2）如果把root改为alias

 location /images {
   alias /usr/local/nginx/html;
 }

再次访问上述地址，页面会出现404的错误，查看错误日志会发现是因为地址不对，所以验证了：

 root的处理结果是: root路径+location路径
 /usr/local/nginx/html/images/mv.png
 alias的处理结果是:使用alias路径替换location路径
 /usr/local/nginx/html/images

需要在alias后面路径改为

 location /images {
   alias /usr/local/nginx/html/images;
 }

（3）如果location路径是以/结尾,则alias也必须是以/结尾，root没有要求

将上述配置修改为

 location /images/ {
   alias /usr/local/nginx/html/images;
 }

访问就会出问题，查看错误日志还是路径不对，所以需要把alias后面加上 /

小结：

1、root的处理结果是: root路径+location路径 2、alias的处理结果是:使用alias路径替换location路径 3、alias是一个目录别名的定义，root则是最上层目录的含义。 4、如果location路径是以/结尾,则alias也必须是以/结尾，root没有要求

index指令

index:设置网站的默认首页

语法index file ...;
默认值index index.html;
位置http、server、location

index后面可以跟多个设置，如果访问的时候没有指定具体访问的资源，则会依次进行查找，找到第一个为止。

举例说明：

 location / {
   root /usr/local/nginx/html;
   index index.html index.htm;
 }
 # 访问该location的时候，可以通过 http://ip:port/
 # 地址后面如果不添加任何内容，则默认依次访问index.html和index.htm，找到第一个来进行返回

error_page指令

error_page:设置网站的错误页面

语法error_page code ... [=[response]] uri;
默认值—
位置http、server、location......

当出现对应的响应code后，如何来处理。

举例说明：

（1）可以指定具体跳转的地址

 server {
   error_page 404 http://www.qwer.cn;
 }

（2）可以指定重定向地址

 server{
   error_page 404 /50x.html;
   error_page 500 502 503 504 /50x.html;
   location =/50x.html{
     root html;
   }
 }

（3）使用location的@符合完成错误信息展示

 server{
   error_page 404 @jump_to_error;
   location @jump_to_error {
     default_type text/plain;
     return 404 'Not Found Page...';
   }
 }

可选项=[response]的作用是用来将相应代码更改为另外一个

 server{
   error_page 404 =200 /50x.html;
   location =/50x.html{
     root html;
   }
 }
 ​
 # 这样的话，当返回404找不到对应的资源的时候，在浏览器上可以看到，最终返回的状态码是200
 # 这块需要注意下，编写error_page后面的内容，404后面需要加空格，200前面不能加空格
avatar
文章
阅读
粉丝