FLYOS-FAST 자주 묻는 질문 및 문제 해결

이 페이지에서는 FLYOS-FAST의 시스템 제한 사항, 구성 경로, 업데이트 방식 및 일반적인 장애에 대해 설명합니다. 특정 기능의 전체 조작 단계는 링크를 통해 해당 문서로 이동하여 FAQ에서 중복으로 유지하지 않습니다.

권장 문제 해결 순서

1. 웹 페이지나 터미널에 표시된 전체 오류 메시지를 기록하고 마지막 줄만 캡처하지 마십시오.
2. 문제가 발생하기 전에 수정한 구성, 플러그인 또는 시스템 옵션을 확인하십시오.
3. 디스크 공간, 서비스 상태 및 해당 로그를 확인하십시오.
4. 서비스 또는 호스트를 재시작해야 하는 경우 프린터가 인쇄, 가열 또는 이동 중이 아닌지 먼저 확인하십시오.

시스템 및 계정

왜 root 사용자만 사용할 수 있나요?

FLYOS-FAST는 인쇄 제어 장치를 위해 설계된 간소화된 시스템으로 단일 사용자 관리 방식을 채택하고 있으며 root는 유일한 대화형 관리 계정입니다. 시스템은 다른 사용자의 생성 또는 전환을 지원하지 않습니다.

왜 apt나 dpkg를 사용할 수 없나요?

FLYOS-FAST는 기존 Linux 배포판의 패키지 관리 환경을 제공하지 않으므로 다음 명령을 사용하여 소프트웨어를 설치하거나 업데이트할 수 없습니다:

apt update
apt install
dpkg -i

다른 Linux 시스템에서 소프트웨어 패키지나 시스템 라이브러리를 복사하지 마십시오. 추가 종속성은 플러그인 설치 튜토리얼에서 명확히 제공해야 합니다. 일반적인 종속성이 누락된 경우 기술 지원에 피드백해 주십시오.

시스템 디렉터리가 읽기 전용으로 표시되는 이유는 무엇인가요?

핵심 시스템은 읽기 전용 파일 시스템을 사용하며 전체 이미지 또는 OTA를 통해 통합 업데이트됩니다. 루트 디렉터리를 다시 마운트하고 시스템 파일을 직접 수정하지 마십시오. 업데이트 실패나 재부팅 후 변경 사항 손실이 발생할 수 있습니다.

사용자 구성, 플러그인 및 인쇄 데이터는 영구 저장 디렉터리에 저장해야 합니다.

파일 및 구성

일반적인 파일은 어디에 저장되나요?

내용	Klipper 모드 경로	설명
프린터 구성	/usr/share/printer_data/config/	printer.cfg, Moonraker 및 카메라 구성 포함
G-code 파일	/usr/share/printer_data/gcodes/	웹 업로드 및 USB 인쇄 파일 진입점
실행 로그	/usr/share/printer_data/logs/	Klipper, Moonraker, 화면 및 카메라 로그
플러그인 및 소스 코드	/data/	사용자 정의 플러그인은 여기에 통합 배치해야 함
Klipper 소스 코드	/data/klipper/	시스템에 사전 설치된 Klipper 디렉터리
컴파일 산출물	/data/klipper/out/	펌웨어 컴파일 완료 후 출력 디렉터리

RRF 모드의 데이터 디렉터리는 /opt/dsf/이며 Klipper와 RRF의 구성 경로를 혼용하지 마십시오.

어떤 디렉터리가 영구 저장되나요?

시스템은 /etc, /data, /root 및 현재 인쇄 모드의 데이터 디렉터리를 저장합니다. 이러한 디렉터리가 보존되더라도 OTA 또는 재플래시 전에 프린터 구성을 별도로 백업해야 합니다.

FLYOS-FAST 시스템 구성을 어떻게 수정하나요?

시스템 모델, 네트워크, 화면 및 서비스 스위치는 FlyOS-Conf/config.txt에서 통합 관리됩니다. 시스템 시작 후에도 웹 페이지의 .flyos-config/sys-config.conf를 통해 수정할 수 있습니다.

구성 방법 및 적용 범위: FLYOS-FAST 시스템 구성 가이드 보기

구성을 수정한 후에도 적용되지 않는 이유는 무엇인가요?

다른 구성은 다른 적용 작업이 필요합니다:

수정 내용	적용 작업
printer.cfg 및 Klipper 구성 조각	웹 페이지에서 저장 및 재시작 실행
moonraker.conf	Moonraker 재시작
config.txt 또는 sys-config.conf	전체 호스트 재시작
플러그인 소스 코드 또는 심볼릭 링크	플러그인 튜토리얼에 따라 해당 서비스 재시작

재시작 후에도 적용되지 않으면 파일이 저장되었는지, 구성 항목이 중복 정의되지 않았는지 확인하고 해당 서비스 로그를 확인하십시오.

