平台 · 云集成 / 连接

云集成 / 连接

云端、混合或本地部署：带 mTLS 的 Zebra Weblink、CLI 代理、Docker、单行安装程序以及面向每个站点的企业级安全 - 仅出站，无入站端口。连接 ERP、数据库和消息流：通过出站代理连接 SQL Server 和 MongoDB，Kafka 和 Azure Service Bus 订阅，DHL Internetmarke 邮资，推送渠道和电子邮件。

设计与布局

打印

云集成 / 连接

自动化

随处部署

云端、混合或完全本地部署 - 由您选择，同一平台

zplCloud 采用容器化架构，不依赖特定云服务商。今天就可以在 zplcloud.com 上开始，通过出站代理连接您的站点；当合规要求需要时，可将整个平台迁移到您自己的数据中心或云账户中。

云端（SaaS）

在 zplcloud.com 上全托管：设计器、API、打印队列和 Print View - 数分钟内上线，无需基础设施，自动更新。

Developer → Pro
api.zplcloud.com
print.zplcloud.com

混合部署

打印机保持原位。Zebra Weblink、CLI 代理或浏览器打印服务只建立一条出站连接 - 无入站端口、无 VPN、无需更改防火墙。

仅出站
mTLS
Docker · Raspberry Pi · Synology

私有 / 本地部署

完整平台以容器形式运行在您的数据中心或您的 Azure、AWS 或 Google 账户中。专用队列、自定义 API 限额、SSO/SAML、定制 ERP/SAP 连接器以及 SLA。

Enterprise
您的基础设施
定制 SLA

四种连接打印机的方式 - 按站点选择，自由组合

1 Zebra Weblink Link-OS 打印机通过 WebSocket 出站连接，使用 mTLS 证书 - 无需代理，中间无需 PC。 2 CLI 代理在任意 PC、Raspberry Pi、NAS 或 Docker 主机上运行 zplcloud proxy，即可访问整个 LAN 中的 TCP 9100 和 USB 打印机。 3 CloudToBrowserPrint 本地打印服务（127.0.0.1:9100）：Web 应用可将 ZPL、PDF 和 Office 文件打印到后台打印程序、CUPS、网络和蓝牙打印机。 4 Raw TCP 9100 直接打印到任意网络打印机 - Zebra、CAB、Novexx、Avery - 支持 ZPL、EPL2、EasyPlug 或 PCL。

运维快速入门

一行命令，从零到已连接的打印机

zplCloud CLI

一行命令 - 随处安装

zplcloud CLI 可应用打印机配置文件、发送原始 ZPL(TCP 9100 / USB),并为远程打印机开启出站代理 - 无需入站端口或更改防火墙。

zplcloud profiles apply 42 --target 10.0.0.5
zplcloud send --target 10.0.0.5 --zpl "^XA…^XZ"
zplcloud proxy --agent "Warehouse Berlin"

install-cli.sh 另见 /docs ↗

$ curl -fsSL https://zplcloud.com/install-cli.sh | sh
$ zplcloud --version
zplcloud 1.x.y (osx-arm64)

$ curl -fsSL https://zplcloud.com/install-cli.sh | sh
$ zplcloud --version
zplcloud 1.x.y (linux-x64)

$ curl -fsSL https://zplcloud.com/install-cli.sh | sh
# 自动检测 32/64 位(arm → linux-arm,arm64 → linux-arm64)
zplcloud 1.x.y (linux-arm64)

PS> irm https://zplcloud.com/install-cli-pshell | iex
>> Installing: %LOCALAPPDATA%\zplcloud\zplcloud.exe
zplcloud 1.x.y (win-x64)

docker-compose.agent.yml 另见 /docs ↗

API 密钥代理名称

下方生成的 compose 文件使用这些值。

services:
  zplcloud-agent:
    image: docker.zplcloud.com/zplcloud-agent:latest
    container_name: zplcloud-agent
    restart: unless-stopped
    environment:
      ZPLCLOUD_API_KEY: "sk_zplcloud_CHANGE_ME"   # 来自 API 标签页
      ZPLCLOUD_AGENT: "PI"                        # 远程打印机中的名称
      ZPLCLOUD_API_BASE: "https://api.zplcloud.com"
      ZPLCLOUD_LOG: "true"                      # 每日日志文件
      ZPLCLOUD_LOG_DIR: "logs/zplcloud-logs"
    volumes:
      - ./logs/zplcloud-logs:/logs/zplcloud-logs
      - /dev/bus/usb:/dev/bus/usb   # USB 访问(libusb)
    #privileged: true                            # 最简单的 USB 方式

$ docker compose -f docker-compose.agent.yml up -d
✔ Container zplcloud-agent  Started

Docker Compose

代理作为容器 - Raspberry Pi、Synology 等

可在任意 Docker 主机上运行:64 位 Raspberry Pi、Synology NAS、Intel 或 Apple Silicon Mac。镜像为多架构(linux/amd64 + linux/arm64),公开且无需登录即可拉取 - 无需 .NET SDK。

