🗄️ Agent sur Synology

Si vous avez un Synology dans votre atelier, vous avez déjà où mettre l'agent local : il est allumé toute la journée et sur le même réseau que vos imprimantes. L'agent s'installe comme n'importe quelle autre application de DSM et apparaît dans son menu principal.

Cette page explique comment l'installer, l'associer à votre atelier, le mettre à jour, le déplacer et le retirer. Ce qu'est l'agent et quelles imprimantes il connecte, vous le trouverez dans L'agent local.

---

Avant de commencer

Ce qu'il vous faut	Comment le vérifier
DSM 7 ou ultérieur	Dans DSM, Panneau de configuration → Centre d'infos. Avec DSM 6, cela ne fonctionne pas.
Savoir quel processeur a votre NAS	Le même Centre d'infos indique le modèle de CPU. Intel ou AMD sont en 64 bits ; si c'est un ARM, la fiche de votre modèle sur le site de Synology précise s'il est en 64 ou en 32 bits.
Vous connecter à DSM avec un compte administrateur	Seuls les administrateurs peuvent installer des paquets et ouvrir la page de l'agent.
Être propriétaire de l'atelier dans BolloPrint	Au moment de l'association, seuls les ateliers dont vous êtes propriétaire apparaissent.
Que le NAS et les imprimantes soient sur le même réseau	S'ils sont sur des réseaux séparés, l'agent fonctionne quand même, mais vous devrez ajouter les imprimantes par leur IP.
Que le NAS accède à internet	Rien de plus : aucun port à ouvrir ni IP fixe nécessaire.

---

1. Téléchargez le paquet

Dans BolloPrint, allez dans Paramètres → Imprimantes → Agent local → Nouvel agent et choisissez Synology.

Vous verrez un bouton de téléchargement par type de processeur : Intel ou AMD (64 bits), ARM (64 bits) et ARM (32 bits). Appuyez sur celui de votre NAS. Un fichier qui se termine par .spk se télécharge : c'est le paquet DSM.

Sur ce même écran, il n'y a rien à créer ni aucun code à copier. L'agent naît au moment où vous l'associez, à l'étape 3.

---

2. Installez-le dans DSM

1. Connectez-vous à DSM et ouvrez le Centre de paquets.
2. En haut à droite, appuyez sur Installation manuelle.
3. Appuyez sur Parcourir, choisissez le fichier .spk que vous venez de télécharger et appuyez sur Suivant.
4. DSM vous prévient que le paquet n'est pas publié par Synology. Acceptez pour continuer.
5. L'assistant vous montre le port de la page de l'agent, avec 8257 déjà indiqué. Laissez-le tel quel, sauf si DSM vous dit qu'il est déjà utilisé ; dans ce cas, indiquez 8364.
6. Appuyez sur Suivant puis, dans le récapitulatif, sur Terminé.

En une minute, le paquet apparaît En cours d'exécution et BolloPrint Agent s'ajoute au menu principal de DSM.

---

3. Associez-le à votre atelier

