Files
workphone-sdk/开发文档/8、部署/06-存客宝宝塔/20260809_NAS扫码绑定与设备权限修复.md

1.4 KiB
Raw Blame History

NAS 扫码绑定与设备权限修复

问题与根因

  1. 已登录控制台删除离线设备返回 403前端请求缺少 device.delete 权限上下文。
  2. 扫码后设备没有入库:公网控制台默认以公开域名生成 WebSocket 地址,且 NAS SDK 未注入 DEVICE_PAIRING_TOKEN;手机无法对 NAS 建立有效握手。

修复内容

  • 控制台默认绑定地址固定为公司 NAS 局域网:ws://192.168.110.101:8899/ws/device;局域网直接访问时仍保留当前地址。
  • NAS Compose 注入 DEVICE_PAIRING_TOKEN;首次不存在时在 NAS .env 中生成,且不写入文档或前端。
  • 离线删除请求补齐 X-Authenticated: trueX-Permissions: device.delete,继续保留:已登录会话、确认参数、幂等键、仅离线设备可删、历史审计保留。

验收

  • NAS workphone-sdk-nasrunning | healthy
  • 删除权限验收:对不存在设备返回 HTTP 404不再是权限 403未影响任何真实设备。
  • 二维码验收:成功生成;内容包含 NAS WebSocket 地址和配对令牌字段。
  • 新控制台构建资源:index-BzwMJihg.js

操作说明

请在手机设备页点击“添加手机”→“生成绑定二维码”,确认页面显示 ws://192.168.110.101:8899/ws/device 后,再用最新工作手机 APK 扫码。扫码后等待 10 秒刷新列表;服务端出现 WebSocket 注册后设备才会显示在线。