HandyCafe Docs
owner

如何从零搭建网吧

本指南将带您完成在网吧、电竞馆或电竞中心进行 HandyCafe 全新安装的每个步骤。完成后，您将拥有一台正常运行的服务端、至少一台已连接的客户端 PC、已配置的定价，以及在财务报表中记录了付款的已完成测试时段。

前提条件

  • 用作 HandyCafe Server 的 Windows PC（Windows 10 或更高版本，最低 4 GB 内存）。
  • 至少一台额外的 Windows PC 用作客户端工作站。
  • 连接所有 PC 的本地网络（为了可靠性，推荐使用有线网络）。
  • 有效的 HandyCafe 测试版许可证密钥，首次设置时需要输入。
  • 提前确定好所需的小时费率和货币。

第一阶段：安装和配置服务端

  1. 从您的 HandyCafe 控制台下载最新的 HandyCafe Server 安装程序。
  2. 在您指定为服务端的 PC 上运行安装程序。按照屏幕提示操作，接受默认安装目录。
  3. 启动 HandyCafe Server。首次运行时将自动出现首次设置向导。
  4. 在提示时输入您的测试版许可证密钥。服务端将在线验证密钥并显示您的网吧名称和 PC 限制数量。
  5. 创建管理员账户。输入用户名和强密码。此账户对每项功能都有不受限制的访问权限。
  6. 设置您的网吧名称。此名称将出现在客户端待机画面和报表中。
  7. 点击完成以完成向导。

预期结果： 服务端主窗口打开，显示零已连接客户端的管理面板。您的网吧名称出现在标题栏中。

第二阶段：配置定价

  1. 点击左侧边栏中的齿轮图标打开设置页面。
  2. 导航至定价标签页。
  3. 设置您的基础货币。从货币下拉菜单中选择。所有价格、交易和报表都将使用此货币。
  4. 输入您的小时费率。这是后付费时段的每小时基础价格。例如，输入 10.00 表示每小时十个货币单位。
  5. 设置增值税税率。输入适用于时段费用的百分比（0 到 100）。如果不适用增值税，请输入 0。
  6. 设置起步费。这是无论时段时长如何的每个时段最低收费。如果您不想设置最低收费，请输入 0。
  7. 为常见时长创建定价预设。向下滚动到预设部分。点击添加预设。创建如下预设：
    • "30 分钟"，时长 30 分钟。
    • "1 小时"，时长 60 分钟。
    • "2 小时"，时长 120 分钟。
  8. 点击保存以应用您的定价配置。

预期结果： 定价标签页显示您的小时费率、增值税税率、起步费以及下面列出的所有预设。这些预设将在开始预付费时段时作为快速选择按钮出现。

第三阶段：验证网络设置

  1. 仍在设置中，导航至网络标签页。
  2. 验证监听端口。默认值为 7842。只有在您的网络上的另一个服务使用该端口时才更改。
  3. 设置或记录连接密钥。此密钥对客户端连接进行身份验证。所有客户端 PC 必须使用相同的密钥连接。
  4. 确保服务端 PC 的防火墙允许在配置端口上的入站 TCP 连接。在 Windows 上，HandyCafe 通常在安装过程中会添加此规则。如果您更改了端口，请手动添加新的防火墙规则。
  5. 记录网络标签页中显示的服务端 PC IP 地址。如果客户端无法通过自动发现找到服务端，您将需要此地址。

预期结果： 网络标签页显示监听端口和连接密钥。服务端状态指示灯显示绿色的"正在监听"。

第四阶段：部署第一台客户端

  1. 从您的控制台下载 HandyCafe Client 安装程序。
  2. 在您的第一台客户端 PC 上安装。运行安装程序并按照提示操作。
  3. 启动 HandyCafe Client。客户端将尝试通过 mDNS 在本地网络上自动发现服务端。
  4. 如果自动发现失败，请在客户端连接对话框中手动输入服务端 IP 地址和端口。
  5. 输入您在第三阶段记录的连接密钥。
  6. 等待连接建立。客户端屏幕将切换到待机页面，显示带有时钟的锁屏。

预期结果： 在服务端，管理面板现在显示一台已连接的客户端。客户端方块显示主机名和蓝色"空闲"状态。客户端 PC 显示锁屏。

  1. 服务端将根据客户端的主机名自动分配显示名称。要重命名，请在服务端选择客户端方块并点击重命名。

第五阶段：运行您的第一个测试时段

  1. 在服务端管理面板上，点击空闲客户端方块上的开始。
  2. 在时段对话框中，选择后付费。将会员字段留空，作为访客时段。
  3. 点击确认开始时段。

预期结果： 客户端方块变为绿色，显示向上计数的计时器。在客户端 PC 上，锁屏消失，在线页面桌面出现。

  1. 让时段至少运行 5 分钟，以便您可以验证定价计算。
  2. 点击服务端绿色客户端方块上的结束。
  3. 查看费用明细对话框。它将显示：
    • 时长（例如 5 分钟）。
    • 应用的小时费率。
    • 增值税金额。
    • 总费用。
  4. 选择支付方式（默认为现金）。
  5. 点击确认关闭时段并记录付款。

预期结果： 客户端方块恢复为蓝色"空闲"状态。客户端 PC 再次显示锁屏。系统中记录了一条交易。

第六阶段：在财务报表中验证

  1. 使用左侧边栏导航至财务报表页面。
  2. 确认今天的报表显示一条时段交易。
  3. 验证交易金额与结束时段时看到的费用明细匹配。
  4. 检查支付方式列是否显示"现金"（或您选择的任何方式）。

预期结果： 财务报表列出一条已完成的时段，显示正确的金额、时长和支付方式。您的网吧现在可以正式运营了。

第七阶段：可选后续步骤

基本设置完成后，请考虑配置以下功能：

  1. 添加会员。 导航至会员页面。点击添加创建带有用户名和可选钱包余额的会员账户。会员可以从客户端 PC 登录。
  2. 设置商品。 导航至商品页面。添加带有价格的食品和饮料商品，以便收银员可以创建订单。
  3. 配置客户端菜单。 导航至设置 > 客户端菜单。添加应用分类和应用，让顾客在在线页面看到启动器网格。
  4. 部署更多客户端。 在网吧中每台工作站 PC 上安装 HandyCafe Client。每台都会自动出现在服务端上。
  5. 创建收银员账户。 导航至管理页面。添加具有适当角色的收银员账户，让员工可以登录和管理时段。
  6. 设置高峰/低谷定价。 导航至设置 > 定价排期。创建基于时间的倍率，在繁忙时段收取更高的费用。
  7. 启用 OAuth 登录。 导航至设置 > OAuth。配置 Google 或其他提供商，让顾客可以使用其社交账户登录。

应避免的常见错误

  • 跳过防火墙规则。 如果客户端无法连接，最常见的原因是 Windows 防火墙规则阻止了监听端口。在排查其他问题之前，请验证该规则是否存在。
  • 连接密钥不匹配。 每台客户端上的密钥必须与服务端上的密钥完全匹配。请通过复制粘贴来避免输入错误。
  • 将小时费率设置为 0。 如果将小时费率设为零，所有后付费时段都将免费。正式运营前请务必验证您的定价。
  • 忘记保存设置。 设置页面中的更改在点击保存之前不会应用。如果重启后设置似乎没有更改，很可能是您忘记保存了。
  • 在同一台 PC 上运行服务端和客户端。 虽然技术上可以用于测试，但不建议用于正式运营。服务端 PC 应该是专用工作站。