理由非常直接:打印机自带的仓内摄像头画质太差、不够清晰。
与其将就内置的低清模组,不如直接外挂一颗高清运动相机。我自己是用吸盘支架把 DJI Osmo Action 3 直接吸附贴在拓竹 X2D 的前玻璃面板外侧,开启局域网 RTMP 直播推流到家里 极空间 Z4 NAS 的 Docker 容器中,做成了这个打开浏览器就能看高清打印画面的极简 H5 监看服务。
虽然这个项目起因是为了给拓竹 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匹配最优协议播放,无需安装任何客户端。
这是一个面向个人与极客用户的开源轻量微服务,源码结构简单透明,使用前可以快速了解以下几个边界:
- 作者实机形态:我目前是在 拓竹 X2D 前玻璃面板外部贴吸盘安装 DJI Action 3 跑通的日常 1080p 监控;界面交互也围绕机位调整做了适配(支持 90°/180°/270° 旋转、水平镜像、一键抓拍和手机原生横屏全屏)。
- 目前仅做 RTMP 推流,开销极小:
- 为了把机器资源占用压到最低,当前只实现了 RTMP 推流接入,并且强制走纯视频直通(丢弃音频);
- 不做视频硬软转码,也不引入沉重后端运行时,NAS 上整套服务平时 CPU 几乎 0% 占用、内存仅十来 MB,长时间挂着监控打印几乎感觉不到负载。
- 部署在 NAS Docker,默认局域网(可自行端口映射):
- 整个服务直接部署在 NAS(实测极空间 Z4)的 Docker 中,默认面向本地局域网访问,不依赖任何第三方云端;
- 外网访问说明:如果出门在外需要用手机流量看画面,可以在家里路由器上把
8088(H5 网页与 HTTP 视频流)和8555(WebRTC TCP/UDP 媒体端口)做端口映射(Port Forwarding) 配合公网 IP/DDNS,或者走 Tailscale / WireGuard / 极空间自带远程访问即可。
- 源码全公开,欢迎按需求自行魔改:
- 前端就是原生的 HTML + CSS + ES Module JS(零打包构建步骤),核心流媒体仅一份 30 行的
go2rtc.yaml与 50 行的nginx.conf; - 每个目录都带有
AGENTS.md说明职责边界、代码里也有详细中文“为什么这样写”的注释,拿走改个主题色、换个流名称、扩展多机位都很轻松。
- 前端就是原生的 HTML + CSS + ES Module JS(零打包构建步骤),核心流媒体仅一份 30 行的
| DJI Action 3 吸附于拓竹 X2D 前面板实拍 | 浏览器 WebRTC 实时监看界面(无阴影拓竹主题) |
|---|---|
![]() |
![]() |
- 纯视频极速起播:强制只拉取视频轨,避免 DJI Action 推流 AAC 音频与浏览器 WebRTC Opus 冲突,全浏览器直接硬件零转码直出。
- 后端在线态感知:自动同步后端流在线状态,刷新网页直接续播,不会在已推流期间误弹出配网引导;推流断开后自动恢复等待页,重新开播 2 秒内自动拉起。
- 单层卡片与多端自适应:极简纯色圆角 +
1px细丝边框(零容器阴影),自动适应浅色/深色系统主题,覆盖320px超窄手机至桌面大屏;手机端“全屏”原生拉起横屏全屏播放器。 - 低功耗后台控制:标签页切后台自动暂停轮询,切回瞬间立即同步。
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)。
- 用手机打开网页
http://<你的NAS局域网IP>:8088/,在未推流界面直接复制页面展示的 RTMP 地址:rtmp://<你的NAS局域网IP>:1935/printer; - 打开 DJI Mimo App 连接 Action 3(或其他任意支持 RTMP 的相机/软件),进入直播选择 RTMP;
- 粘贴上述 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 一起完善!

