HandyCafe Docs
it-admin

客户端安装

HandyCafe客户端运行在您的网吧或游戏中心的每台客户电脑上。它通过本地网络连接到HandyCafe服务器，执行会话控制，显示应用菜单，并处理空闲屏幕。

前提条件

  • HandyCafe服务器已安装并在您的管理电脑上运行
  • 客户端电脑符合系统要求
  • 客户端电脑与服务器在同一局域网内
  • 您拥有客户端电脑的管理员权限

下载

从HandyCafe官方网站下载最新版本的HandyCafe客户端。

安装步骤

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

连接到服务器

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

自动发现（mDNS）

默认情况下，客户端使用mDNS自动发现本地网络上的服务器。如果服务器正在运行并在同一子网内，客户端将在几秒钟内连接。

手动连接

如果自动发现不起作用：

  1. 在客户端空闲屏幕上，进入客户端设置（需要管理员权限）。
  2. 输入服务器IP地址（例如，192.168.1.100）。
  3. 输入连接密钥（必须与服务器上网络设置中设置的密钥匹配）。
  4. 保存并重启客户端。

验证连接

连接后：

  • 客户端会在服务器的管理面板上显示为空闲电脑
  • 客户端显示服务器配置的空闲屏幕（锁屏）
  • 服务器可以启动会话、截取屏幕并控制客户端

客户端命名

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

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

部署到多台电脑

对于大规模部署：

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

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

连接问题排查

问题 解决方案
客户端显示“正在搜索服务器” 确认服务器正在运行。检查两台电脑是否在同一子网。
客户端无法通过mDNS找到服务器 手动输入服务器IP。检查组播流量是否未被阻止。
客户端连接后断开 确认服务器和客户端上的连接密钥匹配。
连接缓慢或中断 检查网络电缆、交换机端口和带宽。
防火墙阻止连接 在服务器和客户端电脑上为HandyCafe添加例外。打开TCP 5001、5002、5003和UDP 5004端口。

后续步骤