Windows 10 实战：基于 FFmpeg + Nginx 构建 RTSP 转 RTMP/HLS 流媒体网关

1. 为什么需要RTSP转RTMP/HLS网关最近接手了一个监控项目甲方要求将内网摄像头的实时画面通过网页展示给外网用户。刚开始觉得挺简单直到发现摄像头输出的是RTSP协议——这玩意儿在浏览器里根本没法直接播放相信不少做过视频监控开发的同行都遇到过类似问题。RTSP协议虽然适合摄像头传输但存在几个致命缺陷首先它需要专用播放器支持其次对防火墙穿透性差最重要的是所有现代浏览器都已放弃对RTSP的原生支持。这时候就需要一个流媒体网关把RTSP翻译成浏览器友好的协议。我最终选择的方案是FFmpegNginx组合。FFmpeg负责协议转换和转码Nginx作为流媒体服务器分发内容。这套方案最吸引我的地方在于低延迟RTMP适合需要实时监控的场景延迟约1-3秒跨平台HLS所有现代浏览器都能直接播放延迟约5-10秒轻量级全部组件都能在Windows 10上原生运行零成本完全使用开源工具实现2. 环境准备与工具安装2.1 FFmpeg安装指南第一次接触FFmpeg时被它官网的下载页面搞得有点懵——各种静态版本、共享版本看得人眼花。这里分享我的避坑经验访问FFmpeg官网直接下载Windows builds from gyan.dev提供的静态版本解压到C:\ffmpeg目录路径不要含中文和空格配置环境变量WinS搜索环境变量系统属性 → 高级 → 环境变量在Path中添加C:\ffmpeg\bin验证安装是否成功ffmpeg -version如果看到版本信息和编解码器列表说明安装正确。常见问题排查报错不是内部命令检查环境变量路径是否包含\bin缺少dll文件下载的可能是共享版本建议换静态版本2.2 Nginx定制编译标准版Nginx不支持RTMP协议需要手动编译rtmp模块。不过对于Windows用户有个好消息——GitHub上有现成的编译版本下载我测试通过的稳定版本https://github.com/arut/nginx-rtmp-module/wiki/Downloads解压到C:\nginx目录重要目录说明conf/配置文件目录logs/运行日志目录html/静态文件目录建议将nginx目录加入系统环境变量方便后续操作。可以用这个命令快速测试nginx -v3. Nginx流媒体服务器配置3.1 双协议输出配置打开conf/nginx.conf文件在原有配置基础上增加这些关键内容rtmp { server { listen 1935; chunk_size 4096; # RTMP应用低延迟 application live { live on; meta copy; } # HLS应用跨平台 application hls { live on; hls on; hls_path temp/hls; hls_fragment 3s; hls_playlist_length 30s; } } } http { server { listen 8080; # HLS播放端点 location /hls { types { application/vnd.apple.mpegurl m3u8; video/mp2t ts; } alias temp/hls; add_header Cache-Control no-cache; } # 状态监控页面 location /stat { rtmp_stat all; rtmp_stat_stylesheet stat.xsl; } } }几个容易出错的配置点hls_path需要使用绝对路径或确保目录可写RTMP默认端口1935HTTP端口建议用8080避免冲突防火墙要放行配置的端口3.2 服务启动与测试启动Nginx服务nginx -c conf/nginx.conf验证服务是否正常运行访问http://localhost:8080/stat查看RTMP状态页检查temp/hls目录是否自动创建用任务管理器查看nginx进程是否存活常见问题解决方案端口占用netstat -ano | findstr 1935启动失败查看logs/error.log具体原因403禁止访问检查目录权限4. FFmpeg流转换实战4.1 RTSP源配置技巧不同品牌摄像头的RTSP地址格式各异这里列举几种常见格式海康威视rtsp://admin:passwordip:554/Streaming/Channels/101大华rtsp://admin:passwordip:554/cam/realmonitor?channel1subtype0通用ONVIFrtsp://ip:554/onvif1测试摄像头可用性ffplay -rtsp_transport tcp rtsp://...加上-rtsp_transport tcp参数能提高稳定性遇到花屏/卡顿时可以尝试。4.2 双输出转码命令完整的转码推流命令示例ffmpeg -rtsp_transport tcp -i rtsp://... ^ -c:v libx264 -preset ultrafast -tune zerolatency ^ -c:a aac -b:a 128k -ar 44100 ^ -f flv rtmp://localhost/live/stream ^ -c:v libx264 -preset veryfast -g 60 -sc_threshold 0 ^ -c:a aac -b:a 64k -ar 22050 ^ -f hls -hls_time 3 -hls_list_size 10 ^ C:\nginx\temp\hls\stream.m3u8参数解析-preset ultrafast牺牲压缩率换取最低延迟-tune zerolatency零延迟优化-g 60关键帧间隔HLS建议2-3秒一个-hls_list_size 10HLS播放列表长度4.3 性能优化方案在低配设备上运行时可以调整这些参数降低分辨率节省CPU-vf scale1280:720使用硬件加速需显卡支持-c:v h264_nvenc # NVIDIA -c:v h264_qsv # Intel音频降级处理-ac 1 -ar 22050 # 单声道22kHz监控资源占用tasklist /fi imagename eq ffmpeg.exe5. 客户端播放方案5.1 网页播放器集成推荐使用video.js实现网页播放完整示例link hrefhttps://vjs.zencdn.net/7.20.3/video-js.css relstylesheet video idlive classvideo-js controls source srchttp://server:8080/hls/stream.m3u8 typeapplication/x-mpegURL /video script srchttps://vjs.zencdn.net/7.20.3/video.min.js/script script var player videojs(live, { autoplay: true, fluid: true }); /script5.2 移动端适配技巧针对手机浏览器需要特别注意添加playsinline属性video playsinline webkit-playsinline启用H.264 Baseline Profile-profile:v baseline -level 3.0控制码率在1Mbps以内5.3 延迟优化方案实测延迟对比网络环境良好时方案平均延迟适用场景RTMP1-3秒实时监控HLS5-10秒普通观看要降低HLS延迟可以缩短分片时长-hls_time 1 # 1秒一个分片启用低延迟模式hls_low_latency on;6. 生产环境部署建议6.1 开机自启动配置创建start.bat脚本echo off cd /d C:\nginx start nginx -c conf/nginx.conf ffmpeg -rtsp_transport tcp -i rtsp://... ...添加到计划任务WinR输入taskschd.msc创建基本任务触发器选择计算机启动时操作选择启动程序指向bat文件6.2 故障监控方案简易监控脚本monitor.ps1while($true) { if (-not (Get-Process nginx -ErrorAction SilentlyContinue)) { Start-Process C:\nginx\nginx.exe -ArgumentList -c conf/nginx.conf } Start-Sleep -Seconds 30 }6.3 安全防护措施基础安全配置修改默认RTMP应用名application secret_name { live on; allow publish 127.0.0.1; }启用HTTP认证location /hls { auth_basic Restricted; auth_basic_user_file conf/htpasswd; }7. 常见问题排查手册7.1 流无法连接排查步骤检查FFmpeg是否正常推流ffmpeg -i rtsp://... -f null -验证Nginx端口监听netstat -ano | findstr 1935测试本地播放ffplay rtmp://localhost/live/stream7.2 视频卡顿优化可能原因及解决方案网络带宽不足降低视频码率-b:v 1MCPU性能瓶颈使用硬件加速改用-preset faster关键帧间隔过长设置-g 3030帧一个关键帧7.3 音视频不同步处理方法强制固定帧率-r 25 -vsync 1禁用音频重新采样-async 1检查时间戳-fflags genpts在实际项目中这套方案已经稳定运行了8个月每天处理20路1080P视频流。最关键的体会是一定要用-rtsp_transport tcp参数 UDP模式在内网不稳定时会出现各种诡异问题。另外建议每天定时重启Nginx服务长期运行可能会出现内存泄漏。