系统要求

在网吧、电竞馆或电竞中心安装 HandyCafe 前，请确认您的硬件和网络满足以下要求。

服务端 PC 要求

服务端是您的管理工作站。这是运行 HandyCafe Server 以监控和控制整个网吧的 PC。

注意： 如果使用远程桌面和会话录制功能，请为 MP4 录制文件分配额外磁盘空间（根据画质，每小时录制约 50-200 MB）。

Linux 注意： HandyCafe 基于 Tauri v2 构建，在 Linux 上使用 WebKit2GTK。运行应用前必须安装 libwebkit2gtk-4.1 运行时包。支持的发行版包括 Ubuntu 22.04+、Fedora 38+ 及其他提供同等版本 WebKit2GTK 的发行版。

客户端 PC 要求

每台面向顾客的 PC 运行 HandyCafe Client，通过局域网连接到服务端。

注意： 以上仅为 HandyCafe Client 软件的要求。您的 PC 还需要额外资源用于顾客使用的游戏和应用。

网络要求

所有 PC（服务端和客户端）必须在同一局域网（LAN）上。

所需端口

重要提示： 以上是默认端口。可在网络设置中更改。如果更改服务端端口，请更新客户端配置以匹配。

防火墙配置

• Windows 防火墙： HandyCafe 安装时会尝试自动添加防火墙规则。如果自动配置失败，请手动为上述端口添加入站规则。
• macOS 防火墙： 打开系统设置 > 网络 > 防火墙并允许 HandyCafe 的传入连接。或者将上述端口添加到防火墙允许列表。
• Linux（iptables / ufw）： 使用 ufw 时运行 sudo ufw allow 5001:5004/tcp 和 sudo ufw allow 5004/udp。使用原始 iptables 时，添加等效的 INPUT ACCEPT 规则。
• 第三方防火墙： 为服务端 PC 上的 HandyCafe 服务端二进制文件和客户端 PC 上的客户端二进制文件添加例外。
• 路由器/交换机： 纯局域网运行不需要特殊配置。如果有 VLAN，确保服务端和所有客户端在同一 VLAN 上，或路由允许所需端口。

客户端发现

HandyCafe 使用 mDNS（多播 DNS）在局域网上自动发现客户端。要求：

• 所有 PC 在同一子网上
• 多播流量未被交换机或路由器阻止
• 如果 mDNS 不工作（如跨子网），客户端可以手动输入服务端 IP 地址连接

带宽注意事项

拥有 20-50 台 PC 的典型网吧，标准 100 Mbps 局域网足够。如果经常同时对多台 PC 使用远程桌面，推荐千兆以太网。

主机要求

如果管理游戏主机（PlayStation、Xbox 等），主机必须与服务端在同一网络上。每台主机通过其 MAC 地址识别，在主机设置中手动注册。