Klipper Cloud 원격 에이전트
Klipper Cloud 원격 에이전트는 네트워크에 연결된 FLYOS-FAST 장치가 Klipper Cloud에 연결하여 클라우드 플랫폼에서 현재 호스트를 바인딩하고 원격으로 액세스할 수 있도록 하는 데 사용됩니다. FLYOS-FAST v1.4.0 베타 이미지는 첫 부팅 시 로컬 자격 증명을 생성하지만 원격 액세스는 기본적으로 꺼져 있으며 사용자가 직접 활성화해야 합니다.
이 기능은 현재 FLYOS-FAST v1.4.0 베타 이미지에서만 확인되었습니다. 활성화하면 장치가 원격 서비스에 능동적으로 연결됩니다. 원격 액세스가 필요하지 않으면 꺼진 상태를 유지하세요.
장치 ID, 로컬 자격 증명, 에이전트 구성 및 이러한 내용이 포함된 로그는 포럼, 단체 채팅 또는 기타 공개된 장소에 게시해서는 안 됩니다.
원격으로 이동, 가열 또는 G-code를 실행하기 전에 프린터 현장 환경이 안전한지 확인하고 즉시 전원을 차단하거나 비상 정지할 수 있는 조치를 유지해야 합니다. 네트워크 지연, 연결 끊김 또는 상태 동기화 불일치가 조작 결과에 영향을 미칠 수 있으므로 무인 상태에서 이상 상황을 처리할 수 없는 상황에서 원격으로 인쇄를 시작하지 않는 것이 좋습니다.
기능 설명
- 원격 에이전트를 활성화하면 Klipper Cloud 플랫폼 안내에 따라 현재 호스트를 바인딩할 수 있습니다.
- 원격 에이전트를 비활성화하면 클라우드 원격 연결만 중단되며 Fluidd, Mainsail, Moonraker 및 SSH의局域网 액세스에는 영향을 미치지 않습니다.
- 백그라운드에 agent 프로세스가 존재한다고 해서 원격 액세스가 활성화된 것은 아닙니다. 에이전트 프로세스는 사용자 승인을 기다리는 중일 수도 있습니다.
- 장치 ID는 현재 호스트를 식별하는 데 사용되며 메인보드 USB ID, CAN UUID 또는 프린터 구성의 MCU ID가 아닙니다.
전체 활성화 절차
1. 원격 서비스 활성화
SSH로 다음 명령을 실행합니다:
/data/klipper-cloud-agent/klipper-cloud-agent --enable-remote
명령 실행 후 오류가 없으면 에이전트가 클라우드에 연결될 때까지 기다리세요. 활성화 명령을 연속으로 반복 실행하지 마세요.
2. 장치 ID 조회
클라우드 서비스가 활성화되고 호스트가 인터넷에 접속할 수 있는지 확인한 후 다음 명령을 실행합니다:
/data/klipper-cloud-agent/klipper-cloud-agent --device-id
명령이 정상적으로 장치 ID를 반환하면 Klipper Cloud 플랫폼 안내에 따라 장치를 바인딩하세요. 복사할 때는 장치 ID 자체만 선택하고 전체 터미널 스크린샷을 다른 사람에게 보내지 마세요.
위 이미지는 터미널 조작 예시이며 장치 ID는 숨겨져 있습니다. 자신의 장치에서 실제로 반환된 내용을 기준으로 하세요.
3. 클라우드 플랫폼 바인딩 완료
Klipper Cloud 장치 관리를 열고 자신의 계정으로 로그인하세요. 처음 사용하는 경우 페이지의 사용须知, 서비스 약관 및 개인정보 보호 규칙을 먼저 읽어보세요.
로그인 후 왼쪽 내 장치 영역에서 장치 추가 입력란을 찾으세요:
--device-id가 반환한 전체 장치 ID를 KD-… 장치 ID 입력 에 입력합니다.- 추가를 클릭합니다.
- 장치가 왼쪽 목록에 나타날 때까지 기다리고 상태가 온라인으로 표시되는지 확인합니다.
- 장치를 클릭하면 페이지에서 원격 장치 관리 인터페이스를 열 수 있습니다. 별도 창이 필요하면 오른쪽 상단의 새 창에서 열기를 클릭하세요.
장치 관리 페이지 스크린샷의 계정, 장치 이름, 장치 ID 및 원격 인쇄 인터페이스는 모두 숨겨져 있습니다. 실제 정보가 포함된 페이지 스크린샷을 공개적으로 게시하지 마세요.
바인딩 후 다음 사항을 함께 확인해야 합니다:
- 클라우드 플랫폼에 표시된 장치가 현재 호스트와 일치하는지 확인합니다.
- 원격 페이지에서 현재 프린터 상태를 읽을 수 있는지 확인합니다. 3.局域网 내 Fluidd 또는 Mainsail에 여전히 정상적으로 액세스할 수 있는지 확인합니다.
다른 사람이 제공한 장치 ID를 사용하지 말고 자신의 장치를 신뢰할 수 없는 계정에 바인딩하지 마세요.
원격 서비스 비활성화
더 이상 원격 액세스를 사용하지 않을 때 다음 명령을 실행합니다:
/data/klipper-cloud-agent/klipper-cloud-agent --disable-remote
비활성화 후에도 로컬 Fluidd, Mainsail, Moonraker 및 SSH의局域网 액세스에는 영향이 없습니다. 장치를 양도, 수리 또는 재설치할 준비가 되었다면 Klipper Cloud 플랫폼에서도 장치 바인딩을 해제해야 합니다. 단순히 비활성화 명령을 실행하는 것은 클라우드 플랫폼 계정 관계를 해제하는 것과 같지 않습니다.
클라우드 플랫폼 바인딩 해제
장치를 양도, 수리하거나 더 이상 사용하지 않을 준비가 되었다면 장치 측 원격 서비스 비활성화와 플랫폼 바인딩 해제를 동시에 수행해야 합니다:
- 먼저 SSH에서
--disable-remote를 실행합니다. - 컴퓨터에서는 왼쪽 장치를 마우스 오른쪽 버튼으로 클릭하고, 휴대폰 또는 터치 장치에서는 해당 장치를 길게 누릅니다.
- 삭제/해제를 선택합니다.
- 페이지 안내에 따라 현재 장치 이름을 입력하여 확인합니다.
바인딩 해제는 현재 계정과 해당 장치의 관계를 제거합니다. 장치에 저장된 구성, 인쇄 파일 및局域网 액세스는 이로 인해 삭제되지 않습니다.
명령어 빠른 참조
| 작업 | 명령어 | 사용 조건 |
|---|---|---|
| 에이전트 프로그램 확인 | test -x /data/klipper-cloud-agent/klipper-cloud-agent && echo "klipper-cloud-agent 已安装" | SSH 로그인 후 실행 |
| 원격 서비스 활성화 | /data/klipper-cloud-agent/klipper-cloud-agent --enable-remote | 호스트가 이미 네트워크에 연결됨 |
| 장치 ID 조회 | /data/klipper-cloud-agent/klipper-cloud-agent --device-id | 원격 서비스가 활성화되고 네트워크가 정상 |
| 원격 서비스 비활성화 | /data/klipper-cloud-agent/klipper-cloud-agent --disable-remote | 더 이상 클라우드 액세스가 필요하지 않을 때 실행 |