Indice del manuale

🧩 L'agente locale

In 30 secondi

L'agente locale è un piccolo programma che gira su un computer del tuo laboratorio e collega le tue stampanti attraverso la tua rete.
Si installa su qualcosa che hai già acceso: un NAS (Synology, QNAP, TrueNAS), un PC con Windows, Home Assistant, o qualsiasi computer con Docker o Kubernetes. Qui sotto trovi quale ti conviene.
Ne basta uno per tutta la flotta, ed è lui che chiama BolloPrint: non serve aprire porte né avere un IP fisso.
Si aggiorna da solo, e se cade internet salva quello che succede e lo invia al ritorno.

L'agente locale è un piccolo programma che gira su un computer del tuo laboratorio. Parla con le tue stampanti attraverso la rete di casa e racconta a BolloPrint quello che vede.

È l'unica cosa da installare per collegare stampanti in rete locale, e ne basta uno solo per tutta la flotta.

Ti serve?

La tua situazione	Ti serve l'agente?
Hai Bambu Lab e ti basta vederle dal cloud	No, ma con l'agente guadagni la telecamera. E, se attivi sulla stampante la Modalità sviluppatore, anche mettere in pausa, riprendere e annullare: dal cloud non si può
Hai Prusa	Sì. È l'unico modo per collegarle
Hai Elegoo a resina o Centauri	Sì. Non c'è un'altra via
Hai QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, una Snapmaker U1 o qualsiasi macchina con Klipper	Sì
Hai FlashForge Adventurer 5M, AD5X o Creator 5	Sì
Hai Anycubic Kobra 3, Kobra S1, Kobra 4 o Kobra X	Sì. Con la Modalità LAN attivata sulla stampante (in beta)
Hai una Creality K1, K2, Ender-3 V3 o Hi	Sì. Con il firmware di fabbrica, senza preparare nulla (in beta)
Non vuoi che le tue stampanti escano su internet	Sì. L'agente parla con loro dentro la tua rete

Scegli dove installarlo

L'agente va su un computer del laboratorio che sia sempre acceso e, se possibile, nella stessa rete delle stampanti. Non serve comprare nulla: quasi sempre va bene qualcosa che hai già.

Ci sono due modi per installarlo, e la differenza sta in come si collega al tuo account la prima volta:

Con un pacchetto o un programma di installazione (Synology, QNAP, Windows, Home Assistant, TrueNAS). Lo installi come qualsiasi altra applicazione del tuo computer, apri la sua pagina e premi Collega a BolloPrint. Confermi in BolloPrint ed è fatta: non ci sono codici da copiare.
Con un container (Docker, Kubernetes). Crei l'agente in BolloPrint e ti diamo un manifesto con le sue chiavi già inserite, che incolli sul tuo computer.

Dove	Cosa ti serve	Come si installa	Stato
Synology	Un NAS Synology con DSM	Pacchetto, e Collega a BolloPrint	Beta
QNAP	Un NAS QNAP con QTS	Pacchetto da installare a mano, e Collega a BolloPrint	Beta
Windows	Un PC con Windows che non spegni	Programma di installazione, e Collega a BolloPrint	Beta
Home Assistant	Home Assistant con il suo store di applicazioni	Applicazione di Home Assistant, e Collega a BolloPrint	Beta
TrueNAS	Un NAS TrueNAS con Apps	Applicazione di TrueNAS, e Collega a BolloPrint	Beta
Docker	Qualsiasi computer con Docker o Portainer: un NAS, un mini-PC, un Raspberry Pi, un server	Manifesto con chiavi	Stabile
Kubernetes	Un cluster Kubernetes (va bene anche k3s) con un nodo nella rete delle stampanti	Manifesto con chiavi	Stabile

Indeciso tra due? Se il tuo computer ha un pacchetto, usa il pacchetto: si installa con meno passi e si collega con un clic. Docker è l'opzione per tutto il resto, e quella che funziona da più tempo nei laboratori. Quelle segnate Beta funzionano, ma sono nuove: se qualcosa non va come ti aspetti, raccontacelo all'assistenza.

Ogni pagina spiega le due cose che farai con l'agente: installarlo la prima volta e aggiornarlo se un giorno te lo chiediamo.

💡 Per cominciare, in BolloPrint

Tutte cominciano nello stesso punto: Impostazioni → Stampanti, scheda Agente locale, pulsante Nuovo agente. La prima cosa che ti chiede è Dove lo installerai?, con un pulsante per ciascuna delle opzioni di questa tabella.

Tenerlo aggiornato

