joostm8/3d-printer-viewer

镜像概述

本容器启动一个Web服务器，提供Ender 3 3D打印机的可视化界面，用户可通过浏览器访问http://localhost:8000查看打印状态及模型展示。

核心功能

1. 展示3D打印机的实时可视化界面
2. 支持Websocket API接收三种命令，实现网格重置、位置更新、挤出状态调整

使用场景

• 实时监控3D打印机的打印过程与模型状态
• 可视化调试打印路径及挤出参数

配置说明

• 端口映射：需将容器8000端口映射至主机端口（如8000:8000）
• Websocket依赖：客户端默认尝试连接ws://localhost:9090的Websocket服务器，需在此地址部署对应服务以发送控制命令

部署示例

Docker Compose配置

yaml
services:
  3d-printer-viewer:
    image: docker.xuanyuan.run/joostm8/3d-printer-viewer
    restart: unless-stopped
    ports:
     - 8000:8000

Websocket API说明

客户端网页会建立到ws://localhost:9090的Websocket连接，支持以下命令：

Mesh命令（重置网格）

json
{"type":"mesh", "reset":true|false}

PositionUpdate命令（更新位置）

x、y、z为米单位，e表示是否挤出：

json
{"type":"positionUpdate", "x":0.1, "y":0.2, "z":0.3, "e":true}

Extrusion命令（调整挤出可视化）

width、depth为米单位：

json
{"type":"extrusion","extruding":true, "extrusionWidth":0.002, "extrusionDepth":0.001}