企业官网建设流程全解析

如何在Snipe-IT中生成并打印资产二维码标签：完整新手指南

【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it

盘点时，纸质清单和机柜里的实物对不上号，是IT管理员最熟悉的头疼事。Snipe-IT 是一款免费的开源 IT 资产管理系统，内置的条形码/二维码标签功能可以把资产唯一标识印成标签：扫一下，直接跳到对应资产的详情页面。本文带你从零配置到批量打印跑通。

这个功能到底做了什么

Snipe-IT 的标签功能分两层：一是标签打印引擎，按你选的标签纸模板把 1D 条形码、2D 二维码、标题、Logo 和字段渲染成 PDF 供打印；二是在线二维码，开启后系统内每个资产都能扫码直达详情页。适合管理几十到几万台设备、需要定期盘点和频繁资产交接的管理员。

分步走查：从零到打印出第一张标签

第一步：进入标签设置页

后台左侧菜单进入 设置 → 标签。该页面源码在 resources/views/settings/labels.blade.php，所有参数都在这一页填写。

第二步：启用新标签引擎

勾选页面上的label2_enable复选框。勾选后表单切换为新版模板引擎（labels-new-engine.blade.php），不勾选则走旧版简易配置。想要自定义样式就走新版。

第三步：选择标签纸模板

在新版表单的"选择模板"列表里勾选一种模板（模板清单来自 API 路由api.labels.index）。不同模板对应不同的标签纸规格、方向和可容纳行数，按你实际采购的标签纸选。

第四步：设置条码类型与内容

• label2_1d_type：1D 条形码类型，可选 C128、C39、EAN5、EAN13、UPCA、UPCE 或 none，内容为资产标签号（asset_tag），供扫描枪读取。
• label2_2d_type：2D 码类型，可选 QRCODE、PDF417、DATAMATRIX 或 none，供手机扫码。
• label2_2d_target：二维码里装什么。默认hardware_id指向资产详情页 URL；也可选/ht/{asset_tag}快捷查找页，或纯文本（标签号、序列号等）。

第五步：保存并生成标签

点页面底部"保存"。回到资产列表，勾选一个或多个资产，在批量操作菜单中执行"生成标签"（后端路由api.assets.labels，见 routes/api.php）。批量生成下载名为assets.pdf，单个资产在详情页生成时以{资产标签号}.pdf命名，打印即可。渲染逻辑在 app/View/Label.php。

第六步：扫码验证

用微信扫一扫或手机相机扫标签上的二维码，确认能打开该资产的详情页；再用扫描枪扫 1D 条形码，确认在列表搜索框中能直接定位资产。

核心参数一览

进阶定制：让标签更像"自家"的

• 标题占位符：label2_title支持{COMPANY}占位符，渲染时自动替换为资产所属公司名（见 app/View/Label.php 中str_replace('{COMPANY}', ...)逻辑），同一套模板可给多家公司打不同标题。
• Logo 优先级：勾选label2_asset_logo后，优先使用资产所属公司的 Logo，没有则回退到 品牌设置 里上传的标签 Logo。
• 实时预览：设置页底部有标签预览区，改模板、标题、字段时所见即所得，不用打印才知道效果。
• 字段容量受模板限制：label2_fields里定义的字段数量以模板可容纳的行数（getSupportFields）为准，超出部分会被截断，选模板时留意行数。

实战案例

案例一：新员工入职发设备

1. 在资产列表勾选准备好的笔记本与配件，批量操作 → 生成标签，下载 PDF。
2. 打印并贴到设备背面，二维码朝上便于手持设备扫描。
3. 在资产详情页执行"检出"，指定到该员工，系统自动记录领用日志。
4. 之后回收、转借时，员工或管理员扫标签上的二维码直达资产页操作，全程不翻清单。

案例二：季度盘点

1. 在标签设置里把label2_1d_type设为 C128、label2_2d_type设为 QRCODE，让每张标签同时有条码（扫描枪用）和二维码（手机用）。
2. 对未贴标的资产批量生成标签并打印。
3. 盘点当天，逐台扫描设备标签，在资产页核对"所属位置"与"状态"是否一致，不一致直接改。
4. 盘完用资产列表按状态筛选，快速列出"在库但扫不到"的疑点资产。

避坑自查

• 标签上没有 2D 码：多半是label2_2d_type为 none，QrCodeController.php 在该值下直接不生成，改回 QRCODE 再保存。
• 扫码跳到旧页面：二维码 PNG 缓存在uploads/barcodes/目录（命名如qr-hardware-123.png），改过目标设置后请在标签设置页点"清除条码缓存"重新生成。
• 站点域名变了、扫码 404：hardware_id目标写入的是完整 URL，改过app.url后同样需要清一次条码缓存。
• 批量生成跳回设置页并提示模板无效：label2_template指向的模板已被删除，重新选一个模板即可。
• 只打印了一张却拿到assets.pdf：属正常行为——多个资产合并为assets.pdf，单个资产才按标签号命名。
• 中文标签乱码：PDF 由 TCPDF 渲染，先用纯中文常见字验证，异常时排查服务器字体环境。

写在最后

Snipe-IT 的标签功能把"资产是谁"写进了每一张贴纸：1D 条形码服务扫描枪，二维码服务手机，模板引擎负责让打印结果符合你的标签纸。建议现在就挑三五个常用设备，按上文走一遍"设置 → 生成 → 扫码验证"，跑通后再批量铺开。

【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it