---
title: "Bambu Lab MQTT：本機監控如何運作 · Bambu Bar"
description: "Bambu Lab 印表機如何透過本機 MQTT 回報狀態：連接埠、主題、以存取碼登入和憑證，以及為什麼傳送指令需要開發者模式。"
url: https://bambubar.app/zh-hant/guides/bambu-lab-mqtt
language: zh-Hant
---

# Bambu Lab MQTT，用白話說明

Bambu Lab 印表機透過 MQTT 這種輕量的訊息傳遞協定，把狀態直接回報給你網路上的 App。以下說明這個連線如何運作，以及 Bambu Bar 如何使用它。

_更新於 2026-11-08_

## 簡單來說

每台 Bambu Lab 印表機都會在你的區域網路上執行一個 **MQTT** 伺服器，使用 **8883 連接埠**並以 TLS 加密。App 以使用者名稱 **bblp** 和印表機的**存取碼**登入，訂閱印表機的回報主題後，大約每秒會收到一次狀態更新。

讀取狀態在任何模式下都能使用。第三方 App 要傳送暫停、停止等指令，則必須開啟**僅區域網路**和**開發者模式**。Bambu Studio 的區域網路連線和 Bambu Bar 都是這樣運作的。

## 連線

| | |
| --- | --- |
| 通訊協定 | 透過 TLS 的 MQTT |
| 連接埠 | 印表機上的 8883 |
| 使用者名稱 | `bblp` |
| 密碼 | 印表機的 8 位數存取碼 |
| 狀態主題 | `device/<serial>/report` |
| 指令主題 | `device/<serial>/request` |

印表機本身就是伺服器：App 透過你的網路直接連線到它，不經過 Bambu Lab 的雲端。

## 回報：印表機傳送的內容

連線之後，App 會先要求一次完整回報（`pushall` 請求），之後就會在狀態改變時收到更新，列印期間大約每秒一次。回報採用 JSON 格式，內容包括列印工作及其階段、進度和層數、剩餘時間、噴嘴、熱床和腔體溫度、風扇、AMS 槽位及其中的線材，以及印表機錯誤（HMS 代碼）。

Bambu Bar 會把這些變更合併成一份完整的印表機狀態，也就是選單列、視窗和小工具所顯示的內容。不同機型回報的欄位不同，所以 A1 不會顯示腔體溫度，而 H2D 會顯示兩個噴嘴。

## 請求：App 傳送的內容

指令會傳送到請求主題：暫停、繼續、停止、列印速度、腔體照明，或要求一次完整回報。要不要接受由印表機決定：在目前的韌體上，只有印表機處於**僅區域網路**模式並開啟**開發者模式**時，第三方 App 才能傳送列印指令。否則 Bambu Bar 會在這些按鈕上顯示鎖頭圖示。請參閱[控制功能為什麼被鎖定](https://bambubar.app/zh-hant/guides/bambu-lab-developer-mode)。

## 憑證：確認那是你的印表機

連線以 TLS 加密，每台印表機都會出示一份憑證。只有當憑證能追溯到 Bambu Lab 自己的憑證授權單位（隨 App 一起提供），**而且**是核發給這台印表機的序號時，Bambu Bar 才會接受這台印表機。這樣一來，你網路上的其他裝置就無法冒充印表機來騙取存取碼。

## 裝置探索與攝影機

- **裝置探索**：印表機會透過 UDP（2021 連接埠）在你的網路上廣播自己。App 就是這樣在不知道 IP 位址的情況下列出印表機，Bambu Bar 也是這樣發現印表機換了新位址。
- **攝影機**不走 MQTT：X1、H2、H3C、P2S 和 X2D 印表機透過 RTSPS 串流（322 連接埠，需開啟 **LAN Only Liveview**），P1、A1 和 A2L 印表機則透過加密的 JPEG 串流（6000 連接埠）。請參閱[在 Mac 上看攝影機](https://bambubar.app/zh-hant/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 自家 App 在區域網路上使用的通訊協定，而不是有文件記載、穩定的 API：欄位會因機型和韌體版本而不同，Bambu Lab 也可能改變印表機接受的內容。Bambu Bar 會持續追蹤這些變化，你不必操心。相關的印表機設定請參閱[區域網路模式說明](https://bambubar.app/zh-hant/guides/bambu-lab-lan-mode)，另請參閱[存取碼在哪裡](https://bambubar.app/zh-hant/guides/bambu-lab-access-code)。

## 你的疑問，在這裡解答

### Bambu Lab 印表機的 MQTT 使用哪個連接埠？

8883 連接埠，並使用 TLS。使用者名稱是 `bblp`，密碼是印表機的存取碼。

### 讀取 MQTT 狀態需要僅區域網路模式嗎？

不需要。在雲端模式下，印表機也會向本機 App 回報狀態。第三方 App 要傳送列印指令時，才需要僅區域網路並開啟開發者模式。

### Bambu Bar 會使用 Bambu Lab 的雲端嗎？

不會。它和區域網路模式下的 Bambu Studio 一樣，直接連線到印表機的本機 MQTT 伺服器，並先驗證印表機的憑證。

## 繼續閱讀

- [區域網路模式說明](https://bambubar.app/zh-hant/guides/bambu-lab-lan-mode): 雲端模式、僅區域網路、LAN Only Liveview 和開發者模式：四個不同的設定，以及你真正需要哪幾個。
- [開發者模式與被鎖定的控制功能](https://bambubar.app/zh-hant/guides/bambu-lab-developer-mode): 為什麼 Bambu Bar 中的暫停、停止和調整速度會顯示鎖頭、開發者模式會改變印表機的哪些行為，以及你是否需要它。
- [存取碼與 IP 位址](https://bambubar.app/zh-hant/guides/bambu-lab-access-code): 印表機在哪裡顯示 8 位數存取碼和 IP 位址，以及如何用它們從 Mac 連線。
- [隱私權：本機印表機資料與網站分析](https://bambubar.app/zh-hant/privacy): 了解 Bambu Bar 如何處理本機印表機資料、存取碼、攝影機畫面檢視、支持者授權與網站分析。

---

Bambu Bar 是一款獨立 App，與 Bambu Lab 沒有關聯，也未獲 Bambu Lab 認可。Bambu Lab 是其所有者的商標。
