HandyCafe Docs
it-admin

IT 管理员快速入门

本指南涵盖 HandyCafe 的技术部署。完成后，您将完成服务端和客户端的安装、网络配置、应用菜单构建以及远程管理测试。

预计完成时间： 5 分钟（另加客户端部署时间）

步骤 1：安装服务端和客户端

服务端安装：

  1. 确认服务端 PC 满足系统要求。
  2. 在管理 PC 上下载并安装 HandyCafe Server。
  3. 启动服务端并完成首次设置向导以创建管理员账户。
  4. 记录服务端 PC 的局域网 IP 地址。客户端连接时可能需要此地址。

客户端安装（对每台 PC 重复操作）：

  1. 在每台面向顾客的 PC 上下载 HandyCafe Client。
  2. 安装并启动客户端。
  3. 客户端使用 mDNS 发现机制在局域网上搜索服务端。
  4. 如果未自动找到服务端，在客户端设置中手动输入服务端 IP 地址。
  5. 连接成功后，客户端出现在服务端的管理面板中。

提示： 使用服务端的自动命名功能（设置 > 客户端），以"PC #1"、"PC #2"等前缀自动命名客户端。之后可以自定义显示名称。

详情请参阅服务端安装和客户端安装。

步骤 2：配置网络设置

在服务端导航到设置 > 网络。

HandyCafe 使用四个端口进行通信：

端口 默认值 用途
TCP 端口 5001 命令和响应通信
文件端口 5002 服务端与客户端之间的文件传输
远程管理端口 5003 远程桌面流控制
UDP 端口 5004 屏幕流数据

配置：

  1. 设置端口（默认值适用于大多数场景）。
  2. 设置连接密钥。这是用于 HMAC-SHA256 认证的共享密钥。所有客户端必须使用相同的密钥。
  3. 点击保存。

防火墙规则：

确保在服务端和客户端 PC 上都开放以下端口：

  • TCP：5001、5002、5003（服务端入站，客户端出站）
  • UDP：5004（双向，用于屏幕流）

重要提示： 所有 PC 必须在同一局域网（子网）上。HandyCafe 使用 mDNS 进行客户端发现，需要局域网连通性。

详情请参阅网络设置。

步骤 3：设置客户端菜单

客户端菜单是顾客在桌面上看到的应用启动器。导航到设置 > 客户端 > 内容标签页。

  1. 创建分类。 按类型分组应用（如游戏、浏览器、社交媒体、工具）。
  2. 向每个分类添加应用：
    • 设置应用名称和描述。
    • 选择应用类型：游戏、浏览器、链接、文件或应用。
    • 设置可执行路径或启动 URI。
    • 上传图标和可选的海报图片用于应用卡片。
  3. 重新排序分类和应用，使用拖拽手柄。
  4. 切换可见性以显示或隐藏项目。
  5. 点击保存。

变更通过 TCP 实时自动推送到所有已连接客户端。

提示： 使用 IGDB 集成自动搜索游戏元数据和图标。

详情请参阅客户端菜单。

步骤 4：配置待机画面和外观

待机画面（设置 > 客户端 > 待机画面标签页）：

待机画面是顾客在没有活跃时段时看到的界面（锁定屏幕）。

  1. 启用待机画面幻灯片。
  2. 添加图片或视频（PNG、JPG、WebP、GIF、MP4、WebM）。
  3. 设置每个项目的持续时间和转场效果（淡入淡出、滑动、缩放）。
  4. 可选启用时钟叠加层和网吧名称显示并设置自定义颜色。
  5. 点击保存。

外观（设置 > 客户端 > 外观标签页）：

配置顾客在时段期间使用的在线桌面外观。

  1. 选择主题：Neon Arena、Crimson Pulse 或 Emerald Depth。
  2. 选择布局预设：Split Classic、Hero Wide Top、Catalog Wide Bottom 或 Compact Focus。
  3. 配置背景：纯色、渐变、图片或视频，含叠加和模糊设置。
  4. 调整卡片密度（大、中、紧凑）和悬停效果。
  5. 点击保存。

详情请参阅客户端待机画面和客户端外观。

步骤 5：测试远程桌面和截图

验证远程管理功能是否正常：

截图：

  1. 在管理面板上，选择任意在线客户端卡片。
  2. 点击客户端卡片上的截图。
  3. 截图查看器中显示捕获的图像。
  4. 可以下载或刷新截图。

远程桌面：

  1. 选择一张在线客户端卡片，点击远程桌面。
  2. 远程桌面窗口打开，带有实时 H.264 流。
  3. 可以远程控制鼠标和键盘。
  4. 剪贴板同步功能在服务端和客户端之间工作。

注意： 远程桌面使用 UDP 流。如果视频卡顿，请检查网络带宽并确保 UDP 端口 5004 未被阻止。您也可以在流设置中调整比特率（350-25,000 kbps）。

详情请参阅远程桌面和截图。

网络架构概览

服务端 PC（管理端）
    |
    |--- TCP (5001) --- 命令/响应（bincode + HMAC-SHA256）
    |--- TCP (5002) --- 文件传输
    |--- TCP (5003) --- 远程管理控制
    |--- UDP (5004) --- 屏幕流（H.264）
    |--- mDNS ------- 客户端发现（自动）
    |
    +-- 客户端 PC 1
    +-- 客户端 PC 2
    +-- 客户端 PC 3
    +-- ...

后续步骤