zplCloud Blog
Weblink, CLI Proxy ou CloudToBrowserPrint : comment choisir
Trois transports, trois rôles différents. Tous en connexion sortante uniquement : la différence tient à qui détient la connexion et à ce qu'il peut convertir.
Même principe, mécaniques différentes
Il y a trois façons d'amener une étiquette de zplCloud sur une imprimante physique. Elles sont couramment confondues, et choisir la mauvaise coûte une journée de débogage.
Toutes les trois partagent une propriété : la connexion est toujours établie de l'intérieur de votre réseau vers l'extérieur. Pas de port entrant, pas de redirection de port, pas de VPN, pas d'imprimante exposée à internet. Ce qui diffère, c'est quel composant détient cette connexion, et ce qu'il peut faire d'un travail d'impression avant qu'il n'atteigne l'imprimante.
Cloud Connect / Weblink - l'imprimante appelle vers l'extérieur
Weblink est le mécanisme propre de Zebra, provisionné via zplCloud. Un composant relay dans votre réseau maintient un WebSocket sortant vers la plateforme ; l'imprimante s'authentifie avec mTLS en utilisant trois fichiers de certificat poussés dans sa 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
Le script télécharge les certificats de l'imprimante, les téléverse via TCP 9100 (~DY), définit les variables SGD pour l'URL Weblink et NTP, et réinitialise l'imprimante. Ajoutez &ip=10.0.0.5 quand le nom d'hôte ne se résout pas sur votre réseau - le nom d'hôte choisit toujours le certificat, l'IP n'est que la cible TCP.
À utiliser quand : l'imprimante est un appareil de production permanent qui doit être joignable depuis partout dans la plateforme - designer, Print Views, travaux par lots, webhooks, l'API. C'est le défaut pour une imprimante Link-OS qui reste en place.
Nécessite : une imprimante Link-OS. Une GK420 ou un autre appareil pré-Link-OS ne peut pas faire Weblink du tout.
zplCloud Proxy - un agent que vous exécutez
Le proxy fait partie de la CLI zplCloud. Il tourne sur n'importe quelle machine du LAN - Windows, macOS, Linux, Raspberry Pi, ou comme conteneur - et enregistre des imprimantes dans votre espace de travail via une connexion SignalR sortante.
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
Il atteint les imprimantes via TCP 9100 ou USB, ce qui est la différence décisive : une imprimante de bureau USB seule n'a pas de pile réseau pour appeler vers l'extérieur, donc l'agent est le seul moyen de la mettre dans le cloud. L'agent applique aussi des profils d'imprimante (obscurité, vitesse, support, variables SGD), envoie du ZPL brut, surveille des dossiers pour des fichiers .zpl/.prn, et peut porter des connexions SQL Server, MongoDB et Kafka pour le data hub.
--service-install écrit une unité systemd sur Linux et la Pi (zplcloud-agent.service, Restart=always), un job launchd sur macOS, ou une tâche planifiée sur Windows.
À utiliser quand : vous gérez une flotte, avez des imprimantes USB ou anciennes, avez besoin de profils cohérents entre les sites, ou voulez que le même agent porte vos sources de données.
CloudToBrowserPrint - un service local pour les pages web
CloudToBrowserPrint est un service HTTP local sur la machine de l'opérateur :
http://127.0.0.1:9100 (https://127.0.0.1:9101 - nécessaire pour Safari et toute page https)
Une page web du LAN lui parle directement, y compris via un hub SignalR à /hubs/print. Il découvre les imprimantes (imprimantes réseau de printers.json, USB, Bluetooth), convertit les formats, décode les codes-barres et envoie des travaux bruts. Le cloud n'est pas dans le chemin - une page peut imprimer sans aucun aller-retour zplCloud.
irm https://zplcloud.com/install-cloudtobrowserprint-pshell | iex
Parce que le service se lie à un port connu, vérifiez un conflit avant de le déployer - 9100 est un port populaire pour d'autres logiciels, et le service vous dira s'il est pris.
À utiliser quand : votre propre application web doit imprimer sur l'imprimante à côté de l'utilisateur, ou vous voulez une impression pilotée par navigateur sans dépendance au cloud pour le chemin d'impression lui-même.
Côte à côte
| Weblink | CLI Proxy | CloudToBrowserPrint | |
|---|---|---|---|
| S'exécute où | relay dans votre LAN + certificats sur l'imprimante | agent sur une machine LAN / conteneur | service local sur la machine de l'utilisateur |
| Atteint l'imprimante via | Zebra Weblink (mTLS) | TCP 9100, USB | TCP 9100, USB, Bluetooth |
| Cloud nécessaire pour imprimer | oui | oui | non |
| Fonctionne avec imprimantes non-Link-OS | non | oui | oui |
| Formats | ZPL depuis la plateforme | ZPL brut | ZPL, PDF, Office, images, codes-barres |
| Extras | déploiement de certificats, gestion à distance | profils, watch folders, data hub | découverte, conversion, décodage codes-barres |
| Usage typique | imprimantes de production fixes | flottes gérées, USB, sites distants | apps web, impression de bureau ad-hoc |
Choisir
- Imprimante Link-OS qui reste en place et imprime depuis la plateforme → Weblink.
- Imprimante USB, ancienne, ou une flotte que vous gérez → CLI proxy. (Une vieille imprimante de bureau USB seule plus une Raspberry Pi est une configuration complète ; il y a un post séparé là-dessus.)
- Votre propre app web imprimant sur l'imprimante à côté de l'utilisateur → CloudToBrowserPrint.
- Un vrai site exécute généralement deux d'entre eux : Weblink sur les imprimantes de production, l'agent pour la flotte et les sources de données.