Keues 排队叫号：取号机、叫号终端、大屏免装懒猫客户端部署攻略

# Keues 排队叫号：取号机、叫号终端、大屏免装懒猫客户端部署攻略 应用默认地址 `keues.<微服名>.heiyu.space` 需要设备装懒猫客户端才能打开，而取号一体机、安卓广告屏、电视盒子等嵌入式设备很难安装客户端。本文用商店官方应用「局域网端口转发工具」，把 Keues 映射到微服的局域网 IP 端口，现场设备用浏览器直接打开，不用装客户端、不用登录懒猫账号。 | | | | -------------------------------------- | ------------------------------------------------------- | | 管理后台（建网点、队列、窗口、看数据） | 管理员设备装懒猫客户端，用 heiyu.space 地址懒猫账号登录 | | 取号机 / 叫号终端 / 叫号大屏 | 走端口转发地址，无需客户端和账号 | 本文于 2026-10-20 在真实懒猫微服上实测，示例中微服局域网 IP 为 192.168.31.12、转发端口为 18080，请换成你自己的。 ## 一、准备 1\. 微服已安装「Keues排队叫号」 ，并在管理后台建好网点、队列、窗口和业务流（取号机菜单）。窗口的「允许的用户/ 用户组」保持为空，否则现场叫号终端会要求输入 Keues 账号密码。 https://appstore.lazycat.cloud/#/shop/detail/f00700f.keues 2. 现场设备与微服接在同一个局域网。 3. 在商店安装「局域网端口转发工具」（官方应用）。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward  图1 商店里的「局域网端口转发工具」 ## 二、创建端口转发规则 打开「局域网端口转发工具」，点右上角「添加转发规则」，按下表填写： | | | | ----------------- | ----------------------------------------------------- | | 备注 | Keues 排队叫号 | | 协议 | TCP | | 局域网入口类型 | **微服物理网卡**（仅微服所在局域网可访问） | | 出口地址 | 自动带出微服网卡和 IP，如 enp2s0 - 192.168.31.12 | | 监听端口 / 端口段 | 18080（1024 以上、未被占用即可） | | 转发目标类型 | 微服应用 | | 微服应用 | Keues 排队叫号（英文界面显示 Keues Queue Management） | | 服务 | keues | | 目标端口 | 8080 |  图2 填好的转发规则 点「测试目标连接」，再点「创建规则」。列表中出现 `192.168.31.12:18080 → keues.f00700f.keues.lzcapp:8080`，目标显示「目标检查通过」即成功。出口地址里的 IP 就是现场设备要用的地址。  图3 规则创建成功，顶部提示「目标地址连通正常」 ## 三、（可选）自定义域名 不想让设备记 IP，或者担心 IP 变化：先在路由器里给微服做 DHCP静态绑定，再在路由器的「静态 DNS / 自定义解析 / Hosts」里加一条`paidui.lan → 192.168.31.12`（OpenWrt：网络 → 主机名；爱快：DNS 设置 → 静态解析）。路由器不支持时，可在设备 hosts 里加`192.168.31.12 paidui.lan`。之后设备统一用 http 协议打开`paidui.lan:18080`。不要用 .local 后缀或公网真实存在的域名。 ## 四、取号机 在取号机浏览器用 http 打开 `192.168.31.12:18080/ticket` （或`paidui.lan:18080/ticket`）。「服务器地址」会自动填成当前地址（如http://192.168.31.12:18080 ） ，无需修改。  图4 首次打开，服务器地址已自动填好 填写「设备名称」→ 点「连接」→ 选「网点」和「业务流」→「保存」。  图5 选好网点与业务流  图6 保存后进入取号界面，可点左上角「全屏」  图7 顾客点选服务后出票（示例 A014） ## 五、叫号大屏 电视 / 广告屏浏览器用 http 打开 `192.168.31.12:18080/monitors`，填「屏幕名称」→「连接」→ 选「网点」「业务流」→「保存」。  图8 显示屏配置  图9 叫号大屏，左下角显示「已连接」 ## 六、窗口叫号终端 窗口电脑或手机用 http 打开 `192.168.31.12:18080/counter`，填「设备名称」→「连接」→ 选「网点」「业务流」「窗口」→「保存并启动」。  图10 窗口设置  图11 叫号面板：叫下一位、完成服务、转移票号、取消票号  图12 点「叫下一位」，叫到 K003  图13 大屏实时显示 K003 → 3 号窗口，无需刷新 ## 七、常见问题 ·打不开地址：确认设备与微服在同一局域网、入口类型是「微服物理网卡」、Keues正在运行；端口冲突就换一个端口重建规则。 · 页面一直连不上：服务器地址要和浏览器地址栏一致（含 http协议和端口），如果没有安装微服客户端不要填 heiyu.space 地址。 · 叫号终端要求登录：后台把该窗口的允许用户 / 用户组清空。 · 微服 IP 变了：路由器静态绑定；用了自定义域名的只改一处 DNS。 · 设备开机自动打开：电视盒子 /安卓屏用支持开机自启和全屏的浏览器；Windows 可用 Chrome 的 --kiosk 参数启动。 ## 八、安全说明 转发地址绕过懒猫的登录保护，局域网内任何人都能打开取号机、叫号终端和大屏页面。只用「微服物理网卡」入口，不要在路由器上把该端口映射到公网，现场网络建议与访客Wi-Fi 隔离。管理后台的增删改仍需 Keues 管理员登录。