🧩 El agente local
En 30 segundos
- El agente local es un programa pequeño que corre en un equipo de tu taller y conecta tus impresoras por tu red.
- Se instala en algo que ya tengas encendido: un NAS (Synology, QNAP, TrueNAS), un PC con Windows, Home Assistant, o cualquier equipo con Docker o Kubernetes. Abajo tienes cuál te conviene.
- Uno basta para toda la flota, y es él quien llama a BolloPrint: no hay que abrir puertos ni tener IP fija.
- Se actualiza solo, y si se cae internet guarda lo que pasa y lo envía al volver.
El agente local es un programa pequeño que corre en un equipo de tu taller. Habla con tus impresoras por la red de casa y le cuenta a BolloPrint lo que ve.
Es lo único que hay que instalar para conectar impresoras por red local, y con uno solo basta para toda la flota.
¿Lo necesitas?
| Tu situación | ¿Te hace falta el agente? |
|---|---|
| Tienes Bambu Lab y te vale con verlas por la nube | No, pero con el agente ganas cámara. Y, si activas en la impresora el Modo desarrollador, también pausar, reanudar y cancelar: por la nube no se puede |
| Tienes Prusa | Sí. Es la única forma de conectarlas |
| Tienes Elegoo de resina o Centauri | Sí. No hay otra vía |
| Tienes QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, una Snapmaker U1 o cualquier máquina con Klipper | Sí |
| Tienes FlashForge Adventurer 5M, AD5X o Creator 5 | Sí |
| Tienes Anycubic Kobra 3, Kobra S1, Kobra 4 o Kobra X | Sí. Con el Modo LAN activado en la impresora (en beta) |
| Tienes una Creality K1, K2, Ender-3 V3 o Hi | Sí. Con su firmware de fábrica, sin preparar nada (en beta) |
| No quieres que tus impresoras salgan a internet | Sí. El agente habla con ellas dentro de tu red |
Elige dónde instalarlo
El agente va en un equipo del taller que esté siempre encendido y, a ser posible, en la misma red que las impresoras. No hace falta comprar nada: casi siempre sirve algo que ya tienes.
Hay dos formas de instalarlo, y la diferencia es cómo se conecta a tu cuenta la primera vez:
- Con un paquete o un instalador (Synology, QNAP, Windows, Home Assistant, TrueNAS). Lo instalas como cualquier otra aplicación de tu equipo, abres su página y pulsas Vincular con BolloPrint. Confirmas en BolloPrint y listo: no hay códigos que copiar.
- Con un contenedor (Docker, Kubernetes). Creas el agente en BolloPrint y te damos un manifiesto con sus claves ya puestas, que pegas en tu equipo.
| Dónde | Qué necesitas | Cómo se instala | Estado |
|---|---|---|---|
| Synology | Un NAS Synology con DSM | Paquete, y Vincular con BolloPrint | Beta |
| QNAP | Un NAS QNAP con QTS | Paquete que se instala a mano, y Vincular con BolloPrint | Beta |
| Windows | Un PC con Windows que no apagues | Instalador, y Vincular con BolloPrint | Beta |
| Home Assistant | Home Assistant con su tienda de aplicaciones | Aplicación de Home Assistant, y Vincular con BolloPrint | Beta |
| TrueNAS | Un NAS TrueNAS con Apps | Aplicación de TrueNAS, y Vincular con BolloPrint | Beta |
| Docker | Cualquier equipo con Docker o Portainer: un NAS, un mini-PC, una Raspberry Pi, un servidor | Manifiesto con claves | Estable |
| Kubernetes | Un clúster de Kubernetes (k3s también vale) con un nodo en la red de las impresoras | Manifiesto con claves | Estable |
¿Dudas entre dos? Si tu equipo tiene paquete, usa el paquete: se instala con menos pasos y se vincula con un clic. Docker es la opción para todo lo demás, y la que más tiempo lleva funcionando en talleres. Las que llevan Beta funcionan, pero son nuevas: si algo no va como esperas, cuéntanoslo en soporte.
Cada página explica las dos cosas que vas a hacer con el agente: instalarlo la primera vez y actualizarlo si alguna vez te lo pedimos.
💡 Para empezar, en BolloPrint
Todas empiezan en el mismo sitio: Configuración → Impresoras, pestaña Agente local, botón Nuevo agente. Lo primero que te pregunta es ¿Dónde lo vas a instalar?, con un botón para cada una de las opciones de esta tabla.
Mantenerlo al día
El agente se actualiza solo: cuando sale una versión nueva, la descarga, comprueba que es nuestra y se reinicia con ella. Nunca lo hace mientras alguna de sus impresoras está imprimiendo.
Solo si BolloPrint te avisa de que tu agente necesita una actualización manual tendrás que hacer algo, y depende de cómo lo instalaste:
- Con un paquete o un instalador: instala la versión nueva encima de la que tienes, sin desinstalar la anterior.
- Con Docker o Kubernetes: cambia la versión de la imagen en tu fichero y vuelve a desplegarlo, con las mismas claves.
El paso a paso está en la página de cada tipo.
Cómo se conecta
El agente llama a BolloPrint, no al revés. Eso es lo que hace que funcione sin tocar el router: no hay que abrir puertos, ni pedir IP fija, ni tocar el firewall. Funciona detrás de un router doméstico normal, e incluso con las conexiones de fibra que no dan IP pública.
Cargando diagrama…
Lo que BolloPrint le dice al agente viaja por esa misma conexión que abrió él.
Una vez conectado:
- pregunta qué impresoras tiene que atender,
- se conecta a cada una por su protocolo,
- y va enviando lo que ve.
Cuando das de alta una impresora nueva desde BolloPrint, el agente se entera solo, en segundos. No hay que reiniciarlo.
La pantalla de estado
La pestaña Agente local tiene dos partes:
- Los agentes, uno por fila, con el logo de dónde está instalado, su estado y su versión. En el menú ⋮ de cada uno tienes Editar, que abre su ventana, y Eliminar.
- Impresoras por red local, debajo: las de todos tus agentes juntas, cada una con el agente que la conduce. Arriba están Buscar ahora y Añadir por IP, y al final lo que cada agente ha encontrado en tu red y las direcciones que aún está buscando.
La ventana de un agente tiene dos pestañas:
- Estado — lo que el propio agente informa (la tabla de abajo), las instalaciones pendientes y la conexión con cada impresora. Aquí también le cambias el nombre.
- Despliegue — en Docker y Kubernetes, el manifiesto con la versión actual y Regenerar claves. En un agente instalado con un paquete solo dice que se vinculó desde su página: no tiene manifiesto ni claves. Para quitarlo, Eliminar en el menú ⋮ de la lista, y su página vuelve a ofrecer Vincular con BolloPrint.
Lo que puede aparecer en Estado:
| Lo que ves | Qué significa |
|---|---|
| En línea | Está conectado y trabajando. |
| Sin instalar | Lo creaste en BolloPrint, pero todavía no se ha conectado nunca. No se ha roto nada: falta arrancarlo en tu equipo. |
| Sin señal reciente | Lleva un rato sin dar señales. Suele ser el equipo apagado o sin internet. |
| Desconectado | No está. |
| Modo seguro | Ha arrancado y ha conectado, pero no está gestionando impresoras. Te dice el motivo. |
| Búfer | Lo que ha guardado mientras no podía enviarlo. Si aparece «mensajes descartados», hubo un corte tan largo que no cupo todo. |
| Actualiza tu agente | Hay una versión más reciente. Los agentes recientes se actualizan solos; si dice que hace falta actualizar a mano, sigue la página de tu tipo de agente. |
Debajo, Conexión con cada impresora: máquina por máquina, si el agente llega a ella y, si no, por qué.
El agente busca impresoras nuevas en tu red él solo cada 15 minutos. Si acabas de encender una y no quieres esperar, pulsa Buscar ahora en Impresoras por red local.
Peculiaridades que conviene conocer
Un agente aguanta una flota entera. No hace falta uno por impresora ni uno por sala. Dicho eso, puedes tener varios agentes en la misma cuenta, y hay tres motivos para hacerlo:
- Redes separadas: una VLAN para producción y otra para oficina, por ejemplo. Un agente en cada una descubre las suyas sin que tengas que añadir nada a mano.
- Locales distintos: dos naves, dos talleres, dos casas. Cada sitio con el suyo, y todo se ve junto en BolloPrint.
- Un agente saturado: si la flota crece mucho y notas que va justo, reparte las impresoras entre dos.
No tienen por qué ser del mismo tipo: puedes tener uno en el Synology de la nave y otro en Docker en la oficina. En la pestaña Agente local los verás uno debajo de otro, y en Impresoras por red local cada máquina dice por qué agente llega. Para mover una impresora de un agente a otro, ábrela con Editar en su menú ⋮ y cambia el agente en el desplegable. Al Añadir por IP con varios agentes, te pregunta cuál la conduce.
⚠️ Un agente por equipo
Cada equipo lleva su propio agente. Un agente de Docker o Kubernetes no se copia en una segunda máquina con el mismo manifiesto: para dos equipos, dos agentes. Lo de cada tipo, en su página.
Sobrevive a los cortes. Si se cae tu internet, el agente sigue leyendo las impresoras y guardando lo que pasa. Cuando vuelve la conexión, lo manda todo. Las horas del corte no se pierden del historial.
Eliminar un agente se lleva sus impresoras. Se hace desde el menú ⋮ de su fila. Deja de conectarse al momento, y las impresoras que solo llegaban por él desaparecen de la lista y dejan de contar para tu plan. Las que también llegan por Bambu Cloud se quedan. No se pierde nada: si vuelves a añadir una de esas impresoras —con otro agente, por descubrimiento o por IP—, vuelve con su número y todo su historial. Lo que hay instalado en tu equipo no se borra desde BolloPrint: un paquete vuelve solo a su página de Vincular con BolloPrint, y un contenedor lo paras y lo eliminas tú. Cómo, en la página de cada tipo.
Cuando algo no va
| Síntoma | Qué mirar |
|---|---|
| El agente no aparece nunca | ¿El equipo llega a internet? ¿Hay un cortafuegos bloqueando la salida? En Docker y Kubernetes, ¿se pegó el manifiesto entero, sin cambios? |
| No detecta ninguna impresora | ¿Están el agente y las impresoras en la misma red? Si no lo están, o si usas Docker Desktop, es lo esperado: añádelas por IP y funcionarán igual. |
| Una impresora sale «conectada pero sin enviar datos» | Cierra la app del móvil o el laminador que la tenga abierta. Algunas máquinas solo admiten una conexión a la vez. |
| Una impresora «responde pero rechaza la conexión» | Código de acceso equivocado, o modo LAN desactivado en la pantalla de la máquina. Ojo: en Bambu, el código cambia cada vez que activas o desactivas el modo LAN. |
| Todas las impresoras de un agente, desconectadas de golpe | No es la flota, es el agente. Ábrelo con Editar y mira su Estado. |
Si con eso no basta, la página de tu tipo de agente explica dónde ver su registro, que es lo primero que te pediremos en soporte.
Preguntas frecuentes
¿Puedo pausar o cancelar una impresión desde BolloPrint? Sí, en las máquinas conectadas por el agente que lo permiten (hoy, Klipper, Snapmaker, PrusaLink, las Elegoo que van por SDCP —las de resina y la Centauri Carbon— y las Bambu con el Modo desarrollador activado). Ese modo exige el Modo LAN Only, que desconecta la Bambu de su nube; sin él, la impresora ignora la orden, y BolloPrint apaga sus botones en cuanto la rechaza. Por la nube, las Bambu no aceptan órdenes. Lo que no se puede en ninguna es enviar trabajos: el fichero se sigue mandando desde tu laminador.
¿Qué pasa si se cae internet en el taller? El agente sigue hablando con tus impresoras y guarda lo que ocurre. Cuando vuelve la conexión, lo envía todo. Si el corte es larguísimo puede que no le quepa el detalle entero, y en ese caso te lo dice.
¿Guarda algo en mi disco? No guarda datos de impresión. Guarda su propio registro de actividad de los últimos días, que se va borrando solo, y las versiones que descarga para actualizarse. Ese registro solo sale de tu equipo si soporte de BolloPrint lo pide para investigar un problema.
¿Cuánto consume? Poco: no necesita un equipo potente, y cabe de sobra en un NAS o en un mini-PC junto a lo que ya tengas. En Docker y Kubernetes, el manifiesto le pone un tope de 512 MB de memoria.
¿Y si apago el equipo? No pasa nada. Al encenderlo, el agente vuelve solo y sin pedirte nada.
¿Tengo que abrir puertos en el router? No. Ni puertos, ni IP fija, ni reglas de cortafuegos. La conexión sale de tu red hacia fuera, como cuando abres una página web.
¿Puedo cambiar de tipo más adelante? Sí. Instala el nuevo, comprueba que sale En línea, pasa las impresoras a él (o deja que las encuentre) y elimina el antiguo. Las impresoras conservan su número y su historial.