---
title: "Bambu Lab MQTT: 로컬 모니터링의 작동 방식 · Bambu Bar"
description: "Bambu Lab 프린터가 로컬 MQTT로 상태를 보고하는 방식: 포트, 토픽, 액세스 코드 로그인, 인증서, 그리고 명령에 개발자 모드가 필요한 이유."
url: https://bambubar.app/ko/guides/bambu-lab-mqtt
language: ko
---

# Bambu Lab MQTT, 쉽게 설명하기

Bambu Lab 프린터는 가벼운 메시징 프로토콜인 MQTT로 네트워크의 앱에 상태를 직접 보고합니다. 이 연결이 어떻게 작동하는지, Bambu Bar가 어떻게 사용하는지 알려 드립니다.

_2026-11-08 업데이트_

## 요약

모든 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는 해당 버튼에 자물쇠를 표시합니다. [제어가 잠기는 이유](https://bambubar.app/ko/guides/bambu-lab-developer-mode)를 참고하세요.

## 인증서: 내 프린터가 맞는지 확인하기

연결은 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에서 보는 프린터 카메라](https://bambubar.app/ko/features/camera)를 참고하세요.

## 보고를 직접 확인하기

진단용으로는 어떤 MQTT 클라이언트로도 보고를 읽을 수 있습니다. [Mosquitto](https://mosquitto.org)의 명령줄 도구를 사용하고, 자리 표시자를 내 프린터의 값으로 바꾸세요.

```
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 모드 설명](https://bambubar.app/ko/guides/bambu-lab-lan-mode)을, 액세스 코드는 [액세스 코드 찾는 곳](https://bambubar.app/ko/guides/bambu-lab-access-code)을 참고하세요.

## 궁금한 점, 답해 드립니다

### Bambu Lab 프린터는 MQTT에 어떤 포트를 사용하나요?

TLS를 사용하는 포트 8883입니다. 사용자 이름은 `bblp`이고 비밀번호는 프린터의 액세스 코드입니다.

### MQTT로 상태를 읽으려면 LAN 전용 모드가 필요한가요?

아니요. 프린터는 클라우드 모드에서도 로컬 앱에 상태를 보고합니다. 서드 파티 앱이 출력 명령을 보내려면 LAN 전용 모드와 개발자 모드가 필요합니다.

### Bambu Bar는 Bambu Lab 클라우드를 사용하나요?

아니요. LAN 모드의 Bambu Studio처럼 프린터의 로컬 MQTT 서버에 직접 연결하며, 먼저 프린터의 인증서를 확인합니다.

## 함께 읽어 보세요

- [LAN 모드 설명](https://bambubar.app/ko/guides/bambu-lab-lan-mode): 클라우드 모드, LAN 전용, LAN Only Liveview, 개발자 모드: 서로 다른 네 가지 설정과 실제로 필요한 것.
- [개발자 모드와 잠긴 제어 기능](https://bambubar.app/ko/guides/bambu-lab-developer-mode): Bambu Bar에서 일시정지, 중지, 속도에 자물쇠가 표시되는 이유, 개발자 모드가 프린터에서 바꾸는 것, 그리고 정말 필요한지.
- [액세스 코드와 IP 주소](https://bambubar.app/ko/guides/bambu-lab-access-code): 프린터가 8자리 액세스 코드와 IP 주소를 표시하는 곳, 그리고 이를 이용해 Mac에서 연결하는 방법.
- [개인정보: 로컬 프린터 데이터와 웹사이트 분석](https://bambubar.app/ko/privacy): Bambu Bar가 로컬 프린터 데이터, 액세스 코드, 카메라 보기, 후원자 라이선스, 웹사이트 분석을 처리하는 방식입니다.

---

Bambu Bar는 독립 앱으로, Bambu Lab과 제휴 관계가 없으며 Bambu Lab의 보증을 받지 않습니다. Bambu Lab은 해당 소유자의 상표입니다.