Klipper Nuitka 部署工具

将 Klipper 3D 打印机固件使用 Nuitka 编译为二进制文件，提升性能并简化部署。

特性

• ✅ 一键编译和部署
• ✅ 性能提升 3-7%
• ✅ 简化部署（无 Python 依赖）
• ✅ ARM64/x86_64 支持
• ✅ 自动环境配置

性能对比

项目	Python 版本	Nuitka 版本	变化
启动速度	基准	+5%	更快
Python 性能	基准	+12-24%	优化
总体性能	基准	+3-7%	提升

快速开始

1. 安装依赖

# Ubuntu/Debian
sudo apt install -y python3 gcc g++ make git patchelf ccache

# 安装 uv
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.cargo/env

2. 一键部署

git clone https://github.com/cuihuir/klipper_bin.git
cd klipper_bin/scripts

./deploy.sh -y

3. 启动服务

sudo systemctl start klipper.service
sudo systemctl status klipper.service

文档

• 使用指南 - 详细使用说明
• 完整指南 - 技术细节和原理

目录结构

klipper_bin/
├── scripts/
│   ├── deploy.sh          # 主部署脚本
│   └── fix_arm64.sh       # ARM64 修复脚本
├── docs/
│   ├── usage.md           # 使用文档
│   └── guide.md           # 完整指南
├── patches/
│   └── chelper_init.patch # 源码补丁说明
└── examples/
    └── printer.cfg        # 配置示例

支持的平台

• ✅ x86_64 (Intel/AMD)
• ✅ ARM64 (树莓派、Orange Pi 等)
• ✅ Debian/Ubuntu 系列发行版

依赖

• 必需: python3, gcc, make, git, patchelf (ARM64)
• 可选: ccache (加速编译)

许可证

GPLv3 - 与 Klipper 保持一致

相关项目

• Klipper - 3D 打印机固件
• Nuitka - Python 编译器

贡献

欢迎提交 Issue 和 Pull Request！

版本

v1.1 - 2026-01-27