🗄️ Agente no Synology

Se tens um Synology na oficina, já tens onde pôr o agente local: está ligado o dia todo e na mesma rede que as tuas impressoras. O agente instala-se como qualquer outra aplicação do DSM e aparece no seu menu principal.

Esta página explica como o instalar, ligá-lo à tua oficina, atualizá-lo, mudá-lo de sítio e removê-lo. O que é o agente e que impressoras liga está em O agente local.

---

Antes de começar

O que precisas	Como o confirmas
DSM 7 ou posterior	No DSM, Painel de controlo → Centro de informações. Com o DSM 6 não funciona.
Saber que processador tem o teu NAS	No mesmo Centro de informações aparece o modelo do CPU. Intel ou AMD são 64 bits; se for ARM, a ficha do teu modelo no site da Synology diz se é de 64 ou de 32 bits.
Entrar no DSM com um utilizador administrador	Só os administradores podem instalar pacotes e abrir a página do agente.
Ser dono da oficina no BolloPrint	Ao ligá-lo só aparecem as oficinas de que és dono.
Que o NAS e as impressoras estejam na mesma rede	Se estiverem em redes separadas, o agente funciona na mesma, mas terás de adicionar as impressoras pelo seu IP.
Que o NAS tenha acesso à internet	Mais nada: não é preciso abrir portas nem ter IP fixo.

---

1. Descarrega o pacote

No BolloPrint, vai a Configurações → Impressoras → Agente local → Novo agente e escolhe Synology.

Vais ver um botão de descarga por cada tipo de processador: Intel ou AMD (64 bits), ARM (64 bits) e ARM (32 bits). Prime o do teu NAS. É descarregado um ficheiro que termina em .spk: é o pacote do DSM.

Nesse mesmo ecrã não tens de criar nada nem copiar nenhum código. O agente nasce quando o ligas, no passo 3.

---

2. Instala-o no DSM

1. Entra no DSM e abre o Centro de pacotes.
2. Em cima, à direita, prime Instalação manual.
3. Prime Procurar, escolhe o ficheiro .spk que acabaste de descarregar e prime Seguinte.
4. O DSM avisa-te de que o pacote não é publicado pela Synology. Aceita para continuar.
5. O assistente mostra-te a porta da página do agente, já com 8257. Deixa-a assim, a não ser que o DSM te diga que está ocupada; nesse caso, põe 8364.
6. Prime Seguinte e, no resumo, Concluído.

Num minuto o pacote aparece como Em execução e o BolloPrint Agent é adicionado ao menu principal do DSM.

---

3. Liga-o à tua oficina

1. No DSM, abre o menu principal (o ícone em cima, à esquerda) e prime BolloPrint Agent. Abre-se num separador novo.
2. A página diz «Este agente ainda não pertence a nenhuma oficina» e mostra um código de oito caracteres, como 6E7B-9DEF. Prime Ligar ao BolloPrint.
3. Abre-se o BolloPrint. Se não tiveres a sessão iniciada, inicia sessão. Escolhe a oficina à qual o adicionas.
4. O BolloPrint mostra-te o equipamento (o nome do teu NAS e «Synology») e o código. Confirma que é o mesmo que aparecia na página do agente e prime Adicionar à oficina.
5. Voltas à página do agente, que agora diz Ligado a e o nome da tua oficina.

Já está. Em Configurações → Impressoras → Agente local vais ver o agente com o nome do teu NAS e o logótipo da Synology, Online.

---

4. Dá-lhe as impressoras

O agente começa a procurar impressoras na tua rede assim que fica ligado. O que encontra aparece em Impressoras na rede local, por baixo da lista de agentes, e é daí que as registas. As que não aparecerem sozinhas, com Adicionar por IP.

Como fazê-lo com cada marca está em Impressoras por rede local.

---

Atualizá-lo

Quase nunca tens de fazer nada: o agente atualiza-se sozinho. Quando sai uma versão nova, descarrega-a, confirma que é nossa e reinicia com ela.

Só se o BolloPrint te avisar de que o teu agente precisa de uma atualização manual, é instalar o pacote novo por cima do que já tens:

1. Descarrega o pacote novo a partir do mesmo ecrã do BolloPrint (Agente local → Novo agente → Synology), o do teu processador.
2. No Centro de pacotes, Instalação manual, escolhe o ficheiro e continua. O DSM vê que já está instalado e atualiza-o: não volta a perguntar a porta.

