Snipe-IT 条形码/二维码资产盘点:如何从贴标到扫码的完整指南
【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it
仓库里 200 台待盘点的笔记本摞成两排,你举着手机对着序列号一个一个念,半天没对上 37 台的归属人——这是没有自动识别时的 IT 资产盘点。开源的 IT 资产/许可证管理系统 Snipe-IT 内置条形码(Barcode)与二维码(QR Code)标签功能:给每件资产贴一张带码的标签,盘点时扫一下码就直达资产详情页。下面讲清楚怎么开、怎么印、怎么扫,照着做一轮盘点下来,对不上的设备会从几十台掉到个位数。
二维码在哪里开启:三步进标签设置页
- 登录后台,进入「设置 → 标签」页面。这个页面对应仓库里的 resources/views/settings/labels.blade.php,所有标签参数都在这一个表单里改。
- 勾选「启用新标签引擎」(
label2_enable)。勾选后页面切换为新的标签编辑区,可选二维码类型;不勾则停留在旧版表单,只能看到一维码和二维码开关。 - 选好码制、填好标题,点页面底部的「保存」。页面上会用一条示例资产渲染预览,确认标签长什么样后再去给存量资产打标签。
几个核心开关的作用和建议值:
| 选项 | 作用 | 建议值 |
|---|---|---|
label2_enable | 打开新标签引擎,解锁二维码(QR Code / Data Matrix)选项 | 1 |
label2_2d_type | 二维码类型,决定手机上扫的是二维码还是 Data Matrix | QRCODE |
label2_1d_type | 一维码码制:C128、C39、EAN5、EAN13、UPCA、UPCE 或 none | C128 |
alt_barcode_enabled | 旧版引擎:在标签上追加显示一维条形码(需 PHP 装了 GD 扩展) | 按需 |
qr_code | 旧版引擎:是否显示二维码,并启用附加文字输入框 | 1 |
labels_per_page | 每页排几张标签,对应你的标签纸排版 | 按标签纸规格 |
补充一个旧版字段的说明:旧引擎的二维码下拉框默认跟随「设置 → 通用」里的barcode_type取值,改这里只影响单张标签的覆盖值。
一张标签到一箱标签:从详情页打到整箱 PDF
单个标签:打开任意资产的详情页,点「标签」按钮(路由label/hardware),浏览器直接输出这张资产的标签图,存下来打印即可。标签上印什么由模板变量控制,比如标题字段里写{{asset_tag}}就会渲染成这台资产的编号;二维码扫出来指向/ht/{asset_tag}短链,直达资产详情。标题文字、字号、标签尺寸都在设置页同一表单里改,改完用预览效果确认再保存。
批量标签怎么打印:在硬件列表页勾选若干资产(或按筛选条件全选),从批量操作菜单选「标签」,系统按labels_per_page排好的版式一次性输出一整个 PDF,直接送打印机。几百台新设备入库,一箱标签纸半小时就能印完贴完,批量逻辑走的是 app/Http/Controllers/Assets/BulkAssetsController.php。
贴标签的物理细节别省:
- 尺寸:建议 38×25 mm 左右,二维码边长不小于 15 mm,太小的码手机对焦困难。
- 位置:笔记本贴 A 面(顶盖)中央;台式机贴机箱正面中上部。避开散热孔、接口、经常开合的边缘。
- 防磨损:哑光标签贴完再覆一层透明膜,或干脆用带覆膜的铜版纸;贴上去之后用手摸一遍确认不起边。
盘点现场实录:一个人、一部手机走一圈
以手机自带相机对准二维码为例:
- 走到工位前,扫笔记本 A 面标签上的二维码,浏览器跳到该资产的详情页——系统已把码里的内容解析成
asset_tag,再经/ht/短链定位到记录。 - 页面上核对资产名称、序列号、当前状态与持有人的信息。
- 信息无误就继续走;需要动的(比如这台其实已归还)直接在详情页执行「归还」或编辑,保存后操作立刻写进该资产的日志。
- 遇到扫出来却找不到记录的设备,回列表页用资产编号手动搜一遍,确认是不是调拨过。
- 一圈走完,剩下的工作是对着系统里"未扫到"的清单补扫漏网之鱼。
扫码盘点流程的关键就在第 1 步:码里存的是资产编号对应的短链,扫一下等于替你在列表里完成了一次精确搜索。
三条真实工作流:领设备、盘点、维修
新员工领设备:勾选笔记本和鼠标 → 扫员工工牌、再扫两台设备的标签 → 系统把资产记到该员工名下,并自动发出签收确认邮件。
月度盘点:按区域走一圈逐台扫码 → 系统里未扫到的设备自动进入"漏盘"清单 → 导出清单让各区域负责人当周内补核。
维修返场:扫故障设备标签,详情页直接看保修到期日和维保记录 → 执行「归还」并填维修备注 → 生成一条新的操作日志,设备状态回到在用。
翻车自救:标签生成失败与扫码不识别
标签生成失败怎么办:先回到设置页确认开关——二维码开关或二维码类型至少开一个,label2_2d_type是 none 时标签上就不会有任何二维码。开关没问题就去设置 → 标签页点「清除条形码缓存」按钮(purgebarcodes),它删掉服务器上已缓存的标签文件,下次访问强制重新生成。按钮背后的逻辑就在 resources/views/settings/labels.blade.php 的脚本里,核心是这样一段:
// 点击“清除条形码缓存”按钮 $purgeButton.click(function () { $.ajax({ url: '{{ route('api.settings.purgebarcodes') }}', // POST 到清缓存接口 type: 'POST', success: function (data) { // 成功后在按钮旁显示绿色提示 $purgeStatus.html('<i class="fas fa-check text-success"></i> ' + data.message); }, error: function () { // 失败显示红色警告,便于继续排查 $purgeStatus.html('Files could not be deleted.').addClass('text-danger'); } }); });扫码不识别,按清单排查:
- 标签磨损、卷边、被反光膜盖住 → 重打一张,这是最高频原因。
- 扫出来是空或 404 → 核对资产的
asset_tag是否和码里内容一致,短链域名是否指向你的 Snipe-IT 实例(检查应用 URL 配置)。 - 换了扫码枪后整串读不出 → 确认扫码枪的工作模式设为"键盘模式",且读取方向与码的摆放角度对得上。
落地清单:五件事勾完再收工
- 每季度备份一次数据库,标签丢了可以重打,记录丢了就全完
- 标签贴完覆膜,季度巡检时顺手检查有没有起边、发花的标签
- 让一线同事过一遍"扫 → 核对 → 操作"的流程,重点是漏扫后怎么补
- 每月盘点结束清一次条形码缓存,避免旧文件占用磁盘
asset_tag编号规则定下来就不要改,改一次等于全公司重贴一次
设置只花十分钟,标签一贴,下一次盘点你手里只需要一部手机。先把仓库那 200 台笔记本的标签打出来试试。
【免费下载链接】snipe-itA free open source IT asset/license management system项目地址: https://gitcode.com/GitHub_Trending/sn/snipe-it
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考