nginxrtmp编译

‘壹’ 编译nginx错误nginx.exe : fatal error LNK1120: 3 个无法解析的外部命令

OpenGL作业进行中，突然发现一直提示默认返回类型出错，发现是C++的前向声明问题。好吧，解决完这个问题发现有有些看不懂的字符解析问题出现，提示如下所示：
>AccountDlg.obj : error LNK2001: 无法解析的外部符号 "protected: virtual struct AFXMSGMAP const * _thiscall CglQuaternion75::CglQuaternion75(CglQuaternion75 &)const " (?GetMessageMap@CAccountDlg@@MBEPBUAFX_MSGMAP@@XZ) 1>E:\code\OpenGL\Debug\example.exe : fatal error LNK1120: 1 个无法解析的外部命令
乍一眼不知道错在哪里...等会儿再看，还是不知道错在哪里，网上一搜明白了。
出现这种问题的典型原因一般是：文件中有相应函数的定义，却没有相应函数的实现部分。即有了声明，却没有实现的定义部分。
在上面报错信息中，重要的是
__thiscall CglQuaternion75::CglQuaternion75(CglQuaternion75 &)
这一部分，通过这部分就能确定出错的函数部分究竟在哪里，定位了之后进行修改就顺利了许多。
于是点到声明部分右键转到定义部分，果然没有反应，于是立马加上漏掉的拷贝构造函数，好的解决了。
自己在完后jsoncpp的过程中出现了上面的错误，原因在于没有将函数名字前面加上类：：。这让其只是一个外部函数，因此在类对象调用的时候总是出现上面的错误。

‘贰’ nginx-rtmp模块简介

1:  Mole Configuration Struct(s)模块配置结构

这个结构的命名规则为ngx_http_[mole-name]_[main|srv|loc]_conf_t。

main,srv,loc表示这个模块的作用范围是配置文件中的main/server/location三种范围（这个需要记住，后面会经常用到）

2: Mole Directives模块命令结构

static ngx_command_t ngx_http_echo_commands[] = {

{

ngx_string("echo"), //命令名字

NGX_HTTP_LOC_CONF|NGX_CONF_TAKE1, //代表是local配置，带一个参数

ngx_http_echo, //组装模块配置结构

NGX_HTTP_LOC_CONF_OFFSET, //上面的组装模块配置获取完参数后存放到 哪里？使用这个和下面的offset参数来进行定位

offsetof(ngx_http_echo_loc_conf_t, ed), //同上 

},

ngx_null_command //必须使用ngx_null_command作为commands的结束标记

};

3: The Mole Context模块内容

static ngx_http_mole_t   ngx_http_circle_gif_mod ule_ctx

主要是定义了一些钩子函数, nginx会在不同时期会调用

4: The Mole Definition模块整合