O agente continua ligado à mesma oficina, com as mesmas impressoras e o seu histórico. Não é preciso ligar nada outra vez.

Quando o pacote estiver no catálogo da Synology, o próprio Centro de pacotes te avisará e bastará premir Atualizar.

---

Mudá-lo para outro NAS ou reinstalá-lo

Um agente novo é um agente novo: não há forma de «transferir» um. O que muda de sítio são as impressoras, e mudam com todo o seu histórico.

1. Instala o pacote no NAS novo e liga-o (passos 1 a 3). Vai aparecer como um segundo agente.
2. Em Configurações → Impressoras, abre cada impressora com Editar no seu menu ⋮ e muda-a para o agente novo na lista pendente.
3. Quando o antigo já não tiver impressoras, elimina-o a partir do menu ⋮ da sua linha.

Se reinstalares no mesmo NAS, a ordem é a mesma: primeiro liga o novo e passa-lhe as impressoras, e depois elimina o antigo.

---

Desinstalá-lo

1. No DSM, abre o Centro de pacotes, entra em BolloPrint Agent e prime Ação → Desinstalar. São apagados o pacote e tudo o que guardava, incluindo a sua identidade.
2. No BolloPrint, em Configurações → Impressoras → Agente local, elimina o agente a partir do menu ⋮ da sua linha.

Ao eliminá-lo, as impressoras que só chegavam por esse agente saem da lista e deixam de contar para o teu plano. Não se perde nada: se voltares a adicionar uma, ela volta com o seu número e o seu histórico.

---

Quando alguma coisa não vai

A primeira coisa é ver se o pacote está Em execução no Centro de pacotes. A partir da sua ficha também podes ver o seu registo: Ação → Ver registo.

O que vês	O que fazer
O assistente diz que a porta 8257 está ocupada	Outra aplicação do NAS usa-a. Põe 8364 e continua.
O DSM diz que o pacote não é compatível com o teu modelo	Descarregaste o de outro processador. Descarrega o certo.
Ao abrir o BolloPrint Agent pede para iniciar sessão no DSM	Abre-o a partir do menu do DSM com a sessão iniciada, e com um utilizador administrador. Se continuar, fecha esse separador e volta a abri-lo a partir do menu.
A página diz que o agente não responde	O pacote está parado ou a arrancar. No Centro de pacotes, abre o BolloPrint Agent, prime Ação → Executar e espera uns segundos.
Ao ligar não aparece a tua oficina	Só aparecem as oficinas de que és dono. Pede ao dono que seja ele a ligá-lo.
«Este pedido de ligação não é válido» ou expirou	Volta à página do agente e prime outra vez Ligar ao BolloPrint.
Depois de reiniciar o NAS o agente demora a aparecer Online	Espera uns minutos: arranca com o DSM e volta a tentar sozinho até o NAS ter internet.
Não encontra nenhuma impressora	O NAS e as impressoras estão na mesma rede? Se não estiverem, adiciona-as por IP. Se acabaste de ligar uma, prime Procurar agora. Se tens a firewall do DSM ativada, permite as portas do BolloPrint Agent (aparece na lista de aplicações ao criar uma regra).
O agente aparece como Sem sinal recente	O NAS está desligado, sem internet ou o pacote está parado.

---

Perguntas frequentes

Preciso de Docker ou do Container Manager? Não. O pacote não usa contentores. Se preferires o agente num contentor, também é possível: está em Agente no Docker.

Tenho de abrir portas no router? Não. O agente liga ao BolloPrint de dentro para fora, como quando abres uma página web. A porta 8257 é só para a sua página dentro do próprio NAS: não fica aberta à tua rede.

Quem pode abrir a página do agente? Só os administradores do DSM, a partir do seu menu principal. Quem apenas partilha a tua rede não a consegue abrir.

Posso mudar a porta depois? O assistente só a pergunta ao instalar. Para a mudar é preciso desinstalar e instalar de novo, e isso é um agente novo (vê «Mudá-lo para outro NAS ou reinstalá-lo», mais acima).

E se desligar ou reiniciar o NAS? Não acontece nada. O agente arranca sozinho com o DSM e volta a ligar-se sem te pedir nada.