nginx开发第一个helloworld.

jolley — Tue, 10 May 2016 00:25:00 GMT

Nginx开发第三方模块实例

Ø 序言

Nginx是一个极具扩展性的服务器,这显著体现在对第三方模块的支持，开发者能够将自己开发的模块，按照nginx既有的规则，完美地融合进http框架中，以实现开发者定制功能的作用。

这篇文章主要用于结合如何开发一个简单的第三方模块，目标人群为想了解nginx开发第三方模块的同学，文章内容主要包括三个部分，如何将HTTP模块嵌入nginx和如何开发第三方模块以及一个例子。

Ø 如何将HTTP模块嵌入nginx

Nginx目前来说提供了二种方式,config文件+configure 脚本，手动方式，后面手动方式是更加复杂的，且容易出错，在常规的nginx开发中，基本上都是用config文件+configure脚本方式比较多。接下来分别介绍这两种方式。

1) Config文件+configure脚本

l Config文件

这个是指提供config文件，并且在文件里面给出三个配置项，就可以达到效果。这三个配置项是指：

A. Ngx_addon_name：就是自己要开发的这个模块名字。

B. Nginx模块名：这有点像设置环境变量啥的，首先要知道自己开发啥模块，nginx对应的模块有，$HTTP_MODULES(常规的http模块), $HTTP_FILTER_MODULES(HTTP过滤模块)，$HTTP_HEAD_FILTER_MODULES(HTTP 头部过滤模块)， $CORE_MODULES(nginx的核心模块)，$EVENT_MODULES(nginx的事件模块)等，然后在后面添加你所要添加的模块名字，以空格隔开，比如这次我们开发添加的模块:

HTTP_MODULES = “$HTTP_MODULES ngx_http_helloworld_module”

C. NGX_ADDON_SRCS：这个顾名思义，就是指定新添加文件的路径，不过这个都是相对路径，因为在configure的时候就指定了上层路径，比如--add-modules=PATH。

比如我们这次开发要添加的源文件：

NGX_ADDON_SRCS = “$NGX_ADDON_SRCS $ngx_addon_dir/ngx_http_helloworld_module.c”

l Configure脚本

这里需要用- -add-module=PATH将第三方模块的路径加入，

比如configure - -add-module=~/ngx_3^rd_modules/

那我们能分析下这背后做了什么呢？我们从下面两个部分来展开说明

a) Auto/modules

这个主要是说明将定制的第三方模块添加到生成的ngx_modules.c里面。

a) 指定模块下面的配置文件.

b) 生成模块信息

一、生成模块数组

根据需要开启的模块加载对应的模块,下面是开启http模块后的所需要的模块

二、生成ngx_modules.c文件

b) Auto/make

显而易见，这个就是负责编译相关的模块。

1) 生成第三方源码

2) 生成链接代码，并将目标文件，库文件链接成二进制程序

2) 手动方式

分两步来做，第一，修改obj/ngx_modules.c, 在里面增加对应的第三方模块，第二，修改obj/Makefile,在里面增加第三方模块的编译，这种直接修改的方法不太可取，易出错，一般都是用上面的第二种方法。

Ø 开发第三方模块注意事项

首先,要确定针对那个模块进行开发，nginx的模块是有顺序性的，比如： HTTP_MODULES = “$HTTP_MODULES ngx_http_helloworld_module”

其次，因为nginx是异步非阻塞的，在编制代码时，一定要注意不能阻塞nginx进程.

Ø 示例

见附件/Files/jolleydtan/test.zip

参考：

深入理解nginx.

jolley 2016-05-10 08:25 发表评论

nginx tcp负载均衡

jolley — Fri, 11 Mar 2016 00:44:00 GMT