ngx_mole_t ngx_http_<mole name>_mole = {

NGX_MODULE_V1,

&ngx_http__mole_ctx, /* mole context模块内容 */

ngx_http__commands, /* mole directives模块命令*/

NGX_HTTP_MODULE, /* mole type模块类型，HTTP模块，或者HTTPS*/

5: Mole Installation模块安装

1: ngx_rtmp_live_mole

直播模块:推拉流同点, 不涉及回源

2: ngx_rtmp_relay_mole

中继模块:  1:回源pull  2: 转推: push

一:  建立rtmp连接, 需要握手

      1: ngx_rtmp_handshake_recv()开始握手

      2: NGX_RTMP_HANDSHAKE_DONE()握手完成

      3: ngx_rtmp_cycle()重新设置读写handler

二:  建立网络连接

    建立rtmp连接之后, ngx_rtmp_recv函数会利用ngx_event_t结构会获取推送过来的原始数据, 接受到的数据会存放到ngx_rtmp_stream_t的in链表结构中.

1:接受chunk数据

2:分析处理chunk数据, 如果message还没接受完, 继续接受数据

3:将chunk组成一个rtmp message, 然后交给ngx_rtmp_receive_message处理, 这个函数根据消息的类型找对应的handle

三:  建立网络流

        在建立网络连接后,就需要建立网络流了, 网络流代表了发送多媒体数据的通道. 服务器和客户端只能建立一个网络连接, 且多个网络流可以复用这一个网络连接

1: ngx_rtmp_recv接受数据后交给ngx_rtmp_receive_handler, 它会根据类型区别处理, 此时客户端发送ngx_rtmp_msg_chunk_size类型的消息

2:接受message后跳转到处理函数ngx_rtmp_amf_message_handler. 处理客户端发送的amf控制消息. 此时连续接受3个amf数据.

3:调用ngx_rtmp_cmd_create_stream_init初始化网络流. 利用ngx_rtmp_receive_amf获取接受的amf数据.

4:调用ngx_rtmp_cmd_create_stream创建网络流, 利用ngx_rtmp_send_amf向客户端发送amf控制消息

四:  传输媒体数据

在客户端和服务端建立网络流之后,接下来就可以传输媒体数据了, 一般来讲, 媒体数据分为两部分, 一部分为meta元信息, 另一部分是音视频数据, 首先传送的是meta元信息. 然后推送媒体. 服务器处理如下:

1:从客户端接受amf命令信息, 然后服务端会利用ngx_rtmp_cmd_publish_init来初始化发布环境.  函数功能: 会读取刚接受端amf信息

2:利用ngx_rtmp_auto_push_publish, ngx_rtmp_notify_publish, ngx_rtmp_exec_publish建立发布环境,

3:如果conf配置了record命令记录媒体文件, 此时会调用ngx_rtmp_record_publish来初始化记录环境;

4:执行ngx_rtmp_access_publish;

[if !supportLists]l [endif]meta信息:

5:接受客户端amf, 并调用ngx_rtmp_codec_meta_data获取meta元信息;

6:结合服务器的参数, 利用ngx_rtmp_codec_reconstruct_meta接口重构meta元信息, 并调用ngx_rtmp_prepare_message组成消息保存

[if !supportLists]l [endif]媒体数据:

7:接受客户端推送, 根据类型转到ngx_rtmp_codec_av来处理音视频数据; 其中利用函数ngx_rtmp_codec_parse_avc_header来处理头部信息

8:调用record模块记录数据, 接口为ngx_rtmp_codec_av;

9:调用live模块来广播发布数据, 接口为ngx_rtmp_live_av, 广播到所有观察者, 第一次调用接口ngx_rtmp_live_start创建广播, 之后直接调用ngx_rtmp_append_shared-bufs

 

rtmp 的 信令交互图:

1: 播放器端发起play

2: ngx_rtmp_relay_play()

3: ngx_rtmp_relay_pull() --主要建立pull请求, 将远程拉流的上下文和本地上下文放到链表中

    ngx_rtmp_relay_create_local_ctx()创建本地上下文

    ngx_rtmp_relay_create_remote_ctx()创建远端上下文

4: ngx_rtmp_relay_create_remote_ctx详解:  创建远端session, 开始rtmp信令交互

       1: ngx_rtmp_relay_create_connection  

        2: ngx_rtmp_init_session

注意:此时session中的flashver为“ngx-local-relay“

5: rtmp信令交互流程

核心函数: ngx_rtmp_relay_on_result主要用来接收对端服务端发送的amf消息包，而后按正常rtmp协议请求进行下一步交互，这个主要是当前服务端做为客户端发起远程rtmp请求流程

例如:   ngx_rtmp_client_handshake(发起握手)

         握手完成后调用回调函数: ngx_rtmp_relay_handshake_done

       ngx_rtmp_relay_send_connect:发起连接请求, 接着参考rtmp信令交互图

        核心功能:向nginx推送一个直播流，该直播流经 nginx-rtmp 的 ngx_rtmp_live_mole 模块转发给 application live 应用，然后使用vlc连接 live，播放该直播流。本质上就是1对多的广播

参考: http://nginx.org/en/docs/debugging_log.html

1: Nginx-rtmp-mole模块源码学习

https://blog.evanxia.com/2017/02/1264

2: nginx_rtmp_relay_mole模块解读

https://www.shangmayuan.com/a/d74b78669f804fb5b12cae5a.html

3:开发手册中文版:包含指令介绍

https://blog.csdn.net/ai2000ai/article/details/55517992

‘叁’ 使用nginx-rtmp-mole 部署了一个rtmp服务， 但是推流地址只有一个，我如何才能有多个推流地址

建议使用WebRTC方式，多路推流服务器能行吗？

‘肆’ centos 使用yum安装nginx后如何添加模块

1.确认你已经安装在用的nginx信息

nginx-V

#停掉nginx服务
servicenginxstop
#进入解压的nginx-1.10.3目录
cdnginx-1.10.3
#编译./configure后面加上第1步nginx-V查看到的所有配置参数,后面加上你要加的模块配置
./configure--prefix=/etc/nginx--sbin-path=/usr/sbin/nginx...（太长我省略了）--add-mole=/root/nginx-rtmp-mole-1.1.10
make
千万别makeinstall
验证新nginx是否可用验证编译后的nginx是否可以使用已有的配置
./objs/nginx-t
使用新nginx
备份cp/usr/sbin/nginx/usr/sbin/nginx-bak
替换cp./objs/nginx/usr/sbin/nginx

ok了,重启nginx
servicenginxstart
祝你成功！

‘伍’ 如何 编译 ngx

一、必要软件准备
1.安装pcre

为了支持rewrite功能，我们需要安装pcre

复制代码代码如下:
# yum install pcre* //如过你已经装了，请跳过这一步

2.安装openssl
需要ssl的支持，如果不需要ssl支持，请跳过这一步

复制代码代码如下:
# yum install openssl*

3.gzip 类库安装

复制代码代码如下:
yum install zlib zlib-devel

4.安装wget
下载nginx使用,如果已经安装，跳过这一步

复制代码代码如下:
# yum install wget

二、安装nginx

1.下载

复制代码代码如下:
wget http://nginx.org/download/nginx-1.7.0.tar.gz

2.解压

复制代码代码如下:

tar -zxvf nginx-1.7.0.tar.gz

3.编译和安装
执行如下命令：

复制代码代码如下:

# cd nginx-1.7.0
# ./configure --prefix=/usr/local/nginx-1.7.0 \
--with-http_ssl_mole --with-http_spdy_mole \
--with-http_stub_status_mole --with-pcre

–with-http_stub_status_mole：支持nginx状态查询
–with-http_ssl_mole：支持https
–with-http_spdy_mole：支持google的spdy,想了解请网络spdy,这个必须有ssl的支持
–with-pcre：为了支持rewrite重写功能，必须制定pcre

最后输出如下内容，表示configure OK了。

复制代码代码如下:

checking for zlib library ... found
creating objs/Makefile
Configuration summary
+ using system PCRE library
+ using system OpenSSL library
+ md5: using OpenSSL library
+ sha1: using OpenSSL library
+ using system zlib library
nginx path prefix: "/usr/local/nginx-1.7.0"
nginx binary file: "/usr/local/nginx-1.7.0/sbin/nginx"
nginx configuration prefix: "/usr/local/nginx-1.7.0/conf"
nginx configuration file: "/usr/local/nginx-1.7.0/conf/nginx.conf"
nginx pid file: "/usr/local/nginx-1.7.0/logs/nginx.pid"
nginx error log file: "/usr/local/nginx-1.7.0/logs/error.log"
nginx http access log file: "/usr/local/nginx-1.7.0/logs/access.log"
nginx http client request body temporary files: "client_body_temp"
nginx http proxy temporary files: "proxy_temp"
nginx http fastcgi temporary files: "fastcgi_temp"
nginx http uwsgi temporary files: "uwsgi_temp"
nginx http scgi temporary files: "scgi_temp"
# make //确定你的服务器有安装make，如果没有安装请执行yum install make

# make install

三、启动、关闭、重置nginx
启动：直接执行以下命令,nginx就启动了,不需要改任何配置文件,nginx配置多域名虚拟主机请参考后续文章.

复制代码代码如下:
/usr/local/nginx-1.7.0/sbin/nginx

试试访问：直接使用curl命令来读取web信息

复制代码代码如下:

[root@ns conf]
# curl -s http://localhost | grep nginx.com
nginx.com.

关闭：

复制代码代码如下:
/usr/local/nginx-1.7.0/sbin/nginx -s stop

重置：当你有修改配置文件的时候，只需要reload以下即可

复制代码代码如下:
/usr/local/nginx-1.7.0/sbin/nginx -s reload

整个nginx的安装就到这里结束了。

四、nginx编译参数详解

复制代码代码如下:

–prefix= 指向安装目录
–sbin-path 指向（执行）程序文件（nginx）
–conf-path= 指向配置文件（nginx.conf）
–error-log-path= 指向错误日志目录
–pid-path= 指向pid文件（nginx.pid）
–lock-path= 指向lock文件（nginx.lock）（安装文件锁定，防止安装文件被别人利用，或自己误操作。）
–user= 指定程序运行时的非特权用户
–group= 指定程序运行时的非特权用户组
–builddir= 指向编译目录
–with-rtsig_mole 启用rtsig模块支持（实时信号）
–with-select_mole 启用select模块支持（一种轮询模式,不推荐在高载环境下使用）禁用：–without-select_mole
–with-poll_mole 启用poll模块支持（功能与select相同，与select特性相同，为一种轮询模式,不推荐在高载环境下使用）
–with-file-aio 启用file aio支持（一种APL文件传输格式）
–with-ipv6 启用ipv6支持
–with-http_ssl_mole 启用ngx_http_ssl_mole支持（使支持https请求，需已安装openssl）
–with-http_realip_mole 启用ngx_http_realip_mole支持（这个模块允许从请求标头更改客户端的IP地址值，默认为关）
–with-http_addition_mole 启用ngx_http_addition_mole支持（作为一个输出过滤器，支持不完全缓冲，分部分响应请求）
–with-http_xslt_mole 启用ngx_http_xslt_mole支持（过滤转换XML请求）
–with-http_image_filter_mole 启用ngx_http_image_filter_mole支持（传输JPEG/GIF/PNG 图片的一个过滤器）（默认为不启用。gd库要用到）
–with-http_geoip_mole 启用ngx_http_geoip_mole支持（该模块创建基于与MaxMind GeoIP二进制文件相配的客户端IP地址的ngx_http_geoip_mole变量）
–with-http_sub_mole 启用ngx_http_sub_mole支持（允许用一些其他文本替换nginx响应中的一些文本）
–with-http_dav_mole 启用ngx_http_dav_mole支持（增加PUT,DELETE,MKCOL：创建集合,COPY和MOVE方法）默认情况下为关闭，需编译开启
–with-http_flv_mole 启用ngx_http_flv_mole支持（提供寻求内存使用基于时间的偏移量文件）
–with-http_gzip_static_mole 启用ngx_http_gzip_static_mole支持（在线实时压缩输出数据流）
–with-http_random_index_mole 启用ngx_http_random_index_mole支持（从目录中随机挑选一个目录索引）
–with-http_secure_link_mole 启用ngx_http_secure_link_mole支持（计算和检查要求所需的安全链接网址）
–with-http_degradation_mole 启用ngx_http_degradation_mole支持（允许在内存不足的情况下返回204或444码）
–with-http_stub_status_mole 启用ngx_http_stub_status_mole支持（获取nginx自上次启动以来的工作状态）
–without-http_charset_mole 禁用ngx_http_charset_mole支持（重新编码web页面，但只能是一个方向–服务器端到客户端，并且只有一个字节的编码可以被重新编码）
–without-http_gzip_mole 禁用ngx_http_gzip_mole支持（该模块同-with-http_gzip_static_mole功能一样）
–without-http_ssi_mole 禁用ngx_http_ssi_mole支持（该模块提供了一个在输入端处理处理服务器包含文件（SSI）的过滤器，目前支持SSI命令的列表是不完整的）
–without-http_userid_mole 禁用ngx_http_userid_mole支持（该模块用来处理用来确定客户端后续请求的cookies）
–without-http_access_mole 禁用ngx_http_access_mole支持（该模块提供了一个简单的基于主机的访问控制。允许/拒绝基于ip地址）
–without-http_auth_basic_mole禁用ngx_http_auth_basic_mole（该模块是可以使用用户名和密码基于http基本认证方法来保护你的站点或其部分内容）
–without-http_autoindex_mole 禁用disable ngx_http_autoindex_mole支持（该模块用于自动生成目录列表，只在ngx_http_index_mole模块未找到索引文件时发出请求。）
–without-http_geo_mole 禁用ngx_http_geo_mole支持（创建一些变量，其值依赖于客户端的IP地址）
–without-http_map_mole 禁用ngx_http_map_mole支持（使用任意的键/值对设置配置变量）
–without-http_split_clients_mole 禁用ngx_http_split_clients_mole支持（该模块用来基于某些条件划分用户。条件如：ip地址、报头、cookies等等）
–without-http_referer_mole 禁用disable ngx_http_referer_mole支持（该模块用来过滤请求，拒绝报头中Referer值不正确的请求）
–without-http_rewrite_mole 禁用ngx_http_rewrite_mole支持（该模块允许使用正则表达式改变URI，并且根据变量来转向以及选择配置。如果在server级别设置该选项，那么他们将在 location之前生效。如果在location还有更进一步的重写规则，location部分的规则依然会被执行。如果这个URI重写是因为location部分的规则造成的，那么 location部分会再次被执行作为新的URI。 这个循环会执行10次，然后Nginx会返回一个500错误。）
–without-http_proxy_mole 禁用ngx_http_proxy_mole支持（有关代理服务器）
–without-http_fastcgi_mole 禁用ngx_http_fastcgi_mole支持（该模块允许Nginx 与FastCGI 进程交互，并通过传递参数来控制FastCGI 进程工作。 ）FastCGI一个常驻型的公共网关接口。
–without-http_uwsgi_mole 禁用ngx_http_uwsgi_mole支持（该模块用来医用uwsgi协议，uWSGI服务器相关）
–without-http_scgi_mole 禁用ngx_http_scgi_mole支持（该模块用来启用SCGI协议支持，SCGI协议是CGI协议的替代。它是一种应用程序与HTTP服务接口标准。它有些像FastCGI但他的设计 更容易实现。）
–without-http_memcached_mole 禁用ngx_http_memcached_mole支持（该模块用来提供简单的缓存，以提高系统效率）
-without-http_limit_zone_mole 禁用ngx_http_limit_zone_mole支持（该模块可以针对条件，进行会话的并发连接数控制）
–without-http_limit_req_mole 禁用ngx_http_limit_req_mole支持（该模块允许你对于一个地址进行请求数量的限制用一个给定的session或一个特定的事件）
–without-http_empty_gif_mole 禁用ngx_http_empty_gif_mole支持（该模块在内存中常驻了一个1*1的透明GIF图像，可以被非常快速的调用）
–without-http_browser_mole 禁用ngx_http_browser_mole支持（该模块用来创建依赖于请求报头的值。如果浏览器为modern ，则$modern_browser等于modern_browser_value指令分配的值；如 果浏览器为old，则$ancient_browser等于 ancient_browser_value指令分配的值；如果浏览器为 MSIE中的任意版本，则 $msie等于1）
–without-http_upstream_ip_hash_mole 禁用ngx_http_upstream_ip_hash_mole支持（该模块用于简单的负载均衡）
–with-http_perl_mole 启用ngx_http_perl_mole支持（该模块使nginx可以直接使用perl或通过ssi调用perl）
–with-perl_moles_path= 设定perl模块路径
–with-perl= 设定perl库文件路径
–http-log-path= 设定access log路径
–http-client-body-temp-path= 设定http客户端请求临时文件路径
–http-proxy-temp-path= 设定http代理临时文件路径
–http-fastcgi-temp-path= 设定http fastcgi临时文件路径
–http-uwsgi-temp-path= 设定http uwsgi临时文件路径
–http-scgi-temp-path= 设定http scgi临时文件路径
-without-http 禁用http server功能
–without-http-cache 禁用http cache功能
–with-mail 启用POP3/IMAP4/SMTP代理模块支持
–with-mail_ssl_mole 启用ngx_mail_ssl_mole支持
–without-mail_pop3_mole 禁用pop3协议（POP3即邮局协议的第3个版本,它是规定个人计算机如何连接到互联网上的邮件服务器进行收发邮件的协议。是因特网电子邮件的第一个离线协议标 准,POP3协议允许用户从服务器上把邮件存储到本地主机上,同时根据客户端的操作删除或保存在邮件服务器上的邮件。POP3协议是TCP/IP协议族中的一员，主要用于 支持使用客户端远程管理在服务器上的电子邮件）
–without-mail_imap_mole 禁用imap协议（一种邮件获取协议。它的主要作用是邮件客户端可以通过这种协议从邮件服务器上获取邮件的信息，下载邮件等。IMAP协议运行在TCP/IP协议之上， 使用的端口是143。它与POP3协议的主要区别是用户可以不用把所有的邮件全部下载，可以通过客户端直接对服务器上的邮件进行操作。）
–without-mail_smtp_mole 禁用smtp协议（SMTP即简单邮件传输协议,它是一组用于由源地址到目的地址传送邮件的规则，由它来控制信件的中转方式。SMTP协议属于TCP/IP协议族，它帮助每台计算机在发送或中转信件时找到下一个目的地。）
–with-google_perftools_mole 启用ngx_google_perftools_mole支持（调试用，剖析程序性能瓶颈）
–with-cpp_test_mole 启用ngx_cpp_test_mole支持
–add-mole= 启用外部模块支持
–with-cc= 指向C编译器路径
–with-cpp= 指向C预处理路径
–with-cc-opt= 设置C编译器参数（PCRE库，需要指定–with-cc-opt=”-I /usr/local/include”，如果使用select()函数则需要同时增加文件描述符数量，可以通过–with-cc- opt=”-D FD_SETSIZE=2048”指定。）
–with-ld-opt= 设置连接文件参数。（PCRE库，需要指定–with-ld-opt=”-L /usr/local/lib”。）
–with-cpu-opt= 指定编译的CPU，可用的值为: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64
–without-pcre 禁用pcre库
–with-pcre 启用pcre库
–with-pcre= 指向pcre库文件目录
–with-pcre-opt= 在编译时为pcre库设置附加参数
–with-md5= 指向md5库文件目录（消息摘要算法第五版，用以提供消息的完整性保护）
–with-md5-opt= 在编译时为md5库设置附加参数
–with-md5-asm 使用md5汇编源
–with-sha1= 指向sha1库目录（数字签名算法，主要用于数字签名）
–with-sha1-opt= 在编译时为sha1库设置附加参数
–with-sha1-asm 使用sha1汇编源
–with-zlib= 指向zlib库目录
–with-zlib-opt= 在编译时为zlib设置附加参数
–with-zlib-asm= 为指定的CPU使用zlib汇编源进行优化，CPU类型为pentium, pentiumpro
–with-libatomic 为原子内存的更新操作的实现提供一个架构
–with-libatomic= 指向libatomic_ops安装目录
–with-openssl= 指向openssl安装目录
–with-openssl-opt 在编译时为openssl设置附加参数
–with-debug 启用debug日志

‘陆’ centos 使用yum安装nginx后如何添加模块

【操作步骤】

1. 确认你已经安装在用的nginx信息

   

   ‘柒’ 在nginx.conf中加入rtmp后nginx启动不了

   1）正确编译和安装：网页链接

   2）安装完成后，键入 nginx -V 命令查看（无法找到命令的话，请使用绝对路径访问 nginx 可执行文件）

   

   正常编译安装情况

   应当出现类似 --add-mole=nginx-rtmp-mole 字样

   3）问题依旧可以尝试：

   1. 移除旧安装目录下文件（rm -rf /usr/local/nginx）

   2. 清楚编译产生的文件（make clean）

   3. 使用正确的选项重新编译安装

   4. 问题还在？尝试换个 nginx 版本，再重复上述步骤

   ‘捌’ nginx编译安装需要哪些库

   如果有网的情况，不用管这些。进入你的nginx文件夹，进行以下操作：
   通常至少需要以下库：
   pcre(正则) , gcc(C编译器) , net-tools(使用netstat命令)。
   一般有了上述的库就能完成编译，如果还不行，运行
   ./configure --prefix=你希望安装到的目录
   命令，最下方提示error少了什么库，你就 yum -y install 库名（错误的提示里面）就可以自动下载安装了。

   ‘玖’ nginx rtmp 什么时候产生m3u8

   nginx rtmp 什么时候产生m3u8
   参考下面方法 jwplayer("mediaplayer").setup({ playlist: [{ sources: [{ file: 'rtmp://' + path + '/' + name },{ file: 'http://' + path + '/' + name // 这里可以写m3u8的url。 }] }], height: 360, primary: "flash", width: 640 });
   jwplayer("mediaplayer").setup({ playlist: [{ sources: [{ file: 'rtmp://' + path + '/' + name },{ file: 'http://' + path + '/' + name // 这里可以写m3u8的url。 }] }], height: 360, primary: "flash", width: 640 });