跳到内容

ZPL打印代理

云商店或 ERP 无法访问您网络上的打印机。OpenZPL 代理与打印机一起运行,接收打印任务并发送,无需打开防火墙端口。

下载

该代理尚未进行代码签名,因此 Windows 和 Mac 第一次会发出警告。在 Windows 上选择更多信息,然后选择继续运行。在 Mac 上,右键单击它并选择打开。

运行它

创建一个API key,然后使用每个打印机的地址启动代理。没有任何--printer时,它会使用计算机上安装的所有打印机。

openzpl-agent --key oz_live_… --printer "Dock=192.168.1.50"

对于连接到计算机的打印机,请使用安装时的名称,前面加上 queue:。使用 openzpl-agent list 列出它们。

openzpl-agent --key oz_live_… --printer "Desk=queue:ZDesigner ZD421"

将标签发送给它

从任何系统发送 ZPL 或填写保存的设计,并命名打印机。

curl https://api.openzpl.com/v1/print-jobs -H "X-API-Key: oz_live_…" -H "Content-Type: application/json" \
  -d '{"printer": "Dock", "zpl": "^XA^FO50,50^A0N,50,50^FDHello^FS^XZ"}'

curl https://api.openzpl.com/v1/templates/d123/print -H "X-API-Key: oz_live_…" -H "Content-Type: application/json" \
  -d '{"printer": "Dock", "data": {"sku": "A-100"}}'

答案包含作业 ID:请询问 GET /v1/print-jobs/{id} 是否已打印。

保持运行

将您的密钥和打印机放在程序旁边的 openzpl-agent.conf 文件中,每行一个,并使用计算机启动它。

key=oz_live_…
printer=Dock=192.168.1.50

Windows

schtasks /Create /TN OpenZPLAgent /SC ONSTART /RU SYSTEM /TR "C:\OpenZPL\openzpl-agent.exe"

Linux (systemd)

[Service]
ExecStart=/opt/openzpl/openzpl-agent
Restart=always

问题

哪些打印机可用?

任何接受 ZPL 的系统,网络上(端口 9100)或安装在计算机上。

我的网络是否暴露?

不。代理仅发起外部HTTPS调用,无法连接内部。

你们保留这些标签吗?

仅在代理报告结果之前,如果他从未取走,最多一天。请参阅privacy page。

这会算入我的计划吗?

该代理是 Pro 的一部分,支持最多 3 台打印机,同时也是 Business 的一部分,没有限制。免费账户可以试用 14 天。每个发送的标签与已渲染的标签数量相同。

需要我们还没有的东西吗?

为您的系统、标签格式或新工具提供连接器:告诉我们您使用什么,我们将考虑构建它。

请求工具或集成
反馈