1. go2rtc 到底是什么为什么我需要它先说结论go2rtc 是一个轻量级流媒体网关用 Go 语言写的核心功能是把各种不同协议的摄像头流统一接进来再以你想要的协议转发出去。它支持 RTSP、RTMP、HLS、MSE、WebRTC、ONVIF、SIP 等几乎覆盖了市面上主流监控设备和播放端的协议需求。配合 Docker 部署一条命令就能把整个服务跑起来整个过程可以控制在十分钟以内。我在实际使用中遇到的最典型场景是这样的家里和工作室里陆陆续续装了不同品牌的摄像头有支持 RTSP 的有只支持 RTMP 推流的还有走 ONVIF 协议的。以前要同时看这些画面得给每个品牌单独装一个 App或者分别配置不同的播放器非常痛苦。更麻烦的是我需要把这些摄像头接入 Home Assistant 做自动化还需要在浏览器里直接低延迟预览以前这些需求几乎没法同时满足。go2rtc 就是来解决这个问题的——它像一个翻译官把各种协议的视频流统一转化为标准化输出任何终端都能直接拉流观看。另一个让我选择 go2rtc 的原因是它资源占用极小。Go 编译出来的二进制文件只有几十 MB运行内存通常不到 100MB哪怕放在树莓派或者软路由这种小设备上也毫无压力。对比我之前尝试过的 Zoneminder、Shinobi 这类完整 NVR 方案go2rtc 在轻量性和灵活性上优势明显而且它不强制绑定存储和录像管理可以安心做一个纯粹的流媒体网关。如果你和我一样手里有多个不同品牌、不同协议的摄像头希望统一接入、低延迟预览还想方便地对接 Home Assistant 或其他自动化平台那 go2rtc Docker 这套组合就是目前最省心的方案之一。2. 用 Docker 部署 go2rtc2.1 安装前的准备工作go2rtc 的部署方式非常灵活可以直接下载二进制文件运行也可以用 Docker 容器跑。我推荐直接用 Docker因为依赖隔离、升级回滚都方便而且配置文件可以放在宿主机上统一管理换机器迁移时只需要把配置目录带走。部署前我建议先确认几个基础条件宿主机最好已经安装好 Docker 和 Docker Compose 插件。如果是新装的 Docker记得把当前用户加入 docker 用户组否则每次执行 docker 命令都要加 sudo操作起来很别扭。如果你用 Windows 系统Docker Desktop 安装好之后需要在设置里确认是否启用了 WSL2 后端这样容器性能会好很多。go2rtc 官方维护的镜像名是ghcr.io/alexxit/go2rtc在 Docker Hub 上也有同名镜像。实际拉取时我建议直接引用官方仓库避免第三方镜像来源不明带来的安全风险。默认情况下go2rtc 会有三个端口需要映射1984是 Web 管理界面和 API 端口这个端口同时承担了 MSE、WebRTC 等播放能力8554是 RTSP 服务端口8555是 RTMP 服务端口。你可以在 docker-compose 里按需映射如果只做内网使用没必要把端口暴露到公网后面我会专门谈安全加固。2.2 编写 docker-compose.yml 并启动下面是我实际在用的 docker-compose 配置你可以直接复制过去修改version: 3.8 services: go2rtc: image: ghcr.io/alexxit/go2rtc:latest container_name: go2rtc hostname: go2rtc restart: unless-stopped network_mode: host volumes: - ./go2rtc.yaml:/config/go2rtc.yaml - ./media:/media environment: - TZAsia/Shanghai这里我特意使用了network_mode: host因为 go2rtc 内部经常需要主动去拉取摄像头的 RTSP 流使用 host 网络模式可以避免 Docker 端口映射造成的性能损耗也能减少 NAT 带来的延迟。在 Linux 宿主机上这是最推荐的网络模式。如果你使用 Windows 或者 macOS 的 Docker Desktophost 网络模式支持不完整那就改回桥接模式并显式映射端口version: 3.8 services: go2rtc: image: ghcr.io/alexxit/go2rtc:latest container_name: go2rtc restart: unless-stopped ports: - 1984:1984/tcp - 8554:8554/tcp - 8555:8555/tcp volumes: - ./config:/config - ./media:/media environment: - TZAsia/Shanghai配置写好之后在 docker-compose.yml 所在目录执行docker compose up -d启动完成后浏览器访问http://宿主机IP:1984如果能看到 go2rtc 的 Web 界面就说明服务已经正常跑起来了。这个界面虽然不算豪华但功能非常直接左边是流列表点击即可预览右边是配置和日志面板很多问题都能在这里直接定位。2.3 配置文件的初始化与理解go2rtc 的配置文件默认是一个 YAML 文件如果不存在首次启动会自动创建一个空配置。建议在启动前就手动创建好这个文件并至少写入一个测试流避免启动后还要手动去界面操作。我的初始配置长这样log: level: info streams: demo: - ffmpeg:rtsp://192.168.1.100:554/stream1#videoh264#audioaac这个配置的意思是定义了一个名为demo的流实际视频源是某个 IP 摄像头的 RTSP 地址并且通过 ffmpeg 后端强制指定了视频编码为 H.264、音频编码为 AAC。你把它换成自己摄像头的真实地址保存后重启容器然后在 Web 界面上点一下demo如果能正常出画面说明整个链路已经通了。需要注意go2rtc 的配置格式里同一个流名下可以写多个候选源用换行加-的列表形式排列。它会按顺序尝试连接如果第一个源不可用就自动切换到第二个。这个特性在配合多路存储备份时特别有用。3. 多协议接入摄像头与流源的配置实操3.1 RTSP 接入最主流的方式绝大多数专业摄像头和海康、大华、宇视等品牌的设备都支持 RTSP 协议。RTSP 的全称是 Real Time Streaming Protocol它本身并不负责传输视频数据而是负责协商和控制会话真正的视频数据一般通过 RTP 协议传输。go2rtc 对 RTSP 的支持非常完善甚至内置了自己的 RTSP 服务端这意味着其他软件可以作为客户端来 go2rtc 拉流。接入一个 RTSP 摄像头配置非常简单streams: living_room: - rtsp://admin:password192.168.1.101:554/Streaming/Channels/101有些摄像头的主码流和辅码流分别对应不同路径比如海康的路径通常是/Streaming/Channels/101主码流和/Streaming/Channels/102辅码流。主码流画质高、码率大辅码流分辨率低、带宽小。如果你只是用于浏览器预览可以优先接辅码流如果要录像或做画面分析再使用主码流。建议把主码流和辅码流都配置上然后在应用层根据需要切换。我在接入时还发现一个坑某些摄像头不支持通过 URL 参数传递用户名密码必须在路径里嵌入。如果密码里含有、:、/这类特殊字符一定要做 URL 编码否则会导致认证失败。比如密码是abc123应该写成abc%40123。3.2 ONVIF 自动发现设备如果一个局域网里摄像头数量很多手动一个个填 RTSP 地址会很烦。go2rtc 内置了 ONVIF 协议的支持可以自动发现局域网内支持 ONVIF 标准的设备。ONVIF 是一种安防行业的标准协议不同品牌的摄像头如果都支持 ONVIF就能通过标准化的方式互相发现和配置。配置方式有两个入口一是直接写进配置文件streams: auto_camera: - onvif://admin:password192.168.1.102二是通过 Web 界面上的自动发现功能扫描局域网点击后 go2rtc 会广播探测包支持 ONVIF 的设备会返回设备信息包括设备名称、厂家、RTSP 地址等。页面会直接列出所有发现的设备点一下就可以把对应流添加到配置中。这里我要提醒一下ONVIF 自动发现依赖局域网的 UDP 广播如果摄像头和 go2rtc 不在同一个 VLAN 或者网段广播往往不生效。这时候还是得靠手动配置 RTSP 地址。另外某些厂商默认关闭了 ONVIF 功能需要先在摄像头的 Web 管理后台里开启。3.3 RTMP 和 FFmpeg 系的接入有些运动相机、编码器或推流软件输出的是 RTMP 协议go2rtc 同样可以直接拉流或者推流。RTMP 在直播领域仍然广泛使用虽然延迟比 WebRTC 高一点但胜在生态成熟很多设备默认就支持 RTMP 推流。配置方式streams: drone_live: - rtmp://192.168.1.50/live/stream如果遇到 go2rtc 原生协议不支持的特殊设备还有一个兜底方案使用 ffmpeg 后端。go2rtc 在编译时会包含 ffmpeg 库它可以作为一个通用的拉流器支持几乎所有 ffmpeg 能识别的输入。比如有些 USB 摄像头或者 HDMI 采集卡在系统中会暴露为/dev/video0设备节点可以将它们接入streams: usb_camera: - ffmpeg:/dev/video0#videoh264#hardware这里的#videoh264表示要求 ffmpeg 输出 H.264 编码#hardware表示优先使用硬件编码器来降低 CPU 负担。我测试过 ESP32-S3 搭配 USB 摄像头输出的 MJPG 流也能通过这种方式接入并正常预览只要设备节点存在go2rtc 就能把它变成标准的 WebRTC 或 HLS 流。3.4 同一路流多协议输出go2rtc 最大的便利在于当摄像头流接入之后它自动同时对外提供 RTSP、RTMP、HLS、MSE、WebRTC 等多种输出方式。你不用为每种协议单独部署一套服务也不需要知道底层摄像头原始协议是什么。比如接入之后Web 界面可以直接点击播放其他软件可以从rtsp://宿主机IP:8554/living_room拉 RTSP 流浏览器可以通过http://宿主机IP:1984/api/stream/living_room.m3u8获取 HLS 流带 WebRTC 支持的网页客户端则可以直接从http://宿主机IP:1984/api/webrtc?srcliving_room建立 P2P 连接。这样一套配置就兼容了手机、平板、电脑、电视盒子和第三方 NVR 系统。4. 浏览器低延迟播放与 WebRTC 的实战4.1 WebRTC 才是低延迟的核心go2rtc 在浏览器里播放画面最推荐的方式是 WebRTC。常规的 HLS 播放延迟通常在 5 到 10 秒以上RTMP 播放也有 2 到 5 秒的延迟而 WebRTC 可以把延迟压到 500 毫秒以内几乎达到实时监控的效果。这个差距在需要远程查看门口异常、观察宠物动态时有本质区别。WebRTC 的流程是浏览器向 go2rtc 发起 SDP 协商请求go2rtc 作为 WebRTC 的 Peer 与浏览器交换 media 信息然后通过 UDP 方式传输媒体数据。由于 WebRTC 默认使用 UDP 并且对丢包重传做了优化所以在局域网环境下表现尤其出色。在 go2rtc 的 Web 界面里默认播放器就会优先尝试 WebRTC如果浏览器不支持或者网络受限它会自动降级到 MSE。这一点对非技术用户非常友好家里人打开页面就能看不需要安装任何播放器插件。4.2 MSE 与 HLS 的兼容场景虽然 WebRTC 体验最好但并不是所有场景都适合用它。比如在微信内置浏览器、部分旧版 Safari 里WebRTC 的支持并不完整此时 MSEMedia Source Extensions就是备选方案。MSE 是浏览器原生支持的一种媒体播放能力go2rtc 会将视频流封装为 fMP4 片段推送给浏览器播放延迟一般在 1 到 3 秒。HLS 则是兼容性最广的方案iOS 自带浏览器对 HLS 支持非常好很多电视盒子、智能投影也直接支持 HLS 播放。代价是延迟更高通常在 5 秒以上。如果仅仅是回放和确认画面HLS 完全够用。go2rtc 提供了统一的播放地址规则在 Web 界面点击流名称它会自动选择一个最优播放方式如果你在第三方播放器里使用就可以手动拼 URL比如结尾加.m3u8会返回 HLS 播放列表加.mp4会返回可拖拽的 MP4 流。4.3 对接 Home Assistant 与外部播放软件go2rtc 和 Home Assistant 的集成是它的一大亮点。在 Home Assistant 里只需要通过自定义源配置指向 go2rtc 的 REST API就能把摄像头画面直接显示到 Lovelace 面板而且支持连续预览、WebRTC 低延迟。比传统的generic camera走 HLS 方案流畅非常多。对接方式很简单在 Home Assistant 的configuration.yaml中配置一个 camera 实体平台指向genericstream_source 填 go2rtc 的 RTSP 地址camera: - platform: generic name: Living Room stream_source: rtsp://127.0.0.1:8554/living_room这样配置之后Home Assistant 的媒体播放器可以直接从 go2rtc 拉流。更重要的是go2rtc 会自动把 RTSP 源转换成 Home Assistant 支持的格式不需要在 HA 侧再安装 ffmpeg 来处理转码。如果你在用 Frigate 或者 Blue Iris 这类 NVR 软件同样可以把 go2rtc 作为上游流源。比如 Frigate 可以配置go2rtc模块来对接从而同时利用 go2rtc 的 WebRTC 低延迟能力减少重复拉流对摄像头造成的压力。5. 音频处理、转码与录像扩展5.1 音频缺失与编码不兼容的问题很多人在接入摄像头后只看到画面没有声音遇到这个问题先说大原理摄像头音频编码非常多样G.711、AAC、G.726、Opus 都有可能在设备中出现。浏览器通常只支持 AAC 和 Opus如果摄像头输出的是 G.711 原始 PCM 流直接播放很容易出现无声或者无法播放的情况。go2rtc 的解决办法是内置音频转码能力。你可以在流的配置后面加上#audioopus强制将音频转成 Opus 编码输出。如果摄像头本身没有音频输入也可以用#audionone明确关闭音频避免播放器一直尝试初始化音频轨道导致报错。我踩过的另一个坑是个别摄像头默认主码流不带音频辅码流带音频。配置的时候要仔细看设备管理页面的编码参数不要想当然认为主码流一定包含音频轨。5.2 减少转码压力硬件加速与源流直转go2rtc 在设计上尽量追求源流直转意思是如果输入流和输出流的编码格式一致它就只做容器转换不进行编解码。这样 CPU 开销极低。但一旦需要转码CPU 占用会快速上升。比如摄像头输出 H.265HEVC而你的浏览器不支持直接播放 HEVCgo2rtc 就必须先把 H.265 转成 H.264这个过程非常耗费 CPU。解决思路有两个一是优先让摄像头输出 H.264 编码这也是码流画质可接受范围内最稳妥的选择二是启用硬件加速。go2rtc 在 ffmpeg 后端里支持#hardware标记在配置 H.265 流时加上这个参数它会尝试使用 Intel Quick Sync、VAAPI、NVENC 等硬件能力来转码。实测在树莓派 4B 上启用硬件转码之后H.265 摄像头转 H.264 的 CPU 占用能从 80% 以上降到 20% 左右。5.3 录像能力与 Frigate 联动go2rtc 本身不是录像系统它追求的是实时转发和协议转换不做长时间录像存储。但这不代表你不能录像。go2rtc 提供了record配置和 Web API可以控制录像的开始、停止和文件保存。实际项目中我建议将 go2rtc 与 Frigate 配合使用go2rtc 负责低延迟实时画面Frigate 负责 AI 物体检测和录像回放。Frigate 的配置里可以同时引用 go2rtc 的流go2rtc: host: 127.0.0.1 port: 1984 cameras: living_room: ffmpeg: inputs: - path: rtsp://127.0.0.1:8554/living_room roles: - detect - record这样做的好处是 Frigate 只需要从 go2rtc 拉一份流就能同时用于检测和录像不会因为多路拉流把摄像头搞崩溃。摄像头本身的 RTSP 连接只被 go2rtc 占用一次整个系统的连接数压力大大降低。6. 常见问题排查与避坑实录6.1 画面黑屏或无法预览遇到黑屏先不要急着怀疑 go2rtc。我用过的流程是这样的先在摄像头厂家 App 里确认设备本身画面正常然后登录 go2rtc 的 Web 界面进入对应的流查看日志输出。日志里最常见的报错有两种401 Unauthorized表示用户名密码错误Connection timed out表示网络不可达或者摄像头限制了访问来源。前者检查 URL 中的认证信息后者检查网段和防火墙规则。有些摄像头默认开启 IP 过滤只允许特定 IP 访问需要把 go2rtc 所在设备的 IP 加入白名单。另外很多摄像头默认同时连接数限制在 4 路左右。如果我同时让 Frigate、Home Assistant、浏览器里多个标签页拉流很容易触发连接数上限表现为间歇性黑屏或者延迟越来越高。解决办法是尽量统一通过 go2rtc 中转避免多个服务直接连摄像头。6.2 延迟高与画面卡顿延迟高首先要区分是网络问题还是转码问题。局域网内如果延迟超过 1 秒大概率是链路中发生了转码。检查 go2rtc 日志中是否出现transcode字样如果出现了说明输入编码和输出编码不一致。最直接的优化方式是让摄像头端直接输出 H.264 编码并在 go2rtc 配置中不做强制转码。如果无法修改摄像头编码那就启用#hardware硬件加速。但注意硬件加速是 ffmpeg 后端的功能只有走ffmpeg:前缀的源才支持纯 RTSP 协议接入的流无法直接使用该标记。还有一个容易忽略的问题如果宿主机的网卡工作在半双工模式或者网线质量太差也会造成持续的高延迟。这一步排查起来很容易但极容易被忽视。6.3 端口冲突与 Docker 网络模式问题如果你在启动容器时发现port is already allocated的报错说明宿主机上已经有其他服务占用了相应端口。最常见的是 8554 端口和某些 NVR 软件或者另一个 RTSP 服务冲突。解决办法是修改宿主机的映射端口例如改为9554:8554但这样 go2rtc 对外提供的 RTSP 地址端口也会变化。还有一类问题只出现在 Windows Docker Desktop 环境network_mode: host无法完全生效导致 Web 界面打不开。这时候需要把网络模式改回桥接并且显式映射端口。我在跨平台部署时都会准备两份 compose 文件一份 host 模式给 Linux一份 bridge 模式给桌面端。6.4 常见问题速查表症状可能原因解决建议黑屏无画面认证失败、网络隔离、摄像头连接数满检查 URL 认证、IP 白名单、减少直连客户端有画面无声音音频编码浏览器不支持开启音频转码为 Opus/AAC延迟过高转码导致 CPU 瓶颈改用 H.264 源流、启用硬件加速频繁断流摄像头固件不稳、WiFi 信号弱改用有线连接、降低码率、增加源备用地址Web 界面无法打开端口映射错误检查容器的端口映射确认 1984 端口可访问7. 安全与性能调优部署后必做的几件事7.1 务必修改默认密码和访问控制go2rtc 默认的 Web 界面没有强制认证。如果在公网环境下暴露了 1984 端口任何人都可以直接查看你的摄像头画面这非常危险。我强烈建议在内网环境中也不要把 Web 端口直接暴露到公网而是通过带认证的反向代理如 Nginx、Caddy、Traefik来对外提供服务。如果确实需要在局域网内提供免登录页面至少把 go2rtc 的 API 放在网段隔离的 VLAN 中只允许可信设备访问。任何形式的公网暴露都要加一层身份验证再转发到 go2rtc。7.2 控制拉流数量与码率go2rtc 本身非常高效但一个摄像头同时被多个客户端直接拉流仍然会对摄像头造成压力。建议在配置层面统一使用 go2rtc 作为流代理客户端只连 go2rtc不直接连摄像头。这样即使有 10 个人同时看画面摄像头也只需要维持一条上行连接。高分辨率摄像头建议在摄像头端把码率控制在合理范围比如 200 万像素 25 帧H.264 编码主码流设置 4Mbps 左右足够辅码流设置 1Mbps。码率过高不仅占用带宽在公网访问时也会造成卡顿。7.3 用 REST API 做自动化扩展go2rtc 提供的 REST API 非常简洁适合用来做自动化脚本。比如通过 API 获取当前所有流的状态curl http://127.0.0.1:1984/api/streams返回 JSON 中包含每个流的连接数、类型、是否在线等信息。我之前写过一个简单的监控脚本定期检查所有摄像头流的在线状态如果发现有流断线就自动重启对应容器或者发送通知。这个机制比单纯依赖摄像头自带报警要可靠得多。API 还支持动态启动录像curl -X POST http://127.0.0.1:1984/api/record?srcliving_roomduration60这个命令会触发对living_room这一路流录制 60 秒的视频文件。配合一个定时脚本就能实现轻量级的录像计划而不必部署完整的 NVR 系统。8. 后续扩展还能把 go2rtc 用在哪里go2rtc 不仅适用于家用监控场景。我在实际项目中还把 go2rtc 用在了无人机图传链路、开源硬件视觉小车、树莓派 CSI 摄像头、USB 工业相机等设备的画面接入上。尤其是 ESP32-S3 搭配 USB 摄像头作为简易无线图传通过 v4l2 驱动采集后go2rtc 能把画面直接推到浏览器端用来做智能车视觉调试非常方便。智能车摄像头这块我多说几句以前调试视觉算法时每次都要通过命令行工具截图、保存、再传输流程繁琐。接入 go2rtc 之后直接把摄像头流映射成一个 WebRTC 地址在电脑浏览器里实时观察车端画面同时用 OpenCV 通过 RTSP 拉流做算法处理整个开发效率提升非常明显。另一个常见的扩展方向是把 go2rtc 作为家庭媒体中心的基础设施。比如将摄像头流接入 Home Assistant 后不仅能在手机上实时查看还能结合人体传感器做录像触发、自动播报等自动化场景。go2rtc 本身的轻量特征决定了它可以长期 7x24 小时运行在低功耗设备上不会对系统造成显著负担。如果你手里正好有闲置的树莓派或软路由不妨试着把摄像头统一接入感受一下一套平台管理所有摄像头的便利。
1. go2rtc 到底是什么为什么我需要它先说结论go2rtc 是一个轻量级流媒体网关用 Go 语言写的核心功能是把各种不同协议的摄像头流统一接进来再以你想要的协议转发出去。它支持 RTSP、RTMP、HLS、MSE、WebRTC、ONVIF、SIP 等几乎覆盖了市面上主流监控设备和播放端的协议需求。配合 Docker 部署一条命令就能把整个服务跑起来整个过程可以控制在十分钟以内。我在实际使用中遇到的最典型场景是这样的家里和工作室里陆陆续续装了不同品牌的摄像头有支持 RTSP 的有只支持 RTMP 推流的还有走 ONVIF 协议的。以前要同时看这些画面得给每个品牌单独装一个 App或者分别配置不同的播放器非常痛苦。更麻烦的是我需要把这些摄像头接入 Home Assistant 做自动化还需要在浏览器里直接低延迟预览以前这些需求几乎没法同时满足。go2rtc 就是来解决这个问题的——它像一个翻译官把各种协议的视频流统一转化为标准化输出任何终端都能直接拉流观看。另一个让我选择 go2rtc 的原因是它资源占用极小。Go 编译出来的二进制文件只有几十 MB运行内存通常不到 100MB哪怕放在树莓派或者软路由这种小设备上也毫无压力。对比我之前尝试过的 Zoneminder、Shinobi 这类完整 NVR 方案go2rtc 在轻量性和灵活性上优势明显而且它不强制绑定存储和录像管理可以安心做一个纯粹的流媒体网关。如果你和我一样手里有多个不同品牌、不同协议的摄像头希望统一接入、低延迟预览还想方便地对接 Home Assistant 或其他自动化平台那 go2rtc Docker 这套组合就是目前最省心的方案之一。2. 用 Docker 部署 go2rtc2.1 安装前的准备工作go2rtc 的部署方式非常灵活可以直接下载二进制文件运行也可以用 Docker 容器跑。我推荐直接用 Docker因为依赖隔离、升级回滚都方便而且配置文件可以放在宿主机上统一管理换机器迁移时只需要把配置目录带走。部署前我建议先确认几个基础条件宿主机最好已经安装好 Docker 和 Docker Compose 插件。如果是新装的 Docker记得把当前用户加入 docker 用户组否则每次执行 docker 命令都要加 sudo操作起来很别扭。如果你用 Windows 系统Docker Desktop 安装好之后需要在设置里确认是否启用了 WSL2 后端这样容器性能会好很多。go2rtc 官方维护的镜像名是ghcr.io/alexxit/go2rtc在 Docker Hub 上也有同名镜像。实际拉取时我建议直接引用官方仓库避免第三方镜像来源不明带来的安全风险。默认情况下go2rtc 会有三个端口需要映射1984是 Web 管理界面和 API 端口这个端口同时承担了 MSE、WebRTC 等播放能力8554是 RTSP 服务端口8555是 RTMP 服务端口。你可以在 docker-compose 里按需映射如果只做内网使用没必要把端口暴露到公网后面我会专门谈安全加固。2.2 编写 docker-compose.yml 并启动下面是我实际在用的 docker-compose 配置你可以直接复制过去修改version: 3.8 services: go2rtc: image: ghcr.io/alexxit/go2rtc:latest container_name: go2rtc hostname: go2rtc restart: unless-stopped network_mode: host volumes: - ./go2rtc.yaml:/config/go2rtc.yaml - ./media:/media environment: - TZAsia/Shanghai这里我特意使用了network_mode: host因为 go2rtc 内部经常需要主动去拉取摄像头的 RTSP 流使用 host 网络模式可以避免 Docker 端口映射造成的性能损耗也能减少 NAT 带来的延迟。在 Linux 宿主机上这是最推荐的网络模式。如果你使用 Windows 或者 macOS 的 Docker Desktophost 网络模式支持不完整那就改回桥接模式并显式映射端口version: 3.8 services: go2rtc: image: ghcr.io/alexxit/go2rtc:latest container_name: go2rtc restart: unless-stopped ports: - 1984:1984/tcp - 8554:8554/tcp - 8555:8555/tcp volumes: - ./config:/config - ./media:/media environment: - TZAsia/Shanghai配置写好之后在 docker-compose.yml 所在目录执行docker compose up -d启动完成后浏览器访问http://宿主机IP:1984如果能看到 go2rtc 的 Web 界面就说明服务已经正常跑起来了。这个界面虽然不算豪华但功能非常直接左边是流列表点击即可预览右边是配置和日志面板很多问题都能在这里直接定位。2.3 配置文件的初始化与理解go2rtc 的配置文件默认是一个 YAML 文件如果不存在首次启动会自动创建一个空配置。建议在启动前就手动创建好这个文件并至少写入一个测试流避免启动后还要手动去界面操作。我的初始配置长这样log: level: info streams: demo: - ffmpeg:rtsp://192.168.1.100:554/stream1#videoh264#audioaac这个配置的意思是定义了一个名为demo的流实际视频源是某个 IP 摄像头的 RTSP 地址并且通过 ffmpeg 后端强制指定了视频编码为 H.264、音频编码为 AAC。你把它换成自己摄像头的真实地址保存后重启容器然后在 Web 界面上点一下demo如果能正常出画面说明整个链路已经通了。需要注意go2rtc 的配置格式里同一个流名下可以写多个候选源用换行加-的列表形式排列。它会按顺序尝试连接如果第一个源不可用就自动切换到第二个。这个特性在配合多路存储备份时特别有用。3. 多协议接入摄像头与流源的配置实操3.1 RTSP 接入最主流的方式绝大多数专业摄像头和海康、大华、宇视等品牌的设备都支持 RTSP 协议。RTSP 的全称是 Real Time Streaming Protocol它本身并不负责传输视频数据而是负责协商和控制会话真正的视频数据一般通过 RTP 协议传输。go2rtc 对 RTSP 的支持非常完善甚至内置了自己的 RTSP 服务端这意味着其他软件可以作为客户端来 go2rtc 拉流。接入一个 RTSP 摄像头配置非常简单streams: living_room: - rtsp://admin:password192.168.1.101:554/Streaming/Channels/101有些摄像头的主码流和辅码流分别对应不同路径比如海康的路径通常是/Streaming/Channels/101主码流和/Streaming/Channels/102辅码流。主码流画质高、码率大辅码流分辨率低、带宽小。如果你只是用于浏览器预览可以优先接辅码流如果要录像或做画面分析再使用主码流。建议把主码流和辅码流都配置上然后在应用层根据需要切换。我在接入时还发现一个坑某些摄像头不支持通过 URL 参数传递用户名密码必须在路径里嵌入。如果密码里含有、:、/这类特殊字符一定要做 URL 编码否则会导致认证失败。比如密码是abc123应该写成abc%40123。3.2 ONVIF 自动发现设备如果一个局域网里摄像头数量很多手动一个个填 RTSP 地址会很烦。go2rtc 内置了 ONVIF 协议的支持可以自动发现局域网内支持 ONVIF 标准的设备。ONVIF 是一种安防行业的标准协议不同品牌的摄像头如果都支持 ONVIF就能通过标准化的方式互相发现和配置。配置方式有两个入口一是直接写进配置文件streams: auto_camera: - onvif://admin:password192.168.1.102二是通过 Web 界面上的自动发现功能扫描局域网点击后 go2rtc 会广播探测包支持 ONVIF 的设备会返回设备信息包括设备名称、厂家、RTSP 地址等。页面会直接列出所有发现的设备点一下就可以把对应流添加到配置中。这里我要提醒一下ONVIF 自动发现依赖局域网的 UDP 广播如果摄像头和 go2rtc 不在同一个 VLAN 或者网段广播往往不生效。这时候还是得靠手动配置 RTSP 地址。另外某些厂商默认关闭了 ONVIF 功能需要先在摄像头的 Web 管理后台里开启。3.3 RTMP 和 FFmpeg 系的接入有些运动相机、编码器或推流软件输出的是 RTMP 协议go2rtc 同样可以直接拉流或者推流。RTMP 在直播领域仍然广泛使用虽然延迟比 WebRTC 高一点但胜在生态成熟很多设备默认就支持 RTMP 推流。配置方式streams: drone_live: - rtmp://192.168.1.50/live/stream如果遇到 go2rtc 原生协议不支持的特殊设备还有一个兜底方案使用 ffmpeg 后端。go2rtc 在编译时会包含 ffmpeg 库它可以作为一个通用的拉流器支持几乎所有 ffmpeg 能识别的输入。比如有些 USB 摄像头或者 HDMI 采集卡在系统中会暴露为/dev/video0设备节点可以将它们接入streams: usb_camera: - ffmpeg:/dev/video0#videoh264#hardware这里的#videoh264表示要求 ffmpeg 输出 H.264 编码#hardware表示优先使用硬件编码器来降低 CPU 负担。我测试过 ESP32-S3 搭配 USB 摄像头输出的 MJPG 流也能通过这种方式接入并正常预览只要设备节点存在go2rtc 就能把它变成标准的 WebRTC 或 HLS 流。3.4 同一路流多协议输出go2rtc 最大的便利在于当摄像头流接入之后它自动同时对外提供 RTSP、RTMP、HLS、MSE、WebRTC 等多种输出方式。你不用为每种协议单独部署一套服务也不需要知道底层摄像头原始协议是什么。比如接入之后Web 界面可以直接点击播放其他软件可以从rtsp://宿主机IP:8554/living_room拉 RTSP 流浏览器可以通过http://宿主机IP:1984/api/stream/living_room.m3u8获取 HLS 流带 WebRTC 支持的网页客户端则可以直接从http://宿主机IP:1984/api/webrtc?srcliving_room建立 P2P 连接。这样一套配置就兼容了手机、平板、电脑、电视盒子和第三方 NVR 系统。4. 浏览器低延迟播放与 WebRTC 的实战4.1 WebRTC 才是低延迟的核心go2rtc 在浏览器里播放画面最推荐的方式是 WebRTC。常规的 HLS 播放延迟通常在 5 到 10 秒以上RTMP 播放也有 2 到 5 秒的延迟而 WebRTC 可以把延迟压到 500 毫秒以内几乎达到实时监控的效果。这个差距在需要远程查看门口异常、观察宠物动态时有本质区别。WebRTC 的流程是浏览器向 go2rtc 发起 SDP 协商请求go2rtc 作为 WebRTC 的 Peer 与浏览器交换 media 信息然后通过 UDP 方式传输媒体数据。由于 WebRTC 默认使用 UDP 并且对丢包重传做了优化所以在局域网环境下表现尤其出色。在 go2rtc 的 Web 界面里默认播放器就会优先尝试 WebRTC如果浏览器不支持或者网络受限它会自动降级到 MSE。这一点对非技术用户非常友好家里人打开页面就能看不需要安装任何播放器插件。4.2 MSE 与 HLS 的兼容场景虽然 WebRTC 体验最好但并不是所有场景都适合用它。比如在微信内置浏览器、部分旧版 Safari 里WebRTC 的支持并不完整此时 MSEMedia Source Extensions就是备选方案。MSE 是浏览器原生支持的一种媒体播放能力go2rtc 会将视频流封装为 fMP4 片段推送给浏览器播放延迟一般在 1 到 3 秒。HLS 则是兼容性最广的方案iOS 自带浏览器对 HLS 支持非常好很多电视盒子、智能投影也直接支持 HLS 播放。代价是延迟更高通常在 5 秒以上。如果仅仅是回放和确认画面HLS 完全够用。go2rtc 提供了统一的播放地址规则在 Web 界面点击流名称它会自动选择一个最优播放方式如果你在第三方播放器里使用就可以手动拼 URL比如结尾加.m3u8会返回 HLS 播放列表加.mp4会返回可拖拽的 MP4 流。4.3 对接 Home Assistant 与外部播放软件go2rtc 和 Home Assistant 的集成是它的一大亮点。在 Home Assistant 里只需要通过自定义源配置指向 go2rtc 的 REST API就能把摄像头画面直接显示到 Lovelace 面板而且支持连续预览、WebRTC 低延迟。比传统的generic camera走 HLS 方案流畅非常多。对接方式很简单在 Home Assistant 的configuration.yaml中配置一个 camera 实体平台指向genericstream_source 填 go2rtc 的 RTSP 地址camera: - platform: generic name: Living Room stream_source: rtsp://127.0.0.1:8554/living_room这样配置之后Home Assistant 的媒体播放器可以直接从 go2rtc 拉流。更重要的是go2rtc 会自动把 RTSP 源转换成 Home Assistant 支持的格式不需要在 HA 侧再安装 ffmpeg 来处理转码。如果你在用 Frigate 或者 Blue Iris 这类 NVR 软件同样可以把 go2rtc 作为上游流源。比如 Frigate 可以配置go2rtc模块来对接从而同时利用 go2rtc 的 WebRTC 低延迟能力减少重复拉流对摄像头造成的压力。5. 音频处理、转码与录像扩展5.1 音频缺失与编码不兼容的问题很多人在接入摄像头后只看到画面没有声音遇到这个问题先说大原理摄像头音频编码非常多样G.711、AAC、G.726、Opus 都有可能在设备中出现。浏览器通常只支持 AAC 和 Opus如果摄像头输出的是 G.711 原始 PCM 流直接播放很容易出现无声或者无法播放的情况。go2rtc 的解决办法是内置音频转码能力。你可以在流的配置后面加上#audioopus强制将音频转成 Opus 编码输出。如果摄像头本身没有音频输入也可以用#audionone明确关闭音频避免播放器一直尝试初始化音频轨道导致报错。我踩过的另一个坑是个别摄像头默认主码流不带音频辅码流带音频。配置的时候要仔细看设备管理页面的编码参数不要想当然认为主码流一定包含音频轨。5.2 减少转码压力硬件加速与源流直转go2rtc 在设计上尽量追求源流直转意思是如果输入流和输出流的编码格式一致它就只做容器转换不进行编解码。这样 CPU 开销极低。但一旦需要转码CPU 占用会快速上升。比如摄像头输出 H.265HEVC而你的浏览器不支持直接播放 HEVCgo2rtc 就必须先把 H.265 转成 H.264这个过程非常耗费 CPU。解决思路有两个一是优先让摄像头输出 H.264 编码这也是码流画质可接受范围内最稳妥的选择二是启用硬件加速。go2rtc 在 ffmpeg 后端里支持#hardware标记在配置 H.265 流时加上这个参数它会尝试使用 Intel Quick Sync、VAAPI、NVENC 等硬件能力来转码。实测在树莓派 4B 上启用硬件转码之后H.265 摄像头转 H.264 的 CPU 占用能从 80% 以上降到 20% 左右。5.3 录像能力与 Frigate 联动go2rtc 本身不是录像系统它追求的是实时转发和协议转换不做长时间录像存储。但这不代表你不能录像。go2rtc 提供了record配置和 Web API可以控制录像的开始、停止和文件保存。实际项目中我建议将 go2rtc 与 Frigate 配合使用go2rtc 负责低延迟实时画面Frigate 负责 AI 物体检测和录像回放。Frigate 的配置里可以同时引用 go2rtc 的流go2rtc: host: 127.0.0.1 port: 1984 cameras: living_room: ffmpeg: inputs: - path: rtsp://127.0.0.1:8554/living_room roles: - detect - record这样做的好处是 Frigate 只需要从 go2rtc 拉一份流就能同时用于检测和录像不会因为多路拉流把摄像头搞崩溃。摄像头本身的 RTSP 连接只被 go2rtc 占用一次整个系统的连接数压力大大降低。6. 常见问题排查与避坑实录6.1 画面黑屏或无法预览遇到黑屏先不要急着怀疑 go2rtc。我用过的流程是这样的先在摄像头厂家 App 里确认设备本身画面正常然后登录 go2rtc 的 Web 界面进入对应的流查看日志输出。日志里最常见的报错有两种401 Unauthorized表示用户名密码错误Connection timed out表示网络不可达或者摄像头限制了访问来源。前者检查 URL 中的认证信息后者检查网段和防火墙规则。有些摄像头默认开启 IP 过滤只允许特定 IP 访问需要把 go2rtc 所在设备的 IP 加入白名单。另外很多摄像头默认同时连接数限制在 4 路左右。如果我同时让 Frigate、Home Assistant、浏览器里多个标签页拉流很容易触发连接数上限表现为间歇性黑屏或者延迟越来越高。解决办法是尽量统一通过 go2rtc 中转避免多个服务直接连摄像头。6.2 延迟高与画面卡顿延迟高首先要区分是网络问题还是转码问题。局域网内如果延迟超过 1 秒大概率是链路中发生了转码。检查 go2rtc 日志中是否出现transcode字样如果出现了说明输入编码和输出编码不一致。最直接的优化方式是让摄像头端直接输出 H.264 编码并在 go2rtc 配置中不做强制转码。如果无法修改摄像头编码那就启用#hardware硬件加速。但注意硬件加速是 ffmpeg 后端的功能只有走ffmpeg:前缀的源才支持纯 RTSP 协议接入的流无法直接使用该标记。还有一个容易忽略的问题如果宿主机的网卡工作在半双工模式或者网线质量太差也会造成持续的高延迟。这一步排查起来很容易但极容易被忽视。6.3 端口冲突与 Docker 网络模式问题如果你在启动容器时发现port is already allocated的报错说明宿主机上已经有其他服务占用了相应端口。最常见的是 8554 端口和某些 NVR 软件或者另一个 RTSP 服务冲突。解决办法是修改宿主机的映射端口例如改为9554:8554但这样 go2rtc 对外提供的 RTSP 地址端口也会变化。还有一类问题只出现在 Windows Docker Desktop 环境network_mode: host无法完全生效导致 Web 界面打不开。这时候需要把网络模式改回桥接并且显式映射端口。我在跨平台部署时都会准备两份 compose 文件一份 host 模式给 Linux一份 bridge 模式给桌面端。6.4 常见问题速查表症状可能原因解决建议黑屏无画面认证失败、网络隔离、摄像头连接数满检查 URL 认证、IP 白名单、减少直连客户端有画面无声音音频编码浏览器不支持开启音频转码为 Opus/AAC延迟过高转码导致 CPU 瓶颈改用 H.264 源流、启用硬件加速频繁断流摄像头固件不稳、WiFi 信号弱改用有线连接、降低码率、增加源备用地址Web 界面无法打开端口映射错误检查容器的端口映射确认 1984 端口可访问7. 安全与性能调优部署后必做的几件事7.1 务必修改默认密码和访问控制go2rtc 默认的 Web 界面没有强制认证。如果在公网环境下暴露了 1984 端口任何人都可以直接查看你的摄像头画面这非常危险。我强烈建议在内网环境中也不要把 Web 端口直接暴露到公网而是通过带认证的反向代理如 Nginx、Caddy、Traefik来对外提供服务。如果确实需要在局域网内提供免登录页面至少把 go2rtc 的 API 放在网段隔离的 VLAN 中只允许可信设备访问。任何形式的公网暴露都要加一层身份验证再转发到 go2rtc。7.2 控制拉流数量与码率go2rtc 本身非常高效但一个摄像头同时被多个客户端直接拉流仍然会对摄像头造成压力。建议在配置层面统一使用 go2rtc 作为流代理客户端只连 go2rtc不直接连摄像头。这样即使有 10 个人同时看画面摄像头也只需要维持一条上行连接。高分辨率摄像头建议在摄像头端把码率控制在合理范围比如 200 万像素 25 帧H.264 编码主码流设置 4Mbps 左右足够辅码流设置 1Mbps。码率过高不仅占用带宽在公网访问时也会造成卡顿。7.3 用 REST API 做自动化扩展go2rtc 提供的 REST API 非常简洁适合用来做自动化脚本。比如通过 API 获取当前所有流的状态curl http://127.0.0.1:1984/api/streams返回 JSON 中包含每个流的连接数、类型、是否在线等信息。我之前写过一个简单的监控脚本定期检查所有摄像头流的在线状态如果发现有流断线就自动重启对应容器或者发送通知。这个机制比单纯依赖摄像头自带报警要可靠得多。API 还支持动态启动录像curl -X POST http://127.0.0.1:1984/api/record?srcliving_roomduration60这个命令会触发对living_room这一路流录制 60 秒的视频文件。配合一个定时脚本就能实现轻量级的录像计划而不必部署完整的 NVR 系统。8. 后续扩展还能把 go2rtc 用在哪里go2rtc 不仅适用于家用监控场景。我在实际项目中还把 go2rtc 用在了无人机图传链路、开源硬件视觉小车、树莓派 CSI 摄像头、USB 工业相机等设备的画面接入上。尤其是 ESP32-S3 搭配 USB 摄像头作为简易无线图传通过 v4l2 驱动采集后go2rtc 能把画面直接推到浏览器端用来做智能车视觉调试非常方便。智能车摄像头这块我多说几句以前调试视觉算法时每次都要通过命令行工具截图、保存、再传输流程繁琐。接入 go2rtc 之后直接把摄像头流映射成一个 WebRTC 地址在电脑浏览器里实时观察车端画面同时用 OpenCV 通过 RTSP 拉流做算法处理整个开发效率提升非常明显。另一个常见的扩展方向是把 go2rtc 作为家庭媒体中心的基础设施。比如将摄像头流接入 Home Assistant 后不仅能在手机上实时查看还能结合人体传感器做录像触发、自动播报等自动化场景。go2rtc 本身的轻量特征决定了它可以长期 7x24 小时运行在低功耗设备上不会对系统造成显著负担。如果你手里正好有闲置的树莓派或软路由不妨试着把摄像头统一接入感受一下一套平台管理所有摄像头的便利。
