企业官网建设流程全解析

go2rtc 连接 GoPro 流会断？关掉相机自动休眠的完整指南

【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc

go2rtc 接入 GoPro 后,流跑几分钟就中断、相机屏幕同时变黑——这就是典型的"休眠"问题:相机自动关机策略生效,接收端在 3 秒收不到包后关闭连接。能做的事只有三件:改相机设置(最彻底)、挂 keep-alive 心跳(兜底)、接持续供电(长期值守)。下文从自查讲起,按步骤做完即可。

🔍 症状自查:是休眠还是断网

先看你对上哪一行,再决定往下读哪节:

注意:当前模块只支持 HERO9 / HERO10 / HERO11 / HERO12,其他机型走的是另一套协议。机型不符时先排除"发现不到",别按休眠方向排。

为什么会这样:相机先睡,接收端 3 秒确认

GoPro 默认开启"自动关机",在 webcam 模式(相机内置的网络摄像头模式,经 HTTP 指令启动后走 UDP 推 H.264 流)下,一段时间无操作就熄屏并中断输出。

go2rtc 侧的 GoPro 模块先用 HTTP 告诉相机起流,在 UDP 8554 收包,接收端带 3 秒超时:一旦收不到包,立即关闭连接并回发停止指令。所以"连上又断"的链路是:相机先睡 → 3 秒后 go2rtc 确认断开 → 流中断。修的目标是"相机别再睡",而不是网络。

怎么选型:改设置、挂心跳还是接电源

选型逻辑:优先改设置,因为它是唯一"一次修好"的办法;心跳用于动不了设置或防设置被重置;供电是长期场景的保底,单独用它治不了熄屏。

⚡ 跟着做:关闭自动关机并验证 gopro 流

第 1 步:拿到相机地址。WebUI 的"添加 > GoPro"可自动发现,或直接看 USB 连接后新建的网卡。地址形如172.20.100.51。

预期:得到一个可 ping 通的地址。

第 2 步:关闭相机自动关机。在能访问相机的机器上执行,62 是 GoPro 的"自动关机"设置项,option=0表示关闭:

# 查询当前值,改完用它验证 curl -s "http://172.20.100.51:8080/gopro/camera/setting?setting=62" # 关闭自动关机 curl -s "http://172.20.100.51:8080/gopro/camera/setting?setting=62&option=0"

预期:查询结果显示自动关机已禁用,之后相机不再自行熄屏。不想敲命令的话,在 GoPro 官方 App 里把"自动关机"设为"从不",效果相同。

第 3 步:写入 go2rtc 配置并重启:

streams: hero12: gopro://172.20.100.51

预期:WebUI 出现该流且可播放。

第 4 步:30 分钟验收。挂着观察,持续不断即完成。若固件升级后设置被重置导致偶发中断,再挂一条心跳,让相机一直"被当作使用中":

while true; do curl -s -m 3 "http://172.20.100.51:8080/gopro/webcam/status" >/dev/null; sleep 25; done

间隔比相机的休眠阈值短即可,设得太密不会更稳,只是平白加压。

避坑与排查:发现、心跳、卡顿的高频问题

流中断后按这条路径走,比反复重启快:

Q:curl 返回非 200 或超时?确认地址在 172.2X 网段、8080 端口开放、防火墙放行;USB 连接地址每次可能变化,先重新确认。

Q:WebUI 发现不到 GoPro?USB 连接会在主机上创建一块 172.2X 网卡;Windows 需另装 GoPro 网络驱动;发现得到但起流失败时,关掉防火墙再试。

Q:心跳间隔设多少合适?25~30 秒是常用值,略短于相机休眠阈值即可;超时参数给 3 秒,避免单次失败拖住整个循环。

Q:固件升级后流又断了?升级会重置相机设置,重跑「跟着做」第 2 步即可,不用改 go2rtc 配置。

Q:卡顿但不断流?那是带宽问题,不是休眠问题:到网络页核对连接,或调低相机输出规格。

收尾:怎么算修好

验收标准一句话:流连续播放 30 分钟不断,期间相机屏幕保持常亮。想看模块实现,可查 GoPro 流生产者 pkg/gopro/ 与 模块说明 internal/gopro/README.md。

【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc