Spis treści instrukcji

📦 Agent na QNAP

W 30 sekund

Beta. Agent dla QNAP to nowy pakiet i wciąż uczymy się od pierwszych warsztatów, które z niego korzystają.
Pobierasz go z BolloPrint (Ustawienia → Drukarki → Agent lokalny → Nowy agent → QNAP) i instalujesz ręcznie w App Center w QTS.
Otwierasz go z App Center i klikasz Powiąż z BolloPrint. Bez kodów, bez szablonów i bez otwierania portów.
Żeby go zaktualizować, instalujesz nowy pakiet na ten, który już masz.

Jak uruchomić agenta lokalnego na serwerze NAS QNAP bez Dockera, jako jedną z aplikacji w App Center. Jeśli wolisz Container Station (Docker), skorzystaj ze strony Agent w Dockerze: działa równie dobrze.

🧪 To jest wersja beta

Przetestowaliśmy go od początku do końca na QTS 5.2 z procesorem Intel. Pakiety dla procesorów ARM są już opublikowane, ale nie widzieliśmy jeszcze, jak działają na prawdziwym QNAP-ie. Jeśli masz taki, bardzo nam pomożesz, opowiadając, jak ci poszło — dobrze czy źle.

Zanim zaczniesz

Serwer NAS QNAP z QTS 4.5 lub nowszym, zawsze włączony i w tej samej sieci co drukarki.
Konto administratora QTS: jest potrzebne do instalacji i do otwarcia strony agenta.
Status właściciela warsztatu w BolloPrint. Tylko właściciel może dodawać agenty.
Wiedza, jaki procesor ma twój QNAP. Sprawdzisz to w specyfikacji swojego modelu na stronie QNAP albo w QTS, w Panel sterowania → System → Stan systemu.

Procesor twojego QNAP	Co pobrać
Intel lub AMD (większość modeli)	Intel lub AMD (64-bit)
64-bitowy ARM (na przykład serie TS-x33, TS-x28A, TS-x32X)	ARM (64-bit)
32-bitowy ARM (na przykład serie TS-x31P, TS-x31X)	ARM (32-bit)

Agent jest lekki: nie potrzebuje mocnego sprzętu.

Pobieranie

W BolloPrint przejdź do Ustawienia → Drukarki i otwórz kartę Agent lokalny.
Kliknij Nowy agent i wybierz kafelek QNAP.
Pobierz pakiet dla procesora twojego QNAP. To plik z rozszerzeniem .qpkg.

W tym samym miejscu znajdziesz skrócony opis kroków. Na tym etapie nic jeszcze nie jest tworzone: agent pojawi się na twojej liście, gdy go powiążesz.

Instalacja na QNAP

Ponieważ agenta nie ma jeszcze w sklepie QNAP, instaluje się go ręcznie. To pięć kroków:

Zaloguj się do QTS na konto administratora i otwórz App Center.
Otwórz jego ustawienia (ikona ⚙ w prawym górnym rogu) i włącz Zezwalaj na instalację aplikacji bez ważnego podpisu cyfrowego. Zapisz.
Naciśnij ikonę instalacji ręcznej: kilka pudełek z +, w prawym górnym rogu, tuż na lewo od ⚙. Nie ma tekstu; najedź na nią myszą, żeby zobaczyć nazwę. Wybierz pobrany plik .qpkg i naciśnij Zainstaluj.
QTS ostrzeże cię, że aplikacja nie ma podpisu cyfrowego. Zaakceptuj to: tak ma być, dopóki agent nie zostanie opublikowany w sklepie QNAP.
Po zakończeniu BolloPrint Agent pojawi się wśród twoich aplikacji. Naciśnij Otwórz.

💡 O ostrzeżeniu o podpisie

QNAP podpisuje aplikacje ze swojego sklepu. Nasza czeka tam na publikację, więc na razie nie ma tego podpisu i QTS o tym ostrzega. Pakiet pobierasz ze swojego konta BolloPrint i to jedyne miejsce, z którego należy go pobierać.

Jeśli wolisz nie zostawiać włączonej opcji z kroku 2, możesz ją wyłączyć zaraz po zakończeniu instalacji. Przy następnej aktualizacji trzeba będzie włączyć ją ponownie.

Powiązanie z warsztatem

Po naciśnięciu Otwórz QTS przeniesie cię na stronę agenta. Tę stronę widzi tylko zalogowany administrator QTS; każdą inną osobę poprosi o zalogowanie się do QTS.

Strona informuje, że agent nie należy jeszcze do żadnego warsztatu, i pokazuje krótki kod. Kliknij Powiąż z BolloPrint.
Otworzy się BolloPrint. Jeśli nie masz aktywnej sesji, zaloguj się na swoje konto.
Jeśli jesteś właścicielem więcej niż jednego warsztatu, wybierz, do którego go dodajesz. Widoczne są tylko warsztaty, których jesteś właścicielem.
Sprawdź, czy kod pokazany w BolloPrint jest taki sam jak na stronie agenta, i kliknij Dodaj do warsztatu.
Wracasz na stronę agenta, na której widnieje teraz Powiązany z i nazwa twojego warsztatu.

