
mkuf/ustreamerµStreamer 是一个轻量级且非常快速的服务器,用于从任何 V4L2 设备向网络流式传输 MJPEG 视频。所有新浏览器都原生支持这种视频格式,大多数视频播放器(如 mplayer、VLC 等)也支持。µStreamer 是 Pi-KVM 项目的一部分,旨在以尽可能高的分辨率和 FPS 流式传输 VGA 和 HDMI 屏幕硬件数据。
_via [***]
默认情况下,ustreamer 会查找设备 /dev/video0。可通过 Docker 设备绑定提供该设备,无需修改默认命令。
bashdocker run -p 8080:8080 --device /dev/video0:/dev/video0 mkuf/ustreamer:latest
(将容器的 8080 端口映射到主机,同时绑定主机的 /dev/video0 设备到容器)
yamlservices: ustreamer: image: mkuf/ustreamer:latest ports: - "8080:8080" # 端口映射 devices: - /dev/video0:/dev/video0 # 设备绑定
| 项 | 描述 |
|---|---|
| 用户 | ustreamer (1000:1000) |
| 工作目录 | /opt |
| 入口点 | /opt/ustreamer |
| 命令 | --host=0.0.0.0 --port=8080(绑定所有网络接口,使用 8080 端口) |
| 端口 | 描述 |
|---|---|
8080/tcp | 默认 WebUI 端口 |
无
| 标签 | 描述 | 是否静态 |
|---|---|---|
latest | 指向最新的运行时镜像。可能在 24 小时内指向新构建,具体取决于上游仓库的代码变更。 | 否 |
<git description>例如: v5.51-1-g3c7564d | 指向上游仓库中特定的 git 描述。例如:pikvm/ustreamer:v5.51-1-g3c7564d | 是 |
容器内每 5 秒执行一次 /opt/health.sh 脚本。
注意:在 Docker 中启用健康检查可能会显著增加 CPU 使用率。测试中,每 30 秒执行一次健康检查时容器 CPU 使用率翻倍,每 5 秒执行时增加六倍。这可能导致低功耗主机资源不足和异常行为。
脚本功能:
.ok 设置为 true(表示 ustreamer 正常运行).result.source.online 设置为 true(表示视频源(摄像头)正常返回图像而非“无信号”)Compose 示例:
yamlservices: ustreamer: healthcheck: test: ["bash", "/opt/health.sh"] interval: 30s # 检查间隔,建议设为 30s 以降低资源消耗



manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务