🗄️ Agent auf Synology

Wenn du eine Synology in der Werkstatt hast, hast du schon einen Platz für den lokalen Agenten: Sie läuft den ganzen Tag und hängt im selben Netzwerk wie deine Drucker. Der Agent wird wie jede andere DSM-Anwendung installiert und erscheint im Hauptmenü von DSM.

Diese Seite erklärt, wie du ihn installierst, mit deiner Werkstatt verknüpfst, aktualisierst, umziehst und entfernst. Was der Agent ist und welche Drucker er verbindet, steht unter Der lokale Agent.

---

Bevor du anfängst

Was du brauchst	Wie du es prüfst
DSM 7 oder neuer	In DSM unter Systemsteuerung → Infocenter. Mit DSM 6 funktioniert es nicht.
Wissen, welchen Prozessor dein NAS hat	Im selben Infocenter steht das CPU-Modell. Intel oder AMD sind 64 Bit; bei ARM steht auf der Seite deines Modells auf der Synology-Website, ob es 64 oder 32 Bit sind.
Mit einem Administrator-Konto in DSM angemeldet sein	Nur Administratoren können Pakete installieren und die Seite des Agenten öffnen.
Inhaber der Werkstatt in BolloPrint sein	Beim Verknüpfen erscheinen nur die Werkstätten, deren Inhaber du bist.
NAS und Drucker im selben Netzwerk	Sind sie in getrennten Netzwerken, funktioniert der Agent trotzdem, aber du musst die Drucker über ihre IP hinzufügen.
Das NAS kommt ins Internet	Mehr nicht: Du musst keine Ports öffnen und brauchst keine feste IP.

---

1. Lade das Paket herunter

Geh in BolloPrint zu Einstellungen → Drucker → Lokaler Agent → Neuer Agent und wähl Synology.

Du siehst einen Download-Button pro Prozessortyp: Intel oder AMD (64 Bit), ARM (64 Bit) und ARM (32 Bit). Klick auf den für dein NAS. Es wird eine Datei mit der Endung .spk heruntergeladen: das DSM-Paket.

Auf diesem Bildschirm musst du nichts anlegen und keinen Code kopieren. Der Agent entsteht erst, wenn du ihn verknüpfst, in Schritt 3.

---

2. Installiere es in DSM

1. Melde dich in DSM an und öffne das Paket-Zentrum.
2. Klick oben rechts auf Manuelle Installation.
3. Klick auf Durchsuchen, wähl die .spk-Datei aus, die du gerade heruntergeladen hast, und klick auf Weiter.
4. DSM weist dich darauf hin, dass das Paket nicht von Synology veröffentlicht wird. Bestätige das, um weiterzumachen.
5. Der Assistent zeigt dir den Port der Agentenseite, mit 8257 schon eingetragen. Lass ihn so, außer DSM sagt dir, dass er belegt ist; dann trag 8364 ein.
6. Klick auf Weiter und in der Zusammenfassung auf Fertig.

Nach einer Minute steht das Paket auf Läuft, und BolloPrint Agent erscheint im Hauptmenü von DSM.

---

3. Verknüpfe ihn mit deiner Werkstatt

1. Öffne in DSM das Hauptmenü (das Symbol oben links) und klick auf BolloPrint Agent. Er öffnet sich in einem neuen Tab.
2. Auf der Seite steht „Dieser Agent gehört noch zu keiner Werkstatt“, und sie zeigt einen Code mit acht Zeichen, etwa 6E7B-9DEF. Klick auf Mit BolloPrint verknüpfen.
3. BolloPrint öffnet sich. Wenn du nicht angemeldet bist, melde dich an. Wähl die Werkstatt, zu der du ihn hinzufügst.
4. BolloPrint zeigt dir das Gerät (den Namen deines NAS und „Synology“) und den Code. Prüfe, dass er derselbe ist wie auf der Seite des Agenten, und klick auf Zur Werkstatt hinzufügen.
5. Du landest wieder auf der Seite des Agenten, auf der jetzt Verknüpft mit deiner Werkstatt steht.

Das war's. Unter Einstellungen → Drucker → Lokaler Agent siehst du den Agenten mit dem Namen deines NAS und dem Synology-Logo, Online.

---

4. Gib ihm die Drucker

Der Agent beginnt mit der Suche nach Druckern in deinem Netzwerk, sobald er verknüpft ist. Was er findet, erscheint unter Drucker im lokalen Netzwerk, unterhalb der Liste der Agenten, und von dort aus legst du sie an. Die, die nicht von allein auftauchen, fügst du mit Per IP hinzufügen hinzu.

Wie das bei jeder Marke geht, steht unter Drucker über das lokale Netzwerk.

---

Aktualisieren

Du musst fast nie etwas tun: Der Agent aktualisiert sich von allein. Wenn eine neue Version erscheint, lädt er sie herunter, prüft, dass sie von uns ist, und startet mit ihr neu.

Nur wenn dich BolloPrint darauf hinweist, dass dein Agent eine manuelle Aktualisierung braucht, heißt Aktualisieren, das neue Paket über das vorhandene zu installieren:

1. Lade das neue Paket über denselben Bildschirm in BolloPrint herunter (Lokaler Agent → Neuer Agent → Synology), das für deinen Prozessor.
2. Wähl im Paket-Zentrum unter Manuelle Installation die Datei aus und mach weiter. DSM erkennt, dass es schon installiert ist, und aktualisiert es: Nach dem Port fragt es nicht noch einmal.

