Nginx的11个phases

最新推荐文章于 2024-02-19 11:17:25 发布

星河_赵梓宇

最新推荐文章于 2024-02-19 11:17:25 发布

阅读量451

点赞数

文章标签： Nginx

原文链接：https://gitee.com/miazzy/lua-nginx-redis/blob/master/Nginx/nginx-phases.md

版权

Nginx的11个phases

一个请求经过nginx处理的过程中，会经过一系列的阶段（phases），下面这个表格列出了nginx的所有phases，每个阶段可选的退出方式，包含的模块和对应的指令

Phases	modules / directives	description
NGX_HTTP_POST_READ_PHASE	HttpRealIpModule	读取请求内容阶段
NGX_HTTP_SERVER_REWRITE_PHASE Location ( server rewrite )	HttpRewriteModule rewrite	请求地址重写阶段
NGX_HTTP_FIND_CONFIG_PHASE Location ( location selection )	HttpCoreModule location	配置查找阶段
NGX_HTTP_REWRITE_PHASE Location ( location rewrite )	HttpLuaModule set_by_lua、rewrite_by_lua	请求地址重写阶段
NGX_HTTP_POST_REWRITE_PHASE	不注册其他模块	请求地址重写提交阶段
NGX_HTTP_PREACCESS_PHASE ( location selection )	degradation NginxHttpLimitZoneModule / limit_zone HttpLimitReqModule / limit req	访问权限检查准备阶段
NGX_HTTP_ACCESS_PHASE	HttpAccessModule allow, deny NginxHttpAuthBasicModule HttpLuaModule access_by_lua	访问权限检查阶段
NGX_HTTP_POST_ACCESS_PHASE	该指令可以用于控制access阶段的指令彼此之间的协作方式	访问权限检查提交阶段
NGX_HTTP_TRY_FILES_PHASE	HttpCoreModule try_files	配置项try_files处理阶段
NGX_HTTP_CONTENT_PHASE	HttpProxyModule / proxy HttpLuaModule / content_by_lua HttpCoreModule / proxy_pass HttpFcgiModule / FastCGI	内容产生阶段
NGX_HTTP_TRY_FILES_PHASE	HttpLogModuel / access_log	日志模块处理阶段

各个phase说明
- (1) post read phase
  
  post-read 属于 rewrite阶段
  
  post-read 支持Nginx模块的钩子
  
  内置模块 ngx_realip 把它的处理程序post-read分阶段挂起，强制重写请求的原始地址作为特定请求头的值
```
server {
    listen 8080;

    set_real_ip_from 127.0.0.1;
    real_ip_header   X-My-IP;

    location /test {
        set $addr $remote_addr;
        echo "from: $addr";
    }
}
```
  该配置告诉Nginx强制将每个请求的原始地址重写127.0.0.1为请求头的值X-My-IP。同时它使用内置变量 $remote_addr来输出请求的原始地址
```
$ curl -H 'X-My-IP: 1.2.3.4' localhost:8080/test
from: 1.2.3.4
```
  curl 参数 -H ：自定义头信息传递给服务器
  
  该选项X-My-IP: 1.2.3.4在请求中包含一个额外的HTTP头
  
  测试结果
```
$ curl localhost:8080/test
from: 127.0.0.1

$ curl -H 'X-My-IP: abc' localhost:8080/test
from: 127.0.0.1
``
```
- server_rewrite phase
  
  这个阶段主要进行初始化全局变量，或者server级别的重写。如果把重写指令放到 server 中，那么就进入了server rewrite 阶段。（重写指令见rewrite phase）
  
  ( 1 ) server-rewrite 阶段运行时间早于 rewrite 阶段
```
location /tinywan {
            set $bbb "$aaa, world";
            echo $bbb;
}
set $aaa "HELLO";
```
  set $a hello 声明被放在server指令中，所以它运行在server-rewrite阶段
  
  因此 set $b "$a, world'" ，在location指令中执行 set 指令后，它将获得正确的$a值
  
  执行结果
```
# curl http://127.0.0.2:8008/tinywan
HELLO, world
```
  ( 2 ) post-read 阶段阶段运行时间早于 server-rewrite 阶段执行
```
server {
    listen 8080;

    set $addr $remote_addr;

    set_real_ip_from 127.0.0.1;
    real_ip_header   X-Real-IP;

    location /test {
        echo "from: $addr";
    }
}
```
  ( 3 ) ngx_realip 阶段阶段运行时间早于 server 的 set 指令 阶段执行
```
$ curl -H 'X-Real-IP: 1.2.3.4' localhost:8080/test
from: 1.2.3.4
```
  服务器指令中的命令集始终比模块ngx_realip晚，
  
  ( 4 ) server-rewrite 阶段阶段运行时间早于 find-config 阶段执行
- find config phase
  
  ( 5 ) find-config 阶段阶段运行时间早于 rewrite 阶段执行
  
  这个阶段使用重写之后的uri来查找对应的location，值得注意的是该阶段可能会被执行多次，因为也可能有location级别的重写指令。这个阶段并不支持 Nginx 模块注册处理程序，而是由 Nginx 核心来完成当前请求与 location 配置块之间的配对工作
- rewrite phase：
  
  如果把重写指令放到 location中，那么就进入了rewrite phase，这个阶段是location级别的uri重写阶段，重写指令也可能会被执行多次
  
  有HttpRewriteModule 的set指令、rewrite指令
  
  HttpLuaModule的 set_by_lua指令,
  
  ngx_set_misc模块的set_unescape_uri指令
  
  另外HttpRewriteModule的几乎所有指令都属于rewrite阶段。
结论：作用域为同一个phase的不同modules的指令，如果modules之间做了特殊的兼容，则它们按照指令在配置文件中出现的顺序依次执行下来
HttpLuaModule 模块指令
- init_by_lua
  
  在nginx重新加载配置文件时，运行里面lua脚本，常用于全局变量的申请。例如lua_shared_dict共享内存的申请，只有当nginx重起后，共享内存数据才清空，这常用于统计。
- set_by_lua
  
  设置一个变量，常用与计算一个逻辑，然后返回结果,该阶段不能运行Output API、Control API、Subrequest API、Cosocket API
- rewrite_by_lua
  
  在access阶段前运行，主要用于rewrite
- access_by_lua
  
  主要用于访问控制，能收集到大部分变量，类似status需要在log阶段才有。这条指令运行于nginx access阶段的末尾，因此总是在 allow 和 deny 这样的指令之后运行，虽然它们同属 access 阶段。
- content_by_lua
  
  阶段是所有请求处理阶段中最为重要的一个，运行在这个阶段的配置指令一般都肩负着生成内容（content）并输出HTTP响应。
- header_filter_by_lua
  
  一般只用于设置Cookie和Headers等,该阶段不能运行Output API、Control API、Subrequest API、Cosocket API
- body_filter_by_lua
  
  一般会在一次请求中被调用多次, 因为这是实现基于 HTTP 1.1 chunked 编码的所谓“流式输出”的,该阶段不能运行Output API、Control API、Subrequest API、Cosocket API
- log_by_lua
  
  该阶段总是运行在请求结束的时候，用于请求的后续操作，如在共享内存中进行统计数据,如果要高精确的数据统计，应该使用body_filter_by_lua
--with-http_realip_module 模块
- set_real_ip_from 192.168.1.0/24; 指定接收来自哪个前端发送的 IP head 可以是单个IP或者IP段
- set_real_ip_from 192.168.2.1;
- real_ip_header X-Real-IP; IP head 的对应参数，默认即可。