切换 Klipper 版本指南

适用条件

本文档仅适用于使用 FlyOS-FAST 系统 的设备。

重要功能变更提示

请注意： 无论是切换至 Kalico 分支还是官方原版 Klipper，都将导致 FlyOS-FAST 系统原有的断电续打、U盘打印等专属功能完全失效。这些功能仅与 FlyOS-FAST 定制系统深度绑定，无法在其他 Klipper 版本中使用。

如果您依赖这些功能，请谨慎考虑是否切换版本。

在进行任何版本切换前，请确保已了解操作风险。建议在操作前对重要配置文件进行额外备份。

通用步骤说明

以下操作均包含三个主要阶段：

1. 备份当前版本
2. 拉取并替换为目标版本
3. 重启服务生效

若新版本出现问题，可利用备份快速还原。

---

安装 Kalico 分支

1. 备份当前 Klipper

   mv /data/klipper /data/klipper_old

2. 拉取 Kalico 版本

   git clone https://github.com/KalicoCrew/kalico.git /data/klipper

   提示

   由于网络或服务器原因，拉取过程可能缓慢甚至失败。如遇问题，可尝试重复执行或检查网络连接。

3. 重启 Klipper 服务

   sudo systemctl restart klipper

4. 演示

   • 出现类似界面则代表成功拉取成功
   

---

安装官方原版 Klipper

1. 备份当前 Klipper

   mv /data/klipper /data/klipper_old

2. 拉取官方版本

   git clone https://github.com/Klipper3d/klipper.git /data/klipper

   提示

   由于网络或服务器原因，拉取过程可能缓慢甚至失败。如遇问题，可尝试重复执行或检查网络连接。

3. 重启 Klipper 服务

   sudo systemctl restart klipper

---

还原到先前版本

如果在切换后遇到问题，可随时还原到备份的版本：

rm -rf /data/klipper

# 还原备份
mv /data/klipper_old /data/klipper

# 重启服务
sudo systemctl restart klipper

功能恢复

还原到原来的 FlyOS-FAST 系统 Klipper 版本后，断电续打、U盘打印等专属功能将自动恢复。

警告

还原操作会覆盖当前的 /data/klipper 目录，请确保已无需保留当前版本文件。

验证版本

重启服务后，你可以通过 Klipper 网页界面或日志来确认当前运行的版本是否已切换成功。