Skip to content

About

超轻量级 DJI Action / RTMP 摄像头局域网直播监看微服务(go2rtc 零转码 WebRTC + 极简 H5),部署于 NAS Docker,适配拓竹 X2D 等 3D 打印机高清外置监控

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Bambu Action Monitor

超轻量 DJI Action / RTMP 摄像头局域网监看微服务 · go2rtc 零转码 WebRTC + 拓竹极简 H5

Version Camera Core Deploy License


为什么做这个?

理由非常直接:打印机自带的仓内摄像头画质太差、不够清晰。

与其将就内置的低清模组,不如直接外挂一颗高清运动相机。我自己是用吸盘支架把 DJI Osmo Action 3 直接吸附贴在拓竹 X2D 的前玻璃面板外侧,开启局域网 RTMP 直播推流到家里 极空间 Z4 NAS 的 Docker 容器中,做成了这个打开浏览器就能看高清打印画面的极简 H5 监看服务。


核心定位(不止于 3D 打印机)

虽然这个项目起因是为了给拓竹 X2D 看打印状态,但在架构上它本质是一个通用的「RTMP 推流相机 / 摄像头转 WebRTC 网页监看微服务」:

  • DJI Action / 运动相机:DJI Osmo Action 3 / 4 / 5 Pro、Osmo Pocket 3、Insta360 等任何可在 App 内填写自定义 RTMP 地址的相机都能直接接入;
  • 任意 RTMP 推流源:OBS Studio、手机端 RTMP 推流 App、FFmpeg 推流脚本、带 RTMP 推流能力的安防摄像机,只要能向 rtmp://<NAS_IP>:1935/printer 推入 H.264 视频流即可复用;
  • 全端免装 App 打开即看:电脑、手机(iOS / Android)、平板浏览器打开网页自动按 WebRTC → MSE → HLS → HTTP-MP4 匹配最优协议播放,无需安装任何客户端。

写在前面(使用前必看)

这是一个面向个人与极客用户的开源轻量微服务,源码结构简单透明,使用前可以快速了解以下几个边界:

  1. 作者实机形态:我目前是在 拓竹 X2D 前玻璃面板外部贴吸盘安装 DJI Action 3 跑通的日常 1080p 监控;界面交互也围绕机位调整做了适配(支持 90°/180°/270° 旋转、水平镜像、一键抓拍和手机原生横屏全屏)。
  2. 目前仅做 RTMP 推流,开销极小:
    • 为了把机器资源占用压到最低,当前只实现了 RTMP 推流接入,并且强制走纯视频直通(丢弃音频);
    • 不做视频硬软转码,也不引入沉重后端运行时,NAS 上整套服务平时 CPU 几乎 0% 占用、内存仅十来 MB,长时间挂着监控打印几乎感觉不到负载。
  3. 部署在 NAS Docker,默认局域网(可自行端口映射):
    • 整个服务直接部署在 NAS(实测极空间 Z4)的 Docker 中,默认面向本地局域网访问,不依赖任何第三方云端;
    • 外网访问说明:如果出门在外需要用手机流量看画面,可以在家里路由器上把 8088(H5 网页与 HTTP 视频流)和 8555(WebRTC TCP/UDP 媒体端口)做端口映射(Port Forwarding) 配合公网 IP/DDNS,或者走 Tailscale / WireGuard / 极空间自带远程访问即可。
  4. 源码全公开,欢迎按需求自行魔改:
    • 前端就是原生的 HTML + CSS + ES Module JS(零打包构建步骤),核心流媒体仅一份 30 行的 go2rtc.yaml 与 50 行的 nginx.conf;
    • 每个目录都带有 AGENTS.md 说明职责边界、代码里也有详细中文“为什么这样写”的注释,拿走改个主题色、换个流名称、扩展多机位都很轻松。

实机机位与界面展示

DJI Action 3 吸附于拓竹 X2D 前面板实拍 浏览器 WebRTC 实时监看界面(无阴影拓竹主题)

已实现交互特性

  • 纯视频极速起播:强制只拉取视频轨,避免 DJI Action 推流 AAC 音频与浏览器 WebRTC Opus 冲突,全浏览器直接硬件零转码直出。
  • 后端在线态感知:自动同步后端流在线状态,刷新网页直接续播,不会在已推流期间误弹出配网引导;推流断开后自动恢复等待页,重新开播 2 秒内自动拉起。
  • 单层卡片与多端自适应:极简纯色圆角 + 1px 细丝边框(零容器阴影),自动适应浅色/深色系统主题,覆盖 320px 超窄手机至桌面大屏;手机端“全屏”原生拉起横屏全屏播放器。
  • 低功耗后台控制:标签页切后台自动暂停轮询,切回瞬间立即同步。

