🗄️ Agente en Synology

Si tienes un Synology en el taller, ya tienes dónde poner el agente local: está encendido todo el día y en la misma red que tus impresoras. El agente se instala como cualquier otra aplicación de DSM y aparece en su menú principal.

Esta página explica cómo instalarlo, vincularlo con tu taller, actualizarlo, moverlo y quitarlo. Qué es el agente y qué impresoras conecta lo tienes en El agente local.

---

Antes de empezar

Qué necesitas	Cómo lo compruebas
DSM 7 o posterior	En DSM, Panel de control → Centro de información. Con DSM 6 no funciona.
Saber qué procesador tiene tu NAS	En el mismo Centro de información sale el modelo de CPU. Intel o AMD son 64 bits; si es ARM, la ficha de tu modelo en la web de Synology dice si es de 64 o de 32 bits.
Entrar en DSM con un usuario administrador	Solo los administradores pueden instalar paquetes y abrir la página del agente.
Ser dueño del taller en BolloPrint	Al vincularlo solo salen los talleres de los que eres dueño.
Que el NAS y las impresoras estén en la misma red	Si están en redes separadas el agente funciona igual, pero tendrás que añadir las impresoras por su IP.
Que el NAS salga a internet	Nada más: no hay que abrir puertos ni tener IP fija.

---

1. Descarga el paquete

En BolloPrint, ve a Configuración → Impresoras → Agente local → Nuevo agente y elige Synology.

Verás un botón de descarga por cada tipo de procesador: Intel o AMD (64 bits), ARM (64 bits) y ARM (32 bits). Pulsa el de tu NAS. Se descarga un fichero que acaba en .spk: es el paquete de DSM.

En esa misma pantalla no hay que crear nada ni copiar ningún código. El agente nace cuando lo vinculas, en el paso 3.

---

2. Instálalo en DSM

1. Entra en DSM y abre el Centro de paquetes.
2. Arriba a la derecha, pulsa Instalación manual.
3. Pulsa Examinar, elige el fichero .spk que acabas de descargar y pulsa Siguiente.
4. DSM te avisa de que el paquete no lo publica Synology. Acéptalo para seguir.
5. El asistente te enseña el puerto de la página del agente, con 8257 ya puesto. Déjalo así salvo que DSM te diga que está ocupado; entonces pon 8364.
6. Pulsa Siguiente y, en el resumen, Hecho.

En un minuto el paquete aparece como En ejecución y BolloPrint Agent se añade al menú principal de DSM.

---

3. Vincúlalo con tu taller

1. En DSM, abre el menú principal (el icono de arriba a la izquierda) y pulsa BolloPrint Agent. Se abre en una pestaña nueva.
2. La página dice «Este agente todavía no pertenece a ningún taller» y enseña un código de ocho caracteres, como 6E7B-9DEF. Pulsa Vincular con BolloPrint.
3. Se abre BolloPrint. Si no tienes la sesión iniciada, inicia sesión. Elige el taller al que lo añades.
4. BolloPrint te enseña el equipo (el nombre de tu NAS y «Synology») y el código. Comprueba que es el mismo que salía en la página del agente y pulsa Añadir al taller.
5. Vuelves a la página del agente, que ahora dice Vinculado a tu taller.

Ya está. En Configuración → Impresoras → Agente local verás el agente con el nombre de tu NAS y el logo de Synology, En línea.

---

4. Dale las impresoras

El agente empieza a buscar impresoras en tu red en cuanto se vincula. Lo que encuentra aparece en Impresoras por red local, debajo de la lista de agentes, y desde ahí las das de alta. Las que no aparezcan solas, con Añadir por IP.

Cómo hacerlo con cada marca está en Impresoras por red local.

---

Actualizarlo

Casi nunca tienes que hacer nada: el agente se actualiza solo. Cuando sale una versión nueva, la descarga, comprueba que es nuestra y se reinicia con ella.

Solo si BolloPrint te avisa de que tu agente necesita una actualización manual, es instalar el paquete nuevo encima del que tienes:

1. Descarga el paquete nuevo desde la misma pantalla de BolloPrint (Agente local → Nuevo agente → Synology), el de tu procesador.
2. En el Centro de paquetes, Instalación manual, elige el fichero y sigue. DSM ve que ya está instalado y lo actualiza: no vuelve a preguntar el puerto.

