NGINX快速入门（03）Nginx的常用配置

你的名字 2022-12-08 05:45 261阅读 0赞

上一篇文章我们主要介绍的Nginx的架构，其实主要是Nginx包含了哪些内容，有哪些功能和技术点。知道了这些，我们就可以猜到，Nginx的配置大部分和这些功能有关系。下面逐步介绍一些常见配置。

首先进入nginx安装目录的conf文件夹下，备份一下默认的配置文件，防止修改错了恢复不了：

> cp nginx.conf nginx.conf.bak

下面我们介绍几种常用配置：

> **入门配置**
> 
> **静态页面配置**
> 
> **动静分离**
> 
> **图片防盗配置**
> 
> **黑白名单配置**
> 
> **下载限速配置**
> 
> **日志配置**

# 先看一个简单配置 #

备份完可以编辑文件了，首先删除配置文件里的全部内容，然后编写下面这样的配置：

![330c289fc73f7569d93c0c210d84e896.png][]

Nginx里面也是分为一个个配置块的，和大部分代码一样，用大括号括起来。比如上面的events \{。。。\}就是一个配置块。

> 注意配置块的名称（events）和左大括号直接要有空格。

配置块里面的以分号结尾的一行（如 worker\_connections  1024;）就是该配置块的一个属性。

上面这个简单的配置共有一个外部属性（worker\_processes）和两个配置块（events、http）。以下是各个部分的含义：

> 1 worker\_processes  属性表示的是worker进程的进程数
> 
> 2 events 表示对事件的配置
> 
> 2.1 events中worker\_connections的含义是最大链接数
> 
> 3 http表示对http请求的配置
> 
> 3.1 http中的include属性表示引入的意思，示例中表示nginx的配置文件引入了mime.types文件
> 
> 3.2 default\_type表示请求响应的默认数据类型
> 
> 3.3 sendfile属性值为on表示启用sendfile，sendfile的作用是在底层拷贝数据的时候可以跳过应用，直接从内核拷贝到网卡，加快速度
> 
> 3.4 keepalive\_timeout表示长连接的一个保活时间，一个连接请求完并不是立马销毁，通过这个属性可以等一段时间，以便下次有请求继续用
> 
> 3.5 server 配置块代表配置一个虚拟机，用来启动并响应
> 
> 3.5.1 server中的listen属性表示监听的端口，不能和其它重复
> 
> 3.5.2 server中server\_name用来配置域名，分发请求的时候会根据访问的域名和配置的域名的对应关系分发
> 
> 3.5.3  server中location表示其中一个请求的地址 后面可以加斜杠,等于号等正则表达式方式匹配，其中的内容是对应的链接和页面，root表示页面所载目录

上面的配置只是初级的很少的一部分配置，我们一一解释了都是什么意思。接下来启动测试一下，首先检测一下配置文件有没有错误：

![49ddfcb4a287e1ca555449c8e0079482.png][]

然后启动，访问：

![315ed1c0779d8464d4534ef2bb8ec8c3.png][]

没有问题！

# 自定义一个页面 #

接下来在安装目录的html文件夹下面新建www/test目录，进入test，新建test.html文件，输入内容 hello nginx test！

然后去nginx中增加对此页面的配置：

![46832625a2f527c9347fc563e2acb9a4.png][]

listen端口与原来的监听一样也可以，因为可以设置不一样的域名，也就是server\_name；

server\_name可以写域名www.test.com，也可以写正则表达式形式，如 \*.test.com，可以同时配置多个。

配置完后，去检查一下配置是否正确：

![ba4ff498469f38515fd2bde4463c12a0.png][]

没问题后，不用重启nginx，重新加载一次配置文件即可：

![35ffcf61a7455cbe155f012979039af7.png][]

由于配置了域名访问，所以要给本机host加一个域名配置：

![3e6fc5f1c77b480e09a854c7ca8c0a36.png][]

然后从浏览器访问一下：

![d5ac60bee0569376a51ed9c18a6d7ddc.png][]

可以看到访问成功！

> 注意，如果不想带端口，可以把nginx设置为80默认端口。

还可以将root配置到location外面：

![0859a6c337bbbde31c59d23867abbac6.png][]

这样server中无论配置几个location都可以继承server中的root。

# 实现动静分离 #

很多时候为了负载更高一些，会把静态文件（如css，js，图片等）和动态文件（如html，jsp等）进行分开。也即是常说的动静分离。这也是可以在nginx中配置的。

首先在上面的www目录中新建路径 static目录，往里面拷贝一个图片test.jps:

![e72f62976ca163257bd84f45dd15f49e.png][]

然后修改test.html文件，加入图片的展示：