现在nginx的版本已经到了1.9.12，不过在1.9.0的时候，就开始了对TCP代理服务器的支持。
之前也有一些早期的做法，比如就有写了nginx_tcp_module模块的https://github.com/yaoweibin/nginx_tcp_proxy_module,
以及nginx_stream_lua模块的
https://github.com/openresty/stream-lua-nginx-module
本来就想着用这两个的，后来发现已经有支持了，就先来试试看看这个了。
默认的话，nginx是没有开启对tcp的支持的.如果要支持的话，需要用--with-stream去指定。
我这边只要需要三个IP，一个是nginx进程所在的机器，我这边用192.168.1.4表示，
另外两台就是TCP上游业务服务器，我们分别用192.168.1.5和192.168.1.21来表示，
基于这样的考虑是因为nginx充当tcp代理服务器后，自身也会占用一个端口。
并且从目前来说，貌似一个nginx进程也就只能listen一个端口。
我用的版本是nginx 1.9.9.
我在/usr/local/nginx/conf下面新建了nginx_stream_tcp.conf作为本次的测试。
worker_processes auto;
2 error_log /usr/local/nginx/logs/error.log info;
3 events {
4     worker_connections 1024;
5 }
6
7 stream {
8     upstream loadbalance {
9 # Specifies a load balancing method for a server group where client-server mapping is based on the hashed key value
10         hash $remote_addr consistent;
11 # sets the weight of the server, by default, 1.
12         server 192.168.1.21:8001 weight=5;
13 # by default, the parameter is set to 10 seconds.
14         server 192.168.1.5:9001 max_fails=3 fail_timeout=30s;
15
16
17     }
18
19 server {
20 # listen 8001.
21         listen 8001;
22 # Defines a timeout for establishing a connection with a proxied server.
23         proxy_connect_timeout 1s;
24 # Sets the timeout between two successive read or write operations on client or proxied server connections
25         proxy_timeout 3s;
26 # Sets the address of a proxied server
27         proxy_pass loadbalance;
28     }
29
30 }
这个大部分是官网支持的，所以其实我也没有修改太多，就设置了几个IP和端口。
在编译好nginx后，可以用/usr/local/nginx/sbin/nginx -c /usr/local/nginx/conf/nginx_stream_tcp.conf
就可以起来了，可以通过netstat -tlnp查看是否起来，大致显示这样的：
tcp        0      0 0.0.0.0:8001            0.0.0.0:*               LISTEN      7744/nginx_stream_t
当然也可以通过telnet来查看。
接下来，写个简单的cs程序来验证下吧.

server端：
if __name__ == '__main__':
import socket
import commands
sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
sock.bind(('192.168.1.21', 8001))
sock.listen(5)
while True:
  connection,address = sock.accept()
  print "connected by",address
  while 1:

    buf = connection.recv(1024)
    if buf != "" :
     print "connection buffer", buf
     connection.sendall(buf)
connection.close()

client端：
if __name__ == '__main__':
    import socket
    HOST='192.168.1.4'
    PORT=8001
    sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
    sock.connect((HOST, PORT))
    while 1:
        cmd = raw_input("please input cmd:")
        sock.sendall(cmd)
        data = sock.recv(1024)
        print data
    sock.close()

在client向192.168.1.4发起一个TCP连接时，接下来192.168.1.4会连接到192.168.1.21，

192.168.1.21的server端会显示， connected by ('192.168.1.4',58559)
后面的端口应该是随机的临时端口。
其实它的确起到了转发作用，这个nginx进程相当于一个通用网关，如果有两个client向nginx进程发起连接，一旦nginx那边调度到同一个上游TCP服务器，那么只需要从NGINX进程建立一个TCP连接到上游TCP服务器即可。
之前我自己设计网关的时候，不是依赖于用户的，而是通过静态配置来建立连接的，比如上游逻辑服务器跟网关有连接，那都是在启动服务器的时候，就建立起来了。
这样有个好处就是可以省事，不过也可以采用这种方式，有玩家连接进某个上游TCP服务器才让网关跟这个TCP服务器建立连接，否则无需处理。因为不少时候还是会有不少服务器处于空闲的.

jolley 2016-03-11 08:44 发表评论

C++博客-concentrate on c/c++ related technology-随笔分类-nginx

nginx开发第一个helloworld.

nginx tcp负载均衡