Windows平台GB28181监控系统全栈部署指南从ZLMediaKit编译到wvp-Pro实战第一次在Windows上搭建GB28181监控系统时我盯着满屏的编译错误和配置参数发呆了半小时——这绝不是个愉快的体验。现在回想起来当时如果有一份真正从零开始的避坑指南至少能节省三天时间。本文将用最直白的语言带你完整走通从源码编译到摄像头接入的全流程特别针对Windows平台特有的环境配置、依赖冲突和网络问题提供解决方案。1. 环境准备构建工具链的精确配置1.1 开发环境基础组件在开始编译前需要确保以下组件已正确安装版本号经过严格验证组件名称推荐版本备注Visual Studio2019 Community必须包含C桌面开发工作负载CMake3.20.5安装时勾选Add to system PATHOpenSSL1.1.1m选择Win64 OpenSSL版本Git2.35用于克隆仓库7-Zip最新版解压依赖包必备工具提示所有工具安装路径不要包含中文或空格建议统一使用类似D:\DevTools的目录结构1.2 环境变量配置实战正确配置环境变量是避免后续编译失败的关键# 检查环境变量是否生效管理员权限运行 [Environment]::GetEnvironmentVariable(Path, Machine).Split(;) | Where-Object { $_ -like *OpenSSL* } # 手动添加环境变量示例根据需要调整路径 $newPath D:\DevTools\OpenSSL-Win64\bin; [Environment]::GetEnvironmentVariable(Path, Machine) [Environment]::SetEnvironmentVariable(Path, $newPath, Machine)常见问题排查如果出现找不到openssl命令检查是否添加了bin目录到PATHVS2019的MSVC编译器路径通常为C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x642. ZLMediaKit编译全流程详解2.1 libsrtp的定制化编译WebRTC功能依赖的libsrtp需要特殊编译方式下载源码包并解压到D:\DevTools\libsrtp-2.4.0创建构建目录mkdir build cd build cmake -G Visual Studio 16 2019 -A x64 ..关键CMake参数配置-DCMAKE_INSTALL_PREFIXD:/DevTools/libsrtp -DENABLE_OPENSSLON -DBUILD_SHARED_LIBSON编译完成后需要将生成的srtp2.dll路径加入系统PATH。我曾遇到过因路径错误导致ZLMediaKit链接失败的情况解决方案是# 永久添加dll搜索路径 [Environment]::SetEnvironmentVariable(PATH, D:\DevTools\libsrtp\bin; [Environment]::GetEnvironmentVariable(PATH, Machine), Machine)2.2 ZLMediaKit的深度定制编译从国内镜像克隆代码更稳定git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit cd ZLMediaKit git submodule update --init --recursiveCMake配置时需要特别注意这些选项# 在CMake GUI中设置 ENABLE_WEBRTCON CMAKE_INSTALL_PREFIXD:/ZLMediaKit/Release OPENSSL_ROOT_DIRD:/DevTools/OpenSSL-Win64编译过程中可能遇到的典型错误及解决方案WebRTC支持编译失败确认libsrtp环境变量配置正确检查OpenSSL版本是否为1.1.x系列文件路径过长错误Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem] LongPathsEnableddword:00000001端口占用问题处理# 查找占用554端口的进程 netstat -ano | findstr :554 # 强制结束进程替换PID taskkill /F /PID 12343. wvp-GB28181-pro部署实战3.1 前置依赖安装指南不同于Linux环境Windows需要特别注意这些组件Redis安装下载Windows版Redis压缩包解压后运行redis-server.exe redis.windows.conf设置为开机启动New-Service -Name Redis -BinaryPathName D:\DevTools\Redis\redis-server.exe --service-run D:\DevTools\Redis\redis.windows.conf -DisplayName Redis -StartupType AutomaticJava环境配置# 验证安装 java -version javac -version # 若出现版本问题检查PATH中JDK路径优先级3.2 前端编译避坑指南国内网络环境下需要调整npm源npm config set registry https://registry.npmmirror.com编译静态资源时的典型错误处理# 清除缓存后重试 rm -rf node_modules npm cache clean --force npm install --legacy-peer-deps npm run build注意若出现node-gyp相关错误需安装Windows构建工具npm install --global --production windows-build-tools3.3 后端配置精要application-dev.yml关键配置项解析media: id: your_media_id # 必须与ZLMediaKit的config.ini中mediaServerId一致 ip: 192.168.1.100 # 本机内网IP http-port: 80 # 与ZLMediaKit的http.port对应 sip: ip: 192.168.1.100 # SIP信令服务器IP port: 5060 # 标准SIP端口数据库配置建议小型测试环境使用内置H2数据库即可生产环境推荐MySQL注意字符集设置为utf8mb44. 系统联调与摄像头接入4.1 服务启动顺序优化正确的启动顺序能避免80%的初始化错误启动Redis服务运行ZLMediaKitcd D:\ZLMediaKit\release\windows64\Debug start MediaServer.exe启动wvp-Projava -jar wvp-pro-2.2.1.jar --spring.profiles.activedev4.2 海康摄像头配置示例通过实际案例演示GB28181设备接入登录摄像头Web界面通常为192.168.1.64进入网络-高级配置-平台接入启用GB/T28181协议服务器地址填写wvp-Pro的SIP IP和端口SIP认证ID格式34020000001320000001媒体传输协议选择TCPwvp-Pro操作流程graph TD A[设备管理] -- B[添加设备] B -- C{选择GB28181} C -- D[填写设备ID/IP] D -- E[保存并刷新]常见接入问题排查检查SIP消息是否到达Wireshark抓包5060端口确认媒体端口范围在ZLMediaKit中已开放查看wvp-Pro日志中的SIP交互记录4.3 性能调优实战高并发场景下的关键参数调整; ZLMediaKit的config.ini优化项 [rtp] timeout_sec3600 [rtmp] handshakeSecond10 keepAliveSecond30 [http] keepAliveSecond30 maxReqSize4096JVM调优建议wvp-Pro# 启动参数示例8G内存机器 java -Xms4g -Xmx6g -XX:UseG1GC -jar wvp-pro-2.2.1.jar记得第一次成功接入摄像头时那个凌晨三点的咖啡格外苦涩。现在你只需要跟着这份指南就能避开我当年踩过的所有坑。如果遇到特别棘手的问题不妨检查下系统时间是否准确——这个看似无关的细节曾让我浪费了整整一天。
Windows 10/11 下保姆级教程：从零编译ZLMediaKit并集成wvp-GB28181-pro实现摄像头监控
发布时间：2026/5/30 16:21:42
Windows平台GB28181监控系统全栈部署指南从ZLMediaKit编译到wvp-Pro实战第一次在Windows上搭建GB28181监控系统时我盯着满屏的编译错误和配置参数发呆了半小时——这绝不是个愉快的体验。现在回想起来当时如果有一份真正从零开始的避坑指南至少能节省三天时间。本文将用最直白的语言带你完整走通从源码编译到摄像头接入的全流程特别针对Windows平台特有的环境配置、依赖冲突和网络问题提供解决方案。1. 环境准备构建工具链的精确配置1.1 开发环境基础组件在开始编译前需要确保以下组件已正确安装版本号经过严格验证组件名称推荐版本备注Visual Studio2019 Community必须包含C桌面开发工作负载CMake3.20.5安装时勾选Add to system PATHOpenSSL1.1.1m选择Win64 OpenSSL版本Git2.35用于克隆仓库7-Zip最新版解压依赖包必备工具提示所有工具安装路径不要包含中文或空格建议统一使用类似D:\DevTools的目录结构1.2 环境变量配置实战正确配置环境变量是避免后续编译失败的关键# 检查环境变量是否生效管理员权限运行 [Environment]::GetEnvironmentVariable(Path, Machine).Split(;) | Where-Object { $_ -like *OpenSSL* } # 手动添加环境变量示例根据需要调整路径 $newPath D:\DevTools\OpenSSL-Win64\bin; [Environment]::GetEnvironmentVariable(Path, Machine) [Environment]::SetEnvironmentVariable(Path, $newPath, Machine)常见问题排查如果出现找不到openssl命令检查是否添加了bin目录到PATHVS2019的MSVC编译器路径通常为C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Tools\MSVC\14.29.30133\bin\Hostx64\x642. ZLMediaKit编译全流程详解2.1 libsrtp的定制化编译WebRTC功能依赖的libsrtp需要特殊编译方式下载源码包并解压到D:\DevTools\libsrtp-2.4.0创建构建目录mkdir build cd build cmake -G Visual Studio 16 2019 -A x64 ..关键CMake参数配置-DCMAKE_INSTALL_PREFIXD:/DevTools/libsrtp -DENABLE_OPENSSLON -DBUILD_SHARED_LIBSON编译完成后需要将生成的srtp2.dll路径加入系统PATH。我曾遇到过因路径错误导致ZLMediaKit链接失败的情况解决方案是# 永久添加dll搜索路径 [Environment]::SetEnvironmentVariable(PATH, D:\DevTools\libsrtp\bin; [Environment]::GetEnvironmentVariable(PATH, Machine), Machine)2.2 ZLMediaKit的深度定制编译从国内镜像克隆代码更稳定git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit cd ZLMediaKit git submodule update --init --recursiveCMake配置时需要特别注意这些选项# 在CMake GUI中设置 ENABLE_WEBRTCON CMAKE_INSTALL_PREFIXD:/ZLMediaKit/Release OPENSSL_ROOT_DIRD:/DevTools/OpenSSL-Win64编译过程中可能遇到的典型错误及解决方案WebRTC支持编译失败确认libsrtp环境变量配置正确检查OpenSSL版本是否为1.1.x系列文件路径过长错误Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem] LongPathsEnableddword:00000001端口占用问题处理# 查找占用554端口的进程 netstat -ano | findstr :554 # 强制结束进程替换PID taskkill /F /PID 12343. wvp-GB28181-pro部署实战3.1 前置依赖安装指南不同于Linux环境Windows需要特别注意这些组件Redis安装下载Windows版Redis压缩包解压后运行redis-server.exe redis.windows.conf设置为开机启动New-Service -Name Redis -BinaryPathName D:\DevTools\Redis\redis-server.exe --service-run D:\DevTools\Redis\redis.windows.conf -DisplayName Redis -StartupType AutomaticJava环境配置# 验证安装 java -version javac -version # 若出现版本问题检查PATH中JDK路径优先级3.2 前端编译避坑指南国内网络环境下需要调整npm源npm config set registry https://registry.npmmirror.com编译静态资源时的典型错误处理# 清除缓存后重试 rm -rf node_modules npm cache clean --force npm install --legacy-peer-deps npm run build注意若出现node-gyp相关错误需安装Windows构建工具npm install --global --production windows-build-tools3.3 后端配置精要application-dev.yml关键配置项解析media: id: your_media_id # 必须与ZLMediaKit的config.ini中mediaServerId一致 ip: 192.168.1.100 # 本机内网IP http-port: 80 # 与ZLMediaKit的http.port对应 sip: ip: 192.168.1.100 # SIP信令服务器IP port: 5060 # 标准SIP端口数据库配置建议小型测试环境使用内置H2数据库即可生产环境推荐MySQL注意字符集设置为utf8mb44. 系统联调与摄像头接入4.1 服务启动顺序优化正确的启动顺序能避免80%的初始化错误启动Redis服务运行ZLMediaKitcd D:\ZLMediaKit\release\windows64\Debug start MediaServer.exe启动wvp-Projava -jar wvp-pro-2.2.1.jar --spring.profiles.activedev4.2 海康摄像头配置示例通过实际案例演示GB28181设备接入登录摄像头Web界面通常为192.168.1.64进入网络-高级配置-平台接入启用GB/T28181协议服务器地址填写wvp-Pro的SIP IP和端口SIP认证ID格式34020000001320000001媒体传输协议选择TCPwvp-Pro操作流程graph TD A[设备管理] -- B[添加设备] B -- C{选择GB28181} C -- D[填写设备ID/IP] D -- E[保存并刷新]常见接入问题排查检查SIP消息是否到达Wireshark抓包5060端口确认媒体端口范围在ZLMediaKit中已开放查看wvp-Pro日志中的SIP交互记录4.3 性能调优实战高并发场景下的关键参数调整; ZLMediaKit的config.ini优化项 [rtp] timeout_sec3600 [rtmp] handshakeSecond10 keepAliveSecond30 [http] keepAliveSecond30 maxReqSize4096JVM调优建议wvp-Pro# 启动参数示例8G内存机器 java -Xms4g -Xmx6g -XX:UseG1GC -jar wvp-pro-2.2.1.jar记得第一次成功接入摄像头时那个凌晨三点的咖啡格外苦涩。现在你只需要跟着这份指南就能避开我当年踩过的所有坑。如果遇到特别棘手的问题不妨检查下系统时间是否准确——这个看似无关的细节曾让我浪费了整整一天。
相关文章
vJoy虚拟手柄：打破物理限制，重塑游戏控制体验的创新解决方案
vJoy虚拟手柄：打破物理限制，重塑游戏控制体验的创新解决方案 【免费下载链接】vJoy Virtual Joystick 项目地址: https://gitcode.com/gh_mirrors/vj/vJoy 你是否曾想过，为什么游戏控制必须受限于物理手柄？当键盘的精准与鼠…
2026年乌审旗能送货的TOP5家电门店，哪家配送时效更有保障？
2026年，乌审旗居民对家电配送的时效性、可靠性要求日益提升，快速上门、全域覆盖的送货服务已成为选购家电的核心决策因素。本次测评聚焦乌审旗5家主流可送货家电门店，通过多维度量化评估，挖掘配送时效最有保障的优质门店。参与门店…
基于Microbit与超声波传感器的自动瞄准发射器设计与实现
1. 项目概述与核心思路几年前，我在一个创客工作坊里看到一群孩子围着一个用乐高和舵机搭的小车，争论着谁的“自动炮台”更准。这让我想起了自己小时候用纸板和橡皮筋做的那些简陋装置。如今，有了像Microbit这样易上手的微控制器，加…
5分钟掌握大疆无人机固件管理神器：DankDroneDownloader完整使用指南
5分钟掌握大疆无人机固件管理神器：DankDroneDownloader完整使用指南 【免费下载链接】DankDroneDownloader A Custom Firmware Download Tool for DJI Drones Written in C# 项目地址: https://gitcode.com/gh_mirrors/da/DankDroneDownloader 你是否曾因无法…
告别自动更新烦恼：在Ubuntu 20.04上彻底禁用apt定时任务的保姆级教程
彻底掌控Ubuntu更新节奏：禁用自动更新的深度实践指南你是否经历过这样的场景：正在视频会议时系统突然弹出更新提示，或是用移动热点工作时后台悄悄下载数百MB的更新包？对于追求系统控制权的Ubuntu用户而言，不受控的自动…
Lindy设备证书批量续期危机（仅剩72小时有效期！附自动轮转+告警熔断方案）
更多请点击： https://intelliparadigm.com 第一章：Lindy设备证书批量续期危机全景透视 Lindy设备广泛部署于边缘计算与IoT网关场景，其TLS双向认证依赖由内部PKI签发的X.509设备证书。当证书有效期统一设为365天且未启用自动轮转机制时&#…
BG3模组管理器终极指南：告别手动管理，拥抱智能模组体验
BG3模组管理器终极指南：告别手动管理，拥抱智能模组体验 【免费下载链接】BG3ModManager A mod manager for Baldurs Gate 3. This is the only official source! 项目地址: https://gitcode.com/gh_mirrors/bg/BG3ModManager 你是否曾为《博德之门…
实战指南：高效使用VoiceFixer开源语音修复工具完整解析
实战指南：高效使用VoiceFixer开源语音修复工具完整解析 【免费下载链接】voicefixer General Speech Restoration 项目地址: https://gitcode.com/gh_mirrors/vo/voicefixer VoiceFixer是一款基于深度学习的开源语音修复工具，能够智能处理各种语音…
CANoe安装总失败？别急着重装系统，先检查这7个地方（附Win10临时文件夹清理指南）
CANoe安装失败终极排查指南：7个工程师亲测有效的解决方案 每次打开Vector CANoe安装包时，那种期待与忐忑交织的感觉，相信很多汽车电子工程师都深有体会。作为行业标准的车载网络分析工具，CANoe的安装过程却常常成为技术人员的&quo…
Win11/Win10深度学习环境搭建：实测PyCharm远程连接WSL2下的CUDA，性能比虚拟机强多少？
Win11/Win10深度学习环境终极对决：WSL2 CUDA vs 虚拟机 vs 双系统实测指南当开发者需要在Windows系统上进行深度学习开发时，通常会面临三种选择：虚拟机方案、双系统方案和WSL2方案。本文将基于实际测试数据，从GPU性能、开发便利性…
SketchUp STL插件终极指南：3D打印工作流完全掌握
SketchUp STL插件终极指南：3D打印工作流完全掌握 【免费下载链接】sketchup-stl A SketchUp Ruby Extension that adds STL (STereoLithography) file format import and export. 项目地址: https://gitcode.com/gh_mirrors/sk/sketchup-stl SketchUp STL插件…
基于ICL8038的多波形信号发生器：从原理到制作的完整指南
1. 项目概述：从零构建一个基于ICL8038的多波形信号发生器在电子实验、设备调试乃至生物医学信号处理领域，一个稳定可靠、波形纯净的信号源是不可或缺的“心脏”。无论是用于测试放大器的频率响应，还是模拟生理电信号进行算法研究，…
施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录
更多请点击： https://codechina.net 第一章：施工现场安全事故预警准确率达94.6%？——解密某央企AI Agent边缘计算部署架构与3个月落地实录 在华北某大型地铁盾构施工现场，一套轻量化AI Agent系统于2024年Q2完成全栈部署ÿ…
附录 B：术语表
本术语表面向“从 MM 到 HMM”专栏阅读过程中的快速查阅。它不是内核 API 手册，而是把文章中反复出现的概念放到同一张地图上：先给出直观含义，再说明它在 Linux MM/HMM 语境里的作用。建议阅读方式： 初读专栏时，把它当…
Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表·行业首曝）
更多请点击： https://kaifayun.com 第一章：Midjourney渐变美学的神经渲染原理（附RGB-HSV-LCH三空间渐变映射对照表行业首曝） Midjourney 的渐变美学并非传统插值实现，而是由其隐式神经渲染器（Implicit Neu…
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案
MPC-BE：基于DirectShow架构的专业级开源媒体播放解决方案 【免费下载链接】MPC-BE MPC-BE – универсальный проигрыватель аудио и видеофайлов для операционной системы Windows. 项目地址:…
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南
如何快速计算3D模型体积和重量：STL-Volume-Model-Calculator终极指南 【免费下载链接】STL-Volume-Model-Calculator STL Volume Model Calculator Python 项目地址: https://gitcode.com/gh_mirrors/st/STL-Volume-Model-Calculator 你是否曾经为3D打印项目…
通过Taotoken CLI工具一键配置团队开发环境与模型密钥
通过Taotoken CLI工具一键配置团队开发环境与模型密钥 1. CLI工具安装与基本使用 Taotoken提供的CLI工具可通过npm全局安装或直接使用npx运行。对于需要频繁使用CLI的团队，推荐全局安装： npm install -g taotoken/taotoken对于临时使用或项目级配置&a…