开源媒体服务器： ZlMediaKit

刺骨的言语ヽ痛彻心扉 2023-10-12 22:05 47阅读 0赞

##### 部署环境 #####

*  操作系统： centos el7
 *  IP ： 10.1.200.48
 *  User： root
 *  Password: 1

##### 安装编译过程： #####

1.  查看操作系统版本，centos6和centos7不一样的方式进行不一样的编译过程
2.      $$ uname -r 或 uname -a
3.  如果是ubuntu直接使用ap-get按照wiki安装即可，这里以centos el7为例。
4.  由于zlmediakit使用的cxx11，官方说明是4.8以上的gcc即可,但是不同版本的centos使用4.8的gcc会出现各式各样不一样的问题，所以推荐使用5.4.0的gcc编译链。
    
     *  依赖于ffmpeg进行转码以及推拉流
     *  依赖于x264库进行H264/AVC的编码格式的编解码。（注：zlmedia支持H265编码格式，虽然一般情况下H265的视频关键帧大小为H264的1/3,但是由于不同设备厂商对于H265的实现不一样，所以可能出现兼容性问题。）
     *  依赖于openssl进行rtmp以及相关协议的握手
     *  新版本的zlmedia支持webrtc。
5.  安装依赖：
    
     *  查看gcc版本： `gcc -v`, 如果版本不高，则需要更新gcc版本，大约一两个小时。
     *  先编译安装x264，openssl，否则编译出来的ffmpeg无法进行264的推拉流和编解码。
     *  编译过程：
        
            # 拉代码
            git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit
            # ！必须进行，初始化所需要的子模块
            git submodule update --init
            # 进入目录预编译
            ./configure
            # 编译
            make -j8
            # 运行
            cd release/linux 
            ./MediaServer
     *  配置
        
            [api]
            #是否调试http api,启用调试后，会打印每次http请求的内容和回复
            apiDebug=1
            #一些比较敏感的http api在访问时需要提供secret，否则无权限调用
            #如果是通过127.0.0.1访问,那么可以不提供secret
            secret=035c73f7-bb6b-4889-a715-d9eb2d1925cc
            #截图保存路径根目录，截图通过http api(/index/api/getSnap)生成和获取
            snapRoot=./www/snap/
            #默认截图图片，在启动FFmpeg截图后但是截图还未生成时，可以返回默认的预设图片
            defaultSnap=./www/logo.png
            
            [ffmpeg]
            #FFmpeg可执行程序绝对路径
            bin=/usr/bin/ffmpeg
            #FFmpeg拉流再推流的命令模板，通过该模板可以设置再编码的一些参数
            cmd=%s -re -i %s -c:a aac -strict -2 -ar 44100 -ab 48k -c:v libx264 -f flv %s
            #FFmpeg生成截图的命令，可以通过修改该配置改变截图分辨率或质量
            snap=%s -i %s -y -f mjpeg -t 0.001 %s
            #FFmpeg日志的路径，如果置空则不生成FFmpeg日志
            #可以为相对(相对于本可执行程序目录)或绝对路径
            log=./ffmpeg/ffmpeg.log
            
            [general]
            #是否启用虚拟主机
            enableVhost=0
            #播放器或推流器在断开后会触发hook.on_flow_report事件(使用多少流量事件)，
            #flowThreshold参数控制触发hook.on_flow_report事件阈值，使用流量超过该阈值后才触发，单位KB
            flowThreshold=1024
            #播放最多等待时间，单位毫秒
            #播放在播放某个流时，如果该流不存在，
            #ZLMediaKit会最多让播放器等待maxStreamWaitMS毫秒
            #如果在这个时间内，该流注册成功，那么会立即返回播放器播放成功
            #否则返回播放器未找到该流，该机制的目的是可以先播放再推流
            maxStreamWaitMS=15000
            #某个流无人观看时，触发hook.on_stream_none_reader事件的最大等待时间，单位毫秒
            #在配合hook.on_stream_none_reader事件时，可以做到无人观看自动停止拉流或停止接收推流
            streamNoneReaderDelayMS=20000
            #拉流代理是否添加静音音频(直接拉流模式本协议无效)
            addMuteAudio=1
            #拉流代理时如果断流再重连成功是否删除前一次的媒体流数据，如果删除将重新开始，
            #如果不删除将会接着上一次的数据继续写(录制hls/mp4时会继续在前一个文件后面写)
            resetWhenRePlay=1
            #是否默认推流时转换成hls，hook接口(on_publish)中可以覆盖该设置
            publishToHls=1
            #是否默认推流时mp4录像，hook接口(on_publish)中可以覆盖该设置
            publishToMP4=0
            #合并写缓存大小(单位毫秒)，合并写指服务器缓存一定的数据后才会一次性写入socket，这样能提高性能，但是会提高延时
            #开启后会同时关闭TCP_NODELAY并开启MSG_MORE
            mergeWriteMS=0
            #全局的时间戳覆盖开关，在转协议时，对frame进行时间戳覆盖
            #该开关对rtsp/rtmp/rtp推流、rtsp/rtmp/hls拉流代理转协议时生效
            #会直接影响rtsp/rtmp/hls/mp4/flv等协议的时间戳
            #同协议情况下不影响(例如rtsp/rtmp推流，那么播放rtsp/rtmp时不会影响时间戳)
            modifyStamp=0
            #服务器唯一id，用于触发hook时区别是哪台服务器
            mediaServerId=your_server_id
            #转协议是否全局开启或关闭音频
            enable_audio=1
            
            ###### 以下是按需转协议的开关，在测试ZLMediaKit的接收推流性能时，请把下面开关置1
            ###### 如果某种协议你用不到，你可以把以下开关置1以便节省资源(但是还是可以播放，只是第一个播放者体验稍微差点)，
            ###### 如果某种协议你想获取最好的用户体验，请置0(第一个播放者可以秒开，且不花屏)
            
            #hls协议是否按需生成，如果hls.segNum配置为0(意味着hls录制)，那么hls将一直生成(不管此开关)
            hls_demand=0
            #rtsp[s]协议是否按需生成
            rtsp_demand=0
            #rtmp[s]、http[s]-flv、ws[s]-flv协议是否按需生成
            rtmp_demand=0
            #http[s]-ts协议是否按需生成
            ts_demand=0
            #http[s]-fmp4、ws[s]-fmp4协议是否按需生成
            fmp4_demand=0
            
            [hls]
            #hls写文件的buf大小，调整参数可以提高文件io性能
            fileBufSize=65536
            #hls保存文件路径
            #可以为相对(相对于本可执行程序目录)或绝对路径
            filePath=./www
            #hls最大切片时间
            segDur=2
            #m3u8索引中,hls保留切片个数(实际保留切片个数大2~3个)
            #如果设置为0，则不删除切片，而是保存为点播
            segNum=3
            #HLS切片从m3u8文件中移除后，继续保留在磁盘上的个数
            segRetain=5
            #是否广播 ts 切片完成通知
            broadcastRecordTs=0
            #直播hls文件删除延时，单位秒，issue: #913
            deleteDelaySec=0
            
            [hook]
            #在推流时，如果url参数匹对admin_params，那么可以不经过hook鉴权直接推流成功，播放时亦然
            #该配置项的目的是为了开发者自己调试测试，该参数暴露后会有泄露隐私的安全隐患
            admin_params=secret=035c73f7-bb6b-4889-a715-d9eb2d1925cc
            #是否启用hook事件，启用后，推拉流都将进行鉴权
            enable=0
            #播放器或推流器使用流量事件，置空则关闭
            on_flow_report=https://127.0.0.1/index/hook/on_flow_report
            #访问http文件鉴权事件，置空则关闭鉴权
            on_http_access=https://127.0.0.1/index/hook/on_http_access
            #播放鉴权事件，置空则关闭鉴权
            on_play=https://127.0.0.1/index/hook/on_play
            #推流鉴权事件，置空则关闭鉴权
            on_publish=https://127.0.0.1/index/hook/on_publish
            #录制mp4切片完成事件
            on_record_mp4=https://127.0.0.1/index/hook/on_record_mp4
            # 录制 hls ts 切片完成事件
            on_record_ts=https://127.0.0.1/index/hook/on_record_ts
            #rtsp播放鉴权事件，此事件中比对rtsp的用户名密码
            on_rtsp_auth=https://127.0.0.1/index/hook/on_rtsp_auth
            #rtsp播放是否开启专属鉴权事件，置空则关闭rtsp鉴权。rtsp播放鉴权还支持url方式鉴权
            #建议开发者统一采用url参数方式鉴权，rtsp用户名密码鉴权一般在设备上用的比较多
            #开启rtsp专属鉴权后，将不再触发on_play鉴权事件
            on_rtsp_realm=https://127.0.0.1/index/hook/on_rtsp_realm
            #远程telnet调试鉴权事件
            on_shell_login=https://127.0.0.1/index/hook/on_shell_login
            #直播流注册或注销事件
            on_stream_changed=https://127.0.0.1/index/hook/on_stream_changed
            #无人观看流事件，通过该事件，可以选择是否关闭无人观看的流。配合general.streamNoneReaderDelayMS选项一起使用
            on_stream_none_reader=https://127.0.0.1/index/hook/on_stream_none_reader
            #播放时，未找到流事件，通过配合hook.on_stream_none_reader事件可以完成按需拉流
            on_stream_not_found=https://127.0.0.1/index/hook/on_stream_not_found
            #服务器启动报告，可以用于服务器的崩溃重启事件监听
            on_server_started=https://127.0.0.1/index/hook/on_server_started
            #server保活上报
            on_server_keepalive=https://127.0.0.1/index/hook/on_server_keepalive
            #hook api最大等待回复时间，单位秒
            timeoutSec=10
            #keepalive hook触发间隔,单位秒，float类型
            alive_interval=10.0
            
            [http]
            #http服务器字符编码，windows上默认gb2312
            charSet=utf-8
            #http链接超时时间
            keepAliveSecond=30
            #http请求体最大字节数，如果post的body太大，则不适合缓存body在内存
            maxReqSize=40960
            #404网页内容，用户可以自定义404网页
            #notFound=<html><head><title>404 Not Found</title></head><body bgcolor="white"><center><h1>您访问的资源不存在！</h1></center><hr><center>ZLMediaKit-4.0</center></body></html>
            #http服务器监听端口
            port=80
            #http文件服务器根目录
            #可以为相对(相对于本可执行程序目录)或绝对路径
            rootPath=./www
            #http文件服务器读文件缓存大小，单位BYTE，调整该参数可以优化文件io性能
            sendBufSize=65536
            #https服务器监听端口
            sslport=443
            #是否显示文件夹菜单，开启后可以浏览文件夹
            dirMenu=1
            #虚拟目录, 虚拟目录名和文件路径使用","隔开，多个配置路径间用";"隔开
            #例如赋值为 app_a,/path/to/a;app_b,/path/to/b 那么
            #访问 http://127.0.0.1/app_a/file_a 对应的文件路径为 /path/to/a/file_a
            #访问 http://127.0.0.1/app_b/file_b 对应的文件路径为 /path/to/b/file_b
            #访问其他http路径,对应的文件路径还是在rootPath内
            virtualPath=
            
            [multicast]
            #rtp组播截止组播ip地址
            addrMax=239.255.255.255
            #rtp组播起始组播ip地址
            addrMin=239.0.0.0
            #组播udp ttl
            udpTTL=64
            
            [record]
            #mp4录制或mp4点播的应用名，通过限制应用名，可以防止随意点播
            #点播的文件必须放置在此文件夹下
            appName=record
            #mp4录制写文件缓存，单位BYTE,调整参数可以提高文件io性能
            fileBufSize=65536
            #mp4录制保存、mp4点播根路径
            #可以为相对(相对于本可执行程序目录)或绝对路径
            filePath=./www
            #mp4录制切片时间，单位秒
            fileSecond=3600
            #mp4点播每次流化数据量，单位毫秒，
            #减少该值可以让点播数据发送量更平滑，增大该值则更节省cpu资源
            sampleMS=500
            #mp4录制完成后是否进行二次关键帧索引写入头部
            fastStart=0
            #MP4点播(rtsp/rtmp/http-flv/ws-flv)是否循环播放文件
            fileRepeat=0
            
            [rtmp]
            #rtmp必须在此时间内完成握手，否则服务器会断开链接，单位秒
            handshakeSecond=15
            #rtmp超时时间，如果该时间内未收到客户端的数据，
            #或者tcp发送缓存超过这个时间，则会断开连接，单位秒
            keepAliveSecond=15
            #在接收rtmp推流时，是否重新生成时间戳(很多推流器的时间戳着实很烂)
            modifyStamp=0
            #rtmp服务器监听端口
            port=1935
            #rtmps服务器监听地址
            sslport=19350
            
            [rtp]
            #音频mtu大小，该参数限制rtp最大字节数，推荐不要超过1400
            #加大该值会明显增加直播延时
            audioMtuSize=600
            #视频mtu大小，该参数限制rtp最大字节数，推荐不要超过1400
            videoMtuSize=1400
            #rtp包最大长度限制，单位KB,主要用于识别TCP上下文破坏时，获取到错误的rtp
            rtpMaxSize=10
            
            [rtp_proxy]
            #导出调试数据(包括rtp/ps/h264)至该目录,置空则关闭数据导出
            dumpDir=
            #udp和tcp代理服务器，支持rtp(必须是ts或ps类型)代理
            port=10000
            #rtp超时时间，单位秒
            timeoutSec=15
            
            [rtc]
            #rtc播放推流、播放超时时间
            timeoutSec=15
            #本机对rtc客户端的可见ip，作为服务器时一般为公网ip，置空时，会自动获取网卡ip
            externIP=
            #设置remb比特率，非0时关闭twcc并开启remb。该设置在rtc推流时有效，可以控制推流画质
            rembBitRate=1000000
            
            [rtsp]
            #rtsp专有鉴权方式是采用base64还是md5方式
            authBasic=0
            #rtsp拉流、推流代理是否是直接代理模式
            #直接代理后支持任意编码格式，但是会导致GOP缓存无法定位到I帧，可能会导致开播花屏
            #并且如果是tcp方式拉流，如果rtp大于mtu会导致无法使用udp方式代理
            #假定您的拉流源地址不是264或265或AAC，那么你可以使用直接代理的方式来支持rtsp代理
            #如果你是rtsp推拉流，但是rtc播放，也建议关闭直接代理模式，
            #因为直接代理时，rtp中可能没有sps pps,会导致rtc无法播放
            #默认开启rtsp直接代理，rtmp由于没有这些问题，是强制开启直接代理的
            directProxy=1
            #rtsp必须在此时间内完成握手，否则服务器会断开链接，单位秒
            handshakeSecond=15
            #rtsp超时时间，如果该时间内未收到客户端的数据，
            #或者tcp发送缓存超过这个时间，则会断开连接，单位秒
            keepAliveSecond=15
            #rtsp服务器监听地址
            port=554
            #rtsps服务器监听地址
            sslport=322
            
            [shell]
            #调试telnet服务器接受最大bufffer大小
            maxReqSize=1024
            #调试telnet服务器监听端口
            port=9090