nginx的11个phases

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

• 各个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 的对应参数，默认即可。