dimalo/klipper-moonraker

镜像概述

Klipper Web Control Docker镜像为3D打印机提供基于Klipper固件的控制解决方案，集成Moonraker API，支持多架构部署。Klipper是高性能3D打印机固件，以精准运动控制和丰富功能著称；Moonraker是其配套API服务，提供Web界面与第三方集成能力。该镜像将两者打包，简化部署流程，适用于各类计算设备。

核心功能与特性

• 多架构支持：兼容amd64、arm64、armhf等架构，可运行于PC、Raspberry Pi、Orange Pi等设备
• 完整集成：包含Klipper固件核心、Moonraker API服务及Web控制界面
• 简化部署：预配置基础环境，无需手动编译或安装依赖
• 灵活配置：支持通过环境变量和数据卷自定义Klipper配置文件
• API支持：Moonraker API提供标准化接口，便于集成第三方应用（如OctoPrint、手机APP等）

使用场景与适用范围

• DIY 3D打印机用户：需要高性能固件且希望简化部署流程
• 多设备部署场景：在不同架构的控制板上统一使用Klipper
• 开发者与集成商：需通过API与Klipper进行交互的应用开发
• 教育与实验室环境：快速搭建3D打印控制演示系统

使用方法与配置说明

基础运行（docker run）

bash
docker run -d \
  --name klipper-web-control \
  --restart unless-stopped \
  -p 7125:7125 \
  -v /path/to/klipper/config:/config \
  -v /path/to/klipper/logs:/logs \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  dimalo/klipper-web-control

Docker Compose配置

yaml
version: '3.8'

services:
  klipper-web-control:
    image: dimalo/klipper-web-control
    container_name: klipper-web-control
    restart: unless-stopped
    ports:
      - "7125:7125"
    volumes:
      - ./klipper/config:/config
      - ./klipper/logs:/logs
    devices:
      - /dev/ttyUSB0:/dev/ttyUSB0
    environment:
      - TZ=Asia/Shanghai
      - KLIPPER_CONFIG_FILE=/config/printer.cfg

环境变量说明

配置与验证

1. 配置文件：将Klipper配置文件（如printer.cfg）放入挂载的/config目录，参考Klipper官方文档
2. 访问API：通过http://<容器IP>:7125/验证Moonraker服务状态
3. 日志查看：使用docker logs klipper-web-control或检查/logs目录
4. 设备连接：确保串口设备正确绑定（如/dev/ttyUSB0），Klipper将自动加载配置并连接打印机