mkuf/ustreamer

ustreamer 打包的 Docker 镜像

什么是 ustreamer？

µStreamer 是一个轻量级且非常快速的服务器，用于从任何 V4L2 设备向网络流式传输 MJPEG 视频。所有新浏览器都原生支持这种视频格式，大多数视频播放器（如 mplayer、VLC 等）也支持。µStreamer 是 Pi-KVM 项目的一部分，旨在以尽可能高的分辨率和 FPS 流式传输 VGA 和 HDMI 屏幕硬件数据。

via https://github.com/pikvm/ustreamer

使用方法

默认情况下，ustreamer 会查找设备 /dev/video0。可通过 Docker 设备绑定提供该设备，无需修改默认命令。

运行

bash
docker run -p 8080:8080 --device /dev/video0:/dev/video0 mkuf/ustreamer:latest

（将容器的 8080 端口映射到主机，同时绑定主机的 /dev/video0 设备到容器）

Docker Compose 配置

yaml
services:
  ustreamer:
    image: mkuf/ustreamer:latest
    ports:
      - "8080:8080"  # 端口映射
    devices:
      - /dev/video0:/dev/video0  # 设备绑定

默认值

端口

卷

无

标签

健康检查

容器内每 5 秒执行一次 /opt/health.sh 脚本。

注意：在 Docker 中启用健康检查可能会显著增加 CPU 使用率。测试中，每 30 秒执行一次健康检查时容器 CPU 使用率翻倍，每 5 秒执行时增加六倍。这可能导致低功耗主机资源不足和异常行为。

脚本功能：

• 获取服务器状态的 JSON 结构
• 检查以下值：
  • .ok 设置为 true（表示 ustreamer 正常运行）
  • .result.source.online 设置为 true（表示视频源（摄像头）正常返回图像而非“无信号”）
• 若上述任一条件不满足，脚本以失败状态退出，标记容器为不健康

Compose 示例：

yaml
services:
  ustreamer:
    healthcheck:
      test: ["bash", "/opt/health.sh"]
      interval: 30s  # 检查间隔，建议设为 30s 以降低资源消耗