go2rtc项目1.9.5版本摄像头加载问题分析与解决方案

go2rtc是一个优秀的WebRTC流媒体服务器项目，在1.9.5版本发布后，许多用户反馈他们的IP摄像头无法正常加载视频流，界面卡在加载状态。这个问题影响了包括Tapo、Unifi、ZOSI、ICSEE等多种品牌的摄像头设备。

问题现象

在升级到1.9.5版本后，用户发现：

• 摄像头画面无法显示，一直处于加载状态
• 浏览器控制台出现错误提示
• 1.9.4版本工作正常，但1.9.5出现故障

问题根源分析

经过技术分析，1.9.5版本引入了一个重要的API变更：

• 新版本要求必须先在go2rtc配置文件中定义流媒体源
• 不再支持直接在卡片配置中使用原始RTSP或HTTP流地址
• 这种变更可能是为了增强安全性和配置管理的统一性

解决方案

开发者AlexxIT迅速响应，在1.9.6版本中修复了这个问题。用户可以通过以下方式解决：

1. 升级到1.9.6版本：这是最直接的解决方案，新版本已修复兼容性问题

2. 临时回退到1.9.4版本：

   • 通过系统备份恢复之前的版本
   • 在Docker环境中回退容器版本

3. 按照新API规范配置（适用于想保持1.9.5版本的用户）：

   • 在go2rtc.yaml中预先定义流媒体源
   • 在卡片配置中引用预定义的流名称而非原始URL

配置示例

正确的1.9.5+版本配置方式：

# go2rtc.yaml配置
streams:
  kitchen: rtsp://username:password@192.168.x.x/stream1
  livingroom: http://192.168.x.x:8080/video

# Lovelace卡片配置
type: custom:webrtc-camera
ui: true
poster: http://192.168.x.x:1984/api/frame.jpeg?src=kitchen
streams:
  - url: ""
    name: PLAY
  - url: kitchen
    name: HD
    mode: webrtc,webrtc/tcp,onvif
    media: video,audio

技术建议

对于这类流媒体服务升级，建议用户：

1. 在升级前备份当前配置
2. 关注项目的更新日志，了解API变更
3. 测试环境先行验证，再应用到生产环境
4. 遇到问题时检查浏览器控制台日志

go2rtc项目团队展现了良好的响应速度，在用户反馈后迅速发布了修复版本，这种开源精神值得赞赏。对于依赖视频监控的家庭自动化系统，保持组件稳定性至关重要。