시스템 업데이트 및 펌웨어

시스템을 어떻게 업데이트해야 하나요?

FLYOS-FAST는 시스템 OTA 또는 해당 장치의 공식 이미지 재플래시를 통해 업데이트해야 합니다. 타사 시스템 업그레이드 스크립트를 사용하여 핵심 파일을 교체하지 마십시오.

온라인 및 USB 업데이트: OTA 시스템 업데이트 가이드 보기

시스템 재플래시: 시스템 이미지 플래시 튜토리얼 보기

OTA가 프린터 구성을 삭제하나요?

정상적인 OTA는 /data 및 프린터 데이터 디렉터리를 보존하지만 다음 상황에서는 구성 이상이 발생할 수 있습니다:

• 사용자가 Klipper, Moonraker 또는 기타 사전 설치된 구성 요소를 직접 교체한 경우.
• 사용자 정의 파일이 OTA에서 제공하는 새 파일을 가리는 경우.
• 업데이트 중 전원 공급이 중단된 경우.
• 업데이트 전 디스크 공간이 부족하거나 파일 시스템이 이미 손상된 경우.

업데이트 전에 printer_data/config 백업을 다운로드하거나 복사해야 합니다. 업데이트 및 재시작 중에는 전원 공급을 안정적으로 유지하고 인쇄 작업을 수행하지 마십시오.

Klipper 또는 Moonraker만 별도로 업데이트할 수 있나요?

권장하지 않습니다. 시스템의 Klipper, Moonraker, 웹 인터페이스 및 화면 서비스는 함께适配되어 있어 특정 구성 요소만 교체하면 경로, 확장 인터페이스 또는 업데이트 메커니즘이 손상될 수 있습니다. 시스템에서 제공하는 전체 업데이트 방식을 사용하십시오.

OTA 후 MCU 버전 불일치가 발생하면 어떻게 하나요?

OTA는 FLY-C8, FLY-C5, FLY-C8P 및 FLY-GEMINI V3 메인보드의 USB 펌웨어 자동 업데이트만 지원합니다. 다른 메인보드, CAN 펌웨어, 툴보드 및 기타 외부 MCU는 자동 업데이트를 지원하지 않으며 해당 제품 튜토리얼에 따라 수동으로 플래시해야 합니다.

자동 업데이트 범위 및 확인 방법: OTA 후 MCU 펌웨어 업데이트 설명 보기

펌웨어 컴파일 완료 후 파일은 어디에서 찾나요?

컴파일 산출물은 다음 위치에 있습니다:

/data/klipper/out/

실제 파일은 MCU 아키텍처와 부트로더 구성에 따라 klipper.bin 또는 klipper.uf2일 수 있습니다.

펌웨어 컴파일 설명: Klipper 펌웨어 컴파일 튜토리얼 보기

플러그인 및 Python 환경

왜 ~/klippy-env/bin/python을 찾을 수 없나요?

FLYOS-FAST는 시스템 Python을 사용하며 일반적인 klippy-env 가상 환경을 사용하지 않습니다. 명령의 Python 인터프리터와 Klipper 경로를 시스템 실제 경로로 변경해야 합니다. 예를 들어 CAN UUID를 쿼리할 때 다음을 사용합니다:

python /data/klipper/scripts/canbus_query.py can0

Python 명령만 교체하고 잘못된 ~/klipper/ 경로를 유지하지 마십시오.

플러그인은 어디에 설치해야 하나요?

플러그인 저장소는 /data/에 통합 배치됩니다. Klipper에 확장 파일을 추가해야 하는 경우 심볼릭 링크를 우선 사용하고 플러그인 튜토리얼에서 요구하는 파일 이름과 종속성을 먼저 확인하십시오. 전체 플러그인 디렉터리를 Klipper에 일괄 복사하지 마십시오.

설치 규칙 및 기존 플러그인 튜토리얼: 플러그인 설치 설명 보기

플러그인 설치 후 적용되지 않으면 어떻게 하나요?

다음을 순서대로 확인하십시오:

1. 네트워크 가져오기 단계가 완전히 성공했는지.

2. 플러그인 파일이 /data/에 실제로 존재하는지.

3. 심볼릭 링크가 올바른 파일을 가리키는지:

   readlink -f /data/klipper/klippy/extras/플러그인파일.py

4. printer.cfg에 플러그인 구성이 로드되었는지.

5. Klipper 로그에 모듈, 종속성 또는 구성 항목 누락 오류가 있는지.

오류를 우회하기 위해 안전 구성을 삭제하거나 Klipper의 온도, 리미트 및 가열 보호를 비활성화하지 마십시오.

웹 및 네트워크

각 웹 페이지 진입점은 무엇인가요?

