zplCloud Blog
Weblink, CLI Proxy o CloudToBrowserPrint: come scegliere
Tre trasporti, tre compiti diversi. Tutti solo in uscita: la differenza è chi mantiene la connessione e cosa può convertire.
Stesso principio, meccaniche diverse
Ci sono tre modi per portare un'etichetta da zplCloud su una stampante fisica. Vengono abitualmente confusi, e scegliere quello sbagliato costa una giornata di debug.
Tutti e tre condividono una proprietà: la connessione è sempre stabilita dall'interno della tua rete verso l'esterno. Nessuna porta in ingresso, nessun port forwarding, nessuna VPN, nessuna stampante esposta a internet. Ciò che differisce è quale componente detiene quella connessione, e cosa può fare con un lavoro di stampa prima che raggiunga la stampante.
Cloud Connect / Weblink - la stampante chiama verso l'esterno
Weblink è il meccanismo di Zebra, provisionato tramite zplCloud. Un componente relay nella tua rete mantiene un WebSocket in uscita verso la piattaforma; la stampante si autentica con mTLS usando tre file di certificato spinti nella sua flash (WEBLINK2_CA.NRD, WEBLINK2_CERT.NRD, WEBLINK2_KEY.NRD).
irm "https://zplcloud.com/weblink-deploy.ps1?hostname=printer01&apikey=sk_zplcloud_XXXX" | iex
curl -fsSL "https://zplcloud.com/weblink-deploy.sh?hostname=printer01&apikey=sk_zplcloud_XXXX" | bash
Lo script scarica i certificati della stampante, li carica via TCP 9100 (~DY), imposta le variabili SGD per l'URL Weblink e NTP e riavvia la stampante. Aggiungi &ip=10.0.0.5 quando l'hostname non si risolve sulla tua rete - l'hostname continua a selezionare il certificato, l'IP è solo il target TCP.
Usalo quando: la stampante è un dispositivo di produzione permanente che deve essere raggiungibile da ogni parte della piattaforma - designer, Print Views, lavori batch, webhook, l'API. Questo è il default per una stampante Link-OS che resta in un posto.
Richiede: una stampante Link-OS. Una GK420 o un altro dispositivo pre-Link-OS non può fare Weblink per niente.
zplCloud Proxy - un agente che esegui tu
Il proxy fa parte della CLI zplCloud. Gira su qualsiasi macchina della LAN - Windows, macOS, Linux, Raspberry Pi, o come contenitore - e registra stampanti nel tuo workspace su una connessione SignalR in uscita.
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
Raggiunge le stampanti via TCP 9100 o USB, che è la differenza decisiva: una stampante da scrivania solo-USB non ha una pila di rete con cui chiamare verso l'esterno, quindi l'agente è l'unico modo per metterla nel cloud. L'agente applica anche profili stampante (oscurità, velocità, supporto, variabili SGD), invia ZPL grezzo, sorveglia cartelle per file .zpl/.prn, e può portare connessioni SQL Server, MongoDB e Kafka per il data hub.
--service-install scrive un'unità systemd su Linux e la Pi (zplcloud-agent.service, Restart=always), un job launchd su macOS, o un'attività pianificata su Windows.
Usalo quando: gestisci una flotta, hai stampanti USB o vecchie, hai bisogno di profili coerenti tra le sedi, o vuoi che lo stesso agente porti le tue sorgenti dati.
CloudToBrowserPrint - un servizio locale per le pagine web
CloudToBrowserPrint è un servizio HTTP locale sulla macchina dell'operatore:
http://127.0.0.1:9100 (https://127.0.0.1:9101 - necessario per Safari e qualsiasi pagina https)
Una pagina web della LAN gli parla direttamente, anche tramite un hub SignalR a /hubs/print. Scopre stampanti (stampanti di rete da printers.json, USB, Bluetooth), converte formati, decodifica codici a barre e invia lavori grezzi. Il cloud non è nel percorso - una pagina può stampare senza alcun andata e ritorno zplCloud.
irm https://zplcloud.com/install-cloudtobrowserprint-pshell | iex
Poiché il servizio si lega a una porta nota, controlla un conflitto prima di distribuirlo - la 9100 è una porta popolare per altri software, e il servizio ti dirà se è occupata.
Usalo quando: la tua applicazione web deve stampare sulla stampante accanto all'utente, o vuoi una stampa guidata dal browser senza dipendenza dal cloud per il percorso di stampa stesso.
Fianco a fianco
| Weblink | CLI Proxy | CloudToBrowserPrint | |
|---|---|---|---|
| Gira dove | relay nella tua LAN + certificati sulla stampante | agente su una macchina LAN / contenitore | servizio locale sulla macchina dell'utente |
| Raggiunge la stampante via | Zebra Weblink (mTLS) | TCP 9100, USB | TCP 9100, USB, Bluetooth |
| Cloud necessario per stampare | sì | sì | no |
| Funziona con stampanti non-Link-OS | no | sì | sì |
| Formati | ZPL dalla piattaforma | ZPL grezzo | ZPL, PDF, Office, immagini, codici a barre |
| Extra | distribuzione certificati, gestione remota | profili, watch folders, data hub | discovery, conversione, decodifica codici |
| Uso tipico | stampanti di produzione fisse | flotte gestite, USB, sedi remote | app web, stampa desktop ad-hoc |
Scelta
- Stampante Link-OS fissa che stampa dalla piattaforma → Weblink.
- Stampante USB, vecchia, o una flotta che gestisci → CLI proxy. (Una vecchia stampante da scrivania solo-USB più una Raspberry Pi è una configurazione completa; c'è un post separato su questo.)
- La tua app web che stampa sulla stampante accanto all'utente → CloudToBrowserPrint.
- Un sito reale di solito ne esegue due: Weblink sulle stampanti di produzione, l'agente per la flotta e le sorgenti dati.