zplCloud Blog
Weblink أم CLI Proxy أم CloudToBrowserPrint: كيف تختار
ثلاث وسائل نقل لثلاث مهام مختلفة، وكلها صادرة فقط - والفرق في من يحمل الاتصال وما الذي يمكنه تحويله.
المبدأ نفسه، آليات مختلفة
هناك ثلاث طرق لإيصال ملصق من zplCloud إلى طابعة مادية. يُخلط بينها باستمرار، واختيار الخاطئة يكلف يوم تصحيح.
الثلاث تشترك في خاصية: الاتصال يُقام دائمًا من داخل شبكتك إلى الخارج. بلا منفذ وارد وبلا إعادة توجيه منفذ وبلا VPN وبلا طابعة مكشوفة للإنترنت. ما يختلف هو أي مكوّن يحمل ذلك الاتصال، وما يمكنه فعله بمهمة طباعة قبل وصولها إلى الطابعة.
Cloud Connect / Weblink - الطابعة تتصل خارجيًا
Weblink آلية Zebra الخاصة، مُجهَّزة عبر zplCloud. مكوّن relay في شبكتك يحافظ على WebSocket خارجي للمنصة؛ الطابعة تصادق بـmTLS بثلاثة ملفات شهادات تُدفع إلى فلاشها (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
السكربت ينزّل شهادات الطابعة ويرفعها عبر TCP 9100 (~DY) ويضبط متغيري SGD لعنوان Weblink وNTP ويعيد ضبط الطابعة. أضف &ip=10.0.0.5 عندما لا يُحل الاسم على شبكتك—الاسم ما زال يختار الشهادة، والـIP مجرد هدف TCP.
استخدمه عندما: تكون الطابعة جهاز إنتاج دائمًا يجب بلوغه من كل مكان في المنصة—مصمم وPrint Views ومهام دفعة وwebhooks وAPI. هذا الافتراضي لطابعة Link-OS تبقى في مكان.
يتطلب: طابعة Link-OS. GK420 أو أي جهاز قبل Link-OS لا يستطيع Weblink إطلاقًا.
zplCloud Proxy - وكيل تشغّله أنت
الوكيل جزء من CLI zplCloud. يعمل على أي جهاز في الشبكة المحلية—Windows أو macOS أو Linux أو Raspberry Pi أو كحاوية—ويسجل طابعات في مساحة عملك عبر اتصال SignalR خارجي واحد.
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
يبلغ الطابعات عبر TCP 9100 أو USB، وهو الفرق الحاسم: طابعة مكتبية USB فقط لا تملك حزمة شبكة تتصل بها خارجيًا، فالوكيل هو الطريقة الوحيدة لوضعها في السحابة. الوكيل يطبّق أيضًا ملفات تعريف طابعة (سواد وسرعة ووسط ومتغيرات SGD) ويرسل ZPL خامًا ويراقب مجلدات لملفات .zpl/.prn ويستطيع حمل اتصالات SQL Server وMongoDB وKafka لمركز البيانات.
--service-install يكتب وحدة systemd على Linux والـPi (zplcloud-agent.service، Restart=always) أو مهمة launchd على macOS أو مهمة مجدولة على Windows.
استخدمه عندما: تدير أسطولًا أو لديك طابعات USB أو أقدم أو تحتاج ملفات تعريف متسقة بين المواقع أو تريد أن يحمل الوكيل نفسه مصادر بياناتك.
CloudToBrowserPrint - خدمة محلية لصفحات الويب
CloudToBrowserPrint خدمة HTTP محلية على جهاز المشغّل:
http://127.0.0.1:9100 (https://127.0.0.1:9101 - ضروري لـSafari وأي صفحة https)
صفحة ويب في الشبكة المحلية تتحدث معه مباشرة، بما فيه عبر hub SignalR عند /hubs/print. يكتشف الطابعات (طابعات شبكة من printers.json وUSB وBluetooth) ويحول الصيغ ويفك رموز الباركود ويرسل مهامًا خامًا. السحابة ليست في المسار—الصفحة تطبع دون أي ذهاب وإياب إلى zplCloud.
irm https://zplcloud.com/install-cloudtobrowserprint-pshell | iex
لأن الخدمة ترتبط بمنفذ معروف، تحقق من تعارض قبل نشره—9100 منفذ شائع لبرامج أخرى، وستخبرك الخدمة إن كان مشغولًا.
استخدمه عندما: يحتاج تطبيق ويب خاص بك إلى الطباعة على الطابعة بجوار المستخدم، أو تريد طباعة يقودها المتصفح دون اعتماد على السحابة لمسار الطباعة نفسه.
جنبًا إلى جنب
| Weblink | CLI Proxy | CloudToBrowserPrint | |
|---|---|---|---|
| يعمل حيث | relay في شبكتك + شهادات على الطابعة | وكيل على جهاز LAN / حاوية | خدمة محلية على جهاز المستخدم |
| يبلغ الطابعة عبر | Zebra Weblink (mTLS) | TCP 9100، USB | TCP 9100، USB، Bluetooth |
| سحابة ضرورية للطباعة | نعم | نعم | لا |
| يعمل مع طابعات غير Link-OS | لا | نعم | نعم |
| الصيغ | ZPL من المنصة | ZPL خام | ZPL وPDF وOffice وصور وباركود |
| إضافات | نشر شهادات وإدارة عن بُعد | ملفات تعريف ومجلدات مراقبة ومركز بيانات | اكتشاف وتحويل وفك باركود |
| استخدام نموذجي | طابعات إنتاج ثابتة | أساطيل مُدارة وUSB ومواقع بعيدة | تطبيقات ويب وطباعة مكتب مؤقتة |
الاختيار
- طابعة Link-OS ثابتة تطبع من المنصة → Weblink.
- طابعة USB أو قديمة أو أسطول تديره → CLI proxy. (طابعة مكتب قديمة USB فقط زائد Raspberry Pi إعداد كامل؛ منشور منفصل عن ذلك.)
- تطبيق ويب يطبع على الطابعة بجوار المستخدم → CloudToBrowserPrint.
- موقع حقيقي عادة يشغّل اثنين منها: Weblink على طابعات الإنتاج والوكيل للأسطول ومصادر البيانات.