跳到主要内容

切换 Klipper 版本指南

适用条件

本文档仅适用于 FLYOS-FAST。以下操作用于兼容确实要求第三方 Klipper 分支的插件，不建议作为常规升级方式。

重要功能变更

切换到 Kalico 或 Klipper 官方原版后，FLYOS-FAST 的断电续打、U 盘打印等定制功能会失效。需要这些功能时，请保留系统自带 Klipper。

切换前请备份 /usr/share/printer_data/config。下载目标版本和替换运行目录必须分开进行，避免网络中断后留下不完整的 /data/klipper。

安装 Kalico​

拉取或更新 Kalico​

此步骤需要连接 GitHub，但不会修改当前正在使用的 /data/klipper。

cd /data
if [ -d /data/kalico/.git ]; then
  git -C /data/kalico pull --ff-only
else
  git clone https://github.com/KalicoCrew/kalico.git /data/kalico
fi
Loading...

切换运行目录​

确认拉取成功且 /data/klipper-flyos-fast 不存在后再执行：

systemctl stop klipper
mv /data/klipper /data/klipper-flyos-fast
mv /data/kalico /data/klipper
systemctl start klipper
systemctl is-active klipper
Loading...

返回 active 只代表服务已启动，还需要查看 Klipper 日志并确认打印机配置没有版本兼容错误。

安装 Klipper 官方原版​

拉取或更新官方版本​

cd /data
if [ -d /data/klipper-upstream/.git ]; then
  git -C /data/klipper-upstream pull --ff-only
else
  git clone https://github.com/Klipper3d/klipper.git /data/klipper-upstream
fi
Loading...

切换运行目录​

确认拉取成功且 /data/klipper-flyos-fast 不存在后再执行：

systemctl stop klipper
mv /data/klipper /data/klipper-flyos-fast
mv /data/klipper-upstream /data/klipper
systemctl start klipper
systemctl is-active klipper
Loading...

恢复 FLYOS-FAST 自带 Klipper​

恢复前确认 /data/klipper-flyos-fast 是切换时保留的原始目录：

systemctl stop klipper
mv /data/klipper "/data/klipper-third-party-$(date +%Y%m%d-%H%M%S)"
mv /data/klipper-flyos-fast /data/klipper
systemctl start klipper
systemctl is-active klipper

恢复成功后，服务状态应返回 active，FLYOS-FAST 定制功能也会重新使用系统自带实现。当前第三方目录会以时间戳名称保留，不会被直接删除。

Loading...