🗄️ Agent na Synology

Jeśli masz Synology w warsztacie, masz już gdzie umieścić agenta lokalnego: jest włączony przez cały dzień i w tej samej sieci co twoje drukarki. Agent instaluje się jak każda inna aplikacja DSM i pojawia się w jego menu głównym.

Ta strona wyjaśnia, jak go zainstalować, powiązać z warsztatem, zaktualizować, przenieść i usunąć. Czym jest agent i jakie drukarki podłącza, znajdziesz w Agent lokalny.

---

Zanim zaczniesz

Czego potrzebujesz	Jak to sprawdzić
DSM 7 lub nowszy	W DSM: Panel sterowania → Centrum informacji. Z DSM 6 nie działa.
Wiedzieć, jaki procesor ma twój NAS	W tym samym Centrum informacji widać model CPU. Intel i AMD to 64 bity; jeśli to ARM, karta twojego modelu na stronie Synology mówi, czy jest 64-, czy 32-bitowy.
Logować się do DSM jako administrator	Tylko administratorzy mogą instalować pakiety i otwierać stronę agenta.
Być właścicielem warsztatu w BolloPrint	Przy powiązywaniu pojawiają się tylko warsztaty, których jesteś właścicielem.
NAS i drukarki w tej samej sieci	Jeśli są w oddzielnych sieciach, agent działa tak samo, ale drukarki trzeba będzie dodać po ich IP.
NAS z dostępem do internetu	Nic więcej: nie trzeba otwierać portów ani mieć stałego IP.

---

1. Pobierz pakiet

W BolloPrint przejdź do Ustawienia → Drukarki → Agent lokalny → Nowy agent i wybierz Synology.

Zobaczysz przycisk pobierania dla każdego typu procesora: Intel lub AMD (64-bit), ARM (64-bit) i ARM (32-bit). Kliknij ten dla swojego NAS-a. Pobierze się plik z końcówką .spk: to pakiet DSM.

Na tym ekranie nie trzeba niczego tworzyć ani kopiować żadnego kodu. Agent powstaje w chwili powiązania, w kroku 3.

---

2. Zainstaluj go w DSM

1. Zaloguj się do DSM i otwórz Centrum pakietów.
2. W prawym górnym rogu kliknij Instalacja ręczna.
3. Kliknij Przeglądaj, wybierz pobrany przed chwilą plik .spk i kliknij Dalej.
4. DSM ostrzega, że pakiet nie jest publikowany przez Synology. Zaakceptuj, żeby kontynuować.
5. Kreator pokazuje port strony agenta, z wpisanym już 8257. Zostaw go tak, chyba że DSM powie, że jest zajęty; wtedy wpisz 8364.
6. Kliknij Dalej, a w podsumowaniu Gotowe.

Po minucie pakiet pokazuje się jako Uruchomiony, a BolloPrint Agent pojawia się w menu głównym DSM.

---

3. Powiąż go ze swoim warsztatem

1. W DSM otwórz menu główne (ikona w lewym górnym rogu) i kliknij BolloPrint Agent. Otworzy się w nowej karcie.
2. Strona mówi „Ten agent nie należy jeszcze do żadnego warsztatu” i pokazuje ośmioznakowy kod, np. 6E7B-9DEF. Kliknij Powiąż z BolloPrint.
3. Otworzy się BolloPrint. Jeśli nie jesteś zalogowany, zaloguj się. Wybierz warsztat, do którego go dodajesz.
4. BolloPrint pokazuje urządzenie (nazwę twojego NAS-a i „Synology”) oraz kod. Sprawdź, czy to ten sam kod, który był na stronie agenta, i kliknij Dodaj do warsztatu.
5. Wracasz na stronę agenta, która teraz pokazuje Powiązany z i nazwę twojego warsztatu.

Gotowe. W Ustawienia → Drukarki → Agent lokalny zobaczysz agenta z nazwą twojego NAS-a i logo Synology, w stanie Online.

---

4. Przekaż mu drukarki

Agent zaczyna szukać drukarek w twojej sieci, gdy tylko zostanie powiązany. To, co znajdzie, pojawia się w Drukarki w sieci lokalnej, pod listą agentów, i stamtąd je dodajesz. Te, które nie pojawią się same, dodaj przez Dodaj po IP.

Jak to zrobić dla każdej marki, opisuje strona Drukarki w sieci lokalnej.

---

Aktualizacja

Prawie nigdy nie musisz nic robić: agent aktualizuje się sam. Gdy wychodzi nowa wersja, pobiera ją, sprawdza, czy pochodzi od nas, i uruchamia się z nią ponownie.

Tylko jeśli BolloPrint powiadomi cię, że twój agent wymaga ręcznej aktualizacji, polega ona na zainstalowaniu nowego pakietu na ten, który już masz:

1. Pobierz nowy pakiet z tego samego ekranu BolloPrint (Agent lokalny → Nowy agent → Synology), ten dla twojego procesora.
2. W Centrum pakietów wybierz Instalacja ręczna, wskaż plik i przejdź dalej. DSM widzi, że pakiet jest już zainstalowany, i go aktualizuje: nie pyta ponownie o port.

