📦 Agente en QNAP

Cómo poner el agente local en un NAS de QNAP sin Docker, como una aplicación más del App Center. Si prefieres usar Container Station (Docker), sigue Agente en Docker: funciona igual de bien.

---

Antes de empezar

• Un NAS de QNAP con QTS 4.5 o posterior, siempre encendido y en la misma red que las impresoras.
• Una cuenta de administrador de QTS: hace falta para instalar y para abrir la página del agente.
• Ser el dueño del taller en BolloPrint. Solo el dueño puede añadir agentes.
• Saber qué procesador tiene tu QNAP. Lo ves en la ficha de tu modelo en la web de QNAP, o en QTS, en Panel de control → Sistema → Estado del sistema.

Procesador de tu QNAP	Descarga
Intel o AMD (la mayoría de modelos)	Intel o AMD (64 bits)
ARM de 64 bits (por ejemplo, series TS-x33, TS-x28A, TS-x32X)	ARM (64 bits)
ARM de 32 bits (por ejemplo, series TS-x31P, TS-x31X)	ARM (32 bits)

El agente es ligero: no necesita un equipo potente.

---

Descargarlo

1. En BolloPrint, ve a Configuración → Impresoras y abre la pestaña Agente local.
2. Pulsa Nuevo agente y elige la tarjeta QNAP.
3. Descarga el paquete del procesador de tu QNAP. Es un fichero que termina en .qpkg.

Ahí mismo tienes los pasos resumidos. Aquí no se crea nada todavía: el agente aparecerá en tu lista cuando lo vincules.

---

Instalarlo en el QNAP

Como el agente aún no está en la tienda de QNAP, se instala a mano. Son cinco pasos:

1. Entra en QTS con tu cuenta de administrador y abre el App Center.
2. Abre sus opciones (el icono ⚙ arriba a la derecha) y activa Permitir la instalación de aplicaciones sin una firma digital válida. Guarda.
3. Pulsa el icono de instalación manual: unas cajitas con un +, arriba a la derecha, justo a la izquierda del ⚙. No tiene texto; al pasar el ratón por encima pone Instalar. Elige el fichero .qpkg que has descargado y pulsa Instalar.
4. QTS te avisa de que la aplicación no tiene firma digital. Acéptalo: es lo esperado mientras el agente no esté publicado en la tienda de QNAP.
5. Cuando termine, BolloPrint Agent aparece entre tus aplicaciones. Pulsa Abrir.

Si prefieres no dejar activada la opción del paso 2, puedes desactivarla en cuanto termine la instalación. Tendrás que volver a activarla para la próxima actualización.

---

Vincularlo con tu taller

Al pulsar Abrir, QTS te lleva a la página del agente. Esa página solo la ve un administrador de QTS con la sesión iniciada; a cualquier otra persona le pide que entre en QTS.

1. La página dice que el agente todavía no pertenece a ningún taller y enseña un código corto. Pulsa Vincular con BolloPrint.
2. Se abre BolloPrint. Si no tenías la sesión iniciada, entra con tu cuenta.
3. Si eres dueño de más de un taller, elige a cuál lo añades. Solo salen los talleres de los que eres dueño.
4. Comprueba que el código que enseña BolloPrint es el mismo que el de la página del agente y pulsa Añadir al taller.
5. Vuelves a la página del agente, que ahora dice Vinculado a y el nombre de tu taller.

En menos de un minuto lo verás En línea en Configuración → Impresoras → Agente local, con el logo de QNAP. A partir de ahí, todo es igual que con cualquier agente: las impresoras de tu red aparecen solas para que las añadas, o las añades por su IP. Lo cuenta El agente 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 ya tienes:

1. Descarga la versión nueva desde Configuración → Impresoras → Agente local → Nuevo agente → QNAP, la del mismo procesador.
2. En el App Center, comprueba que sigue activada la opción Permitir la instalación de aplicaciones sin una firma digital válida.
3. Pulsa el icono de instalación manual (las cajitas con un +, junto al ⚙), elige el fichero nuevo, pulsa Instalar y acepta el aviso de la firma.

QTS sustituye el programa y deja intactos sus datos: el agente sigue vinculado a tu taller, con sus impresoras y su historial. No hay que volver a vincularlo. Si después de actualizar su página te ofreciera Vincular con BolloPrint otra vez, vincúlalo y elimina en BolloPrint el agente antiguo, que se habrá quedado desconectado.

---

Moverlo, reinstalarlo o quitarlo

Reinstalarlo o moverlo a otro NAS es vincular uno nuevo: instálalo en el equipo nuevo y vincúlalo como la primera vez. Será un agente nuevo en tu lista. Las impresoras pasan a él, con todo su historial, en cuanto las añadas. Después elimina el antiguo desde el menú ⋮ de su fila.

Para quitarlo del todo:

1. En BolloPrint, elimina el agente desde el menú ⋮ de su fila en Configuración → Impresoras → Agente local. Deja de conectarse al momento, y las impresoras que solo llegaban por él desaparecen de la lista (si las vuelves a añadir, vuelven con su historial).
2. En el App Center de QTS, abre BolloPrint Agent y pulsa Eliminar. Se borra con sus datos.

Si haces solo el paso 1, el agente se queda instalado y sin taller: su página vuelve a ofrecer Vincular con BolloPrint en unos segundos.

---

Cuando algo no va

Síntoma	Qué mirar
QTS no deja instalar el fichero	¿Está activada Permitir la instalación de aplicaciones sin una firma digital válida? Si dice que no es compatible, has bajado el paquete de otro procesador: vuelve a descargar el que toca. Si tu QTS es anterior a la 4.5, actualízalo primero.
Al pulsar Abrir pide que inicies sesión en QTS	La página del agente solo se abre a un administrador. Entra en QTS con una cuenta de administrador y vuelve a pulsar Abrir desde el App Center.
Abrir da error o una página en blanco	Comprueba en el App Center que BolloPrint Agent está en marcha y, si no, arráncalo. Si sigue igual, mira el registro del sistema de QTS (en QTS 5, QuLog Center) y busca «BolloPrint Agent»: si dice que su puerto está ocupado, otra aplicación usa el 8257 y el 8364. Escríbenos y te ayudamos a cambiarlo.
Al vincular dice que no ha podido hablar con BolloPrint	El QNAP necesita salida a internet. Comprueba su conexión y su DNS en Panel de control → Red.
BolloPrint dice que no eres dueño de ningún taller	Solo el dueño del taller puede añadir agentes. Pídele que lo vincule él.
El agente no sale En línea	Espera un minuto. Si no aparece, mira en el App Center que está en marcha y que el QNAP llega a internet.
No detecta ninguna impresora	¿Están el QNAP y las impresoras en la misma red? Si no lo están (VLAN, red de invitados), añádelas a mano por su IP y funcionarán igual. Si están en la misma red y aun así no salen, añádelas por IP y cuéntanoslo: nos ayuda a mejorar la beta.

No hay que abrir puertos en el router ni en el cortafuegos del QNAP: la conexión con BolloPrint sale de tu red hacia fuera, y la página del agente pasa por el propio QTS.