自助打印 · 管理后台

设置入口：浏览器打开 https://打印机IP/hp/device/（例：https://192.168.1.107/hp/device/）→ 输入管理员账号密码 → Networking（网络）页逐项开关。
设置后验证：回到设备列表，对该设备执行「状态回读」+「测试打印」，确认盒子全链路正常。
总原则：只保留 IPv4 + DHCP + IPP 打印 + SNMP 只读，其余全部关闭——关闭后可防止同网段电脑/手机绕过小程序直接打印（防白嫖），并缩小攻击面。

背景：HP 新固件会"动态安全"拉黑兼容硒鼓芯片导致无法打印。这三项只能在打印机面板上设（已实测：该机型 SNMP/网页均无远程写入口），设一次终身有效。装维装机时按顺序设完再离场。
①【必关】固件自动更新：面板 → 设置 → 系统设置 → 固件更新 → 把自动检查/自动下载设为关闭/手动（不同固件菜单名略有差异，找"固件更新"字样）。这是防芯片报错最重要的一步：固件不升级，已验证好用的兼容芯片永远不会被拉黑。
②【必开】碳粉极低 → 继续：面板 → 设置 → 系统设置 → 耗材设置 → 黑色碳粉 → 极低用量 → 改成继续（青/品红/黄同理）。碳粉极低时照常打印不打断营业，余量由后台监控告警。
③【必关】碳粉盒保护：面板 → 设置 → 系统设置 → 耗材设置 → 碳粉盒保护 → 设为关闭。开启后硒鼓换到另一台打印机会被永久锁死报废。
后台监督：耗材策略（是否限制非原装）与极低行为可远程自动检测，不合规会在设备详情标红告警；固件版本被意外变更也会告警；芯片类错误（10.00.00）秒级推送。"碳粉盒保护"状态无法远程读取，靠本条装机流程把关。

原理：盒子用 Ghostscript 把 PDF 渲染成 1200dpi 打印语言再发给打印机，彩色机走 pxlcolor、黑白机走 pxlmono，颜色由 print-color-mode 指令控制。装机脚本已自动安装 ghostscript/poppler-utils。
① 更换打印机后必做：SSH 到盒子执行 rm /persist/config/printer_color ——彩黑检测结果缓存在此文件，换机后必须删掉让它重新检测，否则黑白机会被当成彩色机走 pxlcolor（字发青）。
② 应急回退直打：渲染异常时执行 echo direct > /persist/config/render_mode 并重启 box-agent，即回退旧链路（PDF 直发打印机渲染）；排查完后 rm /persist/config/render_mode 恢复盒端渲染。
③ 性能参考：x86 盒（Z8350 四核 2G）10 页高清 PDF 渲染约 1.3 秒、峰值内存与页数无关（约 25-30MB）。

入口：浏览器打开 https://打印机IP/hp/device/ → 登录管理员账号 → 左侧 Networking（网络） → 找到 SNMP 项（在协议列表里，和 AirPrint/9100 打印同一页）。
界面结构（HP 固件通用）：页面顶部三个单选项 + 两个团体名称输入框 + 一个复选框：
① 单选项 "启用 SNMPv1/v2 读写访问" ← 必须选这项。选"只读(public)"会把 Get 团体名写死成 public，自定义 ro 无效；
② 输入框 "Set 团体名称"（或 Set Community Name）→ 填 zizhu2026rw，点旁边的 确认/Set 按钮；绝不能留空——留空等于默认 public 仍可写， anyone 都能改打印机配置；
③ 输入框 "Get 团体名称"（或 Get Community Name）→ 填 zizhu2026ro，同样点确认；
④ 复选框 "禁用默认 Get 团体名称 public"（Disable default Get community name "public"）→ 务必勾选，让公知的 public 彻底失效；
⑤ 页面底部点 应用 / Apply 保存。
SNMPv3：不启用（盒子用 v2c，v3 开着也是闲置攻击面）。
安全说明：打印机直连盒子网段、不暴露公网；public 已废、写需要私有串；只读 community 公开在本说明里不影响安全——能读到的只有印数/状态这类无害数据。

盒端 0.7.16 起印数基线 SNMP 优先。设置完成后，在设备列表对该设备执行一次「测试打印」：
验证主通道（SNMP）：看盒端日志出现 印数基线=N（SNMP） 字样，说明 SNMP 读数正常，进度/完成确认都走 SNMP（快、稳）；
验证备用通道（LEDM 兜底）：临时在打印机上把 SNMP 关掉再打一张——日志会出现 印数源回落 LEDM（或印数基线不带 SNMP 标记），说明 LEDM 兜底链路也正常；验完必须把 SNMP 开回，否则长期走慢的 Web 通道。
看日志方式：后台设备列表 → 该设备「盒端日志」，或 SSH 到盒子执行 journalctl -u box-agent -f。

