网络设置
网络设置类别配置 HandyCafe 服务端与局域网上所有客户端 PC 之间使用的通信端口和认证密钥。
端口
HandyCafe 使用三个独立端口用于不同类型的通信。所有端口值必须在 1 到 65535 范围内，且不能互相冲突或与服务端上运行的其他服务冲突。
TCP 端口
- 默认值： 5001
- 用途： 服务端与客户端之间的主要命令和响应通信。所有时段控制消息（开始、结束、延长）、状态更新、菜单推送和配置同步通过此端口传输。
- 协议： TCP，使用二进制编码和加密认证。
文件端口
- 默认值： 5002
- 用途： 服务端与客户端之间的文件传输。同步资源管理器功能通过此端口从服务端向客户端 PC 推送文件（游戏更新、配置文件、软件）。
- 协议： 基于 TCP 的分块文件传输。
UDP 端口
- 默认值： 5004
- 用途： 远程桌面功能的屏幕传输。管理员从服务端控制台查看客户端屏幕时，视频帧通过此端口传输。
- 协议： UDP，用于低延迟实时传输。
连接密钥
连接密钥是用于加密认证的共享密钥密码。服务端与客户端之间的每条消息都使用此密钥签名，防止未授权的设备加入网络。
- 所有客户端 PC 必须配置与服务端相同的连接密钥。
- 如果更改服务端上的连接密钥，必须更新每台客户端的配置以匹配。密钥不匹配的客户端将无法认证，不会出现在服务端控制台中。
- 使用强且唯一的密钥。避免默认或容易猜测的值。
重要注意事项
更改端口或连接密钥需要在两端操作：
- 在服务端的网络设置中更新值并保存。
- 重启 HandyCafe 服务端应用。
- 在每台客户端的配置中更新对应值。
- 在每台 PC 上重启客户端应用。
防火墙规则： 确保网络防火墙（包括服务端操作系统防火墙和任何硬件防火墙）允许所有三个配置端口上的入站和出站流量。被阻止的端口将导致客户端无法连接或传输。
局域网要求： 服务端和所有客户端 PC 必须在同一局域网（LAN）上。HandyCafe 使用 mDNS 进行客户端发现，它在单个广播域内运行。不同子网或 VLAN 上的客户端在没有额外网络配置的情况下可能无法被发现。