Agent pozostaje powiązany z tym samym warsztatem, z tymi samymi drukarkami i ich historią. Nie trzeba niczego powiązywać od nowa.

Gdy pakiet trafi do katalogu Synology, Centrum pakietów samo cię powiadomi i wystarczy kliknąć Aktualizuj.

---

Przeniesienie na inny NAS lub ponowna instalacja

Nowy agent to nowy agent: nie da się „przenieść” istniejącego. Przenosi się drukarki, i to z całą ich historią.

1. Zainstaluj pakiet na nowym NAS-ie i powiąż go (kroki 1–3). Pojawi się jako drugi agent.
2. W Ustawienia → Drukarki otwórz każdą drukarkę przez Edytuj w jej menu ⋮ i zmień jej agenta na nowy na liście rozwijanej.
3. Gdy stary agent nie będzie miał już drukarek, usuń go z menu ⋮ w jego wierszu.

Jeśli instalujesz ponownie na tym samym NAS-ie, kolejność jest taka sama: najpierw powiąż nowego agenta i przekaż mu drukarki, a potem usuń starego.

---

Odinstalowanie

1. W DSM otwórz Centrum pakietów, wejdź w BolloPrint Agent i kliknij Akcja → Odinstaluj. Usunięty zostanie pakiet i wszystko, co przechowywał, również jego tożsamość.
2. W BolloPrint, w Ustawienia → Drukarki → Agent lokalny, usuń agenta z menu ⋮ w jego wierszu.

Po usunięciu agenta drukarki, które docierały tylko przez niego, znikają z listy i przestają liczyć się do twojego planu. Nic nie przepada: jeśli dodasz którąś ponownie, wraca ze swoim numerem i historią.

---

Gdy coś nie działa

Najpierw sprawdź, czy pakiet ma stan Uruchomiony w Centrum pakietów. Z jego karty możesz też zajrzeć do jego dziennika: Akcja → Wyświetl dziennik.

Co widzisz	Co zrobić
Kreator mówi, że port 8257 jest zajęty	Używa go inna aplikacja na NAS-ie. Wpisz 8364 i kontynuuj.
DSM mówi, że pakiet nie jest zgodny z twoim modelem	Pobrałeś pakiet dla innego procesora. Pobierz właściwy.
Przy otwieraniu BolloPrint Agent pojawia się prośba o zalogowanie do DSM	Otwórz go z menu DSM, będąc zalogowanym, i to jako administrator. Jeśli to nie pomaga, zamknij tę kartę i otwórz go ponownie z menu.
Strona mówi, że agent nie odpowiada	Pakiet jest zatrzymany albo właśnie się uruchamia. W Centrum pakietów otwórz BolloPrint Agent, kliknij Akcja → Uruchom i poczekaj kilka sekund.
Przy powiązywaniu nie widać twojego warsztatu	Pojawiają się tylko warsztaty, których jesteś właścicielem. Poproś właściciela, żeby sam go powiązał.
„To żądanie powiązania jest nieprawidłowe” albo wygasło	Wróć na stronę agenta i ponownie kliknij Powiąż z BolloPrint.
Po restarcie NAS-a agent długo nie przechodzi w stan Online	Poczekaj kilka minut: uruchamia się razem z DSM i sam ponawia próby, dopóki NAS nie ma internetu.
Nie znajduje żadnej drukarki	Czy NAS i drukarki są w tej samej sieci? Jeśli nie, dodaj je po IP. Jeśli właśnie włączyłeś jakąś, kliknij Szukaj teraz. Jeśli masz włączoną zaporę DSM, zezwól na porty BolloPrint Agent (pojawia się na liście aplikacji przy tworzeniu reguły).
Agent pokazuje Brak świeżego sygnału	NAS jest wyłączony, nie ma internetu albo pakiet jest zatrzymany.

---

Najczęstsze pytania

Czy potrzebuję Dockera albo Container Managera? Nie. Pakiet nie używa kontenerów. Jeśli wolisz agenta w kontenerze, to też jest możliwe: opisuje to Agent w Dockerze.

Czy muszę otwierać porty w routerze? Nie. Agent łączy się z BolloPrint na zewnątrz, tak jak przy otwieraniu strony internetowej. Port 8257 służy tylko do jego strony wewnątrz samego NAS-a: nie jest otwierany na twoją sieć.

Kto może otworzyć stronę agenta? Tylko administratorzy DSM, z jego menu głównego. Ktoś, kto jedynie korzysta z twojej sieci, nie może jej otworzyć.

Czy mogę później zmienić port? Kreator pyta o niego tylko przy instalacji. Żeby go zmienić, trzeba odinstalować i zainstalować pakiet ponownie, a to oznacza nowego agenta (zobacz „Przeniesienie na inny NAS lub ponowna instalacja” wyżej).

A jeśli wyłączę albo zrestartuję NAS? Nic się nie stanie. Agent uruchamia się sam razem z DSM i łączy się ponownie, niczego od ciebie nie wymagając.