기능	주소	사용 조건
Fluidd 또는 Mainsail	http://장치IP/	Klipper 모드 정상 시작
OTA 관리 페이지	http://장치IP:9998/	호스트 네트워크 정상
GoCam 관리 페이지	http://장치IP:8080/	GoCam 활성화됨

왜 장치IP:9999에 접속할 수 없나요?

FLYOS-FAST는 기본적으로 fly-tools 웹 서비스를 제공하지 않으므로 9999 포트가 응답하지 않는 것은 정상입니다. 시스템 구성 및 펌웨어 작업은 해당 FLYOS-FAST 문서와 SSH 명령을 사용해야 합니다.

메인 웹 페이지에 접속할 수 없을 때 어떻게 확인하나요?

1. 컴퓨터와 호스트가 동일한 LAN에 있는지 확인하십시오.

2. 라우터의 장치 주소를 확인하여 변경된 이전 IP를 계속 사용하지 마십시오.

3. SSH를 통해 현재 네트워크 주소를 확인하십시오:

   ip -br addr

4. 시작에 실패한 서비스가 있는지 확인하십시오:

   systemctl --failed --no-pager

5. SSH도 연결할 수 없는 경우 시스템이 시작을 완료했는지 먼저 확인한 다음 네트워크 케이블, Wi-Fi 구성 및 전원 공급을 점검하십시오.

SSH 연결 방법: SSH를 통해 호스트 연결하기

인쇄, USB 및 카메라

USB 드라이브는 인식되지만 인쇄를 시작할 수 없는 경우 어떻게 하나요?

파일 시스템, G-code 확장자, 로컬 남은 공간 및 파일 인코딩을 확인하십시오. 일부 비 UTF-8 G-code는 "로컬 업로드는 정상이지만 USB에서 인쇄를 시작할 수 없음" 상황이 발생합니다.

USB 인쇄 및 인코딩 문제 해결: USB 인쇄 기능 사용 가이드 보기

카메라에 화면이 없으면 어떻게 하나요?

먼저 카메라가 UVC 프로토콜을 지원하는지 확인한 다음 카메라 서비스가 활성화되었는지, 장치 노드가 올바른지, 해상도가 카메라에서 지원되는지 확인하십시오. 동일한 카메라를 사용하는 두 서비스를 동시에 시작하지 마십시오.

카메라 연결 및 설정: 카메라 연결 및 사용 방법 보기

지연 촬영에서 이미지가 생성되지 않으면 어떻게 해야 하나요?

먼저 브라우저에서 스냅샷 주소에 직접 접속하여 단일 이미지가 반환되는지 확인하세요. 카메라 서비스가 변경된 경우 moonraker.conf의 snapshoturl도 동기화하여 수정해야 합니다.

스냅샷 주소 및 로그 확인: 지연 촬영 기능 보기

Klipper 오류가 발생하면 어디서부터 확인해야 하나요?

웹 페이지에 표시된 원본 오류를 우선 기록하고, klippy.log에서 가장 먼저 나타난 예외를 확인하세요. 마지막에 표시되는 연결 끊김이나 재시작 알림은 보통 후속 현상일 뿐이며, 근본 원인이 아닐 수 있습니다.

Klipper 오류 색인: Klipper 일반 오류 보기

로그 및 기술 지원

일반적인 로그는 어디에 있나요?

로그	경로
Klipper	/usr/share/printer_data/logs/klippy.log
Moonraker	/usr/share/printer_data/logs/moonraker.log
KlipperScreen	/usr/share/printer_data/logs/klipperscreen.log
Crowsnest	/usr/share/printer_data/logs/crowsnest.log
GoCam	/usr/share/printer_data/logs/gocam.log
USB 자동 마운트	/var/log/flyos-auto-mount.log

최근 내용만 확인하려면 다음을 사용할 수 있습니다:

tail -n 100 /usr/share/printer_data/logs/klippy.log

주요 서비스 상태 확인:

systemctl status klipper moonraker --no-pager

시스템 리소스 확인:

uptime
free -h
df -h

기술 지원에 연락할 때 무엇을 제공해야 하나요?

가능하면 한 번에 다음을 제공하세요:

• 호스트 컴퓨터와 마더보드의 구체적인 모델.
• FLYOS-FAST 버전 번호.
• 문제 발생 전에 수행한 작업 또는 수정 내용.
• 웹 페이지의 전체 오류 스크린샷.
• 전체 klippy.log, moonraker.log 또는 해당 서비스 로그.
• 문제가 안정적으로 재현되는지 여부와 재시작 후에도 여전히 존재하는지 여부.

잘린 마지막 몇 줄의 로그만 제공하지 마세요. 그러면 실제 첫 번째 오류를 볼 수 없을 수 있습니다. 설정과 로그를 보내기 전에 Wi-Fi 비밀번호, 클라우드 서비스 자격 증명, 토큰 등 민감한 정보를 삭제하세요.