打印机硬件错误（如 54.14 颜色平面定位传感器错误）发生时，面板有提示但盒端轮询可能要在下一次心跳才发现。Syslog 是打印机主动秒级推送的日志通道：卡纸/门盖/硬件错误/固件异常都会实时上报。
工作链路：打印机 JetDirect Syslog → 盒子 UDP 514 → 盒端分类去重 → 心跳上报 → 警告中心（critical 级错误还会推送店铺）。
盒端 0.7.27b 起全自动：盒子开机后自动用 SNMP 把打印机的 Syslog 服务器指向自己（OID 1.3.6.1.4.1.11.2.4.3.5.5.0，写团体名 zizhu2026rw），设置完重启一次打印机生效；此后每 30 分钟巡检一次，被改丢会自动改回（自愈）。
换打印机后：无需任何操作——新打印机接入后盒子会在 5 分钟内自动完成 Syslog 指向（同样需要重启一次打印机才生效；不重启也能打印，只是错误日志延迟到下次心跳）。
手工验证（SSH 到盒子）：/tmp/snmpget 10.99.0.10 zizhu2026ro 1.3.6.1.4.1.11.2.4.3.5.5.0 回显 10.99.0.1 即已指向盒子；盒端日志出现 [syslog] UDP514 监听已启动 即接收就绪。
查看日志：设备管理 → 🖨 打印机日志页（告警中心右边）：按店铺/打印机/日期筛选，每条事件带出现时间和恢复时间（打印机恢复正常后自动填写，无需人工销警）。
中文翻译：常见报错自动翻译（如 paper out → 缺纸），日志页直接显示中文（原文附后）。

两个独立档位（0 最严重 ~ 7 最轻，8 个级别手动勾选）：
· 上报级别：勾选的级别盒子才往服务器发（日志页可见）；
· 告警级别：勾选的级别才触发告警+推送老板微信，未勾选的只记日志不打扰（生产建议 0-3）。
入口：设备详情 → 📝 Syslog页签（单台设置）；打印机日志页 → ⚙ 上报与过滤设置（全局默认，新盒子跟随）。
过滤优先级（盒端）：恢复信号（error cleared / ready，永远不滤）→ 噪音词（内置 + 后台追加）→ 级别白名单 → 硬件错误关键词兜底。
下发机制：保存即发 MQTT 指令 → 盒子写 /persist/config/syslog-filter.json（断电不丢）热生效；全局变更广播全部设备；离线盒子上线自动补发，无需人工。
API（供联调）：POST /api/devices/{id}/syslog（单台保存即下发，levels/alert_levels 传 "0,1,2,3" 或空=跟随全局，drop 传关键词数组）；GET/POST /api/syslog/defaults（全局默认，POST 保存并广播）。
调试模式：盒子 SSH 执行 touch /persist/config/syslog-all 即全量记录（所有级别+不过滤），rm 该文件恢复配置化过滤。

1. 打印机恢复出厂/确认固件，纸盒介质类型设为「自动」（允许用可用介质代打，避免纸张不一致卡作业）
2. 上电联网后，在设备管理 → 设置里把纸张规格绑定到纸盒（如 A4→纸盒1、A5→纸盒2），并关闭不用的纸盒（关闭后不报缺纸）
3. 按上方清单关闭多余网络服务（SNMP、AirPrint、9100 等）
4. 设备管理 → 运维 → 打印测试页（可选纸盒）+「读取错误」+「查看打印队列」，三条全通才算合格
5. 贴设备二维码，扫码绑定商铺
6. 拆除打印机面板按键（防白嫖），面板残留提示状态交由后台监控

常见问题：
· mediaPrompt 缺纸/装纸提示＝打印机在等纸，纸盒装上纸后按面板 OK 或重新开关纸盒即可；后台「读取错误」能看到具体是哪个纸盒、要求什么纸
· 缺纸状态导致作业卡住：云端/盒端看门狗约 3 分钟自动清理卡死作业并通知店铺，也可在运维页手动「🧹 清理卡死作业」
· 机器无法远程重启（HP 打印机不支持），断电重启只能到店操作——所以纸盒/纸张一定要按 SOP 配好再离场

打印完成 / 退款结果 / 设备告警 / 分成结算 推送给用户与店铺（小程序后台需先申请模板） 未配置

故障持续重提醒 设备故障未解决时按间隔重复推送店主（最多重推 5 次），解决后自动停止

发送测试 配置模板后立即验证能否送达、keywords 是否匹配

手动对齐（不上传原图，免费） 服务器自建（免费，推荐） 腾讯COS通用抠图（0.02元/次） 保存

抠图缓存 排版成品 文档转换 订单封面 上传文件

- 刷新 清空本类

总开关 | 对哪些来源生效： 微信图片（聊天图片直打） 微信文档（不适用） 扫描复印（相机直拍） 手机相册 保存 恢复默认参数

打印文档/头像等文件存腾讯云 COS：小程序 STS 直传不占用服务器带宽，下载走签名 URL（盒子无需改动）。关闭时一切回退本地磁盘。 未配置