快速部署与使用

1. 在 NAS / Linux 主机通过 Docker Compose 启动

git clone https://github.com/Jolly-J/BambuActionMonitor.git
cd BambuActionMonitor/docker
cp .env.example .env
docker compose up -d

说明:如使用极空间 Z4 等界面化 Docker 管理器,可直接把 src/go2rtc/go2rtc.yaml 与 src/web/ 上传到 NAS 目录后按 docker/docker-compose.yml 同参数创建容器(使用 host 网络模式,避开系统 8080 端口占用,网页统一挂载在 8088)。

2. 开启相机 RTMP 推流

  1. 用手机打开网页 http://<你的NAS局域网IP>:8088/,在未推流界面直接复制页面展示的 RTMP 地址:rtmp://<你的NAS局域网IP>:1935/printer;
  2. 打开 DJI Mimo App 连接 Action 3(或其他任意支持 RTMP 的相机/软件),进入直播选择 RTMP;
  3. 粘贴上述 RTMP 地址,分辨率选择 1080p / 720p,点击开始直播推流,1~2 秒内浏览器即可出画。

没有实机也可以在本机先跑测试流联调(需要本机安装 ffmpeg):

./scripts/push-test-stream.sh rtmp://<你的NAS_IP>:1935/printer

端口与外网端口映射说明

服务采用 network_mode: host 模式运行,使 go2rtc 能直接向局域网客户端通告真实的 NAS IP。若需从公网看监控,请按需在路由器配置转发:

端口 协议 用途说明 是否需要外网端口映射
8088 TCP H5 监看页面、状态接口与 HTTP-MP4 / HLS 兜底拉流 必选(外网看网页入口)
8555 TCP + UDP WebRTC 音视频媒体通道(毫秒级超低延迟首选) 建议映射(不映射将自动回退走 8088 HTTP-MP4)
1935 TCP 接收 DJI Action / 推流设备的 RTMP 入口 仅内网推流无需映射(若在户外向家里 NAS 推流才需映射)
8554 TCP 标准 RTSP 拉流口(供 VLC / PotPlayer / Home Assistant 使用) 按需
1984 TCP go2rtc 内部管理 API(已由 Nginx 反代至 8088/api/) 无需对外映射

安全提示:本项目默认无账号密码鉴权。若需暴露到公网端口映射,强烈建议叠加 WireGuard / Tailscale 内网穿透,或在反代前置一层 Basic Auth / 访问控制。


项目结构说明(方便自己改)

全仓遵循「INDEX.md 全局总索引 + 目录级 AGENTS.md」规范,改动源码或界面无需任何编译步骤:

.
├── AGENTS.md                        # 全局工程规范、索引维护与注释约定
├── INDEX.md                         # 全仓目录与全量文件总索引
├── CHANGELOG.md                     # 版本更新日志
├── LICENSE                          # MIT 开源协议
├── docs/                            # 选型方案、NAS 调研报告与实拍截图资源
│   ├── 01-zspace-nas-skill-research.md
│   ├── 02-architecture-options.md
│   └── images/
├── src/
│   ├── go2rtc/go2rtc.yaml           # RTMP(:1935)、RTSP(:8554)、WebRTC(:8555) 核心配置
│   └── web/                         # 原生 H5 前端与 Nginx 单端口反代(免编译直接改)
│       ├── nginx.conf               # 8088 监听 + WebSocket/HTTP 流反代(关闭 proxy_buffering)
│       ├── index.html               # 极简三段式监看页面骨架
│       ├── styles.css               # 拓竹绿主题、浅深色自适应与全端网格布局(零阴影)
│       └── app.js                   # 纯视频拉流、顺时针旋转镜像、抓拍、手机横屏全屏与兜底回退
├── docker/
│   ├── docker-compose.yml           # go2rtc + nginx:alpine 极空间 Z4 编排
│   └── .env.example                 # 时区等环境变量模板
└── scripts/
    └── push-test-stream.sh          # 本机 FFmpeg 模拟 H.264 RTMP 推流验证脚本

开源协议

本项目基于 MIT License 开源,所有源码完全公开。欢迎 Fork 按自己手头的相机型号、打印机机位或 NAS 环境随意调整,也欢迎提 Issue 和 PR 一起完善!

About

超轻量级 DJI Action / RTMP 摄像头局域网直播监看微服务(go2rtc 零转码 WebRTC + 极简 H5),部署于 NAS Docker,适配拓竹 X2D 等 3D 打印机高清外置监控

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages