Indice del manuale

🔌 Stampanti in rete locale

In rete locale, BolloPrint parla con le tue stampanti direttamente nel tuo laboratorio, senza passare per il cloud di nessun produttore. Per questo serve un intermediario dentro la tua rete: l'agente locale.

Si trova in Impostazioni → Stampanti, scheda Agente locale.

Perché è la via consigliata

Funziona con quasi tutti i marchi. Bambu Lab, Prusa, Elegoo, FlashForge, e quelle che hanno Klipper dentro (QIDI, Sovol, Voron, RatRig, Creality K1 con Moonraker raggiungibile…). Il dettaglio per modello è in Stampanti compatibili.
Puoi dare comandi: mettere in pausa, riprendere e annullare la stampa in corso, sulle macchine che lo permettono (le Bambu no).
Hai la telecamera: una foto dell'interno ogni pochi minuti mentre stampa, e un'altra subito quando la chiedi dalla scheda della stampante.
Non dipende dal produttore. Né dal fatto che il suo cloud funzioni, né che tenga aperto il suo servizio.
Regge le interruzioni di internet. Se la tua connessione cade, l'agente continua a leggere le stampanti e salva quello che succede; quando la linea torna, invia tutto. Non perdi lo storico di quelle ore.

L'agente non apre la tua rete a nessuno. È lui a chiamare noi, quindi non c'è bisogno di aprire porte sul router, né di avere un IP fisso, né di configurare nulla sul firewall. Funziona ugualmente dietro un normale router domestico.

I tre passi

Creare l'agente in BolloPrint e copiare il suo manifesto di installazione, che contiene già il codice.
Installarlo su un computer del laboratorio che resti sempre acceso.
Registrare le stampanti che gestirà.

Il passo 2 è spiegato in dettaglio in Installare l'agente. Qui proseguiamo con il 3.

Aggiungere stampanti

Quelle che compaiono da sole

L'agente cerca stampanti nella tua rete e quelle che trova compaiono nella scheda Agente locale, in fondo a Stampanti in rete locale, in Rilevate nella rete (con più agenti, «Rilevate da» e il nome di ciascuno), con il loro marchio e il loro modello. Premi Aggiungi ed è fatta. Se non è tua o non la vuoi, Ignora. Quando ce n'è qualcuna, lo vedrai anche in un avviso sopra le schede.

Se è una stampante che hai già tramite Bambu Cloud, te lo dice («È «P1S-02», che hai già tramite Bambu Cloud») e il pulsante è Collega anche via LAN: non crea una nuova stampante, aggiunge la via locale a quella che hai già.

Alcune ti chiederanno un codice di accesso prima di collegarsi; è la scheda stessa ad avvisarti se lo farà.

Può anche comparire una stampante contrassegnata come Prossimamente: sappiamo cos'è, ma non possiamo ancora collegarla. Se è una che ti serve, diccelo — ci aiuta a decidere l'ordine.

Quelle da aggiungere a mano

Se la stampante non compare, premi Aggiungi per IP in Stampanti in rete locale, nella scheda Agente locale. Se hai più di un agente, ti chiede quale la gestirà. Che non compaia è normale in due casi: quando l'agente sta su un'altra rete rispetto alle stampanti, e quando gira su Docker Desktop. In nessuno dei due perdi qualcosa: aggiunta a mano funziona esattamente uguale, con telecamera e con i comandi se quella macchina li ha.

Protocollo: il tipo di stampante. L'elenco offre solo quelli che possiamo collegare.
Indirizzo: l'IP della stampante. Se usa una porta diversa da quella abituale, scrivila dopo: 192.168.1.50:5000.
Nome (facoltativo): quello che vuoi darle tu.
Modello: per esempio «Saturn 4 Ultra» o «MK4S». Compilalo: con questo sappiamo se la macchina è a filamento o a resina e le diamo la scheda giusta.
La password della stampante, se quella famiglia la richiede. Il nome del campo cambia a seconda del protocollo (vedi la tabella).

