Índice do manual

🔌 Impressoras por rede local

Em 30 segundos

Por rede local, o BolloPrint fala com as tuas impressoras dentro da tua oficina, através do agente local, sem passar pela nuvem do fabricante.
É a via de quase todas as marcas, a que dá câmara e, nas máquinas que o permitem, pausar, retomar e cancelar.
São três passos: instalar o agente num equipamento da oficina, ligá-lo à tua conta e acrescentar as impressoras, que quase sempre aparecem sozinhas.
Não é preciso abrir portas no router: é o agente que liga ao BolloPrint, não o contrário.

Por rede local, o BolloPrint fala com as tuas impressoras diretamente na tua oficina, sem passar pela nuvem de nenhum fabricante. Para isso é preciso um intermediário dentro da tua rede: o agente local.

Está em Configurações → Impressoras, separador Agente local.

Porque é esta a via recomendada

Funciona com quase todas as marcas. Bambu Lab, Prusa, Elegoo, FlashForge, Anycubic e Creality (em beta), Snapmaker, e as que levam Klipper por dentro (QIDI, Sovol, Voron, RatRig…). O detalhe por modelo, em Impressoras compatíveis.
Podes dar ordens: pausar, retomar e cancelar a impressão em curso, nas máquinas que o permitem (as Bambu, com o Modo programador ativado: ver Tipos de ligação).
Tens câmara: em direto na ficha da impressora (em vídeo, onde a câmara o permite), uma foto no momento quando a pedes e uma foto final de como ficou cada impressão. Se o trabalho não trouxer miniatura, também uma foto do interior de poucos em poucos minutos enquanto imprime.
Não depende do fabricante. Nem de a nuvem dele funcionar, nem de ele manter o serviço aberto.
Aguenta os cortes de internet. Se a tua ligação cair, o agente continua a ler as impressoras e guarda o que se passa; quando a linha volta, envia tudo. Não perdes o histórico dessas horas.

O agente não abre a tua rede a ninguém. É ele que nos liga a nós, por isso não é preciso abrir portas no router, nem ter IP fixo, nem configurar seja o que for na firewall. Funciona na mesma atrás de um router doméstico normal.

Os três passos

Instalar o agente num equipamento da oficina que esteja sempre ligado: um NAS, um PC com Windows, o Home Assistant ou qualquer equipamento com Docker.
Ligá-lo à tua conta: com um clique se for um pacote ou um instalador, ou colando o seu manifesto se for Docker ou Kubernetes.
Registar as impressoras que vai gerir.

Os passos 1 e 2 dependem de onde o instalas, e cada opção tem a sua página: escolhe a tua em O agente local. Aqui continuamos com o 3.

Acrescentar impressoras

As que aparecem sozinhas

O agente procura impressoras na tua rede e as que encontra aparecem no separador Agente local, no final de Impressoras na rede local, em Detetadas na rede (com vários agentes, «Detetadas por» e o nome de cada um), com a sua marca e o seu modelo. Prime Adicionar e está feito. Se não é tua ou não a queres, Ignorar. Quando houver alguma, também a vês num aviso por cima dos separadores.

Se for uma impressora que já tens pela Bambu Cloud, ele diz-to («É «P1S-02», que já tens pela Bambu Cloud») e o botão é Ligar também por LAN: não cria uma impressora nova, junta a via local à que já tens.

Algumas vão pedir-te um código de acesso antes de se ligarem; o próprio cartão avisa-te se o vai fazer.

Também pode aparecer uma impressora marcada como Brevemente: sabemos o que é, mas ainda não a conseguimos ligar. Se for uma de que precisas, diz-nos — ajuda-nos a decidir a ordem.

A impressora virtual do Bambuddy

Se usas o Bambuddy para gerir as tuas Bambu Lab, a fila de impressão dele apresenta-se na tua rede como mais uma impressora, e o agente encontra-a. Reconhecemo-la e aparece com a etiqueta Virtual · Bambuddy: em Detetadas na rede, ao adicioná-la, no seu cartão, em Configurações → Impressoras e na sua ficha.

Não é uma máquina: é a fila de impressão do Bambuddy.
O que mostra é uma cópia do estado de outra das tuas impressoras, que pode estar desatualizada.
Podes adicioná-la na mesma, mas ocupa um lugar do teu plano como qualquer impressora. Se não precisares dela, desativa-a no separador Impressoras ou desliga-a.

As que é preciso acrescentar à mão

Se a impressora não aparecer, prime Adicionar por IP em Impressoras na rede local, no separador Agente local. Não aparecer é normal em dois casos: quando o agente está noutra rede que não a das impressoras, e quando corre sobre Docker Desktop. Em nenhum dos dois perdes nada: acrescentada à mão funciona exatamente igual, com câmara e com comandos se essa máquina os tiver.

Abre-se Adicionar impressora por IP, em três passos:

