Посібник
MQTT у Bambu Lab — простими словами
Принтери Bambu Lab повідомляють свій стан через MQTT — легкий протокол обміну повідомленнями — напряму програмам у вашій мережі. Ось як працює це з’єднання і як його використовує Bambu Bar.
Коротко
Кожен принтер Bambu Lab запускає сервер MQTT у вашій локальній мережі, на порту 8883 із шифруванням TLS. Програма входить з іменем користувача bblp і кодом доступу принтера, підписується на топік звітів принтера й отримує оновлення стану приблизно щосекунди.
Читання стану працює в будь-якому режимі. Надсилати команди, як-от пауза й зупинка, сторонні програми можуть лише з увімкненими Лише LAN і режимом розробника. Саме так працюють і LAN-з’єднання Bambu Studio, і Bambu Bar.
З’єднання
| Протокол | MQTT через TLS |
| Порт | 8883 на принтері |
| Ім’я користувача | bblp |
| Пароль | 8-символьний код доступу принтера |
| Топік стану | device/<serial>/report |
| Топік команд | device/<serial>/request |
Сервером є принтер: програми підключаються до нього напряму через вашу мережу, без хмари Bambu Lab.
Звіти: що надсилає принтер
Після підключення програма один раз запитує повний звіт (запит pushall), а потім отримує зміни в міру того, як вони відбуваються, — під час друку приблизно щосекунди. Звіти мають формат JSON і містять завдання та його етап, прогрес і шари, залишок часу, температури сопла, столу й камери друку, вентилятори, лотки AMS з їхнім філаментом і помилки принтера (коди HMS).
Bambu Bar об’єднує ці зміни в одну картину стану принтера — саме її показують смуга меню, вікно й віджети. Різні моделі повідомляють різні поля, тому A1 не показує температуру камери друку, а H2D показує два сопла.
Запити: що надсилають програми
Команди надходять у топік запитів: пауза, продовження, зупинка, швидкість друку, освітлення камери або запит повного звіту. Що прийняти, вирішує принтер: на поточній прошивці сторонні програми можуть надсилати команди друку, лише коли принтер працює в режимі Лише LAN з увімкненим режимом розробника. Інакше Bambu Bar показує на цих кнопках замок. Див. чому керування заблоковано.
Сертифікати: це справді ваш принтер
З’єднання зашифровано TLS, і кожен принтер надає сертифікат. Bambu Bar приймає принтер, лише якщо ланцюжок цього сертифіката веде до власних центрів сертифікації Bambu Lab, які постачаються разом із програмою, і виданий на серійний номер принтера. Так жоден інший пристрій у вашій мережі не зможе видати себе за принтер і вивідати код доступу.
Пошук принтерів і відеокамера
- Пошук: принтери оголошують про себе у вашій мережі через UDP (порт 2021). Так програми показують принтери без IP-адреси, і так Bambu Bar помічає, що принтер отримав нову адресу.
- Відеокамера працює не через 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?
Порт 8883, із TLS. Ім’я користувача — bblp, пароль — код доступу принтера.
Чи потрібен режим «Лише LAN», щоб читати стан через MQTT?
Ні. Принтер повідомляє стан локальним програмам і в хмарному режимі. «Лише LAN» з режимом розробника потрібні для того, щоб сторонні програми могли надсилати команди друку.
Чи користується Bambu Bar хмарою Bambu Lab?
Ні. Вона підключається до локального сервера MQTT принтера напряму, як Bambu Studio в режимі LAN, і спершу перевіряє сертифікат принтера.
Читайте далі
- Режим LAN: що це такеХмарний режим, «Лише LAN», LAN Only Liveview і режим розробника: чотири різні налаштування — і які з них вам справді потрібні.
- Режим розробника й заблоковане керуванняЧому кнопки паузи, зупинки й швидкості в Bambu Bar позначено замком, що змінює на принтері режим розробника і чи потрібен він вам.
- Код доступу й IP-адресаДе принтер показує свій 8-символьний код доступу й IP-адресу і як із ними підключитися з вашого Mac.
- Конфіденційність: локальні дані й аналітика сайтуЯк Bambu Bar обробляє локальні дані принтерів, коди доступу, перегляд камери, ліцензії прихильників і аналітику сайту.

Годі ходити до принтера
Стежте за друком Bambu Lab на Mac: прогрес, час до завершення, температури, філамент AMS і камера наживо. Сповіщення й віджети без відкривання Bambu Studio.
Прогрес друку, сповіщення та філаментmacOS 26+, Apple silicon та IntelДалі — Windows і Linux