🧩 Agent lokalny
W 30 sekund
- Agent lokalny to mały program działający na komputerze w twoim warsztacie, który łączy twoje drukarki przez twoją sieć.
- Instaluje się go na czymś, co już masz włączone: na serwerze NAS (Synology, QNAP, TrueNAS), na komputerze z Windows, w Home Assistant albo na dowolnym komputerze z Dockerem lub Kubernetesem. Poniżej znajdziesz, co ci pasuje.
- Jeden wystarczy dla całej floty i to on łączy się z BolloPrint: nie trzeba otwierać portów ani mieć stałego IP.
- Aktualizuje się sam, a gdy padnie internet, zapisuje, co się dzieje, i wysyła to po powrocie połączenia.
Agent lokalny to mały program działający na komputerze w twoim warsztacie. Rozmawia z twoimi drukarkami przez domową sieć i przekazuje BolloPrint to, co widzi.
To jedyna rzecz, którą trzeba zainstalować, żeby podłączyć drukarki przez sieć lokalną, i jeden wystarczy dla całej floty.
Czy go potrzebujesz?
| Twoja sytuacja | Czy potrzebujesz agenta? |
|---|---|
| Masz Bambu Lab i wystarcza ci podgląd przez chmurę | Nie, ale z agentem zyskujesz kamerę. A jeśli włączysz w drukarce Tryb dewelopera, także wstrzymywanie, wznawianie i anulowanie: przez chmurę się nie da |
| Masz Prusę | Tak. To jedyny sposób, żeby ją podłączyć |
| Masz żywiczną Elegoo albo Centauri | Tak. Nie ma innej drogi |
| Masz QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, Snapmaker U1 albo dowolną maszynę z Klipperem | Tak |
| Masz FlashForge Adventurer 5M, AD5X lub Creator 5 | Tak |
| Masz Anycubic Kobra 3, Kobra S1, Kobra 4 lub Kobra X | Tak. Z włączonym w drukarce Trybem LAN (w becie) |
| Masz Creality K1, K2, Ender-3 V3 lub Hi | Tak. Z fabrycznym oprogramowaniem, bez przygotowań (w becie) |
| Nie chcesz, żeby twoje drukarki wychodziły do internetu | Tak. Agent rozmawia z nimi wewnątrz twojej sieci |
Wybierz, gdzie go zainstalować
Agent działa na komputerze w warsztacie, który jest zawsze włączony i najlepiej w tej samej sieci co drukarki. Nie trzeba niczego kupować: prawie zawsze wystarczy coś, co już masz.
Są dwa sposoby instalacji, a różnią się tym, jak agent łączy się z twoim kontem za pierwszym razem:
- Z pakietem lub instalatorem (Synology, QNAP, Windows, Home Assistant, TrueNAS). Instalujesz go jak każdą inną aplikację na swoim komputerze, otwierasz jego stronę i klikasz Powiąż z BolloPrint. Potwierdzasz w BolloPrint i gotowe: nie ma kodów do kopiowania.
- W kontenerze (Docker, Kubernetes). Tworzysz agenta w BolloPrint, a my dajemy ci manifest z już wpisanymi kluczami, który wklejasz na swoim komputerze.
| Gdzie | Czego potrzebujesz | Jak się instaluje | Status |
|---|---|---|---|
| Synology | Serwer NAS Synology z DSM | Pakiet i Powiąż z BolloPrint | Beta |
| QNAP | Serwer NAS QNAP z QTS | Pakiet instalowany ręcznie i Powiąż z BolloPrint | Beta |
| Windows | Komputer z Windows, którego nie wyłączasz | Instalator i Powiąż z BolloPrint | Beta |
| Home Assistant | Home Assistant z jego sklepem z aplikacjami | Aplikacja Home Assistant i Powiąż z BolloPrint | Beta |
| TrueNAS | Serwer NAS TrueNAS z Apps | Aplikacja TrueNAS i Powiąż z BolloPrint | Beta |
| Docker | Dowolny komputer z Dockerem lub Portainerem: serwer NAS, mini-PC, Raspberry Pi, serwer | Manifest z kluczami | Stabilna |
| Kubernetes | Klaster Kubernetes (k3s też się nada) z węzłem w sieci drukarek | Manifest z kluczami | Stabilna |
Wahasz się między dwiema? Jeśli twój komputer ma pakiet, użyj pakietu: instaluje się w mniejszej liczbie kroków i wiąże jednym kliknięciem. Docker to opcja na całą resztę i ta, która najdłużej działa w warsztatach. Te oznaczone jako Beta działają, ale są nowe: jeśli coś nie działa tak, jak oczekujesz, napisz nam o tym w zgłoszeniu do wsparcia.
Każda strona opisuje dwie rzeczy, które będziesz robić z agentem: instalację za pierwszym razem i aktualizację, jeśli kiedyś cię o nią poprosimy.
💡 Na początek, w BolloPrint
Wszystkie zaczynają się w tym samym miejscu: Ustawienia → Drukarki, karta Agent lokalny, przycisk Nowy agent. Najpierw pojawia się pytanie Gdzie go zainstalujesz?, z przyciskiem dla każdej z opcji z tej tabeli.
Aktualność agenta
Agent aktualizuje się sam: gdy wychodzi nowa wersja, pobiera ją, sprawdza, że pochodzi od nas, i uruchamia się z nią ponownie. Nigdy nie robi tego, gdy któraś z jego drukarek drukuje.
Coś trzeba zrobić tylko wtedy, gdy BolloPrint powiadomi cię, że twój agent wymaga ręcznej aktualizacji, a co dokładnie, zależy od sposobu instalacji:
- Z pakietem lub instalatorem: zainstaluj nową wersję na tę, którą masz, bez odinstalowywania poprzedniej.
- Z Dockerem lub Kubernetesem: zmień wersję obrazu w swoim pliku i wdróż go ponownie, z tymi samymi kluczami.
Instrukcja krok po kroku jest na stronie każdego typu.
Jak się łączy
Agent łączy się z BolloPrint, a nie odwrotnie. Dzięki temu działa bez grzebania w routerze: nie trzeba otwierać portów, prosić o stałe IP ani ruszać firewalla. Działa za zwykłym domowym routerem, a nawet przy łączach światłowodowych bez publicznego IP.
Wczytywanie diagramu…
To, co BolloPrint przekazuje agentowi, wędruje tym samym połączeniem, które otworzył agent.
Po połączeniu agent:
- pyta, które drukarki ma obsługiwać,
- łączy się z każdą z nich jej protokołem,
- i na bieżąco wysyła to, co widzi.
Gdy dodasz nową drukarkę w BolloPrint, agent dowiaduje się o tym sam, w ciągu kilku sekund. Nie trzeba go restartować.
Ekran stanu
Zakładka Agent lokalny ma dwie części:
- Agenty, każdy w osobnym wierszu, z logo miejsca, w którym jest zainstalowany, swoim stanem i wersją. W menu ⋮ każdego z nich masz Edytuj, które otwiera jego okno, oraz Usuń.
- Drukarki w sieci lokalnej, poniżej: drukarki wszystkich twoich agentów razem, każda z agentem, który ją obsługuje. Na górze są Szukaj teraz i Dodaj po IP, a na końcu to, co każdy agent znalazł w twojej sieci, oraz adresy, których jeszcze szuka.
Okno agenta ma dwie zakładki:
- Stan — to, co zgłasza sam agent (tabela poniżej), oczekujące instalacje i połączenie z każdą drukarką. Tutaj też zmieniasz jego nazwę.
- Wdrożenie — w Dockerze i Kubernetesie manifest z aktualną wersją i Wygeneruj klucze ponownie. W agencie zainstalowanym z pakietu jest tam tylko informacja, że został powiązany ze swojej strony: nie ma manifestu ani kluczy. Aby go usunąć, użyj Usuń w menu ⋮ na liście, a jego strona znów zaproponuje Powiąż z BolloPrint.
Co może się pojawić w zakładce Stan:
| Co widzisz | Co to oznacza |
|---|---|
| Online | Jest połączony i pracuje. |
| Niezainstalowany | Utworzono go w BolloPrint, ale jeszcze nigdy się nie połączył. Nic się nie zepsuło: trzeba go jeszcze uruchomić na twoim komputerze. |
| Brak świeżego sygnału | Od jakiegoś czasu nie daje znaku życia. Zwykle komputer jest wyłączony albo nie ma internetu. |
| Rozłączony | Nie ma go. |
| Tryb bezpieczny | Uruchomił się i połączył, ale nie obsługuje drukarek. Podaje powód. |
| Bufor | To, co zapisał, kiedy nie mógł tego wysłać. Jeśli pojawia się „Odrzucone wiadomości”, przerwa była tak długa, że nie wszystko się zmieściło. |
| Zaktualizuj agenta | Jest nowsza wersja. Najnowsze agenty aktualizują się same; jeśli widzisz, że trzeba zaktualizować ręcznie, postępuj według strony swojego typu agenta. |
Poniżej Połączenie z każdą drukarką: maszyna po maszynie, czy agent do niej dociera, a jeśli nie — dlaczego.
Agent sam szuka nowych drukarek w twojej sieci co 15 minut. Jeśli właśnie włączono jakąś i nie chcesz czekać, kliknij Szukaj teraz w Drukarki w sieci lokalnej.
Szczegóły, które warto znać
Jeden agent udźwignie całą flotę. Nie potrzeba jednego na drukarkę ani jednego na pomieszczenie. Mimo to możesz mieć kilka agentów na tym samym koncie — i są trzy powody, żeby tak zrobić:
- Oddzielne sieci: na przykład jedna VLAN dla produkcji, a druga dla biura. Agent w każdej z nich wykrywa swoje drukarki, bez ręcznego dodawania czegokolwiek.
- Różne lokale: dwie hale, dwa warsztaty, dwa domy. Każde miejsce ma swojego agenta, a w BolloPrint widać wszystko razem.
- Przeciążony agent: jeśli flota bardzo urośnie i zauważysz, że agent ledwo nadąża, rozdziel drukarki między dwa.
Nie muszą być tego samego typu: możesz mieć jednego na Synology w hali, a drugiego w Dockerze w biurze. W zakładce Agent lokalny zobaczysz je jeden pod drugim, a w Drukarki w sieci lokalnej przy każdej maszynie widać, przez którego agenta dociera. Żeby przenieść drukarkę z jednego agenta do drugiego, otwórz ją przez Edytuj w jej menu ⋮ i zmień agenta na liście rozwijanej. Przy Dodaj po IP, gdy masz kilka agentów, BolloPrint zapyta, który ma ją obsługiwać.
⚠️ Jeden agent na komputer
Każdy komputer ma własnego agenta. Agenta Dockera lub Kubernetesa nie kopiuje się na drugą maszynę z tym samym manifestem: dwa komputery to dwa agenty. Szczegóły dla każdego typu są na jego stronie.
Przetrwa przerwy. Jeśli padnie ci internet, agent dalej odczytuje drukarki i zapisuje, co się dzieje. Gdy połączenie wróci, wysyła wszystko. Godziny przerwy nie znikają z historii.
Usunięcie agenta zabiera jego drukarki. Robi się to z menu ⋮ w jego wierszu. Agent natychmiast przestaje się łączyć, a drukarki, które docierały tylko przez niego, znikają z listy i przestają liczyć się do twojego planu. Te, które docierają także przez Bambu Cloud, zostają. Nic nie przepada: jeśli dodasz którąś z tych drukarek ponownie — z innym agentem, przez wykrywanie albo po IP — wraca ze swoim numerem i całą historią. Tego, co jest zainstalowane na twoim komputerze, nie usuwa się z BolloPrint: pakiet sam wraca do swojej strony Powiąż z BolloPrint, a kontener zatrzymujesz i usuwasz samodzielnie. Jak to zrobić, opisuje strona każdego typu.
Gdy coś nie działa
| Objaw | Co sprawdzić |
|---|---|
| Agent w ogóle się nie pojawia | Czy komputer ma dostęp do internetu? Czy jakiś firewall nie blokuje ruchu wychodzącego? W Dockerze i Kubernetesie: czy manifest został wklejony w całości, bez zmian? |
| Nie wykrywa żadnej drukarki | Czy agent i drukarki są w tej samej sieci? Jeśli nie są albo używasz Docker Desktop, to oczekiwane: dodaj je po IP, a będą działać tak samo. |
| Drukarka pokazuje „połączona, ale nie wysyła danych” | Zamknij aplikację w telefonie albo slicer, który ma ją otwartą. Niektóre maszyny przyjmują tylko jedno połączenie naraz. |
| Drukarka „odpowiada, ale odrzuca połączenie” | Błędny kod dostępu albo wyłączony tryb LAN na ekranie maszyny. Uwaga: w Bambu kod zmienia się przy każdym włączeniu lub wyłączeniu trybu LAN. |
| Wszystkie drukarki jednego agenta nagle rozłączone | To nie flota, tylko agent. Otwórz go przez Edytuj i zajrzyj do zakładki Stan. |
Jeśli to nie wystarczy, strona twojego typu agenta wyjaśnia, gdzie znaleźć jego log — to pierwsza rzecz, o którą poprosimy cię w zgłoszeniu do wsparcia.
Najczęstsze pytania
Czy mogę wstrzymać lub anulować wydruk z BolloPrint? Tak, w maszynach podłączonych przez agenta, które na to pozwalają (dziś: Klipper, Snapmaker, PrusaLink, Elegoo działające przez SDCP — żywiczne i Centauri Carbon — oraz Bambu z włączonym Trybem dewelopera). Ten tryb wymaga trybu LAN Only, który odłącza Bambu od jej chmury; bez niego drukarka ignoruje polecenie, a BolloPrint wyłącza jej przyciski, gdy tylko je odrzuci. Przez chmurę Bambu nie przyjmują poleceń. W żadnej nie da się natomiast wysyłać zadań: plik nadal wysyłasz ze swojego slicera.
Co się stanie, jeśli w warsztacie padnie internet? Agent dalej rozmawia z twoimi drukarkami i zapisuje, co się dzieje. Gdy połączenie wróci, wysyła wszystko. Jeśli przerwa jest bardzo długa, może nie zmieścić wszystkich szczegółów — i wtedy ci o tym powie.
Czy zapisuje coś na moim dysku? Nie przechowuje danych o wydrukach. Trzyma własny log aktywności z ostatnich dni, który sam się czyści, oraz wersje pobierane do aktualizacji. Ten log opuszcza twój komputer tylko wtedy, gdy wsparcie BolloPrint poprosi o niego, żeby zbadać problem.
Ile zużywa? Niewiele: nie potrzebuje mocnego komputera i bez problemu zmieści się na NAS-ie albo mini-PC obok tego, co już na nim działa. W Dockerze i Kubernetesie manifest ogranicza go do 512 MB pamięci.
A jeśli wyłączę komputer? Nic się nie stanie. Po włączeniu agent wraca sam, niczego od ciebie nie wymagając.
Czy muszę otwierać porty w routerze? Nie. Ani portów, ani stałego IP, ani reguł firewalla. Połączenie wychodzi z twojej sieci na zewnątrz, tak jak przy otwieraniu strony internetowej.
Czy mogę później zmienić typ? Tak. Zainstaluj nowego, sprawdź, czy pojawia się jako Online, przenieś do niego drukarki (albo pozwól mu je znaleźć) i usuń starego. Drukarki zachowują swój numer i historię.