Índice do manual

🔌 Impressoras por rede local

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, e as que levam Klipper por dentro (QIDI, Sovol, Voron, RatRig, Creality K1 com Moonraker acessível…). 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, não).
Tens câmara: uma foto do interior de poucos em poucos minutos enquanto imprime, e outra no momento quando a pedes na ficha da impressora.
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

Criar o agente no BolloPrint e copiar o seu manifesto de instalação, que já leva o código lá dentro.
Instalá-lo num equipamento da oficina que esteja sempre ligado.
Registar as impressoras que vai gerir.

O passo 2 está detalhado em Instalar o agente. 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.

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. Se tiveres mais do que um agente, pergunta-te qual é o que a vai conduzir. 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.

Protocolo: o tipo de impressora. A lista só oferece os que conseguimos ligar.
Endereço: o IP da impressora. Se usar uma porta diferente da habitual, escreve-a a seguir: 192.168.1.50:5000.
Nome (opcional): o que lhe quiseres dar.
Modelo: por exemplo «Saturn 4 Ultra» ou «MK4S». Preenche-o: com ele sabemos se a máquina é de filamento ou de resina e damos-lhe a ficha que lhe corresponde.
A palavra-passe da impressora, se essa família a pedir. O nome do campo muda consoante o protocolo (vê a tabela).

O campo da palavra-passe chama-se como cada marca lhe chama, e por baixo diz-te onde a encontrar na impressora. Isto é o que tens de pôr:

Protocolo	O que escrever
Bambu Lab	Aparece como Código de acesso LAN. É o que a impressora mostra em Definições → Rede → Código de acesso, com o Modo LAN ativado.
PrusaLink	Aparece como Palavra-passe do PrusaLink. A impressora gera-a e mostra-a em Definições → Rede → PrusaLink. Não é a do Prusa Connect.
FlashForge	Aparece como Código de verificação. É o que aparece no menu de rede do ecrã da impressora, com LAN Only ativado.
Elegoo (MQTT local) — Centauri Carbon 2	Aparece como 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	Aparece como Chave de API (opcional). Só se configuraste uma chave de acesso no teu Klipper (Moonraker). Se a impressora recusou a ligação sem chave, o campo passa a ser Chave de API do Moonraker e é obrigatório: encontras a chave no Mainsail ou no Fluidd, em Definições → API key.
SDCP	Não pede nada.

O agente descobre sozinho o número de série. Não é preciso escrevê-lo.

💡 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, fica «Sem ligação» e continua a contar para o teu plano até a desativares ou apagares. Não se perde nada: conserva o seu número e o seu histórico e, se a voltares a ligar, 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 — como se instala (Instalar o agente), como se atualiza (Atualizar o agente), 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.