Índice del manual

🔌 Impresoras por red local

Por red local, BolloPrint habla con tus impresoras directamente en tu taller, sin pasar por la nube de ningún fabricante. Para eso hace falta un intermediario dentro de tu red: el agente local.

Está en Configuración → Impresoras, pestaña Agente local.

Por qué es la vía recomendada

Funciona con casi todas las marcas. Bambu Lab, Prusa, Elegoo, FlashForge, y las que llevan Klipper por dentro (QIDI, Sovol, Voron, RatRig, Creality K1 con Moonraker accesible…). El detalle por modelo, en Impresoras compatibles.
Puedes dar órdenes: pausar, reanudar y cancelar la impresión en curso, en las máquinas que lo permiten (las Bambu, no).
Tienes cámara: una foto del interior cada pocos minutos mientras imprime, y otra al momento cuando la pides desde la ficha de la impresora.
No depende del fabricante. Ni de que su nube funcione, ni de que mantenga su servicio abierto.
Aguanta los cortes de internet. Si tu conexión se cae, el agente sigue leyendo las impresoras y guarda lo que pasa; cuando vuelve la línea, lo envía todo. No pierdes el historial de esas horas.

El agente no abre tu red a nadie. Es él quien nos llama a nosotros, así que no hay que abrir puertos en el router, ni tener IP fija, ni configurar nada en el firewall. Funciona igual detrás de un router doméstico normal.

Los tres pasos

Crear el agente en BolloPrint y copiar su plantilla de despliegue, que ya lleva el código dentro.
Desplegarlo en un equipo del taller que esté siempre encendido.
Dar de alta las impresoras que va a gestionar.

El paso 2 está detallado en Desplegar el agente. Aquí seguimos con el 3.

Añadir impresoras

Las que aparecen solas

El agente busca impresoras en tu red y las que encuentra salen en la pestaña Agente local, al final de Impresoras por red local, en Detectadas en la red (con varios agentes, «Detectadas por» y el nombre de cada uno), con su marca y su modelo. Pulsa Añadir y ya está. Si no es tuya o no la quieres, Ignorar. Cuando hay alguna, también lo verás en un aviso encima de las pestañas.

Si es una impresora que ya tienes por Bambu Cloud, lo dice («Es «P1S-02», que ya tienes por Bambu Cloud») y el botón es Conectar también por LAN: no crea una impresora nueva, le suma la vía local a la que ya tienes.

Algunas te pedirán un código de acceso antes de conectarse; la propia fila te avisa de si va a hacerlo.

También puede aparecer una impresora marcada como Próximamente: sabemos qué es, pero todavía no podemos conectarla. Si es una que necesitas, dínoslo — nos ayuda a decidir el orden.

Las que hay que añadir a mano

Si la impresora no aparece, pulsa Añadir por IP en Impresoras por red local, en la pestaña Agente local. Si tienes más de un agente, te pregunta cuál la va a conducir. Que no aparezca es normal en dos casos: cuando el agente está en otra red que las impresoras, y cuando corre sobre Docker Desktop. En ninguno de los dos pierdes nada: añadida a mano funciona exactamente igual, con cámara y con mandos si esa máquina los tiene.

Protocolo: el tipo de impresora. La lista solo ofrece los que podemos conectar.
Dirección: la IP de la impresora. Si usa un puerto distinto del habitual, escríbelo detrás: 192.168.1.50:5000.
Nombre (opcional): el que quieras darle tú.
Modelo: por ejemplo «Saturn 4 Ultra» o «MK4S». Rellénalo: con él sabemos si la máquina es de filamento o de resina y le damos la ficha que le toca.
La contraseña de la impresora, si esa familia la pide. El nombre del campo cambia según el protocolo (ver la tabla).

El campo de la contraseña se llama como la llama cada marca, y debajo te dice dónde encontrarla en la impresora. Esto es lo que tienes que poner:

Protocolo	Qué escribir
Bambu Lab	Aparece como Código de acceso LAN. Es el que muestra la impresora en Ajustes → Red → Código de acceso, con el Modo LAN activado.
PrusaLink	Aparece como Contraseña de PrusaLink. La genera la impresora y la muestra en Ajustes → Red → PrusaLink. No es la de Prusa Connect.
FlashForge	Aparece como Código de verificación. Es el que aparece en el menú de red de la pantalla de la impresora, con LAN Only activado.
Elegoo (MQTT local) — Centauri Carbon 2	Aparece como Código de acceso (opcional). Déjalo vacío salvo que le hayas puesto un código en la pantalla de la máquina (Ajustes → Red); en ese caso, escribe ese código.
Klipper	Aparece como Clave de API (opcional). Solo si configuraste una clave de acceso en tu Klipper (Moonraker). Si la impresora rechazó la conexión sin clave, el campo pasa a ser Clave de API de Moonraker y es obligatorio: la tienes en Mainsail o Fluidd, en Ajustes → API key.
SDCP	No pide nada.

El agente averigua solo el número de serie. No hace falta que lo teclees.

💡 Reserva la IP en tu router

Si el router le cambia la dirección a la impresora, la volvemos a buscar en tu red sola, pero estará caída un rato. Reservarle la IP por MAC —o ponerle IP fija— evita el hueco.

Editar o quitar una impresora

En Impresoras por red local, en la pestaña Agente local, cada impresora dice qué agente la conduce, y en su menú ⋮ tienes:

Editar: cambiar el nombre, la dirección, el código de acceso o el agente que la gestiona. También llegas aquí desde la pestaña Impresoras, con Editar conexión local en el menú de la máquina.
Desconectar: la impresora deja de estar conectada por este agente.

Para que deje de contar para tu plan sin quitarla, apágala con su interruptor en la pestaña Impresoras.

Sobre Desconectar: Si tenía otra vía (por ejemplo, la nube de Bambu), sigue por esa. Si era su única vía, queda «Sin conexión» y sigue contando para tu plan hasta que la desactives o la borres. No se pierde nada: conserva su número y su historial, y si la reconectas vuelve tal cual, aunque haya cambiado de IP o de código.

Qué significa cada estado

Estado	Qué está pasando
En línea	Todo bien: el agente la ve y recibe sus datos.
Conectada pero sin enviar datos	El agente ha conectado y la impresora no le cuenta nada. Suele ser que la máquina admite pocas conexiones a la vez y ya tiene otra abierta (la app del móvil, el laminador).
No responde en esa dirección	Comprueba que está encendida y en la misma red que el agente.
Responde pero rechaza la conexión	Casi siempre el código de acceso equivocado, o el modo LAN desactivado en la impresora.
Todas las de un agente, desconectadas a la vez	El problema no es de las impresoras: es su agente, que no responde. Las máquinas pueden estar perfectamente. En la pestaña Agente local, ábrelo con Editar y mira su Estado.

Sigue por aquí

🧩 El agente local — cómo se instala (Desplegar el agente), cómo se actualiza (Actualizar el agente), cómo se conecta, cuándo conviene tener más de uno y qué hacer cuando algo falla.
🔗 Tipos de conexión — qué se puede hacer con cada familia.
🖨️ Impresoras compatibles — si la tuya se puede conectar, y cómo.