--- title: "MQTT da Bambu Lab: como funciona o monitoramento local · Bambu Bar" description: "Como a Bambu Lab envia o status por MQTT local: porta, tópicos, login com código de acesso, certificados e por que comandos exigem o Modo de desenvolvedor." url: https://bambubar.app/pt-br/guides/bambu-lab-mqtt language: pt-BR --- # MQTT da Bambu Lab, em palavras simples As impressoras Bambu Lab informam o status por MQTT, um protocolo leve de mensagens, direto para os apps na sua rede. Veja como essa conexão funciona e como o Bambu Bar a usa. _Atualizado em 2026-11-08_ ## Em resumo Toda impressora Bambu Lab roda um servidor **MQTT** na sua rede local, na **porta 8883**, com criptografia TLS. Um app se autentica com o nome de usuário **bblp** e o **código de acesso** da impressora, assina o tópico de relatórios da impressora e recebe atualizações de status mais ou menos a cada segundo. A leitura do status funciona em qualquer modo. O envio de comandos como pausar e parar só funciona para apps de terceiros com o **Somente LAN** e o **Modo de desenvolvedor** ativados. É assim que funcionam tanto a conexão LAN do Bambu Studio quanto o Bambu Bar. ## A conexão | | | | --- | --- | | Protocolo | MQTT sobre TLS | | Porta | 8883 na impressora | | Nome de usuário | `bblp` | | Senha | O código de acesso de 8 caracteres da impressora | | Tópico de status | `device//report` | | Tópico de comandos | `device//request` | A impressora é o servidor: os apps se conectam direto a ela pela sua rede, sem a nuvem da Bambu Lab. ## Relatórios: o que a impressora envia Depois de se conectar, um app pede uma vez um relatório completo (uma solicitação `pushall`) e então recebe as mudanças conforme elas acontecem, mais ou menos a cada segundo durante a impressão. Os relatórios são em JSON e incluem o trabalho e a etapa dele, o progresso e as camadas, o tempo restante, as temperaturas do bico, da mesa e da câmara, os ventiladores, os slots do AMS com seus filamentos e os erros da impressora (códigos HMS). O Bambu Bar junta essas mudanças numa visão única da impressora, que é o que a barra de menus, a janela e os widgets mostram. Modelos diferentes informam campos diferentes, e é por isso que uma A1 não mostra temperatura da câmara e uma H2D mostra dois bicos. ## Solicitações: o que os apps enviam Os comandos vão para o tópico de solicitações: pausar, retomar, parar, velocidade de impressão, a luz da câmara ou um pedido de relatório completo. A impressora decide o que aceitar: no firmware atual, apps de terceiros só podem enviar comandos de impressão quando a impressora está no modo **Somente LAN** com o **Modo de desenvolvedor** ativado. Caso contrário, o Bambu Bar mostra um cadeado nesses botões. Veja [por que os controles ficam bloqueados](https://bambubar.app/pt-br/guides/bambu-lab-developer-mode). ## Certificados: a garantia de que é a sua impressora A conexão é criptografada com TLS, e cada impressora apresenta um certificado. O Bambu Bar só aceita a impressora se esse certificado for encadeado às autoridades certificadoras da própria Bambu Lab, que vêm com o app, **e** tiver sido emitido para o número de série da impressora. Assim, nenhum outro dispositivo na sua rede consegue se passar pela impressora e capturar o código de acesso. ## Descoberta e câmera - **Descoberta:** as impressoras se anunciam na sua rede por UDP (porta 2021). É assim que os apps listam impressoras sem um endereço IP, e como o Bambu Bar percebe quando uma impressora recebe um endereço novo. - **A câmera** não passa pelo MQTT: as impressoras X1, H2, H3C, P2S e X2D a transmitem por RTSPS (porta 322, com o **LAN Only Liveview** ativado), e as P1, A1 e A2L por uma transmissão JPEG criptografada (porta 6000). Veja [a câmera no seu Mac](https://bambubar.app/pt-br/features/camera). ## Veja os relatórios você mesmo Para diagnóstico, qualquer cliente MQTT consegue ler os relatórios. Com as ferramentas de linha de comando do [Mosquitto](https://mosquitto.org), e os valores da sua impressora no lugar dos marcadores: ``` mosquitto_sub -h -p 8883 -u bblp -P --insecure -t "device//report" ``` `--insecure` pula a verificação do certificado, então use só numa rede em que você confia, e só para ler. Nunca cole seu código de acesso ou número de série em fóruns ou relatos de bugs. ## Não é uma API pública Este é o protocolo que os próprios apps da Bambu Lab usam na rede local, não uma API documentada e estável: os campos variam entre modelos e versões de firmware, e a Bambu Lab pode mudar o que a impressora aceita. O Bambu Bar acompanha essas mudanças para que você não precise. Veja [o modo LAN explicado](https://bambubar.app/pt-br/guides/bambu-lab-lan-mode) para as configurações da impressora envolvidas e [onde encontrar o código de acesso](https://bambubar.app/pt-br/guides/bambu-lab-access-code). ## Perguntas, respondidas ### Que porta uma impressora Bambu Lab usa para o MQTT? A porta 8883, com TLS. O nome de usuário é `bblp` e a senha é o código de acesso da impressora. ### Preciso do modo Somente LAN para ler o status por MQTT? Não. A impressora informa o status aos apps locais também no modo nuvem. O modo Somente LAN com o Modo de desenvolvedor é necessário para que apps de terceiros enviem comandos de impressão. ### O Bambu Bar usa a nuvem da Bambu Lab? Não. Ele se conecta direto ao servidor MQTT local da impressora, como o Bambu Studio no modo LAN, e verifica o certificado da impressora antes. ## Leia a seguir - [O modo LAN explicado](https://bambubar.app/pt-br/guides/bambu-lab-lan-mode): Modo nuvem, Somente LAN, LAN Only Liveview e Modo de desenvolvedor: quatro configurações diferentes, e de quais você realmente precisa. - [Modo de desenvolvedor e controles](https://bambubar.app/pt-br/guides/bambu-lab-developer-mode): Por que os botões de pausar, parar e velocidade mostram um cadeado no Bambu Bar, o que o Modo de desenvolvedor muda na impressora e se você precisa dele. - [Código de acesso e endereço IP](https://bambubar.app/pt-br/guides/bambu-lab-access-code): Onde sua impressora mostra o código de acesso de 8 caracteres e o endereço IP, e como usá-los para conectar pelo seu Mac. - [Privacidade: dados locais da impressora e análise do site](https://bambubar.app/pt-br/privacy): Como o Bambu Bar trata os dados locais das impressoras, os códigos de acesso, a visualização da câmera, as licenças de apoio e as análises do site. --- O Bambu Bar é um app independente, não afiliado nem endossado pela Bambu Lab. Bambu Lab é uma marca comercial de seu proprietário.