本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。
所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
轩辕镜像 - 国内开发者首选的专业 Docker 镜像下载加速服务平台 - 官方QQ群:13763429 👈点击免费获得技术支持。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。
本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com
klipper Docker 镜像下载 - 轩辕镜像
klipper 镜像详细信息和使用指南
klipper 镜像标签列表和版本信息
klipper 镜像拉取命令和加速下载
klipper 镜像使用说明和配置指南
Docker 镜像加速服务 - 轩辕镜像平台
国内开发者首选的 Docker 镜像加速平台
极速拉取 Docker 镜像服务
相关 Docker 镜像推荐
热门 Docker 镜像下载
mkuf/klipper
klipper 镜像详细信息
klipper 镜像标签列表
klipper 镜像使用说明
klipper 镜像拉取命令
Docker 镜像加速服务
轩辕镜像平台优势
镜像下载指南
相关 Docker 镜像推荐
Klipper是一款开源的3D打印机固件，其核心优势在于采用高性能计算架构，支持多处理器协同工作，能显著提升打印速度与精度，同时优化打印质量；该固件兼容多种主流3D打印机主板，具备模块化设计，便于用户根据需求扩展功能或进行个性化定制，为3D打印爱好者和专业用户提供了高效、灵活的打印解决方案。
4 收藏0 次下载activemkuf镜像
klipper 镜像详细说明
klipper 使用指南
klipper 配置说明
klipper 官方文档
Docker封装的Klipper
此镜像由 prind项目 构建和使用。
什么是Klipper？
Klipper是一款3D打印机固件。它将通用计算机的算力与一个或多个微控制器结合，充分发挥硬件性能。关于使用Klipper的优势，可参考其功能文档。
引用自 [**]
使用方法
Klipper需要访问主机设备，建议以特权模式运行并挂载主机的/dev目录。非特权模式可能因MCU重置后设备名变更导致功能异常（参考相关问题）。
独立运行
准备工作
- 创建配置文件
printer.cfg - 创建目录
run
运行容器
通过docker run命令
docker run \ --privileged \ -v /dev:/dev \ -v $(pwd)/run:/opt/printer_data/run \ -v $(pwd)/printer.cfg:/opt/printer_data/config/printer.cfg \ mkuf/klipper:latest
通过docker compose配置
services: klipper: image: mkuf/klipper:latest privileged: true volumes: - /dev:/dev - ./printer.cfg:/opt/printer_data/config/printer.cfg - ./run:/opt/printer_data/run
连接GCODE发送器
将GCODE发送器指向 run 目录下的 klipper.tty 文件即可。
与Moonraker一起使用
若需搭配Moonraker使用，两者需共享包含套接字的目录。Moonraker镜像的详细使用说明见其README.md。
准备工作
- 创建配置文件
moonraker.conf和printer.cfg - 创建目录
run（共享套接字）和gcode（存储GCODE文件）
运行容器
通过docker run命令
先启动Klipper：
docker run \ --privileged \ -v /dev:/dev \ -v $(pwd)/run:/opt/printer_data/run \ -v $(pwd)/gcode:/opt/printer_data/gcodes \ -v $(pwd)/printer.cfg:/opt/printer_data/config/printer.cfg \ mkuf/klipper:latest
再启动Moonraker：
docker run \ -v $(pwd)/run:/opt/printer_data/run \ -v $(pwd)/gcode:/opt/printer_data/gcodes \ -v $(pwd)/moonraker.conf:/opt/printer_data/config/moonraker.conf \ -p 7125:7125 \ mkuf/moonraker:latest
通过docker compose配置
services: klipper: image: mkuf/klipper:latest privileged: true volumes: - /dev:/dev - ./printer.cfg:/opt/printer_data/config/printer.cfg - ./run:/opt/printer_data/run - ./gcode:/opt/printer_data/gcodes moonraker: image: mkuf/moonraker:latest ports: - "7125:7125" volumes: - ./moonraker.conf:/opt/printer_data/config/moonraker.conf - ./run:/opt/printer_data/run - ./gcode:/opt/printer_data/gcodes
默认配置
| 项目 | 说明 |
|---|---|
| 用户 | klipper (1000:1000) |
| 工作目录 | /opt |
| 入口命令 | /opt/venv/bin/python klipper/klipper/klippy.py |
| 启动参数 | -I printer_data/run/klipper.tty -a printer_data/run/klipper.sock printer_data/config/printer.cfg |
镜像标签
| 标签 | 说明 | 是否静态 |
|---|---|---|
latest | 指向最新的Klippy运行镜像。根据上游代码变更，可能24小时内更新版本。 | 否 |
<git描述>（如 v0.12.0-114-ga77d0790） | 对应上游仓库的特定git描述版本，如 Klipper3d/klipper:v0.12.0-114-ga77d0790。 | 是 |
*-tools | 包含MCU代码编译所需工具的Debian镜像。 | 是 |
*-hostmcu | klipper_mcu二进制文件的运行镜像。 | 是 |
构建目标
| 目标 | 说明 | 是否推送 |
|---|---|---|
build | 拉取上游代码并构建Python虚拟环境。 | 否 |
build-simulavr | 基于mcu目标，拉取并构建simulavr（用于无硬件测试）。 | 否 |
build-hostmcu | 基于mcu目标，构建klipper_mcu二进制文件。 | 否 |
run | 默认的Klippy运行镜像。 | 是 |
tools | MCU代码编译工具镜像。 | 是 |
hostmcu | klipper_mcu二进制文件的运行镜像。 | 是 |
健康检查
容器内提供 /opt/health.py 脚本用于健康检查。
注意：在Docker中启用健康检查可能显著增加CPU占用。测试中，每30秒执行一次检查会使容器CPU占用翻倍，每5秒执行则增至6倍。低功耗主机可能因此出现资源不足或异常行为。
脚本功能：
- 通过Unix套接字查询Klipper的
info端点 - 检查状态是否为
ready - 若上述任一条件不满足，脚本返回失败状态，标记容器为不健康
Compose配置示例：
services: klipper: healthcheck: test: ["python3", "/opt/health.py"] interval: 30s
常见问题
轩辕镜像免费版与专业版有什么区别？
免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。
轩辕镜像免费版与专业版有分别支持哪些镜像？
免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
流量耗尽错误提示
当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。
410 错误问题
通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。
manifest unknown 错误
先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。
镜像拉取成功后，如何去掉轩辕镜像域名前缀？
使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。
轩辕镜像下载加速使用手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
登录方式进行 Docker 镜像下载加速教程
通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤
Linux Docker 镜像下载加速教程
在 Linux 系统上配置轩辕镜像源，支持主流发行版
Windows/Mac Docker 镜像下载加速教程
在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统
Docker Compose 镜像下载加速教程
在 Docker Compose 中使用轩辕镜像加速，支持容器编排
K8s containerd 镜像下载加速教程
在 k8s 中配置 containerd 使用轩辕镜像加速
宝塔面板 Docker 镜像下载加速教程
在宝塔面板中配置轩辕镜像加速，提升服务器管理效率
群晖 NAS Docker 镜像下载加速教程
在 Synology 群晖NAS系统中配置轩辕镜像加速
飞牛fnOS Docker 镜像下载加速教程
在飞牛fnOS系统中配置轩辕镜像加速
极空间 NAS Docker 镜像下载加速教程
在极空间NAS中配置轩辕镜像加速
爱快路由 ikuai Docker 镜像下载加速教程
在爱快ikuai系统中配置轩辕镜像加速
绿联 NAS Docker 镜像下载加速教程
在绿联NAS系统中配置轩辕镜像加速
威联通 NAS Docker 镜像下载加速教程
在威联通NAS系统中配置轩辕镜像加速
Podman Docker 镜像下载加速教程
在 Podman 中配置轩辕镜像加速，支持多系统
ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程
配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤
专属域名方式进行 Docker 镜像下载加速教程
无需登录即可使用轩辕镜像加速服务，更加便捷高效
需要其他帮助？请查看我们的 常见问题 或 官方QQ群: 13763429