🧩 El agente local
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. Pausar y cancelar no: Bambu no acepta órdenes de programas ajenos, vaya por donde vaya |
| 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 Creality K1 con Moonraker accesible o cualquier máquina con Klipper | Sí |
| Tienes FlashForge Adventurer 5M, AD5X o Creator 5 | Sí |
| No quieres que tus impresoras salgan a internet | Sí. El agente habla con ellas dentro de tu red |
Instalarlo y mantenerlo al día
Dos páginas aparte, porque son dos momentos distintos:
- 🚀 Desplegar el agente — dónde ponerlo, cómo crearlo en BolloPrint y cómo arrancarlo en tu equipo con Docker Compose, Portainer o Kubernetes.
- 🔄 Actualizar el agente — qué hacer cuando BolloPrint te avisa de que hay una versión nueva. Es cambiar un número y volver a desplegar.
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.
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.
Autorizar instalaciones
La instalación de la plantilla que copiaste entra directa. Cualquier otra instalación que use ese mismo código espera tu visto bueno: verás un aviso rojo encima de las pestañas y, dentro del agente, en Estado, la instalación en Instalaciones pendientes de autorizar, con el nombre del equipo desde el que se conecta.
Con una plantilla actual esto casi no pasa: la identidad va escrita en la propia plantilla, así que puedes mover el agente de máquina o reinstalarlo y sigue siendo el mismo. Es normal que pase con un agente anterior, desplegado con una plantilla sin identidad, cuando:
- lo mueves a otra máquina,
- borras su volumen de datos y lo vuelves a crear,
- lo reinstalas desde cero.
Pulsa Autorizar si reconoces el equipo. Al autorizar uno, el anterior deja de tener acceso.
Si aparece una instalación pendiente que no has puesto tú, no la autorices: significa que alguien más tiene tu código. Abre el agente, usa Regenerar claves en Despliegue y vuelve a desplegarlo con la plantilla nueva.
La pantalla de estado
La pestaña Agente local tiene dos partes:
- Los agentes, uno por fila, con 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 — la plantilla con la versión actual y Regenerar claves.
Lo que puede aparecer en Estado:
| Lo que ves | Qué significa |
|---|---|
| En línea | Está conectado y trabajando. |
| 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. Se hace en tu equipo, no desde BolloPrint: cambia la versión de la imagen en tu fichero y vuelve a desplegar. Paso a paso en Actualizar el 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
El agente recuerda quién es. Su identidad va escrita en la plantilla (BP_AGENT_INSTANCE_ID), así que la misma plantilla arrancada en otra máquina sigue siendo el mismo agente. No la cambies ni la copies en otra instalación: es su contraseña. Los agentes desplegados con una plantilla anterior guardan la identidad en su volumen de datos; si lo borras, tendrás que autorizarlo otra vez (no se pierde nada).
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.
Cada agente se crea igual, con su nombre y su propio código. 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 código por equipo
Lo que no debes hacer es usar el mismo código en dos máquinas: la segunda se quedará esperando autorización, y si la autorizas, la primera pierde el acceso. Para dos equipos, dos agentes.
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.
Regenerar las claves corta el agente al momento. El código y la identidad anteriores dejan de valer en cuanto pulsas el botón, así que el agente se desconecta hasta que lo vuelvas a desplegar con la plantilla nueva. Úsalo cuando creas que alguien tiene tus claves o si perdiste la plantilla. Para actualizar el agente no hace falta: basta con cambiar la versión de la imagen (Actualizar el agente).
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. El contenedor que corre en tu equipo no se borra desde BolloPrint: detenlo y elimínalo tú (docker compose down en su carpeta, o borra el stack en Portainer).
Cuando algo no va
Cuando el agente no aparece o se porta raro, lo primero es mirar su registro en el equipo donde corre:
docker logs bolloprint_agent --tail 50
| Síntoma | Qué mirar |
|---|---|
| El agente no aparece nunca | ¿Se pegó bien el código, entero y sin espacios delante o detrás? ¿El equipo llega a internet? ¿Hay un cortafuegos bloqueando la salida? |
| Pide autorización en cada reinicio | La plantilla no lleva BP_AGENT_INSTANCE_ID (es de antes o se editó a mano). Regenera las claves y despliega la plantilla nueva tal cual. |
| 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. |
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, PrusaLink y las Elegoo que van por SDCP: las de resina y la Centauri Carbon). En las Bambu no, ni por el agente ni por la nube: su firmware ignora las órdenes que no vienen de sus propios programas. 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. En su volumen guarda su propio registro de actividad de los últimos días, que se va borrando solo (y, en agentes desplegados con una plantilla anterior, su fichero de identidad). Ese registro solo sale de tu equipo si soporte de BolloPrint lo pide para investigar un problema.
¿Cuánto consume? Muy poco: entre 10 y 20 MB de memoria con varias impresoras conectadas.
¿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.