Bambu Lab MQTT，通俗讲解

连接参数

打印机就是服务器：App 通过你的网络直接连接它，无需经过 Bambu Lab 的云服务。

报告：打印机发送什么

连接后，App 会先请求一次完整报告（pushall 请求），然后在变化发生时接收更新，打印期间大约每秒一次。报告采用 JSON 格式，内容包括任务及其阶段、进度和层数、剩余时间、喷嘴、热床和腔体温度、风扇、AMS 料盘及其中的耗材，以及打印机错误（HMS 代码）。

Bambu Bar 将这些变化合并成一份完整的打印机状态，菜单栏、窗口和小组件显示的正是这些内容。不同机型报告的字段不同，所以 A1 不显示腔体温度，而 H2D 会显示两个喷嘴。

请求：App 发送什么

命令发送到请求主题：暂停、继续、停止、打印速度、腔体照明灯，或请求一次完整报告。是否接受由打印机决定：在当前固件上，只有当打印机处于仅局域网模式并开启开发者模式时，第三方 App 才能发送打印命令。否则，Bambu Bar 会在这些按钮上显示锁形图标。请参阅控制功能为何被锁定。

证书：确认那是你的打印机

连接使用 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 上的摄像头。

亲自查看报告

如需诊断，任何 MQTT 客户端都可以读取这些报告。使用 Mosquitto 的命令行工具，并将占位符替换为你打印机的实际值：

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 会跟进这些变化，你无需操心。相关的打印机设置请参阅局域网模式详解，另请参阅在哪里找到访问码。