Klipper 버전 전환 가이드

적용 조건

이 문서는 FlyOS-FAST 시스템을 사용하는 장치에만 적용됩니다.

주요 기능 변경 안내

주의: Kalico 브랜치로 전환하거나 공식 원판 Klipper로 전환하는 경우, FlyOS-FAST 시스템의 기존 전원 복귀 후 인쇄 재개, USB 드라이브 인쇄 등 전용 기능이 완전히 작동하지 않게 됩니다. 이러한 기능들은 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 버전으로 복원하면, 전원 복귀 후 인쇄 재개, USB 드라이브 인쇄 등 전용 기능이 자동으로 복구됩니다.

주의

복원 작업은 현재의 /data/klipper 디렉토리를 덮어씁니다. 현재 버전 파일을 더 이상 보관할 필요가 없는지 확인하세요.

버전 확인

서비스를 재시작한 후, Klipper 웹 인터페이스나 로그를 통해 현재 실행 중인 버전이 성공적으로 전환되었는지 확인할 수 있습니다.