Impressora: escolhe a marca da tua impressora e prime Seguinte. Klipper e Outra de resina (ChituBox) estão no fim, em Genéricas. É o cartão que decide como falamos com a impressora, por isso atenção a estes casos:
- A Elegoo troca a lista de marcas por Que Elegoo tens?: Saturn, Mars, Jupiter ou Centauri Carbon, Neptune 4 (todas) ou Centauri Carbon 2. Todas as marcas leva-te de volta à lista.
- Uma Snapmaker U1 é Snapmaker, não Klipper.
- Uma impressora com Klipper cuja marca não aparece, ou uma montagem tua, é Klipper.
- Uma de resina com placa ChituBox que não seja Elegoo é Outra de resina (ChituBox).
Se não tens a certeza de qual escolher, Não tens a certeza? Vê a lista de compatíveis leva-te à lista por marca. Se a tua marca não aparecer, o botão Abrir um pedido serve para nos dizeres.
Dados: preenche o que pede e prime Ligar. Os campos obrigatórios têm um asterisco vermelho.
- Que agente a liga?: só aparece se tiveres mais do que um agente. Os que não estão em linha aparecem na lista, mas não se podem escolher.
- IP da impressora: podes vê-la no ecrã da impressora (Definições → Rede) ou no teu router. Se usar outra porta, escreve-a a seguir: 192.168.1.50:5000.
- O código da impressora, se essa marca o pedir. O campo chama-se como cada marca lhe chama (vê a tabela abaixo).
- Nome (opcional): o que lhe quiseres dar.
O modelo e o número de série não se escrevem: é o agente que os pergunta à impressora. No fim, a caixa Lembra-te diz-te o que tem de estar ativado na impressora antes de ligar.
Ligação: vês o agente procurar a impressora nesse endereço e ligar-se a ela. Se correr tudo bem, prime Concluído e já está na tua lista. Se não, explica-te por palavras simples o que falhou e o que verificar, e por baixo, recolhida em Ver detalhe técnico, está a mensagem original (copia-a se nos pedires ajuda). Com Voltar regressas aos dados para os corrigir.

Isto é o que pede cada cartão no passo Dados:

Cartão	O que escrever
Bambu Lab	Código de acesso LAN, obrigatório. É o que a impressora mostra em Definições → Rede → Código de acesso, com o Modo LAN ativado.
Prusa	Palavra-passe do PrusaLink, obrigatória. A impressora gera-a e mostra-a em Definições → Rede → PrusaLink. Não é a do Prusa Connect.
FlashForge	Código de verificação, obrigatório. É o que aparece no menu de rede do ecrã da impressora, com LAN Only ativado.
Anycubic	Não pede nada, mas primeiro tens de ativar o Modo LAN na impressora (Definições → Rede → Modo LAN).
Creality	Não pede nada.
Elegoo → Centauri Carbon 2	Código de acesso (opcional). Deixa-o vazio, a não ser que lhe tenhas posto um código no ecrã da máquina (Definições → Rede); nesse caso, escreve esse código.
Klipper, Snapmaker e as marcas com Klipper (QIDI, Sovol, Voron, RatRig, Artillery, Two Trees e Elegoo → Neptune 4)	Chave de API (opcional). Só se configuraste uma chave de acesso no teu Klipper (Moonraker); encontras a chave no Mainsail ou no Fluidd, em Definições → API key. Se for uma que o agente encontrou e que recusou a ligação sem chave, o campo chama-se Chave de API do Moonraker e é obrigatório.
Elegoo → Saturn, Mars, Jupiter ou Centauri Carbon, Longer e Outra de resina (ChituBox)	Não pedem nada.

💡 Reserva o IP no teu router

Se o router mudar o endereço à impressora, voltamos a procurá-la sozinhos na tua rede, mas ela ficará em baixo durante algum tempo. Reservar-lhe o IP por MAC — ou pôr-lhe IP fixo — evita esse buraco.

Editar ou remover uma impressora

Em Impressoras na rede local, no separador Agente local, cada impressora diz que agente a conduz, e no seu menu ⋮ tens:

Editar: mudar o nome, o endereço, o código de acesso ou o agente que a gere. Também chegas aqui a partir do separador Impressoras, com Editar ligação local no menu da máquina.
Desligar: a impressora deixa de estar ligada por este agente.

Para que deixe de contar para o teu plano sem a removeres, desliga-a com o seu interruptor no separador Impressoras.

Sobre Desligar: se tinha outra via (por exemplo, a nuvem da Bambu), continua por essa. Se era a sua única via, sai da lista e deixa de contar para o teu plano. Não se perde nada: conserva o seu número e o seu histórico e, se a voltares a acrescentar —porque o agente a encontra ou por IP—, volta tal e qual, mesmo que tenha mudado de IP ou de código.

O que significa cada estado

Estado	O que se está a passar
Em linha	Está tudo bem: o agente vê-a e recebe os seus dados.
Ligada mas sem enviar dados	O agente ligou-se e a impressora não lhe conta nada. Costuma ser porque a máquina admite poucas ligações ao mesmo tempo e já tem outra aberta (a app do telemóvel, o fatiador).
Não responde nesse endereço	Confirma que está ligada e na mesma rede que o agente.
Responde mas recusa a ligação	Quase sempre o código de acesso errado, ou o modo LAN desativado na impressora.
Todas as impressoras de um agente desligadas ao mesmo tempo	O problema não é das impressoras: é do seu agente, que não responde. As máquinas podem estar perfeitamente. No separador Agente local, abre-o com Editar e vê o seu Estado.

Continua por aqui

🧩 O agente local — onde o instalar (com uma página para cada opção), como se liga, quando convém ter mais do que um e o que fazer quando alguma coisa falha.
🔗 Tipos de ligação — o que se pode fazer com cada família.
🖨️ Impressoras compatíveis — se a tua se pode ligar, e como.