L'agente si aggiorna da solo: quando esce una versione nuova, la scarica, verifica che sia nostra e si riavvia con essa. Non lo fa mai mentre una delle sue stampanti sta stampando.

Dovrai fare qualcosa solo se BolloPrint ti avvisa che il tuo agente ha bisogno di un aggiornamento manuale, e dipende da come l'hai installato:

Con un pacchetto o un programma di installazione: installa la versione nuova sopra quella che hai, senza disinstallare la precedente.
Con Docker o Kubernetes: cambia la versione dell'immagine nel tuo file e reinstallalo, con le stesse chiavi.

La procedura passo passo è nella pagina di ciascun tipo.

Come si collega

L'agente chiama BolloPrint, non il contrario. È questo che fa sì che funzioni senza toccare il router: non bisogna aprire porte, né chiedere un IP fisso, né toccare il firewall. Funziona dietro un normale router domestico, e persino con le connessioni in fibra che non danno un IP pubblico.

Caricamento del diagramma…

Ciò che BolloPrint dice all'agente viaggia attraverso quella stessa connessione che ha aperto lui.

Una volta collegato:

chiede quali stampanti deve seguire,
si collega a ciascuna con il suo protocollo,
e invia man mano quello che vede.

Quando registri una nuova stampante da BolloPrint, l'agente se ne accorge da solo, in pochi secondi. Non bisogna riavviarlo.

La schermata di stato

La scheda Agente locale ha due parti:

Gli agenti, uno per riga, con il logo di dove è installato, il suo stato e la sua versione. Nel menu ⋮ di ciascuno trovi Modifica, che apre la sua finestra, e Elimina.
Stampanti in rete locale, sotto: quelle di tutti i tuoi agenti insieme, ciascuna con l'agente che la gestisce. In alto trovi Cerca ora e Aggiungi per IP, e in fondo quello che ogni agente ha trovato nella tua rete e gli indirizzi che sta ancora cercando.

La finestra di un agente ha due schede:

Stato — quello che l'agente stesso riferisce (la tabella qui sotto), le installazioni in attesa e il collegamento con ogni stampante. Qui puoi anche cambiargli il nome.
Installazione — con Docker e Kubernetes, il manifesto con la versione attuale e Rigenera le chiavi. In un agente installato con un pacchetto dice solo che è stato collegato dalla sua pagina: non ha manifesto né chiavi. Per toglierlo, usa Elimina nel menu ⋮ dell'elenco, e la sua pagina torna a offrire Collega a BolloPrint.

Cosa può comparire in Stato:

Quello che vedi	Cosa significa
Online	È collegato e sta lavorando.
Non installato	L'hai creato in BolloPrint, ma non si è ancora mai collegato. Non si è rotto niente: manca solo avviarlo sul tuo computer.
Nessun segnale recente	È da un po' che non dà segnali. Di solito è il computer spento o senza internet.
Offline	Non c'è.
Modalità sicura	Si è avviato e si è collegato, ma non sta gestendo stampanti. Ti dice il motivo.
Buffer	Quello che ha salvato mentre non poteva inviarlo. Se compare «messaggi scartati», c'è stata un'interruzione così lunga che non ci è entrato tutto.
Aggiorna il tuo agente	C'è una versione più recente. Gli agenti recenti si aggiornano da soli; se dice che serve un aggiornamento manuale, segui la pagina del tuo tipo di agente.

Sotto, Collegamento con ogni stampante: macchina per macchina, se l'agente la raggiunge e, se no, perché.

L'agente cerca stampanti nuove nella tua rete da solo ogni 15 minuti. Se ne hai appena accesa una e non vuoi aspettare, premi Cerca ora in Stampanti in rete locale.

Particolarità che conviene conoscere

Un agente regge un'intera flotta. Non serve uno per stampante né uno per stanza. Detto questo, puoi avere più agenti nello stesso account, e ci sono tre motivi per farlo:

Reti separate: una VLAN per la produzione e un'altra per l'ufficio, per esempio. Un agente in ciascuna scopre le sue senza che tu debba aggiungere nulla a mano.
Sedi diverse: due capannoni, due laboratori, due case. Ogni posto con il suo, e si vede tutto insieme in BolloPrint.
Un agente sovraccarico: se la flotta cresce molto e noti che fa fatica, distribuisci le stampanti fra due.

Non devono essere dello stesso tipo: puoi averne uno sul Synology del capannone e un altro su Docker in ufficio. Nella scheda Agente locale li vedrai uno sotto l'altro, e in Stampanti in rete locale ogni macchina dice da quale agente arriva. Per spostare una stampante da un agente a un altro, aprila con Modifica nel suo menu ⋮ e cambia l'agente nel menu a tendina. Con Aggiungi per IP e più agenti, ti chiede quale la gestirà.

