go2rtc 完整实战指南10 分钟接好任意摄像头打通所有流媒体协议【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc门口的摄像头只说 RTSP客厅的只认私有协议浏览器里想看却要绕一大圈go2rtc 是一个零依赖、低延迟的流媒体网关用一个 YAML 文件接入任意摄像头再统一转成 RTSP、WebRTC、HLS、RTMP、MJPEG 等协议输出给任何设备。这篇文章带你从零部署到进阶调优看完即可动手。你可能正在被这些麻烦缠住协议碎片化海康、大华走 RTSPTP-Link 摄像头走私有协议Ring 又只能走自家 App一台 NAS 上要装三四套软件才能把所有设备看全。延迟不可接受传统 HLS/RTSP 转发方案动辄 2~5 秒延迟拿来当门口实时监视时画面里的人比现实慢好几秒。双向音频缺失多数转发方案只能看不能说门铃喊话、远程对讲这类需求直接落空。配置繁琐每加一台设备就要改一套配置N 台摄像头就是 N 份参数维护成本指数上升。平台不一致家里树莓派是 ARM办公室是 x86 Linux笔记本是 macOS同一套方案要维护三套环境。go2rtc 凭什么能解决这些问题它的思路很像 GStreamer 的管线模型可以拆成三层来理解输入层Sources内置 30 多个模块从 main.go 的模块列表就能看出来——rtsp、rtmp、onvif、mjpeg、webrtc等公开协议加上tapo、xiaomi、wyze、nest、ring、homekit等品牌私有协议甚至v4l2/alsa这种本地硬件设备全部收进同一个流列表。处理层Transcoding绝大多数场景下数据只做搬运copy零转码零延迟。只有当编码不匹配时比如摄像头出 H.265、浏览器只认 H.264才按需拉起 FFmpeg 转码还支持硬件加速。内置的轻量算法如 PCMA/PCMU 音频自动封装成 FLAC则全自动生效无需配置。输出层Servers/Sinks同一条流可以同时输出为 RTSP8554 端口、WebRTC8555 端口、HLS、MP4/MSE、RTMP、MJPEG 等。客户端连进来时它会自动协商浏览器真正支持的编码和传输方式优先选 WebRTC依次降级到 MSE、HLS。还有一个关键机制值得单独说多源编码协商。比如某摄像头视频是 H.264 没问题但音频是 AAC 而浏览器不认你只需为这条流配第二个ffmpeg:来源专门转音频go2rtc 会把两个来源的轨道拼起来视频走零转码、音频走转码各取所需。快速跑通3 步看到画面第 1 步拿到程序三种方式任选其一后面部署路径章节有完整步骤最快的是下载对应平台的二进制文件Linux x86_64 就是go2rtc_linux_amd64解压后chmod x go2rtc_linux_amd64即可。第 2 步写最小配置在当前目录创建go2rtc.yaml一行就能接入一台摄像头streams: hall: rtsp://admin:password192.168.1.123/cam/realmonitor?channel1subtype0如果没有任何配置文件默认端口就是Web 界面1984、RTSP 服务8554、WebRTC8555。第 3 步打开浏览器http://localhost:1984/—— 看画面自动选最优播放方式http://localhost:1984/config—— 在线编辑 YAML带语法高亮和校验rtsp://localhost:8554/hall—— 任何支持 RTSP 的播放器/录像系统都能直接拉配置编辑界面长这样改完即时生效选择适合你的部署路径路径一Docker 部署推荐最省心镜像alexxit/go2rtc已预装 FFmpeg 和 Python多架构amd64/arm64/armv6 等全覆盖。官方推荐的 compose 写法services: go2rtc: image: alexxit/go2rtc network_mode: host # WebRTC/UDP 设备需要 host 网络 privileged: true # 仅使用 FFmpeg 硬件转码时才需要 restart: unless-stopped # 从 WebUI 改配置或故障时自动重启 environment: - TZAsia/Shanghai volumes: - ~/go2rtc:/config # go2rtc.yaml 放这里用 WebUI 直接编辑需要 NVIDIA/AMD GPU 转码时改用alexxit/go2rtc:latest-hardware镜像并加--gpus all。路径二二进制裸跑推荐嵌入式/老设备单文件、零依赖树莓派、群晖、NAS 甚至小米网关 3MIPS都有对应版本chmod x go2rtc_linux_arm64 ./go2rtc_linux_arm64 # 支持 -c 参数传多份配置后者覆盖前者 # 例./go2rtc -c log.levelinfo -c /etc/go2rtc/go2rtc.yaml配置还支持环境变量替换密码不用明文写死streams: cam1: rtsp://${CAMERA_USER:admin}:${CAMERA_PASS}192.168.1.50/stream路径三Home Assistant 插件智能家居用户HA 中打开 设置 → 插件商店 → 仓库 → 添加官方 go2rtc 插件仓库安装并启动 go2rtc 插件它会自动注册为go2rtc集成在configuration.yaml或 HA 的摄像头集成里引用 go2rtc 即可前端摄像头卡片通过 WebRTC 播放延迟最低进阶玩法4 个高频场景场景 1硬件加速转码CPU 占用打下来只有用 FFmpeg 做视频转码#videoh264时才需要硬件加速纯搬运videocopy或只转音频完全不需要。streams: # 自动选择可用的硬编码器 cam_hw: ffmpeg:rtsp://admin:123456192.168.1.123/stream#videoh264#hardware # 或手动指定 vaapi / cuda / v4l2m2m 等 cam_vaapi: ffmpeg:cam_hw#videoh264#hardwarevaapi收益4K 多路转码场景下 CPU 占用从满载降到个位数详见 internal/ffmpeg/hardware/README.md。Intel 核显 2011 年起就支持 H.264 硬解你的 NUC 大概率白嫖。场景 2Preload 预热开机即出图有些摄像头冷启动要十几秒preload让 go2rtc 启动时就把流拉起来preload: front_door: videoaudio # 全量预热 backyard: video # 只预热视频 garage: videoh264audioopus # 指定编码预热 streams: front_door: rtsp://admin:123456192.168.1.101/stream backyard: rtsp://admin:123456192.168.1.102/stream收益HA 重启、Frigate 重启后画面不空窗。场景 3双向音频与往摄像头里推声音Tapo、Wyze、Xiaomi、Ring、DoorBird 等模块原生支持双向音频浏览器通过 WebRTC 即可与摄像头对讲注意浏览器麦克风需要 HTTPS 环境。更妙的是反向能力——把音频文件、TTS 播报、电台推到摄像头扬声器播放# 把一段 mp3 用 FFmpeg 转成摄像头支持的编码后播放 curl -X POST http://localhost:1984/api/streams?dstfront_doorsrcffmpeg:/media/welcome.mp3#audiopcma#inputfile # 停止播放src 参数传空收益配合格外事件实现有人按门铃 → 语音播报提醒这类自动化。场景 4Publish 直推直播平台publish: # 把转码后的流同时推 Telegram 和 YouTube要求 H.264 AAC live_stream: - rtmps://192.168.1.1:1935/live/mykey - rtmp://a.rtmp.youtube.com/live2/xxxx-xxxx streams: live_stream: - ffmpeg:rtsp://admin:123456192.168.1.123/stream#videoh264#audioaac收益任意 RTSP 摄像头秒变直播间无需再架一台推流服务器。排错手册3 个高频问题问题一RTSP 摄像头连不上或画面卡死现象WebUI 显示流错误或画面长时间不刷新、丢包严重。排查先ping确认网络再看 go2rtc 日志log.level: debug里 SDP 协商是否失败部分廉价摄像头 UDP 传输极不稳定这是最常见根因。修复换 FFmpeg 源并强制 TCP 传输streams: cam: ffmpeg:rtsp://admin:123456192.168.1.123/stream#videocopy#inputrtsp/tcp问题二视频有音频没声音现象画面正常但 WebRTC/MSE 页面没有声音。排查确认摄像头音频编码。大量国产摄像头输出 PCMA/PCMU8kHz 电话音质这类编码 WebRTC 能自动重采样但 RTSP 输出给 Frigate 等录制系统时 FLAC 封装不被支持。修复给录制链路加一路 AAC 转码streams: cam_rec: - rtsp://admin:123456192.168.1.123/stream - ffmpeg:cam_rec#audioaac问题三延迟还是偏高1 秒现象WebRTC 模式下仍有明显延迟。排查先打开http://localhost:1984/net看连接拓扑确认当前走的是 WebRTC 还是降级到了 HLS若是后者通常是编码器不支持或跨网络。再看是否误开了drawtext、视频缩放等高耗参数。修复确保流中有浏览器支持的编码H.264 兼容性最好公网访问时配好 ICE 服务器用 VLC 拉 RTSP 时把缓存调到最低档位验证基准延迟。监控界面可以实时看到每条连接的协议、字节数和包数把 go2rtc 放进更大的系统Frigate AI 识别Frigate 0.12 原生支持把 go2rtc 作为 RTSP 源检测走低码率流、回放走原始流一份摄像头配置两处受益。Home Assistant 全家桶HA 2024.11 内置 go2rtc 集成摄像头卡片、自动化、Frigate 检测事件全部串在一条链路上。自研前端www/ 目录里的video-stream.js是一个完整的播放器示例——自动在 WebRTC/MSE/HLS/MJPEG 之间按音视频 视频、H.265 H.264、WebRTC MSE HLS的优先级选路页面不可见时自动停流。做魔镜、电视端墙、定制大屏时直接复用这套 JS。流推流回传WebTorrent 模块支持两台 go2rtc 之间点对点传流NAS 与边缘盒子分工部署时很有用。生产化建议性能与硬件纯转协议copy几乎不吃 CPU瓶颈在网卡和文件描述符多路部署建议ulimit -n 65536。2~4 路家庭场景任意 2 核机器8~16 路加软件转码4 核 8GB大量 4K 硬转码Intel NUC核显或带 NVENC 的机器 latest-hardware镜像。日志按模块分级log: {api: trace}方便定位而不刷屏。安全加固默认三个端口1984/8554/8555在局域网内免认证局域网不可信时务必收敛。官方提供偏执模式app: modules: [api, rtsp, webrtc, mjpeg] # 只启用需要的模块禁用 echo/exec 等危险源 api: allow_paths: [/api, /api/streams, /api/webrtc, /api/frame.jpeg] local_auth: true # 本机访问也要认证 exec: allow_paths: [ffmpeg] # 限制可执行命令另外注意API 一旦被攻击者控制exec类源意味着任意命令执行公网暴露前请套 Nginx/Caddy 反代加 HTTPS 与 Basic Auth并把api/rtsp的listen绑到127.0.0.1。小结go2rtc 解决的核心问题只有一个让摄像头 ↔ 播放端之间的所有协议差异变得透明——30 多个输入模块、10 多种输出协议、按需转码、自动协商、双向音频全都在一个不到百 MB 的单文件里。下一步你可以试试用 WebUI 的/net页面观察一次 WebRTC 协商全过程或者从 examples/ 目录挑一个 Go 示例比如examples/onvif_client/看看如何把 go2rtc 的 HTTP API 嵌进你自己的项目。【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/12 2:51:46 · 阅读 1.2k go2rtc 完整实战指南：10 分钟接好任意摄像头，打通所有流媒体协议
go2rtc 完整实战指南10 分钟接好任意摄像头打通所有流媒体协议【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc门口的摄像头只说 RTSP客厅的只认私有协议浏览器里想看却要绕一大圈go2rtc 是一个零依赖、低延迟的流媒体网关用一个 YAML 文件接入任意摄像头再统一转成 RTSP、WebRTC、HLS、RTMP、MJPEG 等协议输出给任何设备。这篇文章带你从零部署到进阶调优看完即可动手。你可能正在被这些麻烦缠住协议碎片化海康、大华走 RTSPTP-Link 摄像头走私有协议Ring 又只能走自家 App一台 NAS 上要装三四套软件才能把所有设备看全。延迟不可接受传统 HLS/RTSP 转发方案动辄 2~5 秒延迟拿来当门口实时监视时画面里的人比现实慢好几秒。双向音频缺失多数转发方案只能看不能说门铃喊话、远程对讲这类需求直接落空。配置繁琐每加一台设备就要改一套配置N 台摄像头就是 N 份参数维护成本指数上升。平台不一致家里树莓派是 ARM办公室是 x86 Linux笔记本是 macOS同一套方案要维护三套环境。go2rtc 凭什么能解决这些问题它的思路很像 GStreamer 的管线模型可以拆成三层来理解输入层Sources内置 30 多个模块从 main.go 的模块列表就能看出来——rtsp、rtmp、onvif、mjpeg、webrtc等公开协议加上tapo、xiaomi、wyze、nest、ring、homekit等品牌私有协议甚至v4l2/alsa这种本地硬件设备全部收进同一个流列表。处理层Transcoding绝大多数场景下数据只做搬运copy零转码零延迟。只有当编码不匹配时比如摄像头出 H.265、浏览器只认 H.264才按需拉起 FFmpeg 转码还支持硬件加速。内置的轻量算法如 PCMA/PCMU 音频自动封装成 FLAC则全自动生效无需配置。输出层Servers/Sinks同一条流可以同时输出为 RTSP8554 端口、WebRTC8555 端口、HLS、MP4/MSE、RTMP、MJPEG 等。客户端连进来时它会自动协商浏览器真正支持的编码和传输方式优先选 WebRTC依次降级到 MSE、HLS。还有一个关键机制值得单独说多源编码协商。比如某摄像头视频是 H.264 没问题但音频是 AAC 而浏览器不认你只需为这条流配第二个ffmpeg:来源专门转音频go2rtc 会把两个来源的轨道拼起来视频走零转码、音频走转码各取所需。快速跑通3 步看到画面第 1 步拿到程序三种方式任选其一后面部署路径章节有完整步骤最快的是下载对应平台的二进制文件Linux x86_64 就是go2rtc_linux_amd64解压后chmod x go2rtc_linux_amd64即可。第 2 步写最小配置在当前目录创建go2rtc.yaml一行就能接入一台摄像头streams: hall: rtsp://admin:password192.168.1.123/cam/realmonitor?channel1subtype0如果没有任何配置文件默认端口就是Web 界面1984、RTSP 服务8554、WebRTC8555。第 3 步打开浏览器http://localhost:1984/—— 看画面自动选最优播放方式http://localhost:1984/config—— 在线编辑 YAML带语法高亮和校验rtsp://localhost:8554/hall—— 任何支持 RTSP 的播放器/录像系统都能直接拉配置编辑界面长这样改完即时生效选择适合你的部署路径路径一Docker 部署推荐最省心镜像alexxit/go2rtc已预装 FFmpeg 和 Python多架构amd64/arm64/armv6 等全覆盖。官方推荐的 compose 写法services: go2rtc: image: alexxit/go2rtc network_mode: host # WebRTC/UDP 设备需要 host 网络 privileged: true # 仅使用 FFmpeg 硬件转码时才需要 restart: unless-stopped # 从 WebUI 改配置或故障时自动重启 environment: - TZAsia/Shanghai volumes: - ~/go2rtc:/config # go2rtc.yaml 放这里用 WebUI 直接编辑需要 NVIDIA/AMD GPU 转码时改用alexxit/go2rtc:latest-hardware镜像并加--gpus all。路径二二进制裸跑推荐嵌入式/老设备单文件、零依赖树莓派、群晖、NAS 甚至小米网关 3MIPS都有对应版本chmod x go2rtc_linux_arm64 ./go2rtc_linux_arm64 # 支持 -c 参数传多份配置后者覆盖前者 # 例./go2rtc -c log.levelinfo -c /etc/go2rtc/go2rtc.yaml配置还支持环境变量替换密码不用明文写死streams: cam1: rtsp://${CAMERA_USER:admin}:${CAMERA_PASS}192.168.1.50/stream路径三Home Assistant 插件智能家居用户HA 中打开 设置 → 插件商店 → 仓库 → 添加官方 go2rtc 插件仓库安装并启动 go2rtc 插件它会自动注册为go2rtc集成在configuration.yaml或 HA 的摄像头集成里引用 go2rtc 即可前端摄像头卡片通过 WebRTC 播放延迟最低进阶玩法4 个高频场景场景 1硬件加速转码CPU 占用打下来只有用 FFmpeg 做视频转码#videoh264时才需要硬件加速纯搬运videocopy或只转音频完全不需要。streams: # 自动选择可用的硬编码器 cam_hw: ffmpeg:rtsp://admin:123456192.168.1.123/stream#videoh264#hardware # 或手动指定 vaapi / cuda / v4l2m2m 等 cam_vaapi: ffmpeg:cam_hw#videoh264#hardwarevaapi收益4K 多路转码场景下 CPU 占用从满载降到个位数详见 internal/ffmpeg/hardware/README.md。Intel 核显 2011 年起就支持 H.264 硬解你的 NUC 大概率白嫖。场景 2Preload 预热开机即出图有些摄像头冷启动要十几秒preload让 go2rtc 启动时就把流拉起来preload: front_door: videoaudio # 全量预热 backyard: video # 只预热视频 garage: videoh264audioopus # 指定编码预热 streams: front_door: rtsp://admin:123456192.168.1.101/stream backyard: rtsp://admin:123456192.168.1.102/stream收益HA 重启、Frigate 重启后画面不空窗。场景 3双向音频与往摄像头里推声音Tapo、Wyze、Xiaomi、Ring、DoorBird 等模块原生支持双向音频浏览器通过 WebRTC 即可与摄像头对讲注意浏览器麦克风需要 HTTPS 环境。更妙的是反向能力——把音频文件、TTS 播报、电台推到摄像头扬声器播放# 把一段 mp3 用 FFmpeg 转成摄像头支持的编码后播放 curl -X POST http://localhost:1984/api/streams?dstfront_doorsrcffmpeg:/media/welcome.mp3#audiopcma#inputfile # 停止播放src 参数传空收益配合格外事件实现有人按门铃 → 语音播报提醒这类自动化。场景 4Publish 直推直播平台publish: # 把转码后的流同时推 Telegram 和 YouTube要求 H.264 AAC live_stream: - rtmps://192.168.1.1:1935/live/mykey - rtmp://a.rtmp.youtube.com/live2/xxxx-xxxx streams: live_stream: - ffmpeg:rtsp://admin:123456192.168.1.123/stream#videoh264#audioaac收益任意 RTSP 摄像头秒变直播间无需再架一台推流服务器。排错手册3 个高频问题问题一RTSP 摄像头连不上或画面卡死现象WebUI 显示流错误或画面长时间不刷新、丢包严重。排查先ping确认网络再看 go2rtc 日志log.level: debug里 SDP 协商是否失败部分廉价摄像头 UDP 传输极不稳定这是最常见根因。修复换 FFmpeg 源并强制 TCP 传输streams: cam: ffmpeg:rtsp://admin:123456192.168.1.123/stream#videocopy#inputrtsp/tcp问题二视频有音频没声音现象画面正常但 WebRTC/MSE 页面没有声音。排查确认摄像头音频编码。大量国产摄像头输出 PCMA/PCMU8kHz 电话音质这类编码 WebRTC 能自动重采样但 RTSP 输出给 Frigate 等录制系统时 FLAC 封装不被支持。修复给录制链路加一路 AAC 转码streams: cam_rec: - rtsp://admin:123456192.168.1.123/stream - ffmpeg:cam_rec#audioaac问题三延迟还是偏高1 秒现象WebRTC 模式下仍有明显延迟。排查先打开http://localhost:1984/net看连接拓扑确认当前走的是 WebRTC 还是降级到了 HLS若是后者通常是编码器不支持或跨网络。再看是否误开了drawtext、视频缩放等高耗参数。修复确保流中有浏览器支持的编码H.264 兼容性最好公网访问时配好 ICE 服务器用 VLC 拉 RTSP 时把缓存调到最低档位验证基准延迟。监控界面可以实时看到每条连接的协议、字节数和包数把 go2rtc 放进更大的系统Frigate AI 识别Frigate 0.12 原生支持把 go2rtc 作为 RTSP 源检测走低码率流、回放走原始流一份摄像头配置两处受益。Home Assistant 全家桶HA 2024.11 内置 go2rtc 集成摄像头卡片、自动化、Frigate 检测事件全部串在一条链路上。自研前端www/ 目录里的video-stream.js是一个完整的播放器示例——自动在 WebRTC/MSE/HLS/MJPEG 之间按音视频 视频、H.265 H.264、WebRTC MSE HLS的优先级选路页面不可见时自动停流。做魔镜、电视端墙、定制大屏时直接复用这套 JS。流推流回传WebTorrent 模块支持两台 go2rtc 之间点对点传流NAS 与边缘盒子分工部署时很有用。生产化建议性能与硬件纯转协议copy几乎不吃 CPU瓶颈在网卡和文件描述符多路部署建议ulimit -n 65536。2~4 路家庭场景任意 2 核机器8~16 路加软件转码4 核 8GB大量 4K 硬转码Intel NUC核显或带 NVENC 的机器 latest-hardware镜像。日志按模块分级log: {api: trace}方便定位而不刷屏。安全加固默认三个端口1984/8554/8555在局域网内免认证局域网不可信时务必收敛。官方提供偏执模式app: modules: [api, rtsp, webrtc, mjpeg] # 只启用需要的模块禁用 echo/exec 等危险源 api: allow_paths: [/api, /api/streams, /api/webrtc, /api/frame.jpeg] local_auth: true # 本机访问也要认证 exec: allow_paths: [ffmpeg] # 限制可执行命令另外注意API 一旦被攻击者控制exec类源意味着任意命令执行公网暴露前请套 Nginx/Caddy 反代加 HTTPS 与 Basic Auth并把api/rtsp的listen绑到127.0.0.1。小结go2rtc 解决的核心问题只有一个让摄像头 ↔ 播放端之间的所有协议差异变得透明——30 多个输入模块、10 多种输出协议、按需转码、自动协商、双向音频全都在一个不到百 MB 的单文件里。下一步你可以试试用 WebUI 的/net页面观察一次 WebRTC 协商全过程或者从 examples/ 目录挑一个 Go 示例比如examples/onvif_client/看看如何把 go2rtc 的 HTTP API 嵌进你自己的项目。【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考