Der Agent bleibt mit derselben Werkstatt verknüpft, mit denselben Druckern und ihrem Verlauf. Du musst nichts neu verknüpfen.

Sobald das Paket im Synology-Katalog steht, meldet sich das Paket-Zentrum selbst, und es reicht ein Klick auf Aktualisieren.

---

Auf ein anderes NAS umziehen oder neu installieren

Ein neuer Agent ist ein neuer Agent: Einen Agenten „umzuziehen“ geht nicht. Was umzieht, sind die Drucker, und zwar mit ihrem ganzen Verlauf.

1. Installiere das Paket auf dem neuen NAS und verknüpfe den Agenten (Schritte 1 bis 3). Er erscheint als zweiter Agent.
2. Öffne unter Einstellungen → Drucker jeden Drucker mit Bearbeiten in seinem Menü ⋮ und wähl im Auswahlfeld den neuen Agenten.
3. Wenn der alte keine Drucker mehr hat, lösch ihn über das Menü ⋮ seiner Zeile.

Wenn du auf demselben NAS neu installierst, ist die Reihenfolge dieselbe: erst den neuen verknüpfen und ihm die Drucker geben, dann den alten löschen.

---

Deinstallieren

1. Öffne in DSM das Paket-Zentrum, geh zu BolloPrint Agent und klick auf Aktion → Deinstallieren. Das Paket und alles, was es gespeichert hatte, wird gelöscht, auch seine Identität.
2. Lösch den Agenten in BolloPrint unter Einstellungen → Drucker → Lokaler Agent über das Menü ⋮ seiner Zeile.

Beim Löschen verschwinden die Drucker, die nur über diesen Agenten kamen, aus der Liste und zählen nicht mehr für deinen Plan. Es geht nichts verloren: Fügst du einen davon wieder hinzu, kommt er mit seiner Nummer und seinem Verlauf zurück.

---

Wenn etwas nicht läuft

Als Erstes schaust du, ob das Paket im Paket-Zentrum auf Läuft steht. Auf seiner Seite kannst du auch sein Protokoll ansehen: Aktion → Protokoll anzeigen.

Was du siehst	Was zu tun ist
Der Assistent sagt, dass Port 8257 belegt ist	Eine andere Anwendung auf dem NAS nutzt ihn. Trag 8364 ein und mach weiter.
DSM sagt, dass das Paket mit deinem Modell nicht kompatibel ist	Du hast das für einen anderen Prozessor heruntergeladen. Lade das richtige herunter.
Beim Öffnen von BolloPrint Agent wirst du aufgefordert, dich bei DSM anzumelden	Öffne ihn über das DSM-Menü, während du angemeldet bist, und mit einem Administrator-Konto. Wenn es bleibt, schließ diesen Tab und öffne ihn erneut über das Menü.
Auf der Seite steht, dass der Agent nicht antwortet	Das Paket ist gestoppt oder startet gerade. Öffne im Paket-Zentrum BolloPrint Agent, klick auf Aktion → Ausführen und warte ein paar Sekunden.
Beim Verknüpfen erscheint deine Werkstatt nicht	Es erscheinen nur die Werkstätten, deren Inhaber du bist. Bitte den Inhaber, ihn selbst zu verknüpfen.
„Diese Verknüpfungsanfrage ist ungültig“ oder abgelaufen	Geh zurück zur Seite des Agenten und klick noch einmal auf Mit BolloPrint verknüpfen.
Nach einem Neustart des NAS dauert es, bis der Agent Online ist	Warte ein paar Minuten: Er startet mit DSM und versucht es von allein weiter, bis das NAS Internet hat.
Er findet keinen einzigen Drucker	Sind NAS und Drucker im selben Netzwerk? Wenn nicht, füg sie per IP hinzu. Wenn du gerade einen eingeschaltet hast, klick auf Jetzt suchen. Wenn die DSM-Firewall aktiviert ist, gib die Ports von BolloPrint Agent frei (er steht beim Anlegen einer Regel in der Liste der Anwendungen).
Der Agent zeigt Kein aktuelles Signal	Das NAS ist aus, ohne Internet, oder das Paket ist gestoppt.

---

Häufige Fragen

Brauche ich Docker oder Container Manager? Nein. Das Paket verwendet keine Container. Wenn du den Agenten lieber in einem Container betreibst, geht das auch: Das steht unter Agent in Docker.

Muss ich Ports im Router öffnen? Nein. Der Agent ruft BolloPrint nach außen hin an, so wie wenn du eine Webseite öffnest. Port 8257 ist nur für seine Seite auf dem NAS selbst: Er wird nicht für dein Netzwerk geöffnet.

Wer kann die Seite des Agenten öffnen? Nur DSM-Administratoren, über ihr Hauptmenü. Wer nur in deinem Netzwerk ist, kann sie nicht öffnen.

Kann ich den Port später ändern? Der Assistent fragt nur bei der Installation danach. Um ihn zu ändern, musst du deinstallieren und neu installieren, und das ist ein neuer Agent (siehe „Auf ein anderes NAS umziehen oder neu installieren“, weiter oben).

Und wenn ich das NAS ausschalte oder neu starte? Nichts passiert. Der Agent startet von allein mit DSM und verbindet sich wieder, ohne dich um irgendetwas zu bitten.