⚠️ Un agente per computer

Ogni computer ha il suo agente. Un agente Docker o Kubernetes non si copia su una seconda macchina con lo stesso manifesto: per due computer, due agenti. I dettagli di ciascun tipo, nella sua pagina.

Sopravvive alle interruzioni. Se cade la tua connessione a internet, l'agente continua a leggere le stampanti e a salvare quello che succede. Quando la connessione torna, invia tutto. Le ore dell'interruzione non si perdono dallo storico.

Eliminare un agente si porta via le sue stampanti. Si fa dal menu ⋮ della sua riga. Smette di collegarsi all'istante, e le stampanti che arrivavano solo tramite lui spariscono dall'elenco e smettono di contare per il tuo piano. Quelle che arrivano anche tramite Bambu Cloud restano. Non si perde nulla: se aggiungi di nuovo una di quelle stampanti —con un altro agente, tramite scoperta o per IP—, torna con il suo numero e tutto il suo storico. Quello che è installato sul tuo computer non si elimina da BolloPrint: un pacchetto torna da solo alla sua pagina di Collega a BolloPrint, e un container lo fermi e lo elimini tu. Come, nella pagina di ciascun tipo.

Quando qualcosa non va

Sintomo	Cosa guardare
L'agente non compare mai	Il computer arriva a internet? C'è un firewall che blocca l'uscita? Con Docker e Kubernetes, il manifesto è stato incollato per intero, senza modifiche?
Non rileva nessuna stampante	L'agente e le stampanti sono nella stessa rete? Se non lo sono, o se usi Docker Desktop, è quello che ci si aspetta: aggiungile per IP e funzioneranno lo stesso.
Una stampante risulta «collegata ma non invia dati»	Chiudi l'app del cellulare o lo slicer che la tiene aperta. Alcune macchine ammettono una sola connessione alla volta.
Una stampante «risponde ma rifiuta la connessione»	Codice di accesso sbagliato, o modalità LAN disattivata sullo schermo della macchina. Attenzione: sulle Bambu, il codice cambia ogni volta che attivi o disattivi la modalità LAN.
Tutte le stampanti di un agente disconnesse di colpo	Non è la flotta, è l'agente. Aprilo con Modifica e guarda il suo Stato.

Se non basta, la pagina del tuo tipo di agente spiega dove vedere il suo registro, che è la prima cosa che ti chiederemo all'assistenza.

Domande frequenti

Posso mettere in pausa o annullare una stampa da BolloPrint? Sì, sulle macchine collegate tramite l'agente che lo permettono (oggi Klipper, Snapmaker, PrusaLink, le Elegoo che passano per SDCP — quelle a resina e la Centauri Carbon — e le Bambu con la Modalità sviluppatore attivata). Quella modalità richiede la Modalità LAN Only, che scollega la Bambu dal suo cloud; senza di essa, la stampante ignora il comando, e BolloPrint spegne i suoi pulsanti appena lo rifiuta. Dal cloud, le Bambu non accettano comandi. Quello che non si può fare su nessuna è inviare lavori: il file si continua a mandare dal tuo slicer.

Cosa succede se cade internet in laboratorio? L'agente continua a parlare con le tue stampanti e salva quello che succede. Quando la connessione torna, invia tutto. Se l'interruzione è lunghissima può darsi che non gli entri tutto il dettaglio, e in quel caso te lo dice.

Salva qualcosa sul mio disco? Non salva dati di stampa. Salva il proprio registro di attività degli ultimi giorni, che si cancella da solo, e le versioni che scarica per aggiornarsi. Quel registro esce dal tuo computer solo se il supporto di BolloPrint lo chiede per indagare su un problema.

Quanto consuma? Poco: non ha bisogno di un computer potente e sta comodamente su un NAS o un mini-PC, accanto a quello che ci gira già. Con Docker e Kubernetes, il manifesto gli mette un limite di 512 MB di memoria.

E se spengo il computer? Non succede nulla. Riaccendendolo, l'agente torna da solo e senza chiederti niente.

Devo aprire porte sul router? No. Né porte, né IP fisso, né regole di firewall. La connessione esce dalla tua rete verso l'esterno, come quando apri una pagina web.

Posso cambiare tipo più avanti? Sì. Installa quello nuovo, controlla che risulti Online, passagli le stampanti (o lascia che le trovi) ed elimina quello vecchio. Le stampanti conservano il loro numero e il loro storico.