docker-klipper-simulavr 镜像文档

镜像概述和主要用途

docker-klipper-simulavr是一个集成Klipper（带Simulavr模拟）、Moonraker和mjpg-streamer的Docker镜像。该镜像每小时自动检查Klipper和Moonraker的"master"分支代码更新，如有修改则创建新镜像，确保用户能获取最新版本的组件。主要用于3D打印机固件开发、配置测试和Klipper生态系统学***，无需实际硬件即可构建完整的模拟运行环境。

核心功能和特性

• 完整组件集成：包含Klipper（带Atmel ATmega微控制器模拟）、Moonraker（3D打印服务器）和mjpg-streamer（视频流服务）
• 自动更新机制：每小时检查Klipper和Moonraker的master分支，自动构建包含最新代码的镜像
• 扩展功能模块：预装Klippy额外模块，包括virtual_pins（[]gcode_shell_command（[]
• 便利管理脚本：提供enable-timelapse（启用时间 lapse）、restore-klipper-repo和restore-moonraker-repo（恢复代码版本）等实用脚本
• 灵活部署选项：支持主机网络（简化端口配置）和桥接网络（自定义端口映射），可通过卷挂载覆盖配置文件
• 多版本标签：提供latest（跟踪master分支）、klipper-sha-<hash>（特定Klipper提交）和moonraker-sha-<hash>（特定Moonraker提交）标签

使用场景和适用范围

• 3D打印机固件（Klipper）开发与调试，无需实际硬件
• Klipper和Moonraker配置文件验证与测试
• Klipper生态系统（Klipper/Moonraker/mjpg-streamer）学***与功能验证
• 模拟3D打印过程及时间 lapse功能测试

详细使用方法和配置说明

基本运行方式

主机网络模式（推荐）

使用主机网络可直接映射服务端口，简化配置：

docker run -d \
  --name klipper-simulavr \
  --net=host \
  ei99070/docker-klipper-simulavr

启动后服务默认端口：

• Klipper（带Simulavr模拟）：集成运行
• Moonraker：7125端口
• mjpg-streamer：8080端口

桥接网络模式（自定义端口）

如需修改默认端口，使用桥接网络并指定端口映射：

docker run -d \
  --name klipper-simulavr \
  -p 7125:7125 \  # Moonraker端口
  -p 8080:8080 \  # mjpg-streamer端口
  ei99070/docker-klipper-simulavr

配置文件自定义

默认配置文件位于镜像的/klipper_config目录，运行时文件结构如下：

/printer
  /klipper
  /klippy-env
  /mjpg-streamer
  /moonraker
  /moonraker-env
  /printer_data
    /config
      /moonraker.conf
      /printer.cfg
    /database
    /gcodes
    /logs
      /klippy.log
      /moonraker.log
      /supervisord.log
    /moonraker.asvc
  /pysimulavr

可通过卷挂载覆盖单个文件或目录，例如自定义printer.cfg：

docker run -d \
  --name klipper-simulavr \
  --net=host \
  -v /本地路径/my-printer.cfg:/printer/printer_data/config/printer.cfg \
  ei99070/docker-klipper-simulavr

便利脚本使用

容器内置以下脚本，可通过docker exec执行：

• enable-timelapse：安装Moonraker时间 lapse依赖，更新配置并重启服务
• restore-klipper-repo：将Klipper仓库恢复到镜像构建时的提交点
• restore-moonraker-repo：将Moonraker仓库恢复到镜像构建时的提交点

示例：启用时间 lapse功能

docker exec -it klipper-simulavr enable-timelapse

可用标签

• latest：跟踪Klipper和Moonraker的"master"分支最新代码
• klipper-sha-<hash>：指向特定Klipper GitHub提交哈希
• moonraker-sha-<hash>：指向特定Moonraker GitHub提交哈希

常见问题（FAQ）

Q: 持续出现"MCU 'mcu' shutdown: Timer too close"错误？

A: 通过设置SIMULAVR_PACING_RATE环境变量调整模拟速率，例如：

docker run -d \
  --name klipper-simulavr \
  --net=host \
  -e SIMULAVR_PACING_RATE=0.2 \
  ei99070/docker-klipper-simulavr

许可证

MIT