docker compose -f docker-compose.agent.yml up -d
镜像:docker.zplcloud.com/zplcloud-agent:latest
USB 打印机:privileged: true 或 udev 规则

Weblink

安装证书 - 一行命令搞定

下载打印机的三个 Weblink NRD 文件,并通过 TCP 9100 推送到设备:~DYE 上传、SGD 设置(URL、NTP、时间)和重置 - 完成。脚本在服务器端为您的打印机生成,需要有效的 API 密钥。

Windows:weblink-deploy.ps1(PowerShell 5.1+)
macOS / Linux / Raspberry Pi:weblink-deploy.sh(bash)
选项:&ip=10.0.0.5 覆盖 TCP 目标

weblink-deploy 另见 /docs ↗

主机名 API 密钥 IP(可选)

下方生成的命令使用这些值。主机名在您的网络中无法解析?没问题 - 直接用 IP 部署:它会变成 &ip=… 并覆盖 TCP 目标,主机名仍用于选择证书。

PS> irm "https://zplcloud.com/weblink-deploy.ps1?hostname=printer01&apikey=sk_zplcloud_XXXX&ip=" | iex
[2026-08-22 09:00:00] SUCCESS - 证书已安装到打印机

$ curl -fsSL "https://zplcloud.com/weblink-deploy.sh?hostname=printer01&apikey=sk_zplcloud_XXXX&ip=" | bash
[2026-08-22 09:00:00] SUCCESS - 证书已安装到打印机

$ curl -fsSL "https://zplcloud.com/weblink-deploy.sh?hostname=printer01&apikey=sk_zplcloud_XXXX&ip=" | bash
[2026-08-22 09:00:00] SUCCESS - 证书已安装到打印机

$ curl -fsSL "https://zplcloud.com/weblink-deploy.sh?hostname=printer01&apikey=sk_zplcloud_XXXX&ip=" | bash
[2026-08-22 09:00:00] SUCCESS - 证书已安装到打印机

安全与治理

企业级管控：谁在何处打印什么

每台打印机、每个密钥和每个作业都归属于其所有者。证书在 TLS 握手时验证，访问基于角色控制，每次渲染均计量。

每台打印机均使用 mTLS

Weblink 仅接受由其自有 CA 签发、已注册且未被吊销的客户端证书。按序列号吊销后，该打印机立即被阻止。

API 密钥与用量计量

按用户、团队或公司分配密钥，区分沙箱与正式环境，设置速率和请求体限制，并为每次渲染和打印作业提供用量仪表板。

团队与角色

Admin 和 Member 角色，支持邀请；打印机、设计和 Print View 归属于所属团队或公司。

传输与账户安全

全面采用 TLS 1.2 / 1.3，自动 Let's Encrypt 证书，12 位密码策略，电子邮件确认和防伪造保护。

历史记录与审计日志

标签历史、打印日志和 Webhook 投递概览 - Developer 保留 7 天，Starter 保留 30 天，Pro 保留 90 天并附审计日志，Enterprise 无限制。

数据驻留由您决定

在您自己的数据中心或云账户中运行平台，仅通过出站代理连接数据库，Enterprise 可按需提供 SSO/SAML。

数据中枢与流式处理

数据一到，标签自动打印

接入你已经在用的系统。五种数据库留在局域网内，通过出站代理查询；七种消息总线在云端消费并变成打印好的标签，无需轮询，也无需中间件。

五种数据库

SQL Server、MongoDB、PostgreSQL、MySQL 和 MariaDB，通过 CLI 代理使用下推过滤和参数。连接字符串绝不离开你的网络；可直接访问的云数据库也能直连。打印视图、DHL 查询和批量打印都在用。

七种消息总线

Kafka、Azure Service Bus、MQTT、AMQP 1.0、RabbitMQ、Amazon SQS 和 Google Pub/Sub。每条 JSON 消息都会变成记录，填充设计的绑定并打印，也可以携带 ZPL 信封用于原样打印。

双向对象存储

消息可以只指向 S3 或 Azure Blob 里的一个文件，而不必携带 ZPL。反过来，输出目标会把每张打印过的标签存到那里，并通过消息或 Webhook 告知。

ERP / SAP / WMS

通过 REST API 用你自己的数据按设计 ID 渲染、接收带 HMAC 签名的 Webhook，或把 ZPL 文件放进被监视的文件夹——三条路适配任何集成层。

topic: orders.shipped · design #42

{
  "orderId": "SO-2026-084712",
  "sku": "88-12345",
  "qty": 120,
  "route": "NO-OSL-07"
}
→ record → design #42 → ZPL → ZD421 "Warehouse Berlin"
✓ printed · 41 ms · offset 18 402 committed

ZPL 信封 - 在一台或所有打印机上按原样打印

{
  "schemaVersion": 1,
  "printer": "*",                 // one id or all printers
  "zpl": "^XA^FO50,50^A0N,40,40^FDHello^FS^XZ"
}
Service Bus: PeekLock → complete after print → dead-letter after 3 failures

