nginx.conf配置方法详细介绍

矫情吗；* 2023-10-10 16:21 20阅读 0赞

从前面的内容学习中，我们知道Nginx的核心配置文件默认是放在/usr/local/nginx/conf/nginx.conf，这一节，我们就来学习下nginx.conf的内容和基本配置方法。

读取Nginx自带的Nginx配置文件，我们将其中的注释部分【学习一个技术点就是在Nginx的配置文件中可以使用\#来注释】删除掉后，就剩下下面内容:

worker_processes  1;
    
    events {
        worker_connections  1024;}
    
    http {
        include       mime.types;
        default_type  application/octet-stream;
        sendfile        on;
        keepalive_timeout  65;
    
        server {
            listen       80;
            server_name  localhost;
            location /{
                root   html;
                index  index.html index.htm;}
            error_page   500502503504/50x.html;
            location =/50x.html {
                root   html;}}}

指令名 指令值;  #全局块，主要设置Nginx服务器整体运行的配置指令
    
     #events块,主要设置,Nginx服务器与用户的网络连接,这一部分对Nginx服务器的性能影响较大
    events {     
        指令名 指令值;}
    #http块，是Nginx服务器配置中的重要部分，代理、缓存、日志记录、第三方模块配置...             
    http {      
        指令名 指令值;
        server { #server块，是Nginx配置和虚拟主机相关的内容
            指令名 指令值;
            location /{ 
            #location块，基于Nginx服务器接收请求字符串与location后面的值进行匹配，对特定请求进行处理
                指令名 指令值;}}...}

简单小结下:

nginx.conf配置文件中默认有三大块：全局块、events块、http块。http块中可以配置多个server块，每个server块又可以配置多个location块。

**全局块**

### **user指令** ###

(1)user:用于配置运行Nginx服务器的worker进程的用户和用户组。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:73px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:132px;vertical-align:top;height:52px;">user user [group]</td> 
 </tr> 
 <tr> 
 <td style="width:73px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:132px;vertical-align:top;height:52px;">nobody</td> 
 </tr> 
 <tr> 
 <td style="width:73px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:132px;vertical-align:top;height:52px;">全局块</td> 
 </tr> 
 </tbody> 
</table>

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

该指令的使用步骤:

(1)设置一个用户信息"www"

user www;

![3e9ae927aada59cbfff8359c7cf5a778.jpeg][]

(2)创建一个用户

useradd www

(3)修改user属性

user www

(4)创建/root/html/index.html页面，添加如下内容

<!DOCTYPE html><html><head><title>Welcometonginx!</title><style>
 body {
 width:35em;
 margin:0 auto;
 font-family:Tahoma,Verdana,Arial, sans-serif;}</style></head><body><h1>Welcometonginx!</h1>If you see this page, the nginx web server is successfully installed and
 working.Further configuration is required.For online documentation and support please refer to<a href="http://nginx.org/">nginx.org</a>. Commercial support is available at
 <a href="http://nginx.com/">nginx.com</a>.Thank you for using nginx.I am WWW</body></html>

(5)修改nginx.conf

location /{
    	root   /root/html;
    	index  index.html index.htm;}

(6)测试启动访问

页面会报403拒绝访问的错误

(7)分析原因

因为当前用户没有访问/root/html目录的权限

(8)将文件创建到 /home/www/html/index.html,修改配置

location /{
    	root   /home/www/html;
    	index  index.html index.htm;}

(9)再次测试启动访问

能正常访问。

### **work process指令** ###

master\_process:用来指定是否开启工作进程。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:179px;vertical-align:top;height:52px;">master_process on|off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:179px;vertical-align:top;height:52px;">master_process on;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:179px;vertical-align:top;height:52px;">全局块</td> 
 </tr> 
 </tbody> 
</table>

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">worker_processes num/auto;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">1</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">全局块</td> 
 </tr> 
 </tbody> 
</table>

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

![79c87ac1bb7ae4c75479d743f614eeed.jpeg][]

**其他指令**

daemon：设定Nginx是否以守护进程的方式启动。

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">daemon on|off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">daemon on;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">全局块</td> 
 </tr> 
 </tbody> 
</table>

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">pid file;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">默认为:/usr/local/nginx/logs/nginx.pid</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">全局块</td> 
 </tr> 
 </tbody> 
</table>

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

error\_log:用来配置Nginx的错误日志存放路径

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">include file;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">无</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">any</td> 
 </tr> 
 </tbody> 
</table>

### **events块** ###

(1)accept\_mutex:用来设置Nginx网络连接序列化

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">error_log file [日志级别];</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">error_log logs/error.log error;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">全局块、http、server、location</td> 
 </tr> 
 </tbody> 
</table>

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

