Nginx Upstream模块源码分析（上）

Upstream模块是一个很重要的模块，很多其他模块都会使用它来完成对后端服务器的访问，

达到反向代理和负载均衡的效果。例如Fastcgi、Memcached、SessionSticky等。

如果自己实现这部分功能，采用传统的实现方式，很可能会阻塞Nginx降低其性能，因为Nginx是全异步非阻塞的。

所以要想不破坏其优美的架构，就得按照其规范实现很多回调函数，注册这些钩子到Nginx的处理流程中。

下面以一个使用Upstream模块的第三方模块SessionSticky为例，分析一下Upstream模块的执行流程。

---

一、配置解析

每个模块的入口变量ngx_module_t中，都需要指明：

     一个ngx_command_t数组表示模块可以解析的配置；

     一个module_ctx上下文，注册初始化和合并配置时的回调函数；

     一个解析配置的函数；

Upstream模块的ngx_command_t数组的配置如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49

static  ngx_command_t  ngx_http_upstream_commands[] = {        { ngx_string( "upstream" ),        NGX_HTTP_MAIN_CONF|NGX_CONF_BLOCK|NGX_CONF_TAKE1,        ngx_http_upstream,        0,        0,        NULL },        { ngx_string( "server" ),        NGX_HTTP_UPS_CONF|NGX_CONF_1MORE,        ngx_http_upstream_server,        NGX_HTTP_SRV_CONF_OFFSET,        0,        NULL },          ngx_null_command };     static  ngx_http_module_t  ngx_http_upstream_module_ctx = {      ngx_http_upstream_add_variables,        /* preconfiguration */      NULL,                                   /* postconfiguration */        ngx_http_upstream_create_main_conf,     /* create main configuration */      ngx_http_upstream_init_main_conf,       /* init main configuration */        NULL,                                   /* create server configuration */      NULL,                                   /* merge server configuration */        NULL,                                   /* create location configuration */      NULL                                    /* merge location configuration */ };     ngx_module_t  ngx_http_upstream_module = {      NGX_MODULE_V1,      &ngx_http_upstream_module_ctx,          /* module context */      ngx_http_upstream_commands,             /* module directives */      NGX_HTTP_MODULE,                        /* module type */      NULL,                                   /* init master */      NULL,                                   /* init module */      NULL,                                   /* init process */      NULL,                                   /* init thread */      NULL,                                   /* exit thread */      NULL,                                   /* exit process */      NULL,                                   /* exit master */      NGX_MODULE_V1_PADDING };

1）配置项

从上面的配置可知，Upstream模块可以解析http内的upstream块和块内的server。配置项含义如下，

Nginx就是靠这些选项帮助它找到能解析当前配置的模块：

• NGX_CONF_TAKE1：配置指令接受1个参数。

• NGX_CONF_1MORE：配置指令接受至少一个参数。

• NGX_CONF_BLOCK：配置指令可以接受的值是一个配置信息块。也就是一对大括号括起来的内容。里面可以再包括很多的配置指令。比如常见的server指令就是这个属性的。

• NGX_HTTP_MAIN_CONF: 可以直接出现在http配置指令里。

• NGX_HTTP_UPS_CONF: 可以出现在http里面的upstream配置指令里。

2）初始化函数

初始化函数的工作很简单，create函数中为配置分配空间，init函数中会调用peer的init_stream()，

这是Upstream与使用它的模块的第一次交互。其他模块就是通过注册各种回调函数，加入到Upstream处理的生命周期的。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73