zplCloud Blog
Zebra 云端设置：15 分钟极速演练
每条命令都完整列出，按输入顺序排列，并指出真正让人浪费时间的两个步骤。
承诺
一台新的 Link-OS 打印机应该在约十五分钟内开始打印生产标签，而不是一个下午。以下是带真实命令的演练。有两步总在吃掉预算——介质校准和浓度——所以这里给它们更多关注，而不是一句带过。
0 - 开箱（2 分钟）
移除运输锁和打印头保护，装载介质；热转印则装载碳带。开机并让它校准。
如果打印机送出一串空白标签后停下，它正在校准间隙/黑标检测。让它完成；打断它正是你在第 5 步追查标签长度问题的方式。
1 - 网络（3 分钟）
- 以太网： 插上，DHCP 搞定其余。
- Wi-Fi： 前面板，或面板不配合时通过 USB 用 Android app。
记下 IP。你只需要一次。
2 - 连接 zplCloud（3 分钟）
选一种：
Weblink - 打印机保持一条到平台的出站连接：
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 上传，设置 Weblink 和 NTP 变量并重置设备。如果 hostname 在你的网络上无法解析，加 &ip=10.0.0.5 - hostname 仍用于选择证书，IP 只是 TCP 目标。
CLI agent - LAN 中一台机器注册打印机：
curl -fsSL https://zplcloud.com/install-cli.sh | sh
zplcloud proxy --agent "Warehouse Berlin" --service-install --api-key sk_zplcloud_XXXX
两者都只出站。没有入站端口，没有防火墙变更。
3 - 应用打印机配置文件（2 分钟）
打印机出厂设置是通用的，与你的介质不匹配。
zplcloud profiles list
zplcloud profiles apply "Shipping 102x152" --target 10.0.0.5
配置文件推送浓度（^MD）、速度（^PR）、介质处理及其定义的任何 SGD 变量。变量可在应用时填写：
zplcloud profiles apply 42 --target 10.0.0.5 --var gtin=4006381333930 --var charge=LOT-42
这是决定第 5 步是否可行的步骤。 浓度太低，条码在办公室能扫、在承运商处失败；太高，细条糊在一起。热敏直印和热转印需要不同值，每个介质供应商也不同。
4 - 设计标签（3 分钟）
打开设计器，从模板开始，添加变化的字段并绑定到你的数据。检查 PNG/PDF/SVG 预览——它由生成 ZPL 的同一引擎渲染，所以不是输出的近似。
5 - 打印并验证（2 分钟）
zplcloud send --target 10.0.0.5 --zpl "^XA^FO50,50^A0N,40,40^FDSpeed run^FS^XZ"
zplcloud send --target 10.0.0.5 --file label.zpl
标志是 --target，接受 IP 或 hostname。仅当端口非标准时才加 --port；默认 9100。
然后用真正的扫描器扫描条码，而不是手机相机 app。手机在对比度和静默区上很宽容，仓库扫描器不会。如果第一次读不出：
- 在配置文件中把浓度提高 2 并重新应用，再重打，
- 检查静默区——条码太靠近标签边缘时，无论浓度如何都会失败，
- 确认设计中的标签长度与物理介质一致。
6 - 交给打印的人（2 分钟）
从设计创建 Print View，选择可编辑字段，分享链接或打印二维码贴在打印机旁的墙上。这就是让设置在与今天不在场的班组接触后仍能存活的东西。
演练
| 步骤 | 内容 | 时间 |
|---|---|---|
| 0 | 开箱、介质、校准 | 2 分钟 |
| 1 | 网络 | 3 分钟 |
| 2 | Weblink 或 agent | 3 分钟 |
| 3 | 打印机配置文件 | 2 分钟 |
| 4 | 设计 | 3 分钟 |
| 5 | 打印 + 扫描检查 | 2 分钟 |
| 6 | Print View | 2 分钟 |
约 15 分钟，其中约四分钟打印机在校准和重启，你可以同时做别的事。
不在 15 分钟内的内容
诚实清单：固件版本太老无法用 Weblink 的打印机、启用客户端隔离的 Wi-Fi 网络，以及与你有任何配置文件都不匹配的标签耗材。每一样都会把极速演练变成一下午——而且它们都不是打印机设置问题。