dimalo/mainsail

镜像概述

klipper-web-control-docker是一个Docker镜像，提供Klipper 3D打印机固件的Mainsail网页界面。该镜像封装了Mainsail前端应用，旨在为使用Klipper固件的3D打印机用户提供便捷、直观的Web控制界面，简化3D打印过程的管理与监控。

核心功能和特性

• 直观的用户界面：基于Web的图形化操作界面，支持打印状态实时显示、温度控制、轴移动等核心操作
• 打印作业管理：支持上传、启动、暂停、取消打印任务，查看打印进度与历史记录
• 设备状态监控：实时显示打印机各轴位置、挤出机温度、热床温度等关键参数
• 配置管理：集成Klipper配置文件编辑功能，支持固件参数调整与保存
• 多设备支持：可通过配置连接多台运行Klipper固件的3D打印机（需额外配置）
• 轻量化部署：基于Docker容器化设计，简化安装流程，减少系统依赖冲突

使用场景和适用范围

• 3D打印爱好者：个人用户通过Web界面便捷控制家用3D打印机
• 创客工作室：小型团队集中管理多台3D打印设备，监控打印进度
• 教育场景：教学环境中展示3D打印过程，便于操作演示与教学指导
• Klipper固件用户：所有使用Klipper开源3D打印机固件的设备，需配合Klipper服务端使用

使用方法和配置说明

前置要求

• 已安装Docker Engine（20.10+版本推荐）
• 已部署Klipper服务端（需确保Mainsail能访问Klipper的API接口，默认端口7125）
• 网络环境支持Web访问（客户端需能访问运行容器的主机IP和映射端口）

Docker快速启动

通过以下命令直接运行容器：

bash
docker run -d \
  --name klipper-web-control \
  -p 80:80 \  # Web界面访问端口（可自定义修改主机端口）
  -v /path/to/klipper/config:/config \  # 挂载Klipper配置文件目录（可选）
  -e KLIPPER_HOST=klipper-server-ip \  # Klipper服务端IP地址或主机名
  -e KLIPPER_PORT=7125 \  # Klipper服务端API端口（默认7125）
  --restart unless-stopped \
  dimalo/klipper-web-control:latest

Docker Compose配置

创建docker-compose.yml文件，内容示例：

yaml
version: '3'
services:
  klipper-web-control:
    image: dimalo/klipper-web-control:latest
    container_name: klipper-web-control
    ports:
      - "8080:80"  # 主机端口:容器端口（根据需求修改主机端口）
    volumes:
      - ./klipper-config:/config  # 本地Klipper配置目录映射（可选）
    environment:
      - KLIPPER_HOST=192.168.1.100  # 替换为实际Klipper服务端IP
      - KLIPPER_PORT=7125
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

访问界面

容器启动后，通过浏览器访问 http://<主机IP>:<映射端口> 即可打开Mainsail界面（例如：http://192.168.1.200:80）。首次访问需确保Klipper服务端已启动并正常运行，界面将自动连接至配置的Klipper服务端。

关键配置参数

数据持久化

建议挂载以下目录以确保配置与数据持久化：

• /config：Klipper配置文件目录（若需在界面中编辑配置）
• /data：Mainsail应用数据目录（包含打印历史、日志等）

示例挂载命令：

bash
-v /your/local/config:/config \
-v /your/local/data:/data \