你真的清楚 Nginx 指令的规则吗?
我们已经了解了 Nginx 的基本命令和架构原理,下面该到最让人头疼也是最不容易理解的部分了,那就是 nginx.conf 这个配置文件,下面从 Nginx 的指令开始,一步步来讲解 Nginx 的配置。
Nginx 指令
先来看一个典型的 Nginx 配置文件示例。
从上面可以看到,这个配置文件中包含了多个指令块,有些指令块还是重复的,那么这在 Nginx 中是一个什么样的规则?接下来会慢慢介绍。
指令块的嵌套
在 Nginx 配置文件中,指令块是可以互相嵌套的,例如上面的示例,http 块中可以包含多个 server 块,server 块中还会包含多个 location 块,每一个块中都有相应的指令。
而每一个指令都有 Context 上下文,也就是生效的环境,这在 Nginx 的官方文档中说的很清楚,例如下面的两条指令,Context 中都表明了各自可以生效的环境,access_log 指令可以在多个上下文中生效:
指令的合并
在 Nginx 中,指令分为两种,一种是值指令,一种是动作类指令:
值指令:存储配置项的值,是用来配置某一个配置项的
- 可以合并
- 示例
- root
- access_log
- gzip
动作类指令:指定行为动作,往往表示接下来要做一件事情
- 不可以合并
- 示例
- rewrit
- proxy_pass
- 生效阶段
- server_rewrite 阶段
- rewrite 阶段
- content 阶段
这里面的示例以及生效阶段,后面都还会详细讲,这里可以不用过多关注,既然指令分为两种,那么就有不同的继承规则,下面就来说一下。
值指令的继承规则
例如下面的配置文件,这里面在 server 块和 location 块中都配置了 root 指令,Nginx 的继承规则如下:
子配置不存在时,直接使用父配置块的指令
子配置存在时,覆盖父配置块
根据上面这两条规则,第一个 location 使用自家的 root 指令,后面两个 location 则使用 server 块的 root 指令。这和编程语言中变量的作用域也是类似的,作用域更小的变量优先级往往更高,Nginx 的指令也是一样。
文档中没有的指令如何判断生效范围
对于很多第三方模块,很可能文档并不完善,这时候需要通过源码来查看指令的生效范围。需要明确下面几个问题:
指令在哪个块下生效?
指令允许出现在哪些块下?
这两个问题是在源码中定义的,例如:
从上面第三行可以看到,variables_hash_max_size
指令是在 main 块下生效的。
还会有两个回调方法:
在 server 块生效,从 http 向 server 合并
- char *(*merge_srv_conf)(ngx_conf_t*cf, void *prev, void *conf);
向 location 合并
- char *(*merge_loc_conf)(ngx_conf_t*cf, void *prev, void *conf);
例如:
ngx_http_module_t
这个结构体里面,定义了很多回调方法,最后一个 ngx_http_core_merge_loc_conf
方法,就是制定合并规则的。这个方法定义了两个参数,一个是父配置,一个是子配置:
这个方法表明了从父配置向子配置合并。
listen 指令的用法
listen 指令在 server 块中生效,用来配置监听哪些端口,由这些端口来处理请求。listen 指令的配置如下:
如示例所示,listen 指令可以监听的类型有多种,可以配置监听地址和端口,也可以是仅地址和仅端口,还可以仅监听 IPv6 等等。
究竟是哪个 server 来处理请求
server_name 指令的用法
一个指令:server_name
servername 指令是用来配置究竟是哪个 server 来处理我们的请求的。有时候,一个 servername 中可能会有多个域名,这时候是如何选择的呢?
server_name 指令后可以跟多个域名,第一个是主域名,多个域名之间空格分隔
泛域名:仅支持在最前或最后加 *,例如:
server_name *.taohui.tech
正则表达式匹配:
server_name www.taohui.tech ~^www\d+\.taohui\.tech$;
当 servername 指令后有多个域名时,会有一个 servername_in_redirect 的配置,这个配置默认关闭,它使用来控制域名重定向的,也就是这个配置开启之后,请求过来会重定向到主域名访问。
还可以用正则表达式创建变量
特殊的配置规则
- .test.tech 可以匹配 test.tech *.test.tech
- _ 匹配所有域名请求
- "" 匹配没有传递 host 头部的请求
server 匹配的顺序
精确匹配(与顺序无关)
* 在前的泛域名(与顺序无关)
* 在后的泛域名(与顺序无关)
按文件中的顺序匹配正则表达式域名
default server
- 第 1 个
- listen 指定 default
这里面 default server 有两种指定方式,假如没有配置 default server,那么第一个 server 块就会成为 default server,如果 listen 中配置了 default,那么就会由配置的块进行处理。
本文是我学习Nginx 核心知识 100 讲的笔记,首发地址:https://iziyang.github.io
版权声明: 本文为 InfoQ 作者【子杨】的原创文章。
原文链接:【http://xie.infoq.cn/article/e8b0720627de7c912990b8974】。文章转载请联系作者。
评论