가이드
Bambu Lab MQTT, 쉽게 설명하기
Bambu Lab 프린터는 가벼운 메시징 프로토콜인 MQTT로 네트워크의 앱에 상태를 직접 보고합니다. 이 연결이 어떻게 작동하는지, Bambu Bar가 어떻게 사용하는지 알려 드립니다.
요약
모든 Bambu Lab 프린터는 로컬 네트워크에서 TLS로 암호화된 MQTT 서버를 포트 8883에서 실행합니다. 앱은 사용자 이름 bblp와 프린터의 액세스 코드로 로그인하고, 프린터의 보고 토픽을 구독해 약 1초마다 상태 업데이트를 받습니다.
상태 읽기는 모든 모드에서 가능합니다. 일시정지나 중지 같은 명령은 LAN 전용 모드와 개발자 모드가 켜져 있을 때만 서드 파티 앱에서 보낼 수 있습니다. Bambu Studio의 LAN 연결과 Bambu Bar 모두 이 방식으로 작동합니다.
연결
| 프로토콜 | TLS 기반 MQTT |
| 포트 | 프린터의 8883 |
| 사용자 이름 | bblp |
| 비밀번호 | 프린터의 8자리 액세스 코드 |
| 상태 토픽 | device/<serial>/report |
| 명령 토픽 | device/<serial>/request |
프린터가 서버입니다. 앱은 Bambu Lab 클라우드를 거치지 않고 네트워크를 통해 프린터에 직접 연결합니다.
보고: 프린터가 보내는 것
연결한 뒤 앱은 전체 보고를 한 번 요청하고(pushall 요청), 이후에는 변경 사항을 발생하는 즉시 받습니다. 출력 중에는 대략 1초마다입니다. 보고는 JSON 형식이며 작업과 그 단계, 진행률과 레이어, 남은 시간, 노즐, 베드, 챔버 온도, 팬, 필라멘트가 담긴 AMS 트레이, 프린터 오류(HMS 코드)를 포함합니다.
Bambu Bar는 이 변경 사항을 하나로 합쳐 프린터의 전체 상태를 만들고, 메뉴 막대, 윈도우, 위젯이 이를 보여 줍니다. 모델마다 보고하는 항목이 다르기 때문에 A1에는 챔버 온도가 없고 H2D에는 노즐이 두 개 표시됩니다.
요청: 앱이 보내는 것
명령은 요청 토픽으로 보냅니다. 일시정지, 재개, 중지, 출력 속도, 챔버 조명, 또는 전체 보고 요청입니다. 무엇을 받아들일지는 프린터가 정합니다. 현재 펌웨어에서는 프린터가 LAN 전용 모드이고 개발자 모드가 켜져 있을 때만 서드 파티 앱이 출력 명령을 보낼 수 있습니다. 그렇지 않으면 Bambu Bar는 해당 버튼에 자물쇠를 표시합니다. 제어가 잠기는 이유를 참고하세요.
인증서: 내 프린터가 맞는지 확인하기
연결은 TLS로 암호화되며, 프린터마다 인증서를 제시합니다. Bambu Bar는 그 인증서가 앱에 포함된 Bambu Lab 자체 인증 기관으로 이어지고, 동시에 해당 프린터의 일련번호로 발급된 경우에만 프린터를 받아들입니다. 이렇게 하면 네트워크의 다른 기기가 프린터인 척하며 액세스 코드를 가로챌 수 없습니다.
검색과 카메라
- 검색: 프린터는 UDP(포트 2021)로 네트워크에 자신을 알립니다. 앱이 IP 주소 없이 프린터 목록을 표시하고, Bambu Bar가 프린터의 IP 주소가 바뀐 것을 알아차리는 방법입니다.
- 카메라는 MQTT를 사용하지 않습니다. X1, H2, H3C, P2S, X2D 프린터는 RTSPS(포트 322, LAN Only Liveview 켜기 필요)로, P1, A1, A2L 프린터는 암호화된 JPEG 스트림(포트 6000)으로 스트리밍합니다. Mac에서 보는 프린터 카메라를 참고하세요.
보고를 직접 확인하기
진단용으로는 어떤 MQTT 클라이언트로도 보고를 읽을 수 있습니다. Mosquitto의 명령줄 도구를 사용하고, 자리 표시자를 내 프린터의 값으로 바꾸세요.
mosquitto_sub -h <printer-ip> -p 8883 -u bblp -P <access-code> --insecure -t "device/<serial>/report"
--insecure는 인증서 확인을 건너뛰므로, 신뢰할 수 있는 네트워크에서 읽기 용도로만 사용하세요. 액세스 코드나 일련번호를 포럼이나 버그 리포트에 절대 붙여 넣지 마세요.
공개 API가 아닙니다
이것은 Bambu Lab의 자체 앱이 로컬 네트워크에서 사용하는 프로토콜이지, 문서화된 안정적인 API가 아닙니다. 항목은 모델과 펌웨어 버전마다 다르며, 프린터가 무엇을 받아들일지는 Bambu Lab이 바꿀 수 있습니다. 이런 변화는 Bambu Bar가 따라가므로 사용자가 신경 쓸 필요가 없습니다. 관련 프린터 설정은 LAN 모드 설명을, 액세스 코드는 액세스 코드 찾는 곳을 참고하세요.
궁금한 점, 답해 드립니다
Bambu Lab 프린터는 MQTT에 어떤 포트를 사용하나요?
TLS를 사용하는 포트 8883입니다. 사용자 이름은 bblp이고 비밀번호는 프린터의 액세스 코드입니다.
MQTT로 상태를 읽으려면 LAN 전용 모드가 필요한가요?
아니요. 프린터는 클라우드 모드에서도 로컬 앱에 상태를 보고합니다. 서드 파티 앱이 출력 명령을 보내려면 LAN 전용 모드와 개발자 모드가 필요합니다.
Bambu Bar는 Bambu Lab 클라우드를 사용하나요?
아니요. LAN 모드의 Bambu Studio처럼 프린터의 로컬 MQTT 서버에 직접 연결하며, 먼저 프린터의 인증서를 확인합니다.
함께 읽어 보세요
- LAN 모드 설명클라우드 모드, LAN 전용, LAN Only Liveview, 개발자 모드: 서로 다른 네 가지 설정과 실제로 필요한 것.
- 개발자 모드와 잠긴 제어 기능Bambu Bar에서 일시정지, 중지, 속도에 자물쇠가 표시되는 이유, 개발자 모드가 프린터에서 바꾸는 것, 그리고 정말 필요한지.
- 액세스 코드와 IP 주소프린터가 8자리 액세스 코드와 IP 주소를 표시하는 곳, 그리고 이를 이용해 Mac에서 연결하는 방법.
- 개인정보: 로컬 프린터 데이터와 웹사이트 분석Bambu Bar가 로컬 프린터 데이터, 액세스 코드, 카메라 보기, 후원자 라이선스, 웹사이트 분석을 처리하는 방식입니다.

이제 그만 프린터까지 걸어가세요
Mac에서 Bambu Lab 출력 진행률, 남은 시간, 온도, AMS 필라멘트, 실시간 카메라를 확인하세요. Bambu Studio를 열지 않고 알림과 데스크탑 위젯으로 출력을 살펴보세요.
출력 진행률, 알림, 필라멘트macOS 26 이상, Apple 실리콘 및 Intel Windows 및 Linux 버전 출시 예정