![1b9f302535f4f4e7b48bcc2ae2ed9f1e.png][]

保存后，访问页面可以看到效果：

![890714ec684fda8327f3b0f09faf2bef.png][]

可以看到图片展示失败，是因为图片的位置并不在我们配置的root属性的目录下面。

下面我们把静态文件也配置到nginx中：

![b2837c6c898f7a8349c4bf38c85c64f0.png][]

新增一个location，路径为/static，里面配置目录root为文件的路径，现在重新加载，直接访问图片试试：

![27d730c0398e54d04ad761a4aac14b9b.png][]

可以看到访问找不到，原因是因为静态文件配置了/static路径，location里面又配置了root，那么在目录中找文件的时候默认会再加上一个static，真实的寻找路径是 html/www/static/static路径，这个路径是没有的因此404。下面吧root改为alias别名方式：

![b8290dc559246729d3abc5daf234d091.png][]

保存从新加载，可以看到访问成功：

![45c78278a2c441ce3dd858b8b4f24904.png][]

所以如果我们的设置的文件在static目录下，设置的路径本来也是/static，就不能用root，但是如果我们设置的文件夹是static，但是静态文件在文件夹下的css文件夹中，那么可以用root，路径设置为/css即可。为了防止混乱，最好静态文件都建议用alias。此时修改html文件：

![557b2130a3a7c22e957cd2720062a6b1.png][]

访问页面就可以了：

![e4d56c9a59819e70431013b3e014c4fe.png][]

正则表达式也是常用的配置方式，下面介绍一种正则表达式的配置：

![df9f359b6392d3881f892365a5a2b7af.png][]

正则表达式匹配了以几种后缀结尾的文件，这时候使用root就可以，然后可以访问图片：

![998ca898c1a23b6be670b66180a62e1a.png][]

可以看到路径直接变成了根路径，我们在static下面新建一个image文件夹，把图片剪切到里面，

![bd668c60ad0443d4d694f8dcfe3b2a4a.png][]

这时候在后面带上/image/test.jpg即可：

![f45e49e89b115835225b54b4a7598407.png][]

可见上面这种正则表达式配置可以把static下面二级路径下的所有静态文件都访问到，这是一种配置所有静态文件省事的方式，但是正则表达式遗忘性比较大，所以使用哪种方式看个人。此时修改html文件即可访问到：

![15d27d7aeaa384b06187dd5c02560f4e.png][]

页面是：

![617599d6e39bb3be76f20c17953afc69.png][]

上面介绍了三种location的配置方式，还有一种是直接用等号写死的：

![eae931343ae9b372c92361e3473937e9.png][]

上面直接等于了一个/baidu.html的路径，下面使用proxy\_pass属性代理了百度的官网，关于反向代理后面会讲。此时访问baidu.html可以直接访问到百度官网：

![c610954d0b47556a86cff3b3a9841062.png][]

# 防盗链配置 #

防盗链就是防盗的，主要是别的网站使用本网站的图片等资源就视为被盗了，因此要做特殊防盗配置。配置如下：

![1b09c924cfb338b670cf7ea783cda8a8.png][]

valid\_referers属性表示只允许\*.test.com的域名访问图片，下面的if是判断不是设定的域名的时候，返回403.我们在server\_name后面在配置一个域名：

![d34065393ee2e7ab4706dccc2bd52a44.png][]

然后访问新的：

![8b560193d5cd1ea90be22582064c86a0.png][]

可以看到图片是不显示的，查看状态

![db92a5cbddab6deebdd6b1f722dc43a4.png][]

可以看到图片返回403。此时直接输入图片地址还是可以访问的,我们把配置再改一下：

![a95f1512d893ad707bdfea7d95b6dd00.png][]

把防盗配置中的none blocked去掉，这样单独直接访问图片也没法访问了：

![c706d3c456c002ebf38dc7fa6ce80137.png][]

只能在网站里看图片：

![883dff2e19e82a626c19060406560209.png][]

# 黑白名单配置 #

经常爬数据机器刷的ip，可以设置为黑名单禁止访问，首先在别的机器上面访问一下当前配置的nginx：

![ff5296397477e25a0b51d1e46040d1ae.png][]

目前可以访问到，然后在安装目录的配置文件目录下新建黑名单文件 black.ip，输入一下内容：

![1d3cf48b3777b7f6b81d6c650e2ea526.png][]

修改nginx配置文件，引入黑名单：

![74da5e2fbf0ea95dd7d67ac6d484a3d9.png][]

这个既可以防盗http下面，作为总的黑名单，也可以放到单独一个server下面，现在在别的机器上再次访问：

