go2rtc 上手指南1 台机器统一管理所有摄像头流RTSP、WebRTC 到 HomeKit 随便转【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc客厅装一台 Tapo、门口装一台小米、书房还有一台海康三个品牌三套 App看个完整画面得来回切手机。go2rtc 是一个用 Go 语言编写的摄像头流媒体网关它负责把各种来源的摄像头拉成统一的内部流再按访问端的口味实时转换成 WebRTC、RTSP、HLS、RTMP 等 10 多种输出格式。它单文件即可运行无需安装任何额外依赖在 Windows、macOS、Linux、FreeBSD 上都能跑。 先说清楚go2rtc 适合谁不适合谁go2rtc 解决的核心问题只有一件事多来源、多协议的摄像头流统一接入、按需转换、低延迟分发。它不做录像存储也不做 AI 检测——这两件事分别由 Frigate 这类 NVR 和摄像头本身负责。适合不适合品牌混杂的家庭监控想在一个界面里看到所有摄像头只需要看 1 台品牌摄像头App 已经够用需要把私有协议Tapo、小米、Wyze 等转成 RTSP 喂给 Frigate 等系统需要录像回放、AI 检测请用 Frigate 做上层有树莓派 / NAS 这类常开设备愿意花 10 分钟做一次配置要求把流暴露到公网且没有任何反代防护的部署环境 部署Docker 一条命令其余方式看这里推荐 Docker 方式镜像内置了 FFmpeg 和 Python覆盖 x86 与 ARM含树莓派架构docker run -d --name go2rtc \ --network host \ -v /opt/go2rtc:/config \ alexxit/go2rtc其他方式各说一句也可以直接下载对应平台的二进制文件放到服务器chmod x后运行配置默认读取同目录的go2rtc.yaml从源码构建则是git clone https://gitcode.com/GitHub_Trending/go/go2rtc后go build -o go2rtc。若你的 Home Assistant 跑在 Supervisor 上还有现成的 add-on 可装。 接入第一路摄像头从配置到看到画面启动后浏览器打开http://localhost:1984这就是它的 Web 管理界面左侧能直接看到流列表右侧是带语法检查的配置编辑器。go2rtc 启动时会在当前目录找go2rtc.yaml找不到也没关系可以在 Web 界面里直接创建。最小可用配置只需要两行——声明一个 RTSP 输入流即可streams: cam1: rtsp://admin:12345192.168.1.50/stream1保存后cam1会出现在左侧列表中。验证画面有三条路径同一个流名、不同协议点列表项用内置WebRTC播放延迟最低浏览器端用rtsp://127.0.0.1:8554/cam1接 VLC / FrigateRTSP 默认端口8554用http://127.0.0.1:1984/api/stream.m3u8?srccam1走 HLSHLS 默认端口1984记住这三个默认端口就够应付绝大多数场景1984Web 界面 / API / HLS、8554RTSP、8555WebRTC 信令与媒体。 核心能力一路输入按客户端对码输出go2rtc 最值得花时间的能力是多源编解码器协商同一路流可以同时挂多个输入源比如原生 RTSP 一路 FFmpeg 转码每个客户端连上来时go2rtc 会探测浏览器支持哪些编解码器再从所有输入源里挑一个能播的——Chrome 走 WebRTC 的 H264OPUSiPhone Safari 自动落到 HLSFrigate 从 RTSP 拉到的则是它指定的 codec。一个典型例子某台摄像头音频只发 G.711PCMU/PCMA但摄像头还带 ONVIF 双向音频于是给这一路流同时配上原生 RTSP FFmpeg 转 OPUS两个源streams: dahua: - rtsp://admin:pass192.168.1.123/cam/realmonitor?channel1subtype0 - ffmpeg:rtsp://admin:pass192.168.1.123/cam/realmonitor?channel1subtype0#audioopus浏览器连进来时go2rtc 自动从两个源里选到 OPUS 那一路供 WebRTC 使用而纯播放场景下原生 RTSP 源几乎零开销。此外还有几个自动生效的小转换不需要配置G.711/PCM 音频会被打包成 FLAC 后走 MSE/MP4/HLS非 8kHz 采样率的 G.711 会自动重采样到 WebRTC 可用的 8kHz。想手动锁定输出编码在播放 URL 上加查询参数即可例如rtsp://127.0.0.1:8554/cam1?videoh264audioaac——注意筛选器只挑已有 codec不会凭空生成新编码新编码要靠 FFmpeg 源来转。 生态集成Home Assistant 与 Frigate 的最小配置Home Assistant2024.11 已内置 go2rtc 集成也可以直接配 camera 平台camera: - platform: webrtc streams: - stream: cam1Frigate它的 detect/record 输入直接指向 go2rtc 的 RTSP 口用?mp4参数把音频转成 MP4 兼容格式方便录像文件在各类播放器里使用cameras: cam1: ffmpeg: inputs: - path: rtsp://127.0.0.1:8554/cam1?mp4 roles: [detect, record]接入私有协议摄像头时把 stream 定义换成tapo://、xiaomi://、wyze://等前缀即可输出端完全不用改——这是整套方案最省心的地方。各品牌私有协议的接入方式可查 internal/ 下对应模块的 README如 internal/tapo/、internal/xiaomi/。⚙️ 进阶安全收紧、硬件加速与移动端优化何时收紧安全默认三个端口对局域网全开同网段任何人都能看你的摄像头。不放心时把控制面绑到本机只留 WebRTC 端口对外WebRTC 传的是加密媒体外开相对安全api: listen: 127.0.0.1:1984 rtsp: listen: 127.0.0.1:8554 webrtc: listen: :8555需要暴露 Web 界面时在 api 段配username/password或前面挂一层 Nginx/Caddy 反代。更极端的做法是用app.modules白名单只启用信任的模块并用allow_paths限制 API 路径。何时上硬件加速当你用 FFmpeg 源做转码缩放、换编码、换帧率且机器是 Intel/AMD/NVIDIA/树莓派 Rockchip 平台时转码会吃 CPU。在 ffmpeg 源里加#hardware参数即可go2rtc 会自动选择 vaapi / qsv / cuda / videotoolbox / rkmpp 等后端见 internal/ffmpeg/hardware/。注意纯转发不转码场景没有 CPU 开销无需配置。何时做移动端优化手机走流量时给高频访问的流挂一路降规格转码源如 720p 15fps AAC客户端连上后 go2rtc 会按设备能力自动选用iPhone 上若完全看不到画面先确认走的是 HLS 输出。Web 界面的网络页会把每个流的输入、输出、编解码、流量画成一张拓扑图排查谁在拉哪路流非常直观️ 排障速查现象可能原因解法浏览器 WebRTC 黑屏局域网正常、外网不行8555 端口未在路由器放行 TCP/UDPWebRTC 打洞失败路由器同时放行 8555 TCP 和 UDP有画面没声音摄像头只发 G.711输出协议不支持该音频加 FFmpeg 源转 OPUS/AAC或用?mp4参数FLAC 自动打包转码时 CPU 打满软件转码开销ffmpeg 源加#hardware启用硬件加速流名带冒号导致配置报错YAML 里流名含特殊字符流名改用字母数字如front-door而非front:doorRTSP 客户端拉到的是 H265播放不了摄像头主码流是 H.265多数播放器不吃播放 URL 加?videoh264或在摄像头里开 H.264 子码流收尾什么情况值得装什么情况不必装值得部署的场景品牌混杂的摄像头群哪怕只有两台不同品牌需要把私有协议摄像头转成 RTSP 接 Frigate要在浏览器里用最低延迟WebRTC看画面。不必部署的场景只有单品牌摄像头且厂商 App 体验尚可、没有把流接入其他系统的需求——直接装 App 更省事。另外如果你需要的是录像回放和 AI 事件检测正确的组合是 go2rtc 做流网关、Frigate 做上层而不是期待 go2rtc 自己完成存储和分析。【免费下载链接】go2rtcUltimate camera streaming application项目地址: https://gitcode.com/GitHub_Trending/go/go2rtc创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考