🧩 Místní agent
Za 30 sekund
- Místní agent je malý program, který běží na počítači ve vaší dílně a připojuje vaše tiskárny přes vaši síť.
- Nainstaluje se na něco, co už máte zapnuté: NAS (Synology, QNAP, TrueNAS), počítač s Windows, Home Assistant nebo jakýkoli počítač s Dockerem či Kubernetes. Níže najdete, co se vám hodí.
- Jeden stačí pro celou flotilu a je to on, kdo volá BolloPrint: není potřeba otevírat porty ani mít pevnou IP adresu.
- Aktualizuje se sám a když vypadne internet, ukládá, co se děje, a po obnovení to odešle.
Místní agent je malý program, který běží na počítači ve vaší dílně. Komunikuje s vašimi tiskárnami přes domácí síť a sděluje BolloPrint, co vidí.
Je to jediné, co je potřeba nainstalovat k připojení tiskáren přes místní síť, a jediný agent stačí pro celou flotilu.
Potřebujete ho?
| Vaše situace | Potřebujete agenta? |
|---|---|
| Máte Bambu Lab a stačí vám je sledovat přes cloud | Ne, ale s agentem získáte kameru. A pokud na tiskárně zapnete režim pro vývojáře, také pozastavení, obnovení a zrušení tisku: přes cloud to nejde |
| Máte Prusa | Ano. Je to jediný způsob, jak je připojit |
| Máte pryskyřičnou Elegoo nebo Centauri | Ano. Jiná cesta není |
| Máte QIDI, Sovol, Voron, RatRig, Two Trees, Artillery, Snapmaker U1 nebo jakýkoli stroj s Klipperem | Ano |
| Máte FlashForge Adventurer 5M, AD5X nebo Creator 5 | Ano |
| Máte Anycubic Kobra 3, Kobra S1, Kobra 4 nebo Kobra X | Ano. Se zapnutým režimem LAN na tiskárně (v betě) |
| Máte Creality K1, K2, Ender-3 V3 nebo Hi | Ano. S továrním firmwarem, bez přípravy (v betě) |
| Nechcete, aby vaše tiskárny komunikovaly s internetem | Ano. Agent s nimi komunikuje uvnitř vaší sítě |
Vyberte, kam ho nainstalovat
Agent patří na počítač v dílně, který je stále zapnutý a pokud možno ve stejné síti jako tiskárny. Nemusíte nic kupovat: téměř vždy poslouží něco, co už máte.
Nainstalovat ho lze dvěma způsoby a rozdíl je v tom, jak se poprvé propojí s vaším účtem:
- S balíčkem nebo instalátorem (Synology, QNAP, Windows, Home Assistant, TrueNAS). Nainstalujete ho jako kteroukoli jinou aplikaci na svém zařízení, otevřete jeho stránku a kliknete na Propojit s BolloPrint. Potvrdíte v BolloPrint a je hotovo: žádné kódy ke kopírování.
- V kontejneru (Docker, Kubernetes). Agenta vytvoříte v BolloPrint a my vám dáme manifest s už doplněnými klíči, který vložíte na svém počítači.
| Kde | Co potřebujete | Jak se instaluje | Stav |
|---|---|---|---|
| Synology | NAS Synology s DSM | Balíček a Propojit s BolloPrint | Beta |
| QNAP | NAS QNAP s QTS | Balíček, který se instaluje ručně, a Propojit s BolloPrint | Beta |
| Windows | Počítač s Windows, který nevypínáte | Instalátor a Propojit s BolloPrint | Beta |
| Home Assistant | Home Assistant s obchodem aplikací | Aplikace pro Home Assistant a Propojit s BolloPrint | Beta |
| TrueNAS | NAS TrueNAS s Apps | Aplikace pro TrueNAS a Propojit s BolloPrint | Beta |
| Docker | Jakýkoli počítač s Dockerem nebo Portainerem: NAS, mini-PC, Raspberry Pi, server | Manifest s klíči | Stabilní |
| Kubernetes | Cluster Kubernetes (k3s také stačí) s uzlem v síti tiskáren | Manifest s klíči | Stabilní |
Váháte mezi dvěma? Pokud má vaše zařízení balíček, použijte balíček: instalace má méně kroků a propojí se jedním kliknutím. Docker je volba pro všechno ostatní a v dílnách funguje nejdéle. Možnosti označené Beta fungují, ale jsou nové: pokud něco nefunguje, jak čekáte, dejte nám vědět přes podporu.
Každá stránka popisuje dvě věci, které budete s agentem dělat: poprvé ho nainstalovat a aktualizovat ho, pokud vás o to někdy požádáme.
💡 Začátek v BolloPrint
Všechny možnosti začínají na stejném místě: Nastavení → Tiskárny, záložka Místní agent, tlačítko Nový agent. Jako první se vás zeptá Kam ho nainstalujete?, s tlačítkem pro každou z možností v této tabulce.
Udržování v aktuálním stavu
Agent se aktualizuje sám: když vyjde nová verze, stáhne ji, ověří, že pochází od nás, a restartuje se s ní. Nikdy to neudělá, dokud některá z jeho tiskáren tiskne.
Něco udělat budete muset, jen pokud vás BolloPrint upozorní, že váš agent potřebuje ruční aktualizaci, a záleží na tom, jak jste ho nainstalovali:
- S balíčkem nebo instalátorem: nainstalujte novou verzi přes tu, kterou máte, bez odinstalování předchozí.
- S Dockerem nebo Kubernetes: změňte verzi image ve svém souboru a znovu ho nasaďte se stejnými klíči.
Postup krok za krokem najdete na stránce každého typu.
Jak se připojuje
Agent volá BolloPrint, ne naopak. Díky tomu funguje bez zásahu do routeru: není potřeba otevírat porty, žádat o pevnou IP adresu ani měnit nastavení firewallu. Funguje za běžným domácím routerem, a dokonce i u optických připojení, která nedávají veřejnou IP adresu.
Načítání diagramu…
To, co BolloPrint agentovi sděluje, putuje tímtéž spojením, které otevřel on.
Po připojení agent:
- se zeptá, které tiskárny má obsluhovat,
- připojí se ke každé z nich jejím protokolem,
- a průběžně odesílá, co vidí.
Když v BolloPrint přidáte novou tiskárnu, agent se to dozví sám, během několika sekund. Není potřeba ho restartovat.
Obrazovka stavu
Záložka Místní agent má dvě části:
- Agenti, jeden na řádek, s logem toho, kde je nainstalovaný, se svým stavem a verzí. V nabídce ⋮ každého z nich máte Upravit, které otevře jeho okno, a Smazat.
- Tiskárny v místní síti, pod nimi: tiskárny všech vašich agentů pohromadě, každá s agentem, který ji obsluhuje. Nahoře jsou Hledat nyní a Přidat podle IP a na konci to, co každý agent ve vaší síti našel, a adresy, které ještě hledá.
Okno agenta má dvě záložky:
- Stav — to, co hlásí samotný agent (tabulka níže), čekající instalace a spojení s jednotlivými tiskárnami. Tady mu také změníte název.
- Nasazení — u Dockeru a Kubernetes manifest s aktuální verzí a Přegenerovat klíče. U agenta nainstalovaného z balíčku je tam jen informace, že byl propojen ze své stránky: nemá manifest ani klíče. Chcete-li ho odebrat, použijte Smazat v nabídce ⋮ v seznamu a jeho stránka znovu nabídne Propojit s BolloPrint.
Co se může zobrazit ve Stavu:
| Co vidíte | Co to znamená |
|---|---|
| Online | Je připojený a pracuje. |
| Nenainstalováno | Vytvořili jste ho v BolloPrint, ale ještě se nikdy nepřipojil. Nic se nerozbilo: zbývá ho spustit na vašem počítači. |
| Žádný nedávný signál | Už nějakou dobu se neozval. Obvykle je počítač vypnutý nebo bez internetu. |
| Odpojeno | Agent není dostupný. |
| Nouzový režim | Spustil se a připojil, ale tiskárny neobsluhuje. Řekne vám proč. |
| Vyrovnávací paměť | Co si uložil v době, kdy to nemohl odeslat. Pokud se zobrazí „Zahozené zprávy“, šlo o tak dlouhý výpadek, že se všechno nevešlo. |
| Aktualizujte agenta | Je k dispozici novější verze. Noví agenti se aktualizují sami; pokud je uvedeno, že je potřeba aktualizovat ručně, postupujte podle stránky svého typu agenta. |
Pod tím je Spojení s jednotlivými tiskárnami: stroj po stroji, zda se k němu agent dostane, a pokud ne, proč.
Agent hledá nové tiskárny ve vaší síti sám každých 15 minut. Pokud byla nějaká právě zapnuta a nechcete čekat, klikněte v sekci Tiskárny v místní síti na Hledat nyní.
Zvláštnosti, které je dobré znát
Jeden agent zvládne celou flotilu. Není potřeba jeden na tiskárnu ani jeden na místnost. Přesto můžete mít v jednom účtu víc agentů a důvody jsou tři:
- Oddělené sítě: například jedna VLAN pro výrobu a druhá pro kancelář. Agent v každé z nich najde své tiskárny bez ručního přidávání.
- Různé provozovny: dvě haly, dvě dílny, dva domy. Každé místo má svého agenta a v BolloPrint vidíte všechno pohromadě.
- Přetížený agent: pokud flotila hodně naroste a máte pocit, že agent nestíhá, rozdělte tiskárny mezi dva.
Nemusí být stejného typu: jednoho můžete mít na Synology v hale a druhého v Dockeru v kanceláři. Na záložce Místní agent je uvidíte pod sebou a v sekci Tiskárny v místní síti je u každého stroje uvedeno, přes kterého agenta vede. Chcete-li tiskárnu přesunout od jednoho agenta k jinému, otevřete ji přes Upravit v její nabídce ⋮ a změňte agenta v rozbalovacím seznamu. Při Přidat podle IP se vás s více agenty zeptá, který ji bude obsluhovat.
⚠️ Jeden agent na počítač
Každý počítač má svého vlastního agenta. Agent pro Docker nebo Kubernetes se nekopíruje na druhý počítač se stejným manifestem: pro dva počítače dva agenti. Podrobnosti pro každý typ najdete na jeho stránce.
Přežije výpadky. Když vypadne internet, agent dál čte tiskárny a ukládá, co se děje. Jakmile se připojení obnoví, všechno odešle. Hodiny výpadku se z historie neztratí.
Smazání agenta odebere i jeho tiskárny. Dělá se to z nabídky ⋮ na jeho řádku. Agent se okamžitě přestane připojovat a tiskárny, které vedly jen přes něj, zmizí ze seznamu a přestanou se počítat do vašeho tarifu. Ty, které jsou připojené i přes Bambu Cloud, zůstanou. Nic se neztratí: pokud některou z těchto tiskáren znovu přidáte — s jiným agentem, automatickým vyhledáním nebo podle IP —, vrátí se se svým číslem a celou historií. To, co je nainstalované na vašem počítači, se z BolloPrint nemaže: balíček se sám vrátí na svou stránku Propojit s BolloPrint a kontejner zastavíte a odstraníte sami. Jak na to, najdete na stránce každého typu.
Když něco nefunguje
| Příznak | Co zkontrolovat |
|---|---|
| Agent se vůbec nezobrazí | Je počítač připojený k internetu? Neblokuje odchozí provoz firewall? U Dockeru a Kubernetes: byl vložen celý manifest, beze změn? |
| Nenajde žádnou tiskárnu | Jsou agent a tiskárny ve stejné síti? Pokud ne, nebo pokud používáte Docker Desktop, je to očekávané: přidejte je podle IP a budou fungovat stejně. |
| Tiskárna je „připojena, ale neposílá data“ | Zavřete aplikaci v mobilu nebo slicer, který ji má otevřenou. Některé stroje přijímají jen jedno spojení najednou. |
| Tiskárna „odpovídá, ale spojení odmítá“ | Špatný přístupový kód nebo vypnutý režim LAN na displeji stroje. Pozor: u Bambu se kód změní pokaždé, když režim LAN zapnete nebo vypnete. |
| Všechny tiskárny jednoho agenta se najednou odpojily | Nejde o flotilu, ale o agenta. Otevřete ho přes Upravit a podívejte se na jeho Stav. |
Pokud to nestačí, stránka vašeho typu agenta vysvětluje, kde najdete jeho log, o který si v podpoře řekneme jako první.
Časté dotazy
Mohu tisk z BolloPrint pozastavit nebo zrušit? Ano, u strojů připojených přes agenta, které to umožňují (dnes Klipper, Snapmaker, PrusaLink, tiskárny Elegoo, které komunikují přes SDCP — pryskyřičné a Centauri Carbon —, a Bambu se zapnutým režimem pro vývojáře). Tento režim vyžaduje režim LAN Only, který Bambu odpojí od jejího cloudu; bez něj tiskárna příkaz ignoruje a BolloPrint její tlačítka vypne, jakmile ho odmítne. Přes cloud tiskárny Bambu příkazy nepřijímají. U žádné nelze posílat úlohy: soubor se dál posílá z vašeho sliceru.
Co se stane, když v dílně vypadne internet? Agent dál komunikuje s vašimi tiskárnami a ukládá, co se děje. Jakmile se připojení obnoví, všechno odešle. Pokud je výpadek extrémně dlouhý, nemusí se vejít všechny podrobnosti, a v takovém případě vám to řekne.
Ukládá něco na můj disk? Data o tiscích neukládá. Ukládá si vlastní log činnosti za posledních několik dní, který se sám průběžně maže, a verze, které stahuje kvůli aktualizaci. Tento log opustí váš počítač, jen pokud si ho podpora BolloPrint vyžádá kvůli prošetření problému.
Kolik spotřebuje? Málo: nepotřebuje výkonný počítač a pohodlně se vejde na NAS nebo mini-PC vedle toho, co na nich už běží. U Dockeru a Kubernetes ho manifest omezuje na 512 MB paměti.
A když počítač vypnu? Nic se nestane. Po zapnutí se agent sám vrátí a nebude po vás nic chtít.
Musím na routeru otevírat porty? Ne. Ani porty, ani pevnou IP adresu, ani pravidla firewallu. Spojení vychází z vaší sítě ven, jako když otevíráte webovou stránku.
Mohu později změnit typ? Ano. Nainstalujte nového agenta, zkontrolujte, že se zobrazuje jako Online, převeďte na něj tiskárny (nebo ho nechte, ať je najde) a starého smažte. Tiskárny si zachovají své číslo i historii.