HandyCafe Docs
it-admin

客户端安装

HandyCafe Client 运行在网吧或电竞馆中每台面向顾客的 PC 上。它通过局域网连接到 HandyCafe Server，执行时段控制、显示应用菜单和处理待机画面。

前提条件

  • HandyCafe Server 已在管理 PC 上安装并运行
  • 客户端 PC 满足系统要求
  • 客户端 PC 与服务端在同一局域网上
  • 您在客户端 PC 上拥有管理员权限

下载

从 HandyCafe 官方网站下载最新版本的 HandyCafe Client。

安装步骤

  1. 运行安装程序。 双击下载的安装文件。
  2. 接受许可协议。 阅读并接受条款。
  3. 选择安装目录。 默认位置适用于大多数场景。
  4. 完成安装。 点击安装并等待过程完成。
  5. 启动 HandyCafe Client。 应用自动启动。

连接到服务端

HandyCafe Client 通过以下两种方式之一连接到服务端：

自动发现（mDNS）

默认情况下，客户端使用 mDNS 在局域网上自动发现服务端。如果服务端正在运行且在同一子网上，客户端会在几秒内连接。

手动连接

如果自动发现不工作：

  1. 在客户端待机画面上，访问客户端设置（需要管理员权限）。
  2. 输入服务端 IP 地址（如 192.168.1.100）。
  3. 输入连接密钥（必须与服务端网络设置中设置的密钥一致）。
  4. 保存并重启客户端。

验证连接

连接成功后：

  • 客户端以空闲 PC 状态出现在服务端的管理面板上
  • 客户端显示服务端配置的待机画面（锁定屏幕）
  • 服务端可以开始时段、截图和控制客户端

客户端命名

默认情况下，客户端以 PC 的主机名命名。可以通过两种方式自定义显示名称：

  1. 自动命名： 在"设置 > 客户端"中，设置前缀如"PC #"。客户端命名为"PC #1"、"PC #2"等。
  2. 手动命名： 在"设置 > 客户端 > 客户端目录"中，编辑单个客户端的显示名称。

批量部署

大规模部署时：

  1. 在一台 PC 上安装并配置客户端。
  2. 使用磁盘映像工具将已配置的 PC 克隆到其他机器。
  3. 或者使用文件同步功能从服务端推送配置。

注意： 每个客户端通过其 MAC 地址识别。如果克隆 PC，请确保每台有唯一的 MAC 地址（物理硬件通常如此）。

连接问题排查

问题 解决方案
客户端显示"正在搜索服务端" 确认服务端正在运行。检查两台 PC 是否在同一子网上。
客户端无法通过 mDNS 找到服务端 手动输入服务端 IP。检查多播流量是否被阻止。
客户端连接后断开 确认服务端和客户端的连接密钥一致。
连接慢或掉线 检查网线、交换机端口和带宽。
防火墙阻止连接 在服务端和客户端 PC 上添加 HandyCafe 的防火墙例外。开放 TCP 5001、5002、5003 和 UDP 5004。

后续步骤