W niecałą minutę zobaczysz go jako Online w Ustawienia → Drukarki → Agent lokalny, z logo QNAP. Od tej chwili wszystko działa jak z każdym innym agentem: drukarki z twojej sieci pojawiają się same i wystarczy je dodać, albo dodajesz je po IP. Opisuje to strona Agent lokalny.

🔐 Powiązuj tylko świeżo zainstalowanego agenta

Kontynuuj w BolloPrint tylko wtedy, gdy wszystko zaczęło się chwilę wcześniej od twojego kliknięcia Powiąż z BolloPrint na twoim własnym QNAP-ie. Jeśli ktoś przyśle ci link do „powiązania agenta”, zamknij go.

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:

Pobierz nową wersję z Ustawienia → Drukarki → Agent lokalny → Nowy agent → QNAP, dla tego samego procesora.
W App Center sprawdź, czy opcja Zezwalaj na instalację aplikacji bez ważnego podpisu cyfrowego jest nadal włączona.
Naciśnij ikonę instalacji ręcznej (pudełka z +, obok ⚙), wybierz nowy plik, naciśnij Zainstaluj i zaakceptuj ostrzeżenie o podpisie.

QTS podmienia program i nie rusza jego danych: agent pozostaje powiązany z twoim warsztatem, razem ze swoimi drukarkami i historią. Nie trzeba go wiązać ponownie. Jeśli po aktualizacji jego strona znów zaproponuje Powiąż z BolloPrint, powiąż go i usuń w BolloPrint starego agenta, który będzie już rozłączony.

Przeniesienie, ponowna instalacja lub usunięcie

Ponowna instalacja lub przeniesienie na inny NAS oznacza powiązanie nowego agenta: zainstaluj go na nowym urządzeniu i powiąż tak jak za pierwszym razem. Na twojej liście będzie to nowy agent. Drukarki przejdą do niego z całą historią, gdy tylko je dodasz. Potem usuń starego z menu ⋮ w jego wierszu.

Żeby usunąć go całkowicie:

W BolloPrint usuń agenta z menu ⋮ w jego wierszu w Ustawienia → Drukarki → Agent lokalny. Agent natychmiast przestaje się łączyć, a drukarki, które docierały tylko przez niego, znikają z listy (jeśli dodasz je ponownie, wrócą ze swoją historią).
W App Center w QTS otwórz BolloPrint Agent i naciśnij Usuń. Zostanie usunięty razem ze swoimi danymi.

Jeśli wykonasz tylko krok 1, agent zostaje zainstalowany, ale bez warsztatu: po kilku sekundach jego strona znów proponuje Powiąż z BolloPrint.

Gdy coś nie działa

Objaw	Co sprawdzić
QTS nie pozwala zainstalować pliku	Czy opcja Zezwalaj na instalację aplikacji bez ważnego podpisu cyfrowego jest włączona? Jeśli QTS podaje, że pakiet nie jest zgodny, pobrano pakiet dla innego procesora: pobierz właściwy. Jeśli twój QTS jest starszy niż 4.5, najpierw go zaktualizuj.
Po naciśnięciu Otwórz pojawia się prośba o zalogowanie do QTS	Strona agenta otwiera się tylko administratorowi. Zaloguj się do QTS na konto administratora i ponownie naciśnij Otwórz w App Center.
Otwórz pokazuje błąd albo pustą stronę	Sprawdź w App Center, czy BolloPrint Agent jest uruchomiony, a jeśli nie, uruchom go. Jeśli nic się nie zmienia, zajrzyj do dziennika systemowego QTS (w QTS 5 to QuLog Center) i poszukaj „BolloPrint Agent”: jeśli jest tam informacja, że jego port jest zajęty, to inna aplikacja używa portów 8257 i 8364. Napisz do nas, a pomożemy go zmienić.
Przy powiązaniu pojawia się „Nie udało się połączyć z BolloPrint”	QNAP potrzebuje dostępu do internetu. Sprawdź jego połączenie i DNS w Panel sterowania → Sieć.
BolloPrint pokazuje „Nie jesteś właścicielem żadnego warsztatu”	Tylko właściciel warsztatu może dodawać agenty. Poproś właściciela, żeby to on powiązał agenta.
Agent nie pokazuje się jako Online	Poczekaj minutę. Jeśli nadal go nie ma, sprawdź w App Center, czy jest uruchomiony i czy QNAP ma dostęp do internetu.
Nie wykrywa żadnej drukarki	Czy QNAP i drukarki są w tej samej sieci? Jeśli nie (VLAN, sieć dla gości), dodaj je ręcznie po IP, a będą działać tak samo. Jeśli są w tej samej sieci, a mimo to się nie pojawiają, dodaj je po IP i daj nam znać: to pomaga nam ulepszać betę.

Nie trzeba otwierać portów na routerze ani w zaporze QNAP: połączenie z BolloPrint wychodzi z twojej sieci na zewnątrz, a strona agenta działa przez sam QTS.