--- title: "Bambu Lab MQTT：本地监控的工作原理 · Bambu Bar" description: "Bambu Lab 打印机如何通过本地 MQTT 报告状态：端口、主题、访问码登录和证书，以及为什么发送命令需要开发者模式。" url: https://bambubar.app/zh-hans/guides/bambu-lab-mqtt language: zh-Hans --- # 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//report` | | 命令主题 | `device//request` | 打印机就是服务器：App 通过你的网络直接连接它，无需经过 Bambu Lab 的云服务。 ## 报告：打印机发送什么 连接后，App 会先请求一次完整报告（`pushall` 请求），然后在变化发生时接收更新，打印期间大约每秒一次。报告采用 JSON 格式，内容包括任务及其阶段、进度和层数、剩余时间、喷嘴、热床和腔体温度、风扇、AMS 料盘及其中的耗材，以及打印机错误（HMS 代码）。 Bambu Bar 将这些变化合并成一份完整的打印机状态，菜单栏、窗口和小组件显示的正是这些内容。不同机型报告的字段不同，所以 A1 不显示腔体温度，而 H2D 会显示两个喷嘴。 ## 请求：App 发送什么 命令发送到请求主题：暂停、继续、停止、打印速度、腔体照明灯，或请求一次完整报告。是否接受由打印机决定：在当前固件上，只有当打印机处于**仅局域网**模式并开启**开发者模式**时，第三方 App 才能发送打印命令。否则，Bambu Bar 会在这些按钮上显示锁形图标。请参阅[控制功能为何被锁定](https://bambubar.app/zh-hans/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-hans/features/camera)。 ## 亲自查看报告 如需诊断，任何 MQTT 客户端都可以读取这些报告。使用 [Mosquitto](https://mosquitto.org) 的命令行工具，并将占位符替换为你打印机的实际值： ``` mosquitto_sub -h -p 8883 -u bblp -P --insecure -t "device//report" ``` `--insecure` 会跳过证书检查，所以请只在你信任的网络上使用，并且只用于读取。切勿把你的访问码或序列号贴到论坛或错误报告中。 ## 并非公开 API 这是 Bambu Lab 自家 App 在本地网络上使用的协议，而不是有文档、保持稳定的 API：不同机型和固件版本的字段各不相同，Bambu Lab 也可能改变打印机接受的内容。Bambu Bar 会跟进这些变化，你无需操心。相关的打印机设置请参阅[局域网模式详解](https://bambubar.app/zh-hans/guides/bambu-lab-lan-mode)，另请参阅[在哪里找到访问码](https://bambubar.app/zh-hans/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-hans/guides/bambu-lab-lan-mode): 云模式、仅局域网、LAN Only Liveview 和开发者模式：四个不同的设置，以及你真正需要哪些。 - [开发者模式与被锁定的控制功能](https://bambubar.app/zh-hans/guides/bambu-lab-developer-mode): 为什么 Bambu Bar 中的暂停、停止和调速显示锁形图标，开发者模式会改变打印机的什么，以及你是否需要它。 - [访问码和 IP 地址](https://bambubar.app/zh-hans/guides/bambu-lab-access-code): 打印机在哪里显示 8 位访问码和 IP 地址，以及如何用它们从 Mac 连接打印机。 - [隐私：本地打印机数据与网站分析](https://bambubar.app/zh-hans/privacy): 了解 Bambu Bar 如何处理本地打印机数据、访问码、摄像头画面查看、支持者许可证和网站分析。 --- Bambu Bar 是一款独立 App，与 Bambu Lab 没有关联，也未获 Bambu Lab 认可。Bambu Lab 是其所有者的商标。