如果还没有编译和部署AKStream和ZLMediakit的可以看我之前的博文或者是相关项目的wiki说明文档。
#ZLMediaKit的配置文件
;;;;;;;;;;;;;;;;;!!!!此配置文件为范例配置文件,意在告诉读者,各个配置项的具体含义和作用,
;;;;;;;;;;;;;;;;;!!!!该配置文件在执行cmake时,会拷贝至release/${操作系统类型}/${编译类型}(例如release/linux/Debug) 文件夹。
;;;;;;;;;;;;;;;;;!!!!该文件夹(release/${操作系统类型}/${编译类型})同时也是可执行程序生成目标路径,在执行MediaServer进程时,它会默认加载同目录下的config.ini文件作为配置文件,
;;;;;;;;;;;;;;;;;!!!!你如果修改此范例配置文件(conf/config.ini),并不会被MediaServer进程加载,因为MediaServer进程默认加载的是release/${操作系统类型}/${编译类型}/config.ini。
;;;;;;;;;;;;;;;;;!!!!当然,你每次执行cmake,该文件确实会被拷贝至release/${操作系统类型}/${编译类型}/config.ini,
;;;;;;;;;;;;;;;;;!!!!但是一般建议你直接修改release/${操作系统类型}/${编译类型}/config.ini文件,修改此文件一般不起作用,除非你运行MediaServer时使用-c参数指定到此文件。
[api]
;;;;;;;;;;;;;;;;;是否调试http api,启用调试后,会打印每次http请求的内容和回复
apiDebug = 0
;;;;;;;;;;;;;;;;;一些比较敏感的http api在访问时需要提供secret,否则无权限调用
;;;;;;;;;;;;;;;;;如果是通过127.0.0.1访问,那么可以不提供secret
secret = 8725c73f7-bb6b-4889-a715-d9eb2d1923cc
;;;;;;;;;;;;;;;;;截图保存路径根目录,截图通过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 -vcodec copy -acodec copy -f flv -y %s
;;;;;;;;;;;;;;;;;FFmpeg生成截图的命令,可以通过修改该配置改变截图分辨率或质量
snap = %s -i %s -y -f mjpeg -t 0.001 %s
;;;;;;;;;;;;;;;;;FFmpeg日志的路径,如果置空则不生成FFmpeg日志
;;;;;;;;;;;;;;;;;可以为相对(相对于本可执行程序目录)或绝对路径
log = ./ffmpeg/ffmpeg.log
;;;;;;;;;;;;;;;;; 自动重启的时间(秒), 默认为0, 也就是不自动重启. 主要是为了避免长时间ffmpeg拉流导致的不同步现象
restart_sec = 0
[general]
;;;;;;;;;;;;;;;;;是否启用虚拟主机
enableVhost = 0
;;;;;;;;;;;;;;;;;播放器或推流器在断开后会触发hook.on_flow_report事件(使用多少流量事件),
;;;;;;;;;;;;;;;;;flowThreshold参数控制触发hook.on_flow_report事件阈值,使用流量超过该阈值后才触发,单位KB
flowThreshold = 0
;;;;;;;;;;;;;;;;;播放最多等待时间,单位毫秒
;;;;;;;;;;;;;;;;;播放在播放某个流时,如果该流不存在,
;;;;;;;;;;;;;;;;;ZLMediaKit会最多让播放器等待maxStreamWaitMS毫秒
;;;;;;;;;;;;;;;;;如果在这个时间内,该流注册成功,那么会立即返回播放器播放成功
;;;;;;;;;;;;;;;;;否则返回播放器未找到该流,该机制的目的是可以先播放再推流
maxStreamWaitMS = 15000
;;;;;;;;;;;;;;;;;某个流无人观看时,触发hook.on_stream_none_reader事件的最大等待时间,单位毫秒
;;;;;;;;;;;;;;;;;在配合hook.on_stream_none_reader事件时,可以做到无人观看自动停止拉流或停止接收推流
streamNoneReaderDelayMS = 20000
;;;;;;;;;;;;;;;;;是否全局添加静音aac音频,转协议时有效
;;;;;;;;;;;;;;;;;有些播放器在打开单视频流时不能秒开,添加静音音频可以加快秒开速度
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 = HKJFQHaAcVtFFtJC
;;;;;;;;;;;;;;;;;转协议是否全局开启或关闭音频
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
;;;;;;;;;;;;;;;;;最多等待未初始化的Track时间,单位毫秒,超时之后会忽略未初始化的Track
wait_track_ready_ms = 10000
;;;;;;;;;;;;;;;;;如果流只有单Track,最多等待若干毫秒,超时后未收到其他Track的数据,则认为是单Track
;;;;;;;;;;;;;;;;;如果协议元数据有声明特定track数,那么无此等待时间
wait_add_track_ms = 3000
;;;;;;;;;;;;;;;;;如果track未就绪,我们先缓存帧数据,但是有最大个数限制,防止内存溢出
unready_frame_cache = 100
;;;;;;;;;;;;;;;;;推流断开后可以在超时时间内重新连接上继续推流,这样播放器会接着播放。
;;;;;;;;;;;;;;;;;置0关闭此特性(推流断开会导致立即断开播放器)
;;;;;;;;;;;;;;;;;此参数不应大于播放器超时时间
continue_push_ms = 15000
[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]
enable = 1
on_flow_report = http://192.168.2.145:13000/MediaServer/WebHook/OnFlowReport
on_http_access =
on_play = http://192.168.2.145:13000/MediaServer/WebHook/OnPlay
on_publish = http://192.168.2.145:13000/MediaServer/WebHook/OnPublish
on_record_mp4 = http://192.168.2.145:13000/MediaServer/WebHook/OnRecordMp4
on_record_ts = http://192.168.2.145:13000/MediaServer/WebHook/OnRecordTs
on_rtsp_auth =
on_rtsp_realm =
on_shell_login = http://192.168.2.145:13000/MediaServer/WebHook/OnShellLogin
on_stream_changed = http://192.168.2.145:13000/MediaServer/WebHook/OnStreamChanged
on_stream_none_reader = http://192.168.2.145:13000/MediaServer/WebHook/OnStreamNoneReader
on_stream_not_found =
on_server_started =
timeoutSec = 20
[cluster]
;;;;;;;;;;;;;;;;;设置源站拉流url模板, 格式跟printf类似,第一个%s指定app,第二个%s指定stream_id,
;;;;;;;;;;;;;;;;;开启集群模式后,on_stream_not_found和on_stream_none_reader hook将无效.
;;;;;;;;;;;;;;;;;溯源模式支持以下类型:
;;;;;;;;;;;;;;;;;rtmp方式: rtmp://127.0.0.1:1935/%s/%s
;;;;;;;;;;;;;;;;;rtsp方式: rtsp://127.0.0.1:554/%s/%s
;;;;;;;;;;;;;;;;;hls方式: http://127.0.0.1:80/%s/%s/hls.m3u8
;;;;;;;;;;;;;;;;;http-ts方式: http://127.0.0.1:80/%s/%s.live.ts
;;;;;;;;;;;;;;;;;支持多个源站,不同源站通过分号(;)分隔
origin_url =
;;;;;;;;;;;;;;;;;溯源总超时时长,单位秒,float型;假如源站有3个,那么单次溯源超时时间为timeout_sec除以3
;;;;;;;;;;;;;;;;;单次溯源超时时间不要超过general.maxStreamWaitMS配置
timeout_sec = 15
[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 = 55000
;;;;;;;;;;;;;;;;;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 =
;;;;;;;;;;;;;;;;;禁止后缀的文件缓存,使用“,”隔开
;;;;;;;;;;;;;;;;;例如赋值为 .mp4,.flv
;;;;;;;;;;;;;;;;;那么访问后缀为.mp4与.flv 的文件不缓存
forbidCacheSuffix =
[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 = 120
;;;;;;;;;;;;;;;;;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 = 0
[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
;;;;;;;;;;;;;;;;;随机端口范围,最少确保36个端口
;;;;;;;;;;;;;;;;;该范围同时限制rtsp服务器udp端口范围
port_range = 33000-52000
[rtc]
;;;;;;;;;;;;;;;;;rtc播放推流、播放超时时间
timeoutSec = 15
;;;;;;;;;;;;;;;;;本机对rtc客户端的可见ip,作为服务器时一般为公网ip,置空时,会自动获取网卡ip
externIP = 117.141.154.39
;;;;;;;;;;;;;;;;;rtc udp服务器监听端口号,所有rtc客户端将通过该端口传输stun/dtls/srtp/srtcp数据,
;;;;;;;;;;;;;;;;;该端口是多线程的,同时支持客户端网络切换导致的连接迁移
;;;;;;;;;;;;;;;;;需要注意的是,如果服务器在nat内,需要做端口映射时,必须确保外网映射端口跟该端口一致
port = 8000
;;;;;;;;;;;;;;;;;设置remb比特率,非0时关闭twcc并开启remb。该设置在rtc推流时有效,可以控制推流画质
;;;;;;;;;;;;;;;;;目前已经实现twcc自动调整码率,关闭remb根据真实网络状况调整码率
rembBitRate = 0
;;;;;;;;;;;;;;;;;rtc支持的音频codec类型,在前面的优先级更高
;;;;;;;;;;;;;;;;;以下范例为所有支持的音频codec
preferredCodecA = PCMU,PCMA,opus,mpeg4-generic
;;;;;;;;;;;;;;;;;rtc支持的视频codec类型,在前面的优先级更高
;;;;;;;;;;;;;;;;;以下范例为所有支持的视频codec
preferredCodecV = H264,H265,AV1X,VP9,VP8
[rtsp]
;;;;;;;;;;;;;;;;;rtsp专有鉴权方式是采用base64还是md5方式
authBasic = 0
;;;;;;;;;;;;;;;;;rtsp拉流、推流代理是否是直接代理模式
;;;;;;;;;;;;;;;;;直接代理后支持任意编码格式,但是会导致GOP缓存无法定位到I帧,可能会导致开播花屏
;;;;;;;;;;;;;;;;;并且如果是tcp方式拉流,如果rtp大于mtu会导致无法使用udp方式代理
;;;;;;;;;;;;;;;;;假定您的拉流源地址不是264或265或AAC,那么你可以使用直接代理的方式来支持rtsp代理
;;;;;;;;;;;;;;;;;如果你是rtsp推拉流,但是webrtc播放,也建议关闭直接代理模式,
;;;;;;;;;;;;;;;;;因为直接代理时,rtp中可能没有sps pps,会导致webrtc无法播放; 另外webrtc也不支持Single NAL Unit Packets类型rtp
;;;;;;;;;;;;;;;;;默认开启rtsp直接代理,rtmp由于没有这些问题,是强制开启直接代理的
directProxy = 1
;;;;;;;;;;;;;;;;;rtsp必须在此时间内完成握手,否则服务器会断开链接,单位秒
handshakeSecond = 15
;;;;;;;;;;;;;;;;;rtsp超时时间,如果该时间内未收到客户端的数据,
;;;;;;;;;;;;;;;;;或者tcp发送缓存超过这个时间,则会断开连接,单位秒
keepAliveSecond = 15
;;;;;;;;;;;;;;;;;rtsp服务器监听地址
port = 554
;;;;;;;;;;;;;;;;;rtsps服务器监听地址
sslport = 0
[shell]
;;;;;;;;;;;;;;;;;调试telnet服务器接受最大bufffer大小
maxReqSize = 1024
;;;;;;;;;;;;;;;;;调试telnet服务器监听端口
port = 0
[ffmpeg_templete]
rtsp_tcp2flv = %s -re -rtsp_transport tcp -i %s -vcodec copy -acodec copy -f flv -y %s
ffmpeg2flv = %s -re -i %s -vcodec copy -acodec copy -f flv -y %s
ffmpeg -re -i 1.mp4 -vcodec libx264 -bf 0 -acodec pcm_mulaw -ar 8000 -ac 1 -f flv -y rtmp://yourserverip/live/livestream/test?secret=8725c73f7-bb6b-4889-a715-d9eb2d1923cc
#其中secret是你MediaServer的token,换成你的即可
ffplay rtmp://yourserverip/live/livestream/test?secret=8725c73f7-bb6b-4889-a715-d9eb2d1923cc