![9134208365e2bfb669c6b473bcad1f58.png][]

提示403，已经进入黑名单了！

下面设置白名单，先把黑名单的include注释掉，然后再黑名单的同一个目录新建一个白名单white.ip：

![82d55f2a8220ba9052307594b6883932.png][]

配置一个ip ，设置数值为1，然后修改配置文件：

![2c9b85b8e46956edfa3bd51a9c404644.png][]

文件中修改了两个地方，geo是引入白名单，并设置出了白名单之外的默认值是0，location里面做了判断，只要是0的就不在白名单之列，一律返回403，下面在白名单机器上访问：

![b2a58e97c39c6aabc3302bf0a9702a92.png][]

看到可以成功，在其他机器上访问页面：

![533c2d6837fb1dffd447c755ee55cd13.png][]

可以看到对应的location路径已经不能访问了。白名单功能适合单独由内网访问的系统。

# 网络限速配置 #

打开带图片的页面，可以发现图片加载的速度相当快，这是浏览器下载图片的速度快！

下面修改配置文件进行限速：

![04aa212b19adf149685c1538912dd5f1.png][]

limit\_rate\_after表示小于2k的部分不限速，大于的部分限速。limit\_rate表示如果限速那么限速下载的速度为1k。然后我们从新打开页面，发现图片加载非常慢：

![f3fc584acd86837001b8c3f747c89ff9.png][]

限速成功！如果是一个压缩文件下载限速，也是同样的道理。

# 日志配置 #

nginx的日志配置主要使用两个属性，log\_format设置日志格式，access\_log用来定义日志级别，日志位置。在原来默认的配置文件中都能看到，可以在备份中查看：

![b85e67ce2d63d58ce61075ed432ff991.png][]

常见的日志变量：

> $remote\_addr, $http\_x\_forwarded\_for 记录客户端IP地址
> 
> $remote\_user记录客户端用户名称
> 
> $request记录请求的URL和HTTP协议(GET,POST,DEL,等)
> 
> $status记录请求状态
> 
> $body\_bytes\_sent发送给客户端的字节数，不包括响应头的大小； 该变量与Apache模块mod\_log\_config里的“%B”参数兼容。
> 
> $bytes\_sent发送给客户端的总字节数。
> 
> $connection连接的序列号。
> 
> $connection\_requests 当前通过一个连接获得的请求数量。
> 
> $msec 日志写入时间。单位为秒，精度是毫秒。
> 
> $pipe如果请求是通过HTTP流水线(pipelined)发送，pipe值为“p”，否则为“.”。
> 
> $http\_referer 记录从哪个页面链接访问过来的
> 
> $http\_user\_agent记录客户端浏览器相关信息
> 
> $request\_length请求的长度（包括请求行，请求头和请求正文）。
> 
> $request\_time 请求处理时间，单位为秒，精度毫秒； 从读入客户端的第一个字节开始，直到把最后一个字符发送给客户端后进行日志写入为止。
> 
> $time\_iso8601 ISO8601标准格式下的本地时间。
> 
> $time\_local通用日志格式下的本地时间。

下面我们先加一个简单的日志：

![fd0292e26cc68e7ae555ffc933262f66.png][]

日志格式很简单，文件还是同样的日志文件，把原来的日志备份走，新建一个日志，从新打开日志，执行repon

![633304a5558aab3bf3fd4ae4c9e5c012.png][]

然后刷新两次页面，查看日志：

![9cba3a718e9ad66140a98be1788ff06e.png][]

可以看到日志里面只记录了ip地址，我们再把日志内容丰富一下：

> '$remote\_addr-$remote\_user-\[$time\_local\]-$request';

打印出ip，远程用户，时间，和访问地址，再次刷新查看日志：

![776a1f2dd964ac547f24377c1b3b88b9.png][]

再次丰富日志，打印请求状态，发送给用户的字节数，并记录从哪个页面访问过来的：

> log\_format main '$remote\_addr-$remote\_user-\[$time\_local\]-"$request"-$status-$body\_bytes\_sent-"$http\_referer"';

刷新页面，查看日志：

![1e9ff56c2d21ae21f4935f07b77baad9.png][]

再次丰富日志格式，记录客户端浏览器相关信息等：

> log\_format main '$remote\_addr-$remote\_user-\[$time\_local\]-"$request"-$status-$body\_bytes\_sent-"$http\_referer"-"$http\_user\_agent"-"$http\_x\_forwarded\_for"';

这个格式和默认的基本一样了，大家也应该都知道每个部分的含义了，刷新查看：

![578dc751a50fcd5d66c5a397be9d2b48.png][]

