Skip to content

二维码与访问码 ​

访问码页面用于生成登录二维码、在网页上绑定机台登录信息,并在支持的设备上读取 NFC 卡片。

生成一次性访问码 ​

  1. 打开“获取访问码”。
  2. 选择“一次性”标签页。
  3. 点击生成,等待页面显示二维码和文本内容。
  4. 在有效期内完成一次登录;过期后重新生成。

一次性访问码适合临时使用、测试和不希望长期保存凭据的场景。不要把截图长期留在相册或聊天记录中。

生成长期访问码 ​

  1. 选择“长期”标签页。
  2. 点击生成并等待成功提示。
  3. 将二维码交给需要登录的设备,完成后妥善删除截图。

长期访问码适合本人长期使用,但一旦泄露,影响范围更大。请优先使用设备本地显示或短时间传递。

一次性码的有效期和登录会话的有效期不是同一个概念:二维码过期后应重新生成;已经建立的会话是否继续有效,则以页面验证结果为准。不要为了延长一次性码而反复刷新登录。

从图片识别二维码 ​

页面支持上传清晰的二维码图片:

  • 图片应完整包含二维码四个定位点;
  • 避免压缩、反光、裁切和过度缩放;
  • 识别失败时可以直接复制二维码文本粘贴;
  • 不要把含有二维码的图片发送给无关人员。

在网页上绑定机台登录 ​

机台账号可以使用“在网页上登录”功能:

  1. 准备机台显示的二维码文本或截图。
  2. 选择对应机台标识;如果列表中没有,请按页面提示填写管理员提供的标识。
  3. 需要人机验证时完成验证。
  4. 可选填写自定义服务地址;不确定时保持为空。
  5. 提交后等待成功消息,再回到机台确认登录状态。

NFC ​

部分移动浏览器支持 NFC:

  1. 使用支持 NFC 的设备和浏览器打开页面。
  2. 授予浏览器已经明确显示的读取权限。
  3. 将卡片贴近手机感应区,等待页面显示识别结果。
  4. 识别失败时改用二维码,不要反复快速移动卡片。

浏览器不支持 NFC 时,页面会自动隐藏或禁用相关操作,这不影响二维码和文本登录。

访问码安全 ​

  • 不要在公开群组发送完整访问码。
  • 不要把长期访问码写入脚本仓库。
  • 临时访问码不再使用时无需保存。
  • 发生泄露或异常登录时,立即退出相关 Token,并联系管理员。

聊天经验:临时码、长期码和访问错误 ​

现场反馈中出现过“临时访问码可以使用、长期访问码提示更新”以及“网页二维码生成成功、机台仍提示访问错误”。这通常需要分别检查二维码生命周期和机台配置,不能只凭一种码成功来判断全部设置正常。

建议按以下顺序:

  1. 在网页重新验证当前 Token;
  2. 确认二维码没有过期、裁切或被浏览器使用旧缓存;
  3. 确认机台的访问码功能已保存;
  4. 按页面提示完成一次重启或配置刷新;
  5. 先用新生成的一次性访问码验证;
  6. 最后再测试长期访问码。

如果机台提示网络错误或访问错误,保留提示文字、时间和当前机台状态,不要把完整二维码发送到群里。仍失败时让管理员确认当前连接路径和账号授权。

聊天经验中还出现过“侧载状态下扫码出现数字错误码”的情况。遇到扫码后立即报错时,先记录错误码、侧载分支、热重载开关状态和最后上报时间,再按当前公告确认是否应切换回稳定分支或执行一次冷重启。不要在扫码失败后连续生成二维码,也不要把错误码之外的完整二维码内容发到群里。

如果账号显示被锁定、登录状态长时间不变化或连续收到异常提示,不要用长期码反复尝试绕过状态,也不要连续点击获取二维码。先停止登录请求,保留时间和提示,使用缓存/上传缓存保住已有数据,再联系管理员确认账号状态。

聊天经验:换机台登录必须重新验证目标环境 ​

同一个账号在一台机台成功,不代表把旧二维码、旧截图或浏览器缓存带到另一台机台就能登录。目标机台的授权范围、网络路径、当前分支和会话状态都可能不同。

换机台时:

  1. 先确认页面当前选择的是目标账号和目标机台;
  2. 在目标环境重新生成一次临时访问码,避免使用旧截图;
  3. 登录后回读机台状态、账号归属和一条非敏感记录;
  4. 临时码成功而长期码失败时,单独检查长期码绑定和生命周期;
  5. 两种码都失败时,记录目标机台、时间、网络检查和非敏感提示,再联系管理员。

不要复制第一台机台的 Token、缓存、完整配方或二维码来迁移登录,也不要为了验证换机台而反复获取长期码。

Released under the CC BY-NC-SA 4.0 License.