1. Dans DSM, ouvrez le menu principal (l'icône en haut à gauche) et appuyez sur BolloPrint Agent. Il s'ouvre dans un nouvel onglet.
2. La page indique « Cet agent n'appartient encore à aucun atelier » et affiche un code de huit caractères, comme 6E7B-9DEF. Appuyez sur Associer à BolloPrint.
3. BolloPrint s'ouvre. Si vous n'êtes pas connecté, connectez-vous. Choisissez l'atelier auquel vous l'ajoutez.
4. BolloPrint vous montre l'appareil (le nom de votre NAS et « Synology ») et le code. Vérifiez que c'est le même que celui de la page de l'agent et appuyez sur Ajouter à l'atelier.
5. Vous revenez à la page de l'agent, qui indique maintenant Associé à votre atelier.

C'est fait. Dans Paramètres → Imprimantes → Agent local, vous verrez l'agent avec le nom de votre NAS et le logo de Synology, En ligne.

---

4. Confiez-lui les imprimantes

L'agent commence à chercher des imprimantes sur votre réseau dès qu'il est associé. Ce qu'il trouve apparaît dans Imprimantes sur le réseau local, sous la liste des agents, et c'est de là que vous les ajoutez. Celles qui n'apparaissent pas toutes seules, ajoutez-les avec Ajouter par IP.

La marche à suivre pour chaque marque se trouve dans Imprimantes en réseau local.

---

Le mettre à jour

Vous n'avez presque jamais rien à faire : l'agent se met à jour tout seul. Quand une nouvelle version sort, il la télécharge, vérifie qu'elle vient bien de nous et redémarre avec elle.

Ce n'est que si BolloPrint vous avertit que votre agent a besoin d'une mise à jour manuelle que vous devez le faire vous-même, en installant le nouveau paquet par-dessus celui que vous avez :

1. Téléchargez le nouveau paquet depuis le même écran de BolloPrint (Agent local → Nouvel agent → Synology), celui de votre processeur.
2. Dans le Centre de paquets, Installation manuelle, choisissez le fichier et continuez. DSM voit qu'il est déjà installé et le met à jour : il ne redemande pas le port.

L'agent reste associé au même atelier, avec les mêmes imprimantes et leur historique. Il n'y a rien à associer de nouveau.

Quand le paquet sera dans le catalogue de Synology, le Centre de paquets vous préviendra lui-même et il suffira d'appuyer sur Mettre à jour.

---

Le déplacer vers un autre NAS ou le réinstaller

Un nouvel agent est un nouvel agent : il n'y a aucun moyen d'en « transférer » un. Ce qui se déplace, ce sont les imprimantes, et elles se déplacent avec tout leur historique.

1. Installez le paquet sur le nouveau NAS et associez-le (étapes 1 à 3). Il apparaîtra comme un deuxième agent.
2. Dans Paramètres → Imprimantes, ouvrez chaque imprimante avec Modifier dans son menu ⋮ et passez-la au nouvel agent dans le menu déroulant.
3. Quand l'ancien n'a plus d'imprimantes, supprimez-le depuis le menu ⋮ de sa ligne.

Si vous réinstallez sur le même NAS, l'ordre est le même : associez d'abord le nouveau et passez-lui les imprimantes, puis supprimez l'ancien.

---

Le désinstaller

1. Dans DSM, ouvrez le Centre de paquets, entrez dans BolloPrint Agent et appuyez sur Action → Désinstaller. Le paquet et tout ce qu'il conservait sont effacés, y compris son identité.
2. Dans BolloPrint, Paramètres → Imprimantes → Agent local, supprimez l'agent depuis le menu ⋮ de sa ligne.

En le supprimant, les imprimantes qui n'arrivaient que par cet agent disparaissent de la liste et ne comptent plus pour votre forfait. Rien n'est perdu : si vous en ajoutez une à nouveau, elle revient avec son numéro et son historique.

---

Quand quelque chose cloche

Commencez par vérifier que le paquet est En cours d'exécution dans le Centre de paquets. Depuis sa fiche, vous pouvez aussi consulter son journal : Action → Afficher le journal.

Ce que vous voyez	Que faire
L'assistant indique que le port 8257 est déjà utilisé	Une autre application du NAS l'utilise. Indiquez 8364 et continuez.
DSM indique que le paquet n'est pas compatible avec votre modèle	Vous avez téléchargé celui d'un autre processeur. Téléchargez le bon.
À l'ouverture, BolloPrint Agent demande de se connecter à DSM	Ouvrez-le depuis le menu de DSM en étant connecté, avec un compte administrateur. Si cela persiste, fermez cet onglet et rouvrez-le depuis le menu.
La page indique que l'agent ne répond pas	Le paquet est arrêté ou en train de démarrer. Dans le Centre de paquets, ouvrez BolloPrint Agent, appuyez sur Action → Exécuter et attendez quelques secondes.
Au moment de l'association, votre atelier n'apparaît pas	Seuls apparaissent les ateliers dont vous êtes propriétaire. Demandez au propriétaire de l'associer lui-même.
« Cette demande d'association n'est pas valide » ou elle a expiré	Revenez à la page de l'agent et appuyez à nouveau sur Associer à BolloPrint.
Après un redémarrage du NAS, l'agent met du temps à passer En ligne	Attendez quelques minutes : il démarre avec DSM et réessaie tout seul jusqu'à ce que le NAS ait internet.
Il ne trouve aucune imprimante	Le NAS et les imprimantes sont-ils sur le même réseau ? Sinon, ajoutez-les par IP. Si vous venez d'en allumer une, appuyez sur Chercher maintenant. Si le pare-feu de DSM est activé, autorisez les ports de BolloPrint Agent (il figure dans la liste des applications lorsque vous créez une règle).
L'agent affiche Pas de signal récent	Le NAS est éteint, sans internet, ou le paquet est arrêté.

---

Questions fréquentes

Ai-je besoin de Docker ou de Container Manager ? Non. Le paquet n'utilise pas de conteneurs. Si vous préférez l'agent dans un conteneur, c'est aussi possible : c'est expliqué dans Agent sur Docker.

Dois-je ouvrir des ports sur le routeur ? Non. C'est l'agent qui appelle BolloPrint vers l'extérieur, comme lorsque vous ouvrez une page web. Le port 8257 sert uniquement à sa page à l'intérieur du NAS lui-même : il n'est pas ouvert sur votre réseau.

Qui peut ouvrir la page de l'agent ? Seuls les administrateurs de DSM, depuis son menu principal. Quelqu'un qui partage simplement votre réseau ne peut pas l'ouvrir.

Puis-je changer le port plus tard ? L'assistant ne le demande qu'à l'installation. Pour le changer, il faut désinstaller puis réinstaller, et cela donne un nouvel agent (voir « Le déplacer vers un autre NAS ou le réinstaller », plus haut).

Et si j'éteins ou redémarre le NAS ? Rien de grave. L'agent démarre tout seul avec DSM et se reconnecte sans rien vous demander.