01开始之前
花一分钟确认下面几件事,后面操作会更顺。
这本手册讲什么
管理后台是给您(管理员)使用的网页,用来建立客户档案、给客户发放授权码、查看设备是否正常运行。客户在机器上使用授权码的过程不在这本手册范围内。
https://服务器地址/admin/login;本机试用时一般是 http://localhost:8080/admin/login。最快上手路线
新客户开通的完整细节见 第 08 章「按场景办事」。
02登录、退出与修改密码
每天从这里开始,也在这里结束。
登录
- 打开后台地址在浏览器地址栏输入系统负责人给的地址,结尾为
/admin/login。 - 填写账号与密码对应图 2-1 的 1,注意区分大小写。
- 点击「登录」对应 2,成功后自动进入「仪表盘」。
- 如果登录失败页面下方会出现红色提示 3,按提示修改后重试;连续输错多次会暂时锁定,稍等片刻再试。
退出登录与修改密码
两个入口都在每一页左下角的账户区域:显示您的昵称,下面有「修改密码」和「退出登录」两个按钮。
| 操作 | 怎么操作 | 要注意什么 |
|---|---|---|
| 修改密码 | 点击「修改密码」,依次填写原密码、新密码、确认新密码,点「保存」。新密码至少 6 位,两次输入必须一致。 | 保存成功后会提示「请重新登录」,当前页面立即退出,需要用新密码重新登录。 |
| 退出登录 | 点击「退出登录」,回到登录页。 | 在公用电脑上离开前务必退出,避免他人误操作客户与授权码。 |
03认识管理后台
四个菜单,覆盖日常全部工作。
| 日期 | 心跳次数 | 活跃设备 | 打印量 |
|---|---|---|---|
| 11-01 | 1,280 | 61 台 | 320 米 / 510 个 |
| 11-02 | 1,315 | 63 台 | 335 米 / 496 个 |
| 菜单 | 什么时候用 | 典型动作 |
|---|---|---|
| 仪表盘 | 每天上班先看一眼;有设备异常需要集中处理时 | 看活跃设备数、查异常设备、批量换机解绑 |
| 授权码管理 | 客户要开通机器、换机器、查某台机器用了多少 | 发布授权码、查使用详情、设置验证周期、换机解绑 |
| 客户管理 | 新客户建档、改联系人、暂停或恢复合作 | 新增/编辑客户、设备统计、终止/启用、批量操作 |
| 设备追踪 | 想确认某台机器在哪、是否上线过 | 按指纹/授权码/IP/归属地/客户搜索 |
04仪表盘:一眼看清全局
这里是「看」的地方,绝大多数操作不在这里做——唯一例外是页面底部的异常设备处理。
读懂上面的数字
| 指标 | 它的意思 |
|---|---|
| 客户总数 | 已建档的客户数量,下面小字区分「合作中」和「已终止」。 |
| 授权码总数 1 | 已发出的全部授权码,小字按「正常 / 未激活 / 冻结 / 过期」拆分。 |
| 活跃设备(24h) 2 | 最近 24 小时内有上报记录的设备台数,并显示活跃率与离线台数。 |
| 累计打印量 3 | 导带机按「米」、袜子机和平板机按「个」分别统计,两类单位不会相加。 |
| 异常 / 宽限设备 4 | 只在出现问题时才显示。有数字就说明有设备长时间没来完成验证,请到页面底部处理。 |
| 机器分布 5 | 导带机 / 袜子机 / 平板机各自的台数、在用台数、活跃台数与累计产量。 |
下半页:趋势与排行榜
- 近 7 天心跳与打印量:按天列出心跳次数、活跃设备、打印量,蓝色长条越长代表当天心跳越多。
- 客户打印量排行:看哪些客户用得多;点击客户名可直接跳到客户管理。
- 设备打印量 Top 10:按单台设备排产量,只统计正在使用中的授权码,可对照授权码、客户、机型、最近心跳时间。
底部:异常设备监控
只有当存在异常或宽限期内的设备时,这张表才会出现。它是仪表盘上唯一需要动手操作的区域。
| 等级 | 授权码 | 客户 | 绑定设备 | 验证周期 | 上次验证 | 下次验证截止 | |
|---|---|---|---|---|---|---|---|
| ☑ | 已异常 | SDF-A1B2C3 | 示例纺织有限公司 | FP-88A2… | 30天 / 宽限7天 | 10-02 09:12 | 11-01 09:12 |
| ☑ | 宽限期内 | SDF-D4E5F6 | 华样例机械 | FP-30C1… | 30天 / 宽限7天 | 10-08 14:30 | 11-07 14:30 |
- 先看等级已异常 表示已超过宽限期仍未验证;宽限期内 表示还有几天缓冲,设备通常还能用。
- 勾选要处理的设备对应图 4-2 的 1,可单选,也可点表头复选框全选。
- 选择处理方式2 从监控移除、3 换机解绑、4 删除授权码。三者后果差别很大,见下表。
- 在弹窗中输入管理员密码确认务必逐条阅读红色弹窗里的后果说明,再点确认。
| 按钮 | 点了会发生什么 | 能否恢复 |
|---|---|---|
| 从监控移除 | 只是让这些设备不再出现在异常列表里,授权码、绑定关系、产量数据全部保留,设备照常使用、不会停机。设备日后重新完成验证,会再次出现在监控中。 | 影响最小 |
| 换机解绑 | 授权码回到「未激活」,原设备立即停机;客户可拿同一个码在新机器上重新激活,有效期从激活时重新计算。该授权码的累计心跳与打印量会清零。 | 可重新激活 历史数据不保留 |
| 删除授权码 | 授权码和历史明细被永久删除,对应设备立即失效,只能重新发布新码。 | 不可恢复 |
05客户管理
先有客户档案,才能给这个客户发布授权码。
| ☑ | ID | 客户名称 | 联系人 | 联系电话 | 状态 | 备注 | 操作 6 |
|---|---|---|---|---|---|---|---|
| ☑ | 12 | 示例纺织有限公司 | 张经理 | 138****6621 | 合作中 | 华东区 | 编辑 统计 终止 删除 |
| ☑ | 11 | 华样例机械 | 李工 | 139****2087 | 合作中 | - | 编辑 统计 终止 删除 |
| ☐ | 9 | 旧案例设备商行 | 陈先生 | - | 已终止 | 合同到期 | 编辑 统计 启用 删除 |
找客户
| 控件 | 用途 |
|---|---|
| 搜索框 1 | 输入客户名称中的几个字即可模糊查找,输入后列表自动更新;右侧的小叉可清空。 |
| 状态筛选 2 | 全部状态 / 仅合作中 / 仅已终止。 |
| 排序 3 | 按 ID 降序(最新建档在前)或按名称 A-Z / Z-A 排。 |
| 刷新 | 怀疑数据不是最新时点一下;刚在别处做了改动,回到列表也建议刷新。 |
新增 / 编辑客户
- 点击右上角「新增客户」对应图 5-1 的 4。
- 填写客户名称1 必填,建议用公司全称,方便日后搜索与对账。
- 补上联系人、电话、备注2 4 选填,但设备出现问题时能第一时间联系到客户,建议填写。
- 确认客户状态3 默认「合作中」;只有「合作中」的客户才能正常激活和使用授权码。
- 点「保存」5 保存后弹窗关闭,新客户出现在列表里。
查看某个客户的设备情况
点击客户行末的「统计」按钮 6,会打开「客户设备统计」弹窗:上方是授权码总数、正常使用中、累计心跳、累计打印量四个汇总数字;下方是该客户名下每台设备(每个授权码)的类型、机型、状态、心跳次数、打印量和最后上线时间。对账、排查客户机器是否在线时最常用。
终止合作 / 恢复合作
客户行末的「终止」按钮会暂停合作,「启用」按钮恢复合作(只有已终止的客户才显示「启用」)。
点击「终止」或「删除」时,系统会先弹出红色确认窗口,列出本次会影响多少客户、多少授权码,并要求输入管理员登录密码才能继续。请逐条读完再决定。
· 已绑定设备会被服务端拒绝,机器停机
· 尚未激活的授权码也无法再激活
· 该操作可恢复:重新「启用」后,冻结的授权码自动恢复为正常
批量操作
勾选列表左侧的复选框(或表头全选框)后,会出现黄色批量栏 5,显示已选数量并提供三个按钮:
| 按钮 | 效果 | 需要密码 |
|---|---|---|
| 批量启用 | 把所选客户恢复为「合作中」,并自动解冻之前被冻结的授权码。 | 不需要 |
| 批量终止 | 一次暂停多个客户,名下正常授权码全部冻结、设备停机;可恢复。 | 需要 |
| 批量删除 | 永久删除所选客户及其名下全部授权码、设备绑定、心跳与打印统计,不可恢复。 | 需要 |
06授权码管理
整个后台最常用的一页:上半部分发码,下半部分查码。
发布新授权码
- 选择客户1 下拉框里是已建档的客户;选中后下方会显示客户详情 8(联系人、电话、状态),发码前顺手核对一遍,避免发错客户。客户状态必须是「合作中」。
- 选择授权类型2 月卡 30 天 / 季卡 90 天 / 年卡 365 天 / 自定义天数 / 永久。选「自定义天数」后会出现时长输入框:按天填写,支持小数(0.5 天=12 小时),也可以直接填「秒」做短期测试;两个都填时以「秒」为准,最长 3650 天。
- 选择机器类型3 导带机(按米计)、袜子机(按个计)、平板机(按个计)。务必与实际机型一致,否则产量单位会不对。
- 选择起始时间4「发布时间」=从发码当天开始算有效期;「激活时间」=客户拿到码、在机器上激活那天才开始算。批量预售、提前发码时通常选后者。
- 填写数量与备注5 一次最多 100 个;6 备注可写「某某的月卡」「一批 5 台」等,日后在列表里好找。
- 点击「发布」7 成功后页面出现绿色提示和生成的授权码 9。请立即复制保存并交给客户,页面关闭后不会再集中展示这一批码。
授权码列表与状态
| ID | 授权码 | 客户 | 类型 | 状态 2 | 验证状态 3 | 打印量 | 下次验证 | 操作 4 |
|---|---|---|---|---|---|---|---|---|
| 86 | SDF-A1B2C3 | 示例纺织 | 月卡 | 正常 | 正常 | 820 米 | 12-01 09:12 | 详情 验证设置 解绑 |
| 85 | SDF-D4E5F6 | 华样例机械 | 年卡 | 未激活 | 未启用 | 0 个 | - | 详情 验证设置 |
| 84 | SDF-G7H8I9 | 旧案例设备 | 季卡 | 已冻结 | 宽限期内 | 260 个 | 11-09 10:30 | 详情 验证设置 |
| 看哪里 | 怎么读 |
|---|---|
| 状态 2 | 未激活 还没被任何机器使用过 · 正常 使用中 · 已过期 超过有效期 · 已冻结 被暂停(常见于客户终止合作) · 已作废 不再有效 |
| 验证状态 3 | 未启用=没设置强制验证周期;正常/宽限期内/异常 表示设备是否按时回来验证。 |
| 有效期 / 下次验证 | 前者是授权到期日;后者是设备必须回来验证的截止时间,逾期会进入异常监控。 |
| 心跳 / 打印量 | 该授权码累计上报次数与累计产量,导带机显示「米」,袜子机/平板机显示「个」。 |
行末三个按钮 4
| 按钮 | 用途 |
|---|---|
| 详情 | 打开「设备使用详情」:授权码信息、绑定设备、到期时间、验证配置、累计心跳与打印量、最近 20 条上线记录(时间、IP、设备信息、当次产量)。排查单机问题时首选这里。 |
| 验证设置 | 打开「强制验证配置」,设置该码的验证周期与宽限期,见下文。 |
| 解绑 | 只在状态为「正常」时出现,用于客户换机器,见 第 08 章。 |
设置强制验证周期
- 验证周期 1:设备隔多久必须回来「报到」一次。填
0表示不强制验证,验证状态显示「未启用」。 - 宽限期 2:错过截止时间后,再给多少天缓冲;缓冲期内显示「宽限期内」,超过后变为「已异常」,并出现在仪表盘的异常监控里。
- 一般客户保持默认(周期 30 天、宽限 7 天)即可;短期测试可临时填小数天,测试完记得改回。
换机解绑(单个授权码)
客户换了机器时,在授权码列表点行末的「解绑」,阅读确认框后确认。结果是:原设备授权立即失效、机器停机;授权码回到「未激活」,客户可以拿同一个码在新机器上重新激活,有效期从激活时重新算起。
07设备追踪
想知道「这台机器在哪、最近有没有上线」,来这一页。
| ID | 机器指纹 | 授权码 | 所属客户 | 最后 IP | 归属地 | 上线次数 | 最后上线 | 设备信息 |
|---|---|---|---|---|---|---|---|---|
| 72 | FP-88A2… | SDF-A1B2C3 | 示例纺织有限公司 | 112.17.**.** | 浙江 杭州 | 1,204 | 2026-11-07 10:42 | DDB-2000 / v2.1 |
| 71 | FP-30C1… | SDF-D4E5F6 | 华样例机械 | 60.12.**.** | 广东 佛山 | 330 | 2026-11-07 09:58 | SK-800 / v2.0 |
| 70 | FP-71B9… | 未关联 | 未关联 | 183.14.**.** | 江苏 苏州 | 2 | 2026-11-06 16:24 | 未知设备 |
| 列 | 说明 |
|---|---|
| 机器指纹 | 设备的唯一识别编号。同一台机器即使换了网络,指纹也不变,排查「一码多用」时最有用。 |
| 授权码、所属客户 | 该设备当前或最近关联的授权码与客户;显示「未关联」表示这台设备还没有对应到已发出的授权码。 |
| IP 与归属地 | 设备最近一次上网的地址与大致地区,可用于判断设备是否被搬到别处。归属地仅为大致范围,不能当精确地址用。 |
| 上线次数与时间 | 累计上线次数与首末时间(首次上线、最后上线)。「最后上线」很久没变,通常说明机器停机或网络不通。 |
| 设备信息 | 设备上报的型号等描述信息,可能为空或显示为「未知设备」。 |
08按场景办事
遇到问题直接照着对应流程走,不用记菜单。
场景 A:给新客户开通机器
发码时若选择「起始时间=激活时间」,有效期从客户激活当天开始算,适合提前发码的场景。
场景 B:客户更换机器
多台一起换:到仪表盘底部「异常设备监控」勾选后点「换机解绑」,需要管理员密码确认。
场景 C:客户暂停合作,之后又恢复
场景 D:仪表盘出现「异常设备」
场景 E:客户说「机器不动了」
- 查客户状态「客户管理」里是否为「已终止」;若是,按场景 C 恢复合作。
- 查授权码状态「授权码管理」里是否为已冻结 / 已过期 / 已作废;已过期需重新发码,已冻结可查是否因终止合作引起。
- 查设备是否在线「授权码管理 → 详情」看最后一次在线时间与最近上线记录;「设备追踪」看最后上线时间、IP 与归属地。
- 查强制验证「详情」里看验证状态是否为「异常」、下次验证截止是否已过;必要时调整验证周期。
- 仍无法定位把授权码、机器指纹、最后上线时间记录下来,交给系统负责人进一步排查。
09危险操作与安全须知
下面这些操作会影响客户机器能否继续生产,动手前请停三秒。
| 操作 | 位置 | 后果 | 可恢复 | 要密码 |
|---|---|---|---|---|
| 终止客户 | 客户管理 | 名下正常授权码全部冻结,设备停机,未激活码不能激活 | 可 | 是 |
| 批量终止客户 | 客户管理 | 同上,一次影响多个客户 | 可 | 是 |
| 删除客户 | 客户管理 | 客户档案、名下全部授权码及心跳与打印统计永久删除,设备立即失效 | 否 | 是 |
| 批量删除客户 | 客户管理 | 同上,一次影响多个客户 | 否 | 是 |
| 换机解绑(单个) | 授权码管理 | 原设备停机,授权码回「未激活」,可在新机器重新激活 | 可重新激活 | 否 |
| 批量换机解绑 | 仪表盘 · 异常监控 | 同上,且这些授权码的累计心跳与打印量清零 | 部分 | 是 |
| 从监控移除 | 仪表盘 · 异常监控 | 仅不再显示在异常列表,授权与数据完全不变,设备照常使用 | 无影响 | 是 |
| 批量删除授权码 | 仪表盘 · 异常监控 | 授权码与历史明细永久删除,设备立即失效,只能重新发码 | 否 | 是 |
| 修改密码 | 左下角账户区 | 改完后当前会话立即退出,须用新密码重新登录 | — | 用原密码 |
10常见问题
按现象找答案。
提示「登录已失效(服务端重启或会话过期)」,数据丢了吗?
页面上的数字看起来不对 / 刚做完操作没变化,怎么办?
为什么打印量有「米」和「个」两个数字,不能加起来?
授权码发出去了,列表里一直是「未激活」?
客户说机器突然停了,先查哪里?
「验证状态」显示「未启用」是什么意思?
「从监控移除」之后还能把设备找回来吗?
仪表盘点客户名为什么直接跳到了客户管理?
修改密码后所有页面都要重新登录吗?
忘记密码 / 需要新增管理员账号怎么办?
附名词速查
页面里出现的词,用大白话解释一遍。
| 名词 | 意思 |
|---|---|
| 授权码 | 发给客户的一串号码,相当于一台机器的「使用许可证」。客户在设备上输入后机器才能工作。 |
| 激活 | 客户第一次使用授权码、把它和某台机器绑定的过程。激活后授权码状态从「未激活」变为「正常」。 |
| 心跳 | 设备定期向系统报一次「我还在、我用了多少」。心跳越新,说明设备越近还在线。 |
| 强制验证 / 验证周期 | 要求设备每隔一段时间主动回来核对一次授权。周期由管理员按授权码设置,填 0 表示不要求。 |
| 宽限期 | 错过验证截止时间后再给的一段缓冲时间。缓冲期内设备一般仍可使用,超过后就变成「已异常」。 |
| 机器指纹 | 每台设备唯一的识别编号,换网络也不会变,用来确认「是不是同一台机器」。 |
| 冻结 | 暂时停止授权。常见于客户终止合作,恢复合作后会自动解冻,不需要重新发码。 |
| 换机解绑 | 取消授权码与原机器的绑定,让同一个码可以在新机器上重新激活。 |
| 在用 / 活跃 / 离线 | 在用=已发出的有效授权码台数;活跃=24 小时内有上报;离线=超过 7 天没有上报。 |