El agente sigue vinculado al mismo taller, con las mismas impresoras y su historial. No hay que vincular nada otra vez.

Cuando el paquete esté en el catálogo de Synology, el Centro de paquetes te avisará él mismo y bastará con pulsar Actualizar.

---

Moverlo a otro NAS o reinstalarlo

Un agente nuevo es un agente nuevo: no hay forma de «trasladar» uno. Lo que se mueve son las impresoras, y se mueven con todo su historial.

1. Instala el paquete en el NAS nuevo y vincúlalo (pasos 1 a 3). Aparecerá como un segundo agente.
2. En Configuración → Impresoras, abre cada impresora con Editar en su menú ⋮ y cámbiala al agente nuevo en el desplegable.
3. Cuando el antiguo ya no tenga impresoras, elimínalo desde el menú ⋮ de su fila.

Si reinstalas en el mismo NAS, el orden es el mismo: primero vincula el nuevo y pásale las impresoras, y luego elimina el antiguo.

---

Desinstalarlo

1. En DSM, abre el Centro de paquetes, entra en BolloPrint Agent y pulsa Acción → Desinstalar. Se borran el paquete y todo lo que guardaba, también su identidad.
2. En BolloPrint, Configuración → Impresoras → Agente local, elimina el agente desde el menú ⋮ de su fila.

Al eliminarlo, las impresoras que solo llegaban por ese agente salen de la lista y dejan de contar para tu plan. No se pierde nada: si vuelves a añadir una, vuelve con su número y su historial.

---

Cuando algo no va

Lo primero es mirar si el paquete está En ejecución en el Centro de paquetes. Desde su ficha también puedes ver su registro: Acción → Ver registro.

Lo que ves	Qué hacer
El asistente dice que el puerto 8257 está ocupado	Otra aplicación del NAS lo usa. Pon 8364 y sigue.
DSM dice que el paquete no es compatible con tu modelo	Has bajado el de otro procesador. Descarga el que toca.
Al abrir BolloPrint Agent pide iniciar sesión en DSM	Ábrelo desde el menú de DSM con la sesión iniciada, y con un usuario administrador. Si persiste, cierra esa pestaña y vuelve a abrirlo desde el menú.
La página dice que el agente no responde	El paquete está parado o arrancando. En el Centro de paquetes, abre BolloPrint Agent, pulsa Acción → Ejecutar y espera unos segundos.
Al vincular no sale tu taller	Solo salen los talleres de los que eres dueño. Pide al dueño que lo vincule él.
«Este enlace de vinculación no es válido» o ha caducado	Vuelve a la página del agente y pulsa otra vez Vincular con BolloPrint.
Después de reiniciar el NAS el agente tarda en salir En línea	Espera unos minutos: arranca con DSM y reintenta solo hasta que el NAS tiene internet.
No encuentra ninguna impresora	¿Están el NAS y las impresoras en la misma red? Si no, añádelas por IP. Si acabas de encender una, pulsa Buscar ahora. Si tienes el cortafuegos de DSM activado, permite los puertos de BolloPrint Agent (sale en la lista de aplicaciones al crear una regla).
El agente sale Sin señal reciente	El NAS está apagado, sin internet o el paquete está parado.

---

Preguntas frecuentes

¿Necesito Docker o Container Manager? No. El paquete no usa contenedores. Si prefieres el agente en un contenedor, también se puede: está en Agente en Docker.

¿Tengo que abrir puertos en el router? No. El agente llama a BolloPrint hacia fuera, como cuando abres una página web. El puerto 8257 es solo para su página dentro del propio NAS: no se abre a tu red.

¿Quién puede abrir la página del agente? Solo los administradores de DSM, desde su menú principal. Quien solo comparte tu red no puede abrirla.

¿Puedo cambiar el puerto después? El asistente solo lo pregunta al instalar. Para cambiarlo hay que desinstalar e instalar de nuevo, y eso es un agente nuevo (mira «Moverlo a otro NAS o reinstalarlo», más arriba).

¿Y si apago o reinicio el NAS? No pasa nada. El agente arranca solo con DSM y vuelve a conectarse sin pedirte nada.