企业官网建设流程全解析

go2rtc 接 GoPro 30 秒就黑屏？三步修好睡眠断流

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

你在 go2rtc 里接上 GoPro 后，画面大概 30 秒就黑掉。原因是相机自动睡眠：go2rtc 建连后没有任何保活机制，相机一睡就断流。修法有三个方向：关自动关机、轮询保活、预加载流。

一分钟速览：GoPro 睡眠断流先做什么

• 问题一句话定义：GoPro 播流期间触发自动关机，go2rtc 的 UDP 监听 3 秒收不到包就拆流，拆掉后不会自动重连。
• 最快修复：把相机"自动关机"改成"从不"，一条 curl 命令即可（见下文修复路径）。
• 备选：改不了相机设置时，在主机侧每 25 秒轮询一次相机状态页保活。
• 适用条件：HERO9 到 HERO12，USB 或 Wi-Fi 接入均可；其他型号 gopro 模块不支持。

现场还原：断流时长这样

HERO12 用 USB 接到一台小 Linux 机器，打开 go2rtc 页面能正常播放。30 秒左右画面先卡住一秒，然后变黑，网络视图里流的状态恢复"未连接"。日志几乎不报错，很容易让你误以为是网络故障。

原理拆解：为什么总是在 30 秒断

GoPro 的电源管理默认把"无操作"判成空闲，空闲计时到点就自动关机。go2rtc 建连时只做三件事：先发 /gopro/webcam/stop 清场、监听 UDP 8554（收视频包的端口）、再发 /gopro/webcam/start 让相机推流。因为这条链路没有任何保活信号，所以当相机的睡眠计时器触发、切断网络后，UDP 上不再来包；go2rtc 的收包循环设了 3 秒读超时，一超时就退出循环、关流，并调 /gopro/webcam/stop 收尾。producer 被移除后，页面里的消费者收不到任何数据，画面自然黑了。

修复路径：三种办法修好 go2rtc GoPro 断流

按轻重排序，任选其一。

⚡ 把相机"自动关机"改成从不（推荐）

这是治本方案：让相机根本不睡。GoPro 的 8080 端口开放了 OpenGoPro HTTP API（相机自带的开放 HTTP 接口），用 curl 就能改设置：

# 把相机的自动关机设置写成"从不"（option=0） curl -s "http://172.20.100.52:8080/gopro/camera/setting?setting=62&option=0"

USB 接入时相机默认拿到的地址以 .51 或 .52 结尾（以 WebUI 的 Add 页发现结果为准），Wi-Fi 则用官方 App 里显示的局域网 IP。✅ 生效后流可以长期保持，不再被睡眠计时器打断。如果你不确定该固件下设置编号是否一致，也可以直接在官方 App 的"设置 > 自动关机"里选"从不"。

在主机侧加一个 25 秒轮询保活

改不了相机时（比如被管控的环境），在主机上跑个轻量脚本轮询状态页：任何一次 HTTP 请求都会刷新相机的空闲计时器。

#!/usr/bin/env python3 # 每 25 秒轮询一次相机状态页，防止 GoPro 进入睡眠 import sys, time, urllib.request host = sys.argv[1] if len(sys.argv) > 1 else "172.20.100.52" while True: try: urllib.request.urlopen(f"http://{host}:8080/gopro/webcam/status", timeout=3) print(f"heartbeat -> {host} ok") except Exception as e: print(f"heartbeat -> {host} failed: {e}") time.sleep(25)

用nohup python3 keep_gopro.py 172.20.100.52 > /dev/null 2>&1 &放到后台即可。间隔取 25 秒，比相机默认睡眠时间短，计时器永远到不了点。

给流加 preload 让它常驻启动

preload 单独用不能阻止相机睡眠，但它能让流在 go2rtc 启动时就建好，避免每次打开页面才走一遍握手、把断流窗口暴露出来：

# 启动时预加载 GoPro 流，常驻运行减少空闲断连 preload: hero12: "video" streams: hero12: - gopro://172.20.100.52

改完点"Save & Restart"。生效后流一直在线，再叠加前两种方法里的任意一种，相机就不会睡了。

验证清单：四步确认断流消失

1. 在 go2rtc 所在机器执行curl -s http://172.20.100.52:8080/gopro/webcam/status，能返回内容说明相机活着且 API 可达。
2. 打开网络页，确认播放 60 秒后 gopro 节点及其下游连线依然存在。
3. 观察 go2rtc 日志 5 分钟，不应再反复出现 webcam/stop 相关断流记录。
4. 挂机 10 分钟以上不操作，画面不再变黑。

常见误区：这些坑别踩

• 第一反应重启 go2rtc→ 断流是相机侧的电源管理造成的，重启后它照样 30 秒再睡一次。先关自动关机或上保活，重启服务解决不了任何事。
• 怀疑网络就挨个关防火墙→ "播固定时长再黑"几乎都是相机计时器在动；防火墙真出问题时，现象是"压根连不上"，别把两者混为一谈。
• 手动改地址或端口→ USB 接入时相机拿到的 172.2x.1xx.51 地址由系统自动分配，WebUI 的 Add 页会直接列出来，照抄进配置即可，改端口和 IP 都没有意义。

延伸

• GoPro 模块入口与地址发现逻辑
• GoPro 拨号与 UDP 监听实现
• 流预加载机制源码

相机不睡，流就一直在。

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