ZLMediaKit 是啥？
ZLMediaKit是国人开发的开源C++流媒体服务器，同SRS一样是主流的流媒体服务器。
ZLToolKit是基于C++11的高性能服务器框架，和ZLMediaKit是同一个作者，ZLMediaKit正是使用该框架开发的。
官网
ZLMediaKit开源地址：https://github.com/ZLMediaKit/ZLMediaKit
ZLToolKit开源地址：https://github.com/ZLMediaKit/ZLToolKit
国内登陆github非常不稳定，如下是ZLMediaKit对应的gitee 网址
ZLMediaKit: 实现RTSP/RTMP/HLS/HTTP协议的轻量级流媒体框架，支持大并发连接请求
ZLMediaKit源码分析的一篇文章
原文链接：https://blog.csdn.net/weixin_40355471/article/details/135422631
1.如何使用 ZLMediaKit 搭建RTSP 服务器
1.国内⽤户推荐从同步镜像⽹站gitee下载源码
git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit.git
cd ZLMediaKit
# 千万不要忘记执⾏这句命令
git submodule update --init
强烈建议使⽤ubuntu16或更新版本编译ZLMediaKit，macOS是次选推荐平台，最不推
荐的是centos6.*或windows平台。
本地实验会在 ubuntu上实现。相关截图放在后面
2.编译相关
2.1 编译器版本要求
ZLMediaKit采⽤了C++11的语法和库，要求编译器⽀持完整的C++11标准，亦即：
linux上要求gcc 版本 >= 4.8(4.7应该也能⽀持)
macOS上clang >= ???（我也不知道，估计⼤部分不会遇到这个问题）
windows 上visual stuido >= 2015(vs2013某些版本也能编译通过，如果怕麻烦建议直接vs2017)
在ubuntu上查看g++版本
g++ --version
2.2 安装编译器
如果你是debian系操作系统(包括ubuntu系⽤户)，⼀般⾃带的gcc版本够新，你可以这样安装gcc编译 器：
sudo apt-get install build-essential
你正在尝试在Ubuntu或其他基于Debian的Linux发行版上安装
build-essential包。 build-essential是一个包含编译软件所需要的基本包集合的元包。它会安装GCC、G++、Make等基本工具，这些工具是编译大部分源代码所必需的
2.3 安装cmake
ZLMediaKit采⽤cmake来构建项⽬，通过cmake才能⽣成Makefile(或Xcode/VS⼯程)，所以必须先安装 cmake才能完成后续步骤。
如果你是debian系操作系统(包括ubuntu系⽤户)，⼀般⾃带的cmake版本够新，你可以这样安装
cmake
sudo apt-get install cmake
2.4 依赖库
2.4.1 依赖库列表
ZLMediaKit可选依赖⼀些第三⽅库，这些库都不是必选的；在构建ZLMediaKit时，cmake能查找系统路 径中的这些库，并根据安装情况选择是否开启相关特性，你可以选择安装这些依赖并启⽤相关特性：
openssl
flash player在播放rtmp时，采⽤的是复杂握⼿模式，如果不安装该库，flash player将播放不了
zlmediakit 提供的rtmp url. 同时ZLMediaKit的https/rtsps相关功能需要使⽤openssl才能开启。
ffmpeg
zlmediakit可以通过fork ffmpeg进程的⽅式实现多种协议的拉流，编译时不需要安装FFmpeg。
sdl、avcodec、avutil
这3个库供ZLMediaKit的test_player测试程序使⽤，你通常不需要安装这3个库。
2.4.2 安装依赖库
Debian系(包括ubuntu）系统下安装依赖的⽅法：
# 除了 openssl, 其他其实都 可以不安装
sudo apt update
sudo apt-get install openssl
sudo apt-get install openssl
sudo apt-get install libssl-dev
sudo apt-get install libsdl-dev
sudo apt-get install libavcodec-dev
sudo apt-get install libavutil-dev
sudo apt-get install ffmpeg
2.5 构建和编译项⽬
在linux或macOS系统下,你应该这样操作：
1 cd ZLMediaKit
2 mkdir build
3 cd build
4 #macOS下可能需要这样指定openss路径：cmake .. -DOPENSSL_ROOT_DIR=/usr/lo
cal/Cellar/openssl/1.0.2j/
5 cmake ..
6 make -j43 运⾏
ZLMediaKit⼯程主要⽣成3种⼆进制⽬标⽂件，他们的⽣成的路径在release⽬录下，这些⽬标⽂件主要分为：
MediaServer进程这是ZLMediaKit作为服务器的主进程，该进程可以在免去开发的情况下直接作为测 试流媒体服务器使⽤，如果你需要更复杂的业务逻辑，可以通过 Web HOOK 和 RESTful API 实现,同时 你可以通过 配置⽂件 控制其参数。
1 cd ZLMediaKit/release/linux/Debug
2 #通过-h可以了解启动参数
3 ./MediaServer -h
4 #以守护进程模式启动
5 ./MediaServer -d &2.本地实验的截图和说明
下载 ZLMediaKit
git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit.git
cd ZLMediaKit
# 千万不要忘记执⾏这句命令
git submodule update --init
cd ZLMediaKit
在ubuntu上查看g++版本
linux上要求gcc 版本 >= 4.8(4.7应该也能⽀持)，本地安装的ubuntu 是符合标准的，因此
安装编译器
如果你是debian系操作系统(包括ubuntu系⽤户)，⼀般⾃带的gcc版本够新，你可以这样安装gcc编译 器：
sudo apt-get install build-essential
build-essential是一个包含编译软件所需要的基本包集合的元包。它会安装GCC、G++、Make等基本工具，这些工具是编译大部分源代码所必需的
安装cmake
ZLMediaKit采⽤cmake来构建项⽬，通过cmake才能⽣成Makefile(或Xcode/VS⼯程)，所以必须先安装 cmake才能完成后续步骤。
如果你是debian系操作系统(包括ubuntu系⽤户)，⼀般⾃带的cmake版本够新，你可以这样安装
cmake
sudo apt-get install cmake
安装依赖库，这里只是安装了openssl
sudo apt update
sudo apt-get install openssl
sudo apt-get install openssl
构建和编译项⽬
1 cd ZLMediaKit
2 mkdir build
3 cd build
4 #macOS下可能需要这样指定openss路径：cmake .. -DOPENSSL_ROOT_DIR=/usr/lo
cal/Cellar/openssl/1.0.2j/
5 cmake ..
6 make -j4
挨个检查是不是100% build 成功，
3.运行MediaServer
./MediaServer -h 查看启动参数
./MediaServer -d & 以守护进程模式启动
1. 错误排查，原因是 端口号 554 被占用
2. 使用 sudo lsof -i:554 查看554端口被那个 程序占用了
3.使用 sudo kill -9 xxxxx 将 占用该端口的杀死
注意，在杀死占用554 端口的 进程前，./MediaServer -d & 命令行的状态
按下回车后的状态，正常启动了。
然后我们再将 使用 sudo lsof -i:554 查看554端口被那个 程序占用了，
然后再使用 sudo kill -9 xxx 将 占用该端口的杀死
使用 sudo lsof -i:554 查看554端口 会发现，./MediaServer -d & 的进程号是 10503
然后再使用 sudo kill -9 10503 将 占用该端口的杀死，会发现 ./MediaServer -d & 会重启。
4. debug目录下的config.ini 改动参数
log 很重要，要看log，
有可能其他的端口也会占用了，假设你还安装了 其他的 server，sql server，tomcat等服务器，那么被占用端口是很可能的事情。
如果想改动 ZLMediaKit的端口，请 在config.ini 中改动参数
; auto-generated by mINI class {
[api]
apiDebug=1
defaultSnap=./www/logo.png
downloadRoot=./www
secret=nXIB3CEQY1nAtaoDoe0JSwNCNakR3asa
snapRoot=./www/snap/
[cluster]
origin_url=
retry_count=3
timeout_sec=15
[ffmpeg]
bin=/usr/bin/ffmpeg
cmd=%s -re -i %s -c:a aac -strict -2 -ar 44100 -ab 48k -c:v libx264 -f flv %s
log=./ffmpeg/ffmpeg.log
restart_sec=0
snap=%s -i %s -y -f mjpeg -frames:v 1 -an %s
[general]
broadcast_player_count_changed=0
check_nvidia_dev=1
enableVhost=0
enable_ffmpeg_log=0
flowThreshold=1024
listen_ip=::
maxStreamWaitMS=15000
mediaServerId=your_server_id
mergeWriteMS=0
resetWhenRePlay=1
streamNoneReaderDelayMS=20000
unready_frame_cache=100
wait_add_track_ms=3000
wait_audio_track_data_ms=1000
wait_track_ready_ms=10000
[hls]
broadcastRecordTs=0
deleteDelaySec=10
fastRegister=0
fileBufSize=65536
segDelay=0
segDur=2
segKeep=0
segNum=3
segRetain=5
[hook]
alive_interval=10.0
enable=0
on_flow_report=
on_http_access=
on_play=
on_publish=
on_record_mp4=
on_record_ts=
on_rtp_server_timeout=
on_rtsp_auth=
on_rtsp_realm=
on_send_rtp_stopped=
on_server_exited=
on_server_keepalive=
on_server_started=
on_shell_login=
on_stream_changed=
on_stream_none_reader=
on_stream_not_found=
retry=1
retry_delay=3.0
stream_changed_schemas=rtsp/rtmp/fmp4/ts/hls/hls.fmp4
timeoutSec=10
[http]
allow_cross_domains=1
allow_ip_range=::1,127.0.0.1,172.16.0.0-172.31.255.255,192.168.0.0-192.168.255.255,10.0.0.0-10.255.255.255
charSet=utf-8
dirMenu=1
forbidCacheSuffix=
forwarded_ip_header=
keepAliveSecond=30
maxReqSize=40960
notFound=<html><head><title>404 Not Found</title></head><body bgcolor="white"><center><h1>您访问的资源不存在！</h1></center><hr><center>ZLMediaKit(git hash:8bf48ed/2024-12-15T11:43:31+08:00,branch:master,build time:2024-12-19T12:43:26)</center></body></html>
port=80
rootPath=./www
sendBufSize=65536
sslport=443
virtualPath=
[multicast]
addrMax=239.255.255.255
addrMin=239.0.0.0
udpTTL=64
[protocol]
add_mute_audio=1
auto_close=0
continue_push_ms=15000
enable_audio=1
enable_fmp4=1
enable_hls=1
enable_hls_fmp4=0
enable_mp4=0
enable_rtmp=1
enable_rtsp=1
enable_ts=1
fmp4_demand=0
hls_demand=0
hls_save_path=./www
modify_stamp=2
mp4_as_player=0
mp4_max_second=3600
mp4_save_path=./www
paced_sender_ms=0
rtmp_demand=0
rtsp_demand=0
ts_demand=0
[record]
appName=record
enableFmp4=0
fastStart=0
fileBufSize=65536
fileRepeat=0
sampleMS=500
[rtc]
externIP=
maxRtpCacheMS=5000
maxRtpCacheSize=2048
max_bitrate=0
min_bitrate=0
nackIntervalRatio=1.0
nackMaxCount=15
nackMaxMS=3000
nackMaxSize=2048
nackRtpSize=8
port=8000
preferredCodecA=PCMA,PCMU,opus,mpeg4-generic
preferredCodecV=H264,H265,AV1,VP9,VP8
rembBitRate=0
start_bitrate=0
tcpPort=8000
timeoutSec=15
[rtmp]
directProxy=1
enhanced=0
handshakeSecond=15
keepAliveSecond=15
port=1935
sslport=0
[rtp]
audioMtuSize=600
h264_stap_a=1
lowLatency=0
rtpMaxSize=10
videoMtuSize=1400
[rtp_proxy]
dumpDir=
gop_cache=1
h264_pt=98
h265_pt=99
opus_pt=100
port=10000
port_range=30000-35000
ps_pt=96
rtp_g711_dur_ms=100
timeoutSec=15
udp_recv_socket_buffer=4194304
[rtsp]
authBasic=0
directProxy=1
handshakeSecond=15
keepAliveSecond=15
lowLatency=0
port=554
rtpTransportType=-1
sslport=0
[shell]
maxReqSize=1024
port=0
[srt]
latencyMul=4
pktBufSize=8192
port=9000
timeoutSec=5
; } ---4. ZLMediaKit 已经启动，使用ffmpeg 命令 给该服务器上 推流数据
ZLMediaKit⽀持rtsp/rtmp/rtp推流，
1、使⽤rtsp⽅式推流，我们这一节学这个
1 # h264推流
2 ffmpeg -re -i "/path/to/test.mp4" -vcodec h264 -acodec aac -f rtsp
-rtsp_transport tcp rtsp://127.0.0.1/live/test
3 # h265推流
4 ffmpeg -re -i "/path/to/test.mp4" -vcodec h265 -acodec aac -f rtsp
-rtsp_transport tcp rtsp://127.0.0.1/live/testffmpeg -re -i "/path/to/test.mp4" -vcodec h264 -acodec aac -f rtsp -rtsp_transport tcp rtsp://127.0.0.1/live/test
如下的推流说明：
我们将D:/resource/zerenlian.mp4 这个文件推流到 ZLmediakit 服务器；
该文件的 视频格式为 -vcodec h264
该文件的 音频格式为 -acodec aac
推流的方式是rtsp -f rtsp
推流是用tcp 的传送的 -rtsp_transport tcp
服务器的地址写法如下：
rtsp://192.168.31.103/test/00000001zerenlian
rtsp:// 代表的固定格式，如果rtsp 格式 就必须这么写 。
192.168.31.103 是linux服务器的IP。
test/00000001zerenlian 是自己命名的，对于 D:/resource/zerenlian.mp4 文件的映射。
ffmpeg -re -i "D:/resource/zerenlian.mp4" -vcodec h264 -acodec aac -f rtsp -rtsp_transport tcp rtsp://192.168.31.103/test/00000001zerenlian
2.使⽤rtmp⽅式推流
1 #如果未安装FFmpeg，你也可以⽤obs推流
2 ffmpeg -re -i "/path/to/test.mp4" -vcodec h264 -acodec aac -f flv
rtmp://127.0.0.1/live/test
3 # RTMP标准不⽀持H265,但是国内有⾃⾏扩展的，如果你想让FFmpeg⽀持RTMP-H265,请
按照此⽂章编译：https://github.com/ksvc/FFmpeg/wiki/hevcpush3.使⽤rtp⽅式推流
1 # h264推流
2 ffmpeg -re -i "/path/to/test.mp4" -vcodec h264 -acodec aac -f rtp_mpegts rtp://127.0.0.1:10000
3 # h265推流
4 ffmpeg -re -i "/path/to/test.mp4" -vcodec h265 -acodec aac -f rtp_mpegts rtp://127.0.0.1:100001 # h264推流
2 ffmpeg -re -i "/path/to/test.mp4" -vcodec h264 -acodec aac -f rtp_mpegts rtp://127.0.0.1:10000
3 # h265推流
4 ffmpeg -re -i "/path/to/test.mp4" -vcodec h265 -acodec aac -f rtp_mpegts rtp://127.0.0.1:10000
先查看linux的ip，
5. ZLMediaKit 已经启动，使用ffplay 命令从该服务器上 拉流数据
使用 rtsp⽅式拉流
ffplay -rtsp_transport tcp rtsp://192.168.31.103/test/00000001zerenlian
ffplay -rtsp_transport tcp rtsp://192.168.31.103/test/00000001zerenlian如果我们使用 udp的形式去拉呢？实际测试也是可以的
ffplay -rtsp_transport udp rtsp://192.168.31.103/test/00000001zerenlian
6 log 在这里
/home/hunandede/software/ZLMediaKit/release/linux/Debug/log