(5)include:用来引入其他配置文件，使Nginx的配置更加灵活

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">accept_mutex on|off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">accept_mutex on;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">events</td> 
 </tr> 
 </tbody> 
</table>

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

(2)multi\_accept:用来设置是否允许同时接收多个网络连接

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">multi_accept on|off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">multi_accept off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">events</td> 
 </tr> 
 </tbody> 
</table>

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

(3)worker\_connections：用来配置单个worker进程最大的连接数

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:252px;vertical-align:top;height:52px;">worker_connections number;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:252px;vertical-align:top;height:52px;">worker_commections 512;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:252px;vertical-align:top;height:52px;">events</td> 
 </tr> 
 </tbody> 
</table>

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

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:128px;vertical-align:top;height:52px;">use method;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:128px;vertical-align:top;height:52px;">根据操作系统定</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:128px;vertical-align:top;height:52px;">events</td> 
 </tr> 
 </tbody> 
</table>

注意：此处所选择事件处理模型是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的内核。

### **events指令配置实例** ###

打开Nginx的配置文件 nginx.conf,添加如下配置

events{
    	accept_mutex on;
    	multi_accept on;
    	worker_commections 1024;
    	use epoll;}

启动测试

./nginx -t
    ./nginx -s reload

### **http块** ###

**定义MIME-Type**

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

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

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

(1)default\_type:用来配置Nginx响应前端请求默认的MIME类型。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:207px;vertical-align:top;height:52px;">default_type mime-type;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:207px;vertical-align:top;height:52px;">default_type text/plain；</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:207px;vertical-align:top;height:52px;">http、server、location</td> 
 </tr> 
 </tbody> 
</table>

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

举例来说明：

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

如何实现:

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

### **自定义服务日志** ###

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

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

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

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

(1)access\_log:用来设置用户访问日志的相关属性。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:369px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:369px;vertical-align:top;height:52px;">access_log path[format[buffer=size]]</td> 
 </tr> 
 <tr> 
 <td style="width:369px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:369px;vertical-align:top;height:52px;">access_log logs/access.log combined;</td> 
 </tr> 
 <tr> 
 <td style="width:369px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:369px;vertical-align:top;height:52px;">http, server, location</td> 
 </tr> 
 </tbody> 
</table>

(2)log\_format:用来指定日志的输出格式。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:410px;vertical-align:top;height:52px;">log_format name [escape=default|json|none] string....;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:410px;vertical-align:top;height:52px;">log_format combined "...";</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:410px;vertical-align:top;height:52px;">http</td> 
 </tr> 
 </tbody> 
</table>

**其他配置指令**

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:410px;vertical-align:top;height:52px;">sendfile on|off；</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:410px;vertical-align:top;height:52px;">sendfile off;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:410px;vertical-align:top;height:52px;">http、server、location</td> 
 </tr> 
 </tbody> 
</table>

(2)keepalive\_timeout:用来设置长连接的超时时间。

为什么要使用keepalive?

我们都知道HTTP是一种无状态协议，客户端向服务端发送一个TCP请求，服务端响应完毕后断开连接。

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

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:410px;vertical-align:top;height:52px;">keepalive_timeout time;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:410px;vertical-align:top;height:52px;">keepalive_timeout 75s;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:410px;vertical-align:top;height:52px;">http、server、location</td> 
 </tr> 
 </tbody> 
</table>

(3)keepalive\_requests:用来设置一个keep-alive连接使用的次数。

<table style=""> 
 <tbody> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">语法</td> 
 <td style="width:410px;vertical-align:top;height:52px;">keepalive_requests number;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">默认值</td> 
 <td style="width:410px;vertical-align:top;height:52px;">keepalive_requests 100;</td> 
 </tr> 
 <tr> 
 <td style="width:60px;vertical-align:top;height:52px;">位置</td> 
 <td style="width:410px;vertical-align:top;height:52px;">http、server、location</td> 
 </tr> 
 </tbody> 
</table>

**server块和location块**

server块和location块都是我们要重点讲解和学习的内容，因为我们后面会对Nginx的功能进行详细讲解，所以这块内容就放到静态资源部署的地方给大家详细说明。

本节我们主要来认识下Nginx默认给的nginx.conf中的相关内容，以及server块与location块在使用的时候需要注意的一些内容。

server {
            listen       80;
            server_name  localhost;
            location /{
                root   html;
                index  index.html index.htm;}
           
            error_page   500502503504404/50x.html;
            location =/50x.html {
                root   html;}}

[3e9ae927aada59cbfff8359c7cf5a778.jpeg]: https://img-blog.csdnimg.cn/img_convert/3e9ae927aada59cbfff8359c7cf5a778.jpeg
[79c87ac1bb7ae4c75479d743f614eeed.jpeg]: https://img-blog.csdnimg.cn/img_convert/79c87ac1bb7ae4c75479d743f614eeed.jpeg