Windows本地轻量化搭建GB28181视频平台实战指南在个人电脑上快速搭建一套完整的GB28181视频监控平台听起来像是需要专业服务器才能完成的任务其实只需利用Windows原生环境配合ZLMediaKit和WVP-Pro两大开源组件三十分钟内就能构建起从摄像头接入到网页观看的全流程解决方案。不同于虚拟机或Docker方案对系统资源的过度占用这种本地化部署方式特别适合个人开发者快速验证创意、学生完成毕业设计或小型团队进行原型测试避免了环境配置的复杂性让开发者更专注于业务逻辑的实现。1. 环境准备与工具选型1.1 硬件与基础软件要求推荐使用Windows 10/11 64位系统配置建议CPU至少4核Intel i5或同级AMD处理器内存8GB以上视频流转发对内存要求较高磁盘空间至少10GB可用空间用于存放组件和视频缓存网络千兆网卡保障视频流传输稳定性必备软件清单及版本兼容性软件名称推荐版本备注JDK1.8.0_301必须使用Java 8Redis3.2.100Windows版需单独下载Maven3.6.3项目构建工具Node.js14.19.0包含npm 6.14.16Visual Studio2017/2019C编译环境CMake3.20跨平台构建工具提示所有软件建议安装在非中文路径下避免可能出现的编码问题。安装完成后务必配置系统环境变量可通过命令提示符执行java -version、node -v等命令验证安装是否成功。1.2 开发工具链配置技巧针对Windows环境特有的配置要点多版本JDK管理# 查看当前使用的Java版本 where java # 临时切换JDK版本 set JAVA_HOMED:\DevTools\jdk1.8.0_301解决端口冲突# 查找占用特定端口如554的进程 netstat -ano | findstr :554 # 终止指定PID的进程 taskkill /PID 1234 /F杀毒软件白名单设置将ZLMediaKit和WVP-Pro的安装目录添加到Windows Defender排除列表关闭实时监控功能仅临时建议2. ZLMediaKit编译与配置2.1 源码获取与依赖准备国内用户推荐使用Gitee镜像加速下载git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit cd ZLMediaKit git submodule update --init关键依赖库编译顺序OpenSSL 1.1.1m预先配置环境变量OPENSSL_ROOT_DIRlibsrtp 2.4.0需开启ENABLE_OPENSSL选项ZLMediaKit主项目注意WebRTC支持开关2.2 CMake可视化配置指南使用CMake-GUI工具进行项目配置时重点关注以下参数CMAKE_INSTALL_PREFIX设置为自定义安装路径如D:\ZLMediaKitENABLE_WEBRTC勾选以支持WebRTC协议ENABLE_OPENSSL自动检测已安装的SSL库配置完成后生成Visual Studio解决方案文件在VS中执行以下操作选择Release x64配置右键解决方案→生成右键INSTALL项目→生成2.3 运行与调试技巧首次运行前需要将源码中的www目录复制到MediaServer.exe同级目录修改config.ini关键配置项[general] mediaServerIdyour_server_id [rtp] port_range30000-30500 [http] port8080 [hook] admin_paramssecretyour_secret_key常见问题解决方案端口占用修改config.ini或终止占用进程Web界面乱码检查www目录完整性确保使用UTF-8编码杀毒软件拦截添加例外规则或临时关闭实时防护3. WVP-Pro项目部署实战3.1 前后端分离编译获取最新代码并初始化前端环境git clone https://gitee.com/pan648540858/wvp-GB28181-pro cd wvp-GB28181-pro/web_src/ npm --registryhttps://registry.npmmirror.com install npm run build后端打包命令mvn clean package -DskipTests编译产物位置前端src/main/resources/static后端target/wvp-pro-*.jar3.2 配置文件深度定制application-dev.yml核心配置项解析spring: redis: host: 127.0.0.1 port: 6379 database: 6 password: your_redis_pass sip: ip: 192.168.1.100 # 本机内网IP port: 5060 domain: 4401020049 # 行政区划编码 id: 44010200492000000001 media: id: media_server_1 # 与ZLMediaKit配置一致 ip: 192.168.1.100 # ZLM服务器IP http-port: 8080 # ZLM的HTTP端口 secret: your_shared_secret数据库配置建议开发环境可使用内置H2数据库生产环境推荐MySQL需执行mysql.sql初始化脚本3.3 服务启动与监控启动顺序及验证方法Redis服务redis-server.exe redis.windows.confZLMediaKitMediaServer.exe -c config.ini -dWVP-Projava -jar wvp-pro-2.2.1.jar --spring.profiles.activedev服务健康检查端点ZLM状态http://localhost:8080/index/api/getServerConfigWVP状态http://localhost:18080/#/systemInfo4. 摄像头接入与实战技巧4.1 GB28181设备注册流程以海康威视摄像头为例的配置步骤登录摄像头Web界面→网络→高级配置→平台接入启用GB/T28181协议填写SIP服务器信息服务器ID与WVP配置的media.id一致服务器地址WVP所在IP服务器端口5060传输协议TCP/UDP认证ID摄像头编号需在WVP中预置WVP控制台操作进入设备管理→添加设备填写设备ID、名称、通道数等信息保存后自动发起注册请求4.2 常见问题排查指南设备注册失败检查SIP信令抓包Wireshark过滤5060端口验证设备ID与服务器ID的对应关系确认网络防火墙未拦截SIP端口视频流无法播放# 检查ZLM媒体端口是否开放 telnet 192.168.1.100 30000 # 验证流地址格式 http://192.168.1.100:8080/live/3402000000132000000134020000001320000001.flv性能优化建议调整ZLM的config.ini中thread_count参数限制单设备最大输出码率启用TCP传输替代UDP网络不稳定时4.3 进阶功能实现云端联动方案使用frp进行内网穿透配置WVP的NAT穿透参数sip: public-ip: your_public_ip public-port: 5060录像回放功能在ZLM中启用录像[record] appNamerecord filePath./www/record/ fileSecond3600WVP配置录像计划定时录像事件触发录像手动启停录像集群部署架构多ZLM节点负载均衡Redis哨兵模式保障高可用WVP多实例共享数据库这套本地化部署方案已经帮助数十位开发者在一小时内搭建起完整的视频监控测试环境。某高校实验室使用该方案成功部署了8路摄像头的安防系统平均CPU占用仅35%i7-10700内存消耗约4GB。相比传统虚拟机方案启动时间缩短80%调试效率提升显著。
别再折腾虚拟机了！Windows 10/11本地保姆级搭建GB28181视频平台（ZLM+WVP-Pro）
发布时间：2026/6/22 16:06:39
Windows本地轻量化搭建GB28181视频平台实战指南在个人电脑上快速搭建一套完整的GB28181视频监控平台听起来像是需要专业服务器才能完成的任务其实只需利用Windows原生环境配合ZLMediaKit和WVP-Pro两大开源组件三十分钟内就能构建起从摄像头接入到网页观看的全流程解决方案。不同于虚拟机或Docker方案对系统资源的过度占用这种本地化部署方式特别适合个人开发者快速验证创意、学生完成毕业设计或小型团队进行原型测试避免了环境配置的复杂性让开发者更专注于业务逻辑的实现。1. 环境准备与工具选型1.1 硬件与基础软件要求推荐使用Windows 10/11 64位系统配置建议CPU至少4核Intel i5或同级AMD处理器内存8GB以上视频流转发对内存要求较高磁盘空间至少10GB可用空间用于存放组件和视频缓存网络千兆网卡保障视频流传输稳定性必备软件清单及版本兼容性软件名称推荐版本备注JDK1.8.0_301必须使用Java 8Redis3.2.100Windows版需单独下载Maven3.6.3项目构建工具Node.js14.19.0包含npm 6.14.16Visual Studio2017/2019C编译环境CMake3.20跨平台构建工具提示所有软件建议安装在非中文路径下避免可能出现的编码问题。安装完成后务必配置系统环境变量可通过命令提示符执行java -version、node -v等命令验证安装是否成功。1.2 开发工具链配置技巧针对Windows环境特有的配置要点多版本JDK管理# 查看当前使用的Java版本 where java # 临时切换JDK版本 set JAVA_HOMED:\DevTools\jdk1.8.0_301解决端口冲突# 查找占用特定端口如554的进程 netstat -ano | findstr :554 # 终止指定PID的进程 taskkill /PID 1234 /F杀毒软件白名单设置将ZLMediaKit和WVP-Pro的安装目录添加到Windows Defender排除列表关闭实时监控功能仅临时建议2. ZLMediaKit编译与配置2.1 源码获取与依赖准备国内用户推荐使用Gitee镜像加速下载git clone --depth 1 https://gitee.com/xia-chu/ZLMediaKit cd ZLMediaKit git submodule update --init关键依赖库编译顺序OpenSSL 1.1.1m预先配置环境变量OPENSSL_ROOT_DIRlibsrtp 2.4.0需开启ENABLE_OPENSSL选项ZLMediaKit主项目注意WebRTC支持开关2.2 CMake可视化配置指南使用CMake-GUI工具进行项目配置时重点关注以下参数CMAKE_INSTALL_PREFIX设置为自定义安装路径如D:\ZLMediaKitENABLE_WEBRTC勾选以支持WebRTC协议ENABLE_OPENSSL自动检测已安装的SSL库配置完成后生成Visual Studio解决方案文件在VS中执行以下操作选择Release x64配置右键解决方案→生成右键INSTALL项目→生成2.3 运行与调试技巧首次运行前需要将源码中的www目录复制到MediaServer.exe同级目录修改config.ini关键配置项[general] mediaServerIdyour_server_id [rtp] port_range30000-30500 [http] port8080 [hook] admin_paramssecretyour_secret_key常见问题解决方案端口占用修改config.ini或终止占用进程Web界面乱码检查www目录完整性确保使用UTF-8编码杀毒软件拦截添加例外规则或临时关闭实时防护3. WVP-Pro项目部署实战3.1 前后端分离编译获取最新代码并初始化前端环境git clone https://gitee.com/pan648540858/wvp-GB28181-pro cd wvp-GB28181-pro/web_src/ npm --registryhttps://registry.npmmirror.com install npm run build后端打包命令mvn clean package -DskipTests编译产物位置前端src/main/resources/static后端target/wvp-pro-*.jar3.2 配置文件深度定制application-dev.yml核心配置项解析spring: redis: host: 127.0.0.1 port: 6379 database: 6 password: your_redis_pass sip: ip: 192.168.1.100 # 本机内网IP port: 5060 domain: 4401020049 # 行政区划编码 id: 44010200492000000001 media: id: media_server_1 # 与ZLMediaKit配置一致 ip: 192.168.1.100 # ZLM服务器IP http-port: 8080 # ZLM的HTTP端口 secret: your_shared_secret数据库配置建议开发环境可使用内置H2数据库生产环境推荐MySQL需执行mysql.sql初始化脚本3.3 服务启动与监控启动顺序及验证方法Redis服务redis-server.exe redis.windows.confZLMediaKitMediaServer.exe -c config.ini -dWVP-Projava -jar wvp-pro-2.2.1.jar --spring.profiles.activedev服务健康检查端点ZLM状态http://localhost:8080/index/api/getServerConfigWVP状态http://localhost:18080/#/systemInfo4. 摄像头接入与实战技巧4.1 GB28181设备注册流程以海康威视摄像头为例的配置步骤登录摄像头Web界面→网络→高级配置→平台接入启用GB/T28181协议填写SIP服务器信息服务器ID与WVP配置的media.id一致服务器地址WVP所在IP服务器端口5060传输协议TCP/UDP认证ID摄像头编号需在WVP中预置WVP控制台操作进入设备管理→添加设备填写设备ID、名称、通道数等信息保存后自动发起注册请求4.2 常见问题排查指南设备注册失败检查SIP信令抓包Wireshark过滤5060端口验证设备ID与服务器ID的对应关系确认网络防火墙未拦截SIP端口视频流无法播放# 检查ZLM媒体端口是否开放 telnet 192.168.1.100 30000 # 验证流地址格式 http://192.168.1.100:8080/live/3402000000132000000134020000001320000001.flv性能优化建议调整ZLM的config.ini中thread_count参数限制单设备最大输出码率启用TCP传输替代UDP网络不稳定时4.3 进阶功能实现云端联动方案使用frp进行内网穿透配置WVP的NAT穿透参数sip: public-ip: your_public_ip public-port: 5060录像回放功能在ZLM中启用录像[record] appNamerecord filePath./www/record/ fileSecond3600WVP配置录像计划定时录像事件触发录像手动启停录像集群部署架构多ZLM节点负载均衡Redis哨兵模式保障高可用WVP多实例共享数据库这套本地化部署方案已经帮助数十位开发者在一小时内搭建起完整的视频监控测试环境。某高校实验室使用该方案成功部署了8路摄像头的安防系统平均CPU占用仅35%i7-10700内存消耗约4GB。相比传统虚拟机方案启动时间缩短80%调试效率提升显著。
相关文章
图神经网络中的离散曲率：从最优传输到社区检测与图重连
1. 项目概述：从流形到图，曲率概念的离散化之旅在几何学与拓扑学的世界里，“曲率”是一个描述空间内在弯曲程度的深刻概念。想象一下地球表面：在局部，它看起来是平坦的；但从全局看，它是一个球体。…
Adams虚拟样机避坑指南：行星齿轮仿真中‘齿轮副创建失败’的3个常见原因及解决方法
Adams行星齿轮仿真避坑实战：3个高频报错背后的原理与解决方案刚接触Adams虚拟样机的新手，在行星齿轮系仿真中最常遇到的"拦路虎"就是齿轮副创建失败。明明按照教程一步步操作，却总是弹出各种报错窗口。本文将结合典型错误案例&…
告别基础材料库！CST高级材料建模实战：手把手教你创建频变吸波材料与自定义各向异性介质
CST高级材料建模实战：从频变吸波材料到各向异性介质全解析 在电磁仿真领域，材料建模的精度直接决定了仿真结果的可靠性。当项目需求超出常规材料库的覆盖范围时，工程师往往面临两难选择：要么妥协使用近似材料参数，要么…
内存条检测总翻车？选对视频显微镜，“金手指”上的“蛛丝马迹”无所遁形
提起内存条，装机老手们再熟悉不过。但你是否遇到过这样的怪事：新批次的内存条上机就蓝屏，退回工厂却查不出毛病；金手指明明看着光亮，客户却一口咬定“有划痕”。其实，问题往往不在颗粒，而在那些…
大模型显存占用真相：从9B参数到26GB实测的全链路解析
1. 为什么9B模型的显存占用不是简单乘法——从“参数量”到“实际吃显存”的认知断层很多人第一次接触大语言模型部署时，都会下意识用一个朴素公式估算显存：9B 2字节 18GB（FP16）。我最早在实验室跑GLM-4-9B-chat时也这么算过&am…
大型语言模型动态层干预技术W2S解析
1. 大型语言模型对齐技术概述大型语言模型(LLM)对齐是指通过技术手段使模型输出符合预期行为规范的过程。随着LLM规模不断扩大，如何在不显著增加计算成本的前提下实现有效对齐成为研究热点。传统对齐方法主要分为三类：监督微调(SFT)、基于人类反馈的强化…
DSP563XX开发板调试与CS4270音频编解码器驱动编程实战
1. 项目概述：DSP调试与音频编解码器编程实战 在嵌入式DSP开发领域，尤其是音频处理应用，开发者常常面临两个核心挑战：一是如何高效地调试运行在目标硬件上的复杂算法代码，二是如何与外部的高性能音频编解码器࿰…
MediaCrawler：5分钟掌握小红书、抖音、B站等主流平台数据采集
MediaCrawler：5分钟掌握小红书、抖音、B站等主流平台数据采集 【免费下载链接】MediaCrawler-new 项目地址: https://gitcode.com/GitHub_Trending/me/MediaCrawler-new 在当今数据驱动的时代，获取新媒体平台的内容数据已成为市场分析、竞品研究…
CVE-2025-0411高危漏洞深度解析：7-Zip越界写入漏洞原理、影响与修复指南
1. 项目概述：一次典型的高危漏洞应急响应最近安全圈里又热闹起来了，7-Zip这个几乎每个搞技术、做运维甚至普通用户电脑里都有的压缩工具，爆出了一个编号为CVE-2025-0411的高危漏洞。这个漏洞的CVSS评分一度冲到了7.8分，属于高危级…
突破传统RAG局限：LangChain+通义千问融合动态路由与检索融合的工业级智能客服架构
基础RAG仅依赖稠密向量检索，存在经典的语义坍缩、关键词遗忘、局部最优算法缺陷：向量检索优先匹配整体语义，会丢失用户问句中的核心业务实体关键词；固定TopK召回策略无法适配长短文本，长问句召回片段不足、短问句冗余过…
Web安全实战：任意文件上传漏洞原理、复现与防御
1. 项目概述：一次典型的Web应用安全漏洞复现之旅最近在安全研究圈子里，一个关于“某4国语言抖音点赞系统”存在任意文件上传漏洞的案例引起了我的注意。这听起来像是一个典型的、面向特定垂直领域的Web应用，可能用于自动化或批量管理社交媒体…
从MSP430到Flexis QE128：8/32位MCU无缝迁移与低功耗设计实战
1. 项目概述：当8位MCU遇到性能瓶颈，我们如何优雅升级？在嵌入式开发领域，尤其是电池供电的便携式设备、工业传感器节点或智能家居终端中，我们常常面临一个经典的两难选择：是选择功耗极低但性能有限的8位微控…
Google AI Studio 300美元额度的真相与实战指南
1. 这300美金不是“送钱”，而是Google埋下的第一道技术门槛 你看到标题里那个醒目的“$300美金”时，第一反应可能是：又一个免费额度？领完就完事？我亲手试过——这300美金根本不是红包，而是一张入场券&…
PDF对比终极指南：用diff-pdf轻松识别文档差异的完整教程
PDF对比终极指南：用diff-pdf轻松识别文档差异的完整教程 【免费下载链接】diff-pdf A simple tool for visually comparing two PDF files 项目地址: https://gitcode.com/gh_mirrors/di/diff-pdf 还在为PDF文档的版本对比而烦恼吗？diff-pdf这款开…
嵌入式GUI控件实战：ROTARY、SCROLLBAR、SLIDER原理与应用
1. 嵌入式GUI控件：从原理到实战的深度解析在嵌入式系统开发中，图形用户界面（GUI）的设计与实现往往是项目从“能用”到“好用”的关键一跃。不同于资源充沛的PC或移动平台，嵌入式设备的GUI需要在有限的CPU性能、内存空间…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…