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

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

권장 문제 해결 순서

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

시스템 및 계정

왜 `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의 구성 경로를 혼용하지 마세요.

RRF 구성 경로와 일반적인 오류: 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`	전체 호스트 재시작
플러그인 소스 코드 또는 심볼릭 링크	플러그인 튜토리얼에 따라 해당 서비스 재시작

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

RRF 모드

RRF 모드에서 DCS가 반복적으로 연결이 끊기며 M550 머신 이름 불일치 오류가 발생할 경우

RRF 모드에서 다음과 같은 현상이 발생합니다:

DWC 웹페이지에 Connection interrupted, DCS has been stopped 메시지가 반복적으로 표시됩니다.
시작 로그에 Error in start-up file config.g line 3: M550: Machine name must consist of the same letters and digits as configured by the Linux hostname 오류가 나타납니다.
DCS(Duet Control Server)가 정상적으로 시작되지 않아 웹페이지에 연결할 수 없습니다.

원인

RRF는 config.g의 M550 P"..."에 설정된 머신 이름이 Linux 시스템의 hostname과 완전히 일치해야 합니다(동일한 문자와 숫자만 포함). 두 값이 일치하지 않으면 DCS가 시작을 거부하고 반복적으로 충돌 및 재연결을 시도합니다.

printer_name은 최초 시작 시에만 hostname을 초기화하는 데 사용됩니다. 이후 hostname을 수동으로 변경하면서 config.g를 함께 수정하지 않았거나, 다른 장치의 config.g를 복사한 경우 이 오류가 발생합니다.

확인 및 수정 절차:

SSH로 상위 컴퓨터에 연결하여 현재 Linux hostname을 확인합니다:
```
hostname
```
RRF 설정 파일에서 M550의 현재 값을 확인합니다:
```
cat /opt/dsf/sd/sys/config.g | grep M550
```
M550을 hostname과 일치하도록 수정합니다. 예를 들어 hostname이 fly-c5인 경우 다음과 같이 변경해야 합니다:
```
M550 P"fly-c5"
```
파일을 저장한 후 DWC 웹페이지에서 DCS를 재시작하거나 상위 컴퓨터를 직접 재부팅합니다.

이름 문자 제한

M550의 머신 이름은 영문자와 숫자만 포함할 수 있으며, 공백, 밑줄, 한자 또는 기타 특수 문자는 사용할 수 없습니다. hostname을 변경해야 하는 경우 config.g의 M550도 함께 업데이트하여 두 값을 일치시켜야 합니다.

RRF 모드의 설정 파일 위치는 어디인가요?

RRF의 모든 설정 파일은 /opt/dsf/sd/sys/ 디렉터리에 있으며, 주요 파일은 다음과 같습니다:

파일	용도
`config.g`	메인 시작 설정 파일로 `M550`(머신 이름) 등 핵심 설정 포함
`board.txt`	보드 레벨 설정(네트워크, SPI 등)
`deploy.d`	배포 스크립트 디렉터리

G-code 파일은 /opt/dsf/sd/gcodes/에 저장되며, USB 메모리로 인쇄하는 파일도 이 경로에 마운트됩니다. Klipper의 설정 경로(/usr/share/printer_data/)를 RRF와 혼용하지 마십시오.

플러그인 및 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에 일괄 복사하지 마십시오.

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

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

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

네트워크 가져오기 단계가 완전히 성공했는지.
플러그인 파일이 /data/에 실제로 존재하는지.

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

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

printer.cfg에 플러그인 구성이 로드되었는지.
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 명령을 사용해야 합니다.

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

컴퓨터와 호스트가 동일한 LAN에 있는지 확인하십시오.
라우터의 장치 주소를 확인하여 변경된 이전 IP를 계속 사용하지 마십시오.
SSH를 통해 현재 네트워크 주소를 확인하십시오:
```
ip -br addr
```
시작에 실패한 서비스가 있는지 확인하십시오:
```
systemctl --failed --no-pager
```
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 비밀번호, 클라우드 서비스 자격 증명, 토큰 등 민감한 정보를 삭제하세요.

로그 및 기술 지원

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

로그	경로
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 비밀번호, 클라우드 서비스 자격 증명, 토큰 등 민감한 정보를 삭제해 주세요.

시스템 및 계정​

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

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

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

파일과 구성​

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

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

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

구성을 수정한 후 왜 적용되지 않나요?​

RRF 모드​

RRF 모드에서 DCS가 반복적으로 연결이 끊기며 M550 머신 이름 불일치 오류가 발생할 경우​

RRF 모드의 설정 파일 위치는 어디인가요?​

플러그인 및 Python 환경​

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

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

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

웹 및 네트워크​

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

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

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

인쇄, USB 및 카메라​

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

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

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

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

로그 및 기술 지원​

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

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

로그 및 기술 지원​

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

기술 지원에 문의할 때 무엇을 제공해야 하나요?​

시스템 및 계정

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

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

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

파일과 구성

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

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

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

구성을 수정한 후 왜 적용되지 않나요?

RRF 모드

RRF 모드에서 DCS가 반복적으로 연결이 끊기며 M550 머신 이름 불일치 오류가 발생할 경우

RRF 모드의 설정 파일 위치는 어디인가요?

플러그인 및 Python 환경

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

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

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

웹 및 네트워크

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

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

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

인쇄, USB 및 카메라

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

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

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

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

로그 및 기술 지원

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

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

로그 및 기술 지원

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

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