自己使用的时候，根据需求配置日志格式即可。

配置的时候，文件还可以根据网址命名，如：

> access\_log logs/$host.access.log main;

如果原来没有这个文件，那就需要创建，创建需要权限，要在整体配置文件的第一行加上

> user root;

![49cd912fcc9f22bc69255d1d0e0734a5.png][]

reopen一下，然后刷新页面，可以看到对应的网址的日志进入到了对应的日志文件中：

![6f028d141052aefa2c73a3d222552cd3.png][]

有的时候配置生成日志文件不成功是因为没有加上user root。上面再日志的格式上也加上了，日志文件中也会打印：

![7a9605a0f6d200c92be03c0e5ea7a107.png][]

我们把生成的日志文件删除，user root注释掉，这样肯定不会生成新日志文件，如果要从日志中查看原因，需要设置error日志，并设置为debug日志：

![5e1962661452b1068b7f702c465711c0.png][]

刷新并查看error日志：

![cda088341b6bbb4c6f39548302bd700c.png][]

日志中显示，我们并没有访问该域名日志文件的权限，因此failed，这样根据debug日志能很好的调试问题！

平时都这样error的日志量肯定很大，可以针对指定客户端，进行debug日志输出，

> events \{
> 
>         debug\_connection 192.168.1.100; 
> 
>         debug\_connection 192.168.168.128;
> 
> \}

这样其他客户端访问就不会打debug日志！

