简介ZLMediaKit 是一款基于 C11 的运营级流媒体服务框架支持 RTMP、HLS、HTTP-FLV 等主流协议并提供推流、拉流、录制、截图等能力。本资源为 Windows 平台免编译 Release 版本适合需要在 Windows 10 下快速搭建流媒体服务或进行功能验证的开发者无需安装编译环境即可直接部署。压缩包共 86 个文件约 133.23MB主要包括 MediaServer.exe、mk_api.dll 等可执行程序与动态库以及 config.ini、default.pem 等配置文件和 js、html、css 前端页面另附 pdb、ilk 等调试文件便于本地调试与二次开发。Debug 目录组织清晰内置日志与示例工具可辅助理解流媒体服务工作原理。已有 525 人学习下载。通过该包可快速启动服务、完成推拉流测试并借助配套接口与前端代码深入实践 ZLMediaKit 的部署与扩展。 搞流媒体服务的朋友应该都听过ZLMediaKit这个项目功能覆盖RTSP、RTMP、HLS、HTTP-FLV、WebRTC这些主流协议性能在同类型开源项目里属于第一梯队。但它本身是C项目想在Windows上从源码编译出一套可执行文件得先过CMake、OpenSSL、SRTP这些依赖的关很多人就是卡在这一步被劝退的。所以官方在Release里直接维护了一版Windows免编译的成品包解压后双击MediaServer.exe就能把服务跑起来。这篇文章把我实际使用这套免编译版本的经验完整梳理一遍适合想快速验证流媒体功能、做本地联调或者在Windows机器上部署直播转推服务的同学参考。1. ZLMediaKit是什么免编译版解决了什么问题1.1 项目定位与核心能力先说清楚它是个什么东西。ZLMediaKit是一个基于C11开发的高性能流媒体服务框架采用MIT协议开源商用几乎没有限制。它做的事情用一句话概括把各种来源的音视频流收进来按你需要的协议格式分发出去。比如你把一路RTSP摄像头流推给它它就能同时输出RTMP、HTTP-FLV、HLS、WebRTC给不同的播放端也可以反向把RTMP流转成RTSP再输出。这套能力在安防监控、直播、在线教育、智能硬件这些场景里非常常见。它内部支持的功能点包括RTSP/RTMP推拉流、HLS切片与播放、HTTP-FLV流媒体、WebRTC推拉流、GB28181国标接入安防领域的核心协议、集群化部署接口、录像与回放等等。相比mediamtx原rtsp-simple-server这类轻量替代品ZLMediaKit最大的优势在于协议转换完整、API接口丰富、社区活跃很多商业项目直接拿它做底层服务。我自己在选择流媒体中间件时对比过几轮最终稳定用它核心原因就是它的API设计比较规整二次开发成本低。1.2 为什么直接选Windows免编译Release我第一次接触这项目时也是从源码编译入手的折腾了一整个下午。这项目依赖不是一般的多编译器版本、CMake版本、各依赖库版本互相影响稍微对不上就会在链接阶段报一堆莫名其妙的错误。对大多数人来说核心诉求是先跑起来看看效果而不是去研究C工程构建所以官方在GitHub的Releases页面直接发布了Windows平台的预编译版本这一步就直接省掉了。免编译版还有一个容易被忽视的好处环境一致性。你下载到的exe是官方构建环境产出的只要Windows版本不太老、VC运行库不缺就能直接跑不会出现我这能编过你那编不过的尴尬。对团队协作也友好公司内部分发这套Release包同事双击就能起服务不需要统一安装VS、CMake这些开发环境入职培训的成本一下子降下来了。2. 下载与启动从解压到服务跑起来2.1 怎么找到并识别正确的Release包去GitHub的ZLMediaKit/ZLMediaKit仓库切到Releases页面找名称里带Windows字样的zip包。下载前注意两点一看构建日期是否较新二看包内是否包含config.ini、www这些运行必需的文件。有些第三方转存的版本精简过头把配置文件也删了下载下来反而更麻烦。拿到压缩包后解压到纯英文路径比如C:\zlmediakit尽量避免中文目录。原因很实际后续配置、拉流URL、录像文件路径都涉及编码处理中文目录在某些组合下会踩编码坑没必要赌这个。解压后目录里通常包含这些内容MediaServer.exe主程序整个服务的入口config.ini核心配置文件所有协议端口、鉴权、回调都在这里www目录内置web播放页面和静态资源若干dll和.pdb运行库和调试符号文件pdb不用管dll别乱删。2.2 双击启动与启动验证最简单的启动方式就是双击MediaServer.exe。这时候会弹出一个控制台窗口滚动输出日志内容包括监听端口、加载配置、hook回调信息等。日志里有几行值得关注协议支持情况RTSP、RTMP、HTTP是否都成功初始化端口监听是否成功如果看到bind failed之类的字样说明端口被占用具体排查方法在第4节首次启动时日志会打印API secret等关键信息这个后面排查鉴权要反复用到。服务起来之后打开浏览器访问http://127.0.0.1会进入内置的web播放测试页面这是最直观的验证方式页面能打开、能显示服务状态说明基本链路通了。默认80端口如果被业务占用改config.ini里[http]部分的port重启后再用新端口访问。注意控制台窗口别顺手关掉关掉等于杀掉服务。需要长期运行时建议用nssm把这套程序注册成Windows服务具体做法在第5节。3. 核心功能实操推流、拉流与协议转换3.1 config.ini关键参数解读免编译版的默认配置已经能直接工作但几个关键参数必须知道在哪改。配置文件是INI格式按中括号分区[rtsp]和[rtmp]两个协议的监听端口默认是554和1935。端口被占用或想换端口时改这里[http]web页面、HTTP-FLV、HLS对外服务的端口默认80。多服务共用一台机器时这个端口最容易被占[api]重点是secret字段这是所有HTTP管理接口的调用密钥。出厂默认值在日志和配置里都能看到生产环境必须改掉否则等于管理接口裸奔[hook]服务事件回调比如推流开始、推流结束可以回调到你的业务服务器用来做鉴权、统计、告警。改完配置后需要重启MediaServer.exe才生效。改之前建议先备份一份原始config.ini新手改错时能快速回滚。还有个小技巧用文本编辑器改完保存时注意别把文件编码改成带BOM的UTF-8某些版本对配置文件的编码比较敏感BOM会引发解析异常。3.2 用FFmpeg推流验证全链路先下载一个Windows版FFmpeg准备好一个本地视频文件执行下面的命令就能推到ZLMediaKitffmpeg -re -stream_loop -1 -i test.mp4 -c copy -f flv rtmp://127.0.0.1/live/test这条命令的意思是循环推送本地test.mp4保持原始编码不转码-c copy通过RTMP协议推到服务器的live应用中流名是test。推流成功后以下几个地址会同时可用RTMP播放rtmp://127.0.0.1/live/testRTSP播放rtsp://127.0.0.1/live/testHTTP-FLV播放http://127.0.0.1/live/test.flvHLS播放http://127.0.0.1/live/test/hls.m3u8用VLC或者浏览器里的flv.js、hls.js都能验证播放。我最常用的快速验证方法是用VLC打开URL能出画面就说明链路通了。这里要理解一点推流和拉流用的是同一个app和stream名称ZLMediaKit不区分推流协议和拉流协议收到流之后会自动维护多协议的输出能力这就是它协议转换的核心逻辑。3.3 拉取远程流addStreamProxy的用法除了主动推流ZLMediaKit最常用的功能是拉流代理让它主动去拉一个远端流地址再转换成其他协议分发给本地播放端。这个操作通过HTTP接口完成前提是知道API secret。curl http://127.0.0.1/index/api/addStreamProxy?secret你的secretvhost__defaultVhost__applivestreamproxy01urlrtsp://192.168.1.10:554/stream1url参数填要拉取的远端流地址app和stream用来定义它在服务器上的唯一标识。调用成功后就能用http://127.0.0.1/live/proxy01.flv这样的地址播放了。这个功能在对接第三方平台、把不支持WebRTC的老设备转成WebRTC输出、或者把内网流暴露到外网时特别实用我做过一个项目就是靠这个接口把十几路海康摄像头的RTSP流统一转成了HTTP-FLV给前端页面播放。4. 常见问题与排查技巧实录4.1 启动失败端口被占用启动日志里如果出现bind失败或者服务能开但拉流地址不通第一反应查端口。常见的是80端口被IIS或其他web服务占用1935端口被别的直播软件占用。用netstat确认netstat -ano | findstr :80 拿到占用进程的PID后去任务管理器确认是什么程序再决定是停掉它还是改ZLMediaKit的端口。注意修改端口之后所有拉流地址里的端口也要跟着改比如RTSP默认554被占用改成8554播放地址就要写成rtsp://127.0.0.1:8554/live/test。这个细节看着不起眼实际排查时最容易忽略。4.2 老系统启动报无法定位程序输入点这是Windows免编译版一个比较典型的坑。部分低版本Windows比如没打补丁的Win7在双击exe时会弹窗提示无法定位程序输入点SetThreadDescription于动态链接库KERNEL32.dll。原因是新版编译工具链生成的程序用到了较新的系统API老系统内核里没有这个函数。遇到这个提示不用慌这不是文件损坏是系统和程序之间的兼容性问题。解决办法按优先级排日常开发调试尽量用Win10及以上系统Win7机器尝试打全系统补丁部分场景能解决实在不行就翻找历史版本的Release包老包通常使用更保守的编译参数或者直接放弃Windows部署到Linux环境ZLMediaKit在Linux上同样是主流用法。4.3 拉流403或鉴权失败访问接口返回401或403绝大多数是secret不对。默认config.ini里的secret一定要和请求里携带的参数保持一致。另一个常见场景是启用了推流鉴权回调on_publish等hook如果业务服务器没正确放行推流就会失败表现是推流工具报连接被断开但服务日志里没有任何明显错误。排查思路按顺序来先确认secret再确认hooks配置最后看服务日志里的鉴权拒绝记录。我踩过的一个坑改了config.ini但没重启服务反复奇怪为什么配置不生效。这项目的配置是启动时一次性加载的运行中修改不会热更新改完一定要重启进程。5. 基于免编译版的扩展玩法5.1 注册为Windows服务常驻后台双击exe适合临时调试生产环境还是需要服务化。推荐用nssmNon-Sucking Service Manager命令行注册非常简单nssm install ZLMediaKit C:\zlmediakit\MediaServer.exe nssm set ZLMediaKit AppDirectory C:\zlmediakit nssm start ZLMediaKit注册之后服务会随系统开机自启不用每次手动开窗口。注意AppDirectory一定要设置否则服务可能因为找不到配置文件或www目录而启动失败。对于长期跑流媒体服务的机器这一步非常关键另外建议把日志输出重定向到文件方便出问题时回溯。5.2 WebRTC与GB28181国标场景免编译版也内置了WebRTC支持浏览器可以通过HTTPS页面直接播放WebRTC流适合低延迟互动场景。另外安防项目中常见的GB28181国标接入也是这个项目的重要卖点很多做监控平台的团队直接拿这套Windows版对接海康、大华的摄像头国标服务。需要提醒的是WebRTC和GB28181相关配置在config.ini里有专门区块涉及端口范围、公网IP等参数生产环境要逐一确认。这几个功能不是默认配置开箱即用到最优的必须结合实际的网络环境调比如WebRTC的ICE候选地址如果配错外网播放端就会一直卡在连接阶段。5.3 二次开发的准备如果你是做业务开发的先别急着上源码编译。很多需求其实通过HTTP API就能满足查询流列表、踢流、录像管理、流代理管理接口文档在项目WIKI里都有。先用免编译版把API调试通了再决定是否切换到源码自行定制。这个顺序能帮你省很多时间也避免一开始就陷进构建泥潭。关于后续扩展我实际用的体会是这套免编译包最大的价值不是省一次编译的时间而是降低了一个团队的试错成本。先在Windows上把协议流程跑通、把API联调好再决定是否上Linux集群整个项目的推进节奏会顺畅很多。最后再分享一个小经验不管用哪个版本拿到包之后先做一次完整的推流、拉流、转协议、录像全链路测试把默认secret改掉、端口规划好再继续深入使用。基础链路验证过一遍后面折腾什么功能心里都有底。本文还有配套的精品资源点击获取