Il campo della password si chiama come la chiama ogni marca, e sotto ti dice dove trovarla sulla stampante. Questo è quello che devi mettere:

Protocollo	Cosa scrivere
Bambu Lab	Compare come Codice di accesso LAN. È quello che la stampante mostra in Impostazioni → Rete → Codice di accesso, con la Modalità LAN attivata.
PrusaLink	Compare come Password di PrusaLink. La genera la stampante e la mostra in Impostazioni → Rete → PrusaLink. Non è quella di Prusa Connect.
FlashForge	Compare come Codice di verifica. È quello che compare nel menu di rete dello schermo della stampante, con LAN Only attivato.
Elegoo (MQTT locale) — Centauri Carbon 2	Compare come Codice di accesso (facoltativo). Lascialo vuoto a meno che tu non abbia messo un codice sullo schermo della macchina (Impostazioni → Rete); in quel caso, scrivi quel codice.
Klipper	Compare come Chiave API (facoltativa). Solo se hai configurato una chiave di accesso nel tuo Klipper (Moonraker). Se la stampante ha rifiutato la connessione senza chiave, il campo diventa Chiave API di Moonraker ed è obbligatorio: la trovi in Mainsail o Fluidd, in Impostazioni → API key.
SDCP	Non chiede nulla.

L'agente scopre da solo il numero di serie. Non serve che tu lo digiti.

💡 Riserva l'IP sul tuo router

Se il router cambia l'indirizzo alla stampante, la ricerchiamo da soli nella tua rete, ma resterà giù per un po'. Riservarle l'IP per MAC —o darle un IP fisso— evita il buco.

Modificare o rimuovere una stampante

In Stampanti in rete locale, nella scheda Agente locale, ogni stampante dice quale agente la gestisce, e nel suo menu ⋮ trovi:

Modifica: cambiare il nome, l'indirizzo, il codice di accesso o l'agente che la gestisce. Ci arrivi anche dalla scheda Stampanti, con Modifica connessione locale nel menu della macchina.
Scollega: la stampante smette di essere collegata tramite questo agente.

Perché smetta di contare per il tuo piano senza rimuoverla, spegnila con il suo interruttore nella scheda Stampanti.

Riguardo a Scollega: se aveva un'altra via (per esempio, il cloud di Bambu), continua da quella. Se era la sua unica via, resta «Senza connessione» e continua a contare per il tuo piano finché non la disattivi o la elimini. Non si perde nulla: conserva il suo numero e il suo storico, e se la ricolleghi torna esattamente com'era, anche se ha cambiato IP o codice.

Cosa significa ogni stato

Stato	Cosa sta succedendo
Online	Tutto bene: l'agente la vede e riceve i suoi dati.
Collegata ma non invia dati	L'agente si è collegato e la stampante non gli racconta nulla. Di solito è perché la macchina ammette poche connessioni alla volta e ne ha già un'altra aperta (l'app del cellulare, lo slicer).
Non risponde a quell'indirizzo	Controlla che sia accesa e nella stessa rete dell'agente.
Risponde ma rifiuta la connessione	Quasi sempre il codice di accesso sbagliato, o la modalità LAN disattivata sulla stampante.
Tutte le stampanti di un agente disconnesse insieme	Il problema non è delle stampanti: è il loro agente, che non risponde. Le macchine possono stare benissimo. Nella scheda Agente locale, aprilo con Modifica e guarda il suo Stato.

Prosegui da qui

🧩 L'agente locale — come si installa (Installare l'agente), come si aggiorna (Aggiornare l'agente), come si collega, quando conviene averne più di uno e cosa fare quando qualcosa non va.
🔗 Tipi di connessione — cosa si può fare con ogni famiglia.
🖨️ Stampanti compatibili — se la tua si può collegare, e come.