连接器

你的数据库、你的消息总线、你的存储

标签在数据所在的地方生成。zplCloud 支持五种数据库、七种消息总线和两种对象存储，既可以通过你自己网络里的出站代理，也可以直接从云端连接。

数据库

通过代理时，凭据留在你的网络里，只有结果行会离开。可直接访问的云数据库也能不经代理直接接入。

SQL Server
MongoDB
PostgreSQL
MySQL
MariaDB

消息总线

每条收到的消息都会变成一条记录，填充设计并打印，也可以直接携带成品 ZPL。标签送达打印机之前不会确认。

Apache Kafka
Azure Service Bus
MQTT
AMQP 1.0
RabbitMQ
Amazon SQS
Google Pub/Sub

对象存储

双向使用：既能从存储桶取回打印文件，也能把打印过的 ZPL 存进去。兼容 S3，因此 MinIO、Cloudflare R2、Wasabi 和 Backblaze 同样适用。

Amazon S3
Azure Blob Storage
MinIO
Cloudflare R2
Wasabi
Backblaze B2

入站：从对象存储取 ZPL

大的打印文件不该塞进总线消息里。消息只需指向它，打印时再去取回。

zplRef

{
  "schemaVersion": 1,
  "printer": "*",
  "zplRef": { "storage": "archiv", "key": "auftraege/4711.zpl" }
}

出站：存好并通知

每次打印成功后，zplCloud 可以做三件事，单独或一起：

1 存档——把打印过的 ZPL 按你自己的命名模板写入 S3 或 Azure Blob。
2 通知——向七种总线之一发送一条消息，附带时间、打印机和存储 URL。
3 触发——向你自己的 URL 发起 HTTP POST，与其他 Webhook 一样用 HMAC-SHA256 签名。

新功能 · 集成

DHL / Deutsche Post INTERNETMARKE

直接在 zplCloud 中使用真实的 Deutsche Post 邮票：以 PDF 或 ZPL 形式购买并打印 - 使用您自己的 Portokasse，可通过应用、REST API、Print View 或 CLI 操作。此处仅作简要说明 - 详细内容请参阅文档。

使用您自己的 Portokasse 购买真实邮票 - 从 Standardbrief 到 Einschreiben
输出为 PDF 或可直接打印的 Zebra ZPL（203 dpi）
DHL 专用 Print View，支持从您的 SQL Server 查询订单（数据中枢）
交易日志包含凭证、费用、余额、PDF 重新打印和发送 ZPL

查看文档了解更多 →

DHL / Deutsche Post INTERNETMARKE

购买邮票（您的 Portokasse）

PDF / ZPL · 203 dpi

打印为 PDF / ZPL（Weblink、代理、Print View）

Weblink / Agent / Print View

含凭证与余额的交易日志

Voucher · Saldo · Reprint

全部功能

完整的标签工作流工具包

设计器、转换器、打印控制、批量、Webhook、推送和 API - 一切尽在一个平台。新功能标记为新.

管理与安全

团队与角色

邀请和角色(Admin/Member),可访问公司打印机。

按主机品牌定制

通过 branding.json 按域名定制标题、Logo、favicon 和 UI。

设计与版本

已保存的设计带描述、架构版本和过时布局的 ⚠ 提示。

仪表板

API 用量、订阅状态和系统概览一目了然。

Let's Encrypt TLS

为所有 zplcloud 域名自动签发 HTTPS 证书(HTTP-01),以及 ACME 打印机证书。

安全

密码策略(2026 标准)、电子邮件确认、防伪造和 JSON 错误处理。

准备好规模化打印了吗？

数分钟内设计您的第一张标签。Enterprise：私有部署、SLA 和 SSO/SAML 可按需提供。

免费开始阅读文档

免费 Developer 套餐 · 无需信用卡 · 随时取消

云集成 / 连接

云端、混合或完全本地部署 - 由您选择，同一平台

云端（SaaS）

混合部署

私有 / 本地部署

四种连接打印机的方式 - 按站点选择，自由组合

一行命令，从零到已连接的打印机

一行命令 - 随处安装

代理作为 容器 - Raspberry Pi、Synology 等

安装证书 - 一行命令搞定

企业级管控：谁在何处打印什么

每台打印机均使用 mTLS

API 密钥与用量计量

团队与角色

传输与账户安全

历史记录与审计日志

数据驻留由您决定

数据一到，标签自动打印

五种数据库

七种消息总线

双向对象存储

ERP / SAP / WMS

你的数据库、你的消息总线、你的存储

数据库

消息总线

对象存储

入站：从对象存储取 ZPL

出站：存好并通知

DHL / Deutsche Post INTERNETMARKE

完整的标签工作流工具包

管理与安全

团队与角色

按主机品牌定制

设计与版本

仪表板

Let's Encrypt TLS

安全

准备好规模化打印了吗？

代理作为容器 - Raspberry Pi、Synology 等