[330c289fc73f7569d93c0c210d84e896.png]: /images/20221123/cf21ecbd4b7a490399331668264068bb.png
[49ddfcb4a287e1ca555449c8e0079482.png]: /images/20221123/32c0454a1f6a4471bc599f48e4c66848.png
[315ed1c0779d8464d4534ef2bb8ec8c3.png]: /images/20221123/c223882c573642d8a3cd9576723621ba.png
[46832625a2f527c9347fc563e2acb9a4.png]: /images/20221123/ccc71cc38cb5416c8e9aa2411d6bdc7e.png
[ba4ff498469f38515fd2bde4463c12a0.png]: /images/20221123/d58d199533ac4e159223380b5912d19d.png
[35ffcf61a7455cbe155f012979039af7.png]: /images/20221123/35c97624d6f8435da01907dedf9a72fe.png
[3e6fc5f1c77b480e09a854c7ca8c0a36.png]: /images/20221123/139f138d7a0641168964544584d17f76.png
[d5ac60bee0569376a51ed9c18a6d7ddc.png]: /images/20221123/81843bb3cf544b429b29a0eb8c82e321.png
[0859a6c337bbbde31c59d23867abbac6.png]: /images/20221123/66f08d32eb944bac80f9957dc734e915.png
[e72f62976ca163257bd84f45dd15f49e.png]: /images/20221123/737575faa9f84504b479bba52787f5c1.png
[1b9f302535f4f4e7b48bcc2ae2ed9f1e.png]: /images/20221123/5b0276a44559405bb6932ff4dcf4f3bc.png
[890714ec684fda8327f3b0f09faf2bef.png]: /images/20221123/d54bc6572ee94cdc89737622aeb3be21.png
[b2837c6c898f7a8349c4bf38c85c64f0.png]: /images/20221123/ca55b52ba8b043208f5d4a9d6d33d45a.png
[27d730c0398e54d04ad761a4aac14b9b.png]: /images/20221123/a7bc027460e64245ad1df7d3a6cfdba4.png
[b8290dc559246729d3abc5daf234d091.png]: /images/20221123/e61f102f20b04b55838646bd00fc9d92.png
[45c78278a2c441ce3dd858b8b4f24904.png]: /images/20221123/31ca0b79750e431dbd309088ada4a195.png
[557b2130a3a7c22e957cd2720062a6b1.png]: /images/20221123/b58ff6f18994431ab6b41e8851e03f72.png
[e4d56c9a59819e70431013b3e014c4fe.png]: /images/20221123/74a66f53e9ba4986abc74be03f95018d.png
[df9f359b6392d3881f892365a5a2b7af.png]: /images/20221123/11a1f08475ee4a88bcaca7bac3772b25.png
[998ca898c1a23b6be670b66180a62e1a.png]: /images/20221123/51c9c5785a6e4521bc92fc65b8bbb3b9.png
[bd668c60ad0443d4d694f8dcfe3b2a4a.png]: /images/20221123/db7ef63e4d5e4492b77a95e2cf5e1774.png
[f45e49e89b115835225b54b4a7598407.png]: /images/20221123/9658a11639e0406391d18bca7554811a.png
[15d27d7aeaa384b06187dd5c02560f4e.png]: /images/20221123/d4dc7d1a8071413abdfeebb183174e23.png
[617599d6e39bb3be76f20c17953afc69.png]: /images/20221123/cceb66640e474682a15c770d22a9c01c.png
[eae931343ae9b372c92361e3473937e9.png]: /images/20221123/7b457f54c894472da3f876c2d142eb51.png
[c610954d0b47556a86cff3b3a9841062.png]: /images/20221123/6fc2fee8dea74962a0d2d7560b817947.png
[1b09c924cfb338b670cf7ea783cda8a8.png]: /images/20221123/0ec6b1b6a00c42f5bd2b15c527c4062c.png
[d34065393ee2e7ab4706dccc2bd52a44.png]: /images/20221123/b36e7c9ec17746d48767b87139736237.png
[8b560193d5cd1ea90be22582064c86a0.png]: /images/20221123/a6f4c350fd454f6ab6db13ca55b0ebb6.png
[db92a5cbddab6deebdd6b1f722dc43a4.png]: /images/20221123/64633955b1764b6997fbc7bec3b55f13.png
[a95f1512d893ad707bdfea7d95b6dd00.png]: /images/20221123/37ac7bd07e304964a67e3987bdcbfd3d.png
[c706d3c456c002ebf38dc7fa6ce80137.png]: /images/20221123/1870058a5b784263bccad1afdba062e2.png
[883dff2e19e82a626c19060406560209.png]: /images/20221123/c73d523f67644f408e50716d61a61af1.png
[ff5296397477e25a0b51d1e46040d1ae.png]: /images/20221123/e5c5810692144c8ca2f77f65bc069d0a.png
[1d3cf48b3777b7f6b81d6c650e2ea526.png]: /images/20221123/bd2d2519abb5440d85247ed91d82ff41.png
[74da5e2fbf0ea95dd7d67ac6d484a3d9.png]: /images/20221123/1f3c31aed55d4cee97857ef19ae192fd.png
[9134208365e2bfb669c6b473bcad1f58.png]: /images/20221123/7a39ecc855b5489d98a6ecb478488c7c.png
[82d55f2a8220ba9052307594b6883932.png]: /images/20221123/5955dc7e6b1143208311f3f3ce88f9c2.png
[2c9b85b8e46956edfa3bd51a9c404644.png]: /images/20221123/f9b95ccb7bab4d5f95264703fdcfa80c.png
[b2a58e97c39c6aabc3302bf0a9702a92.png]: /images/20221123/163af8b87e564f2cbd20f535bc28a423.png
[533c2d6837fb1dffd447c755ee55cd13.png]: /images/20221123/b74ab0103f6c49b18a92944566e6d890.png
[04aa212b19adf149685c1538912dd5f1.png]: /images/20221123/4ce80c7d89ce466da4ceffd34d3cb013.png
[f3fc584acd86837001b8c3f747c89ff9.png]: /images/20221123/624913f5de1248809a6fc0221e1be57d.png
[b85e67ce2d63d58ce61075ed432ff991.png]: /images/20221123/1588fed63c1a4ecca52fb1d42cc9c68b.png
[fd0292e26cc68e7ae555ffc933262f66.png]: /images/20221123/79c9c98399054dd5b7cf7ad0e046286a.png
[633304a5558aab3bf3fd4ae4c9e5c012.png]: /images/20221123/47c29bf60eff49279230f786f0df1489.png
[9cba3a718e9ad66140a98be1788ff06e.png]: /images/20221123/30ef117faa4248a39d69cb2a50fb9397.png
[776a1f2dd964ac547f24377c1b3b88b9.png]: /images/20221123/0cda354526554abeb44e6904d839a2d2.png
[1e9ff56c2d21ae21f4935f07b77baad9.png]: /images/20221123/3885c1c14dd04270a43083b835886d73.png
[578dc751a50fcd5d66c5a397be9d2b48.png]: /images/20221123/d079e09af53e432da6e2d935a9b0b5f1.png
[49cd912fcc9f22bc69255d1d0e0734a5.png]: /images/20221123/1593b738fcd449dcb28494aa0d1d2e85.png
[6f028d141052aefa2c73a3d222552cd3.png]: /images/20221123/2e182098730f41bd9b76d61966c8c44a.png
[7a9605a0f6d200c92be03c0e5ea7a107.png]: /images/20221123/f556734610274104985a42194824ba00.png
[5e1962661452b1068b7f702c465711c0.png]: /images/20221123/b2af47fd2e5e42938fbb3001017ef7cd.png
[cda088341b6bbb4c6f39548302bd700c.png]: /images/20221123/db7078e59bdd459790052262c2eea4ab.png