故障排除
本页面按类别提供常见问题的解决方案。
连接问题
客户端无法找到服务器
症状： 客户端显示“正在搜索服务器”或“未找到服务器”。
解决方案：
- 确认HandyCafe服务器在管理PC上运行。
- 确保两台PC在同一子网（例如，都在192.168.1.x）。
- 检查网络交换机或路由器是否阻止了mDNS。
- 尝试手动连接：在客户端设置中直接输入服务器的IP地址。
- 确认没有其他软件占用服务器的TCP端口（默认：5001）。
客户端连接后立即断开
症状： 客户端短暂显示“已连接”然后返回“正在搜索”。
解决方案：
- 确认服务器和客户端上的连接密钥匹配。密钥在服务器的设置 > 网络中设置。
- 检查网络不稳定性（数据包丢失、线缆问题）。
- 确保服务器未达到其许可PC限制。
- 查看服务器日志中的身份验证失败消息。
客户端在服务器上显示“离线”但PC正在运行
症状： 客户端PC已开机且客户端应用正在运行，但服务器显示其为离线。
解决方案：
- 在客户端PC上，确认HandyCafe客户端确实在运行（检查系统托盘）。
- 检查客户端PC的网络连接（能否ping通服务器）。
- 验证防火墙规则：TCP端口5001-5003在服务器和客户端上必须开放。
- 重启受影响PC上的HandyCafe客户端。
- 如果使用VLAN，确保服务器和客户端VLAN可以通信。
更改网络设置后无法连接
症状： 更改端口或连接密钥后，客户端无法连接。
解决方案：
- 确保客户端更新了新的端口号和连接密钥。
- 更改网络设置后重启HandyCafe服务器。
- 更新防火墙规则以允许新端口。
- 所有客户端必须重新配置为新值。
会话问题
无法在客户端启动会话
症状： 启动按钮被禁用或启动操作失败并出现错误。
解决方案：
- 检查许可证状态。如果处于只读模式，则无法启动新会话。
- 确认客户端状态为“空闲”。会话只能在空闲客户端上启动。
- 检查收银员权限。角色必须具有AUTH_CLIENT_LOGIN权限。
- 确保定价已配置（设置 > 定价必须有有效的小时费率）。
会话计时器显示时间不正确
症状： 显示的时间与实际经过的时间不匹配。
解决方案：
- 检查服务器和客户端PC上的系统时钟。它们应同步（使用NTP）。
- 如果会话已暂停，暂停的时间不计入。
- 对于预付费会话，计时器显示剩余时间而不是经过时间。
会话费用似乎不正确
症状： 收费金额与预期不符。
解决方案：
- 检查定价计划。如果启用，会话可能经过多个定价时段，具有不同的倍数。
- 查看定价设置：基本小时费率、增值税、启动费、四舍五入。
- 检查交易详情中的会话定价段以获取细分。
- 验证支付方式的佣金和固定费用。
- 对于预付费会话，检查“购买时锁定”或“实时计划”模式是否激活。
暂停的会话无法恢复
症状： 恢复操作失败或不可用。
解决方案：
- 确认客户端PC仍然连接到服务器。
- 检查客户端状态显示“暂停”（橙色）。
- 如果客户端在暂停期间断开连接，可能需要先重新连接。
支付问题
支付方式在下拉菜单中缺失
症状： 关闭会话或订单时，预期的支付方式未出现。
解决方案：
- 验证支付方式在管理 > 支付方式中存在。
- 检查支付方式是否处于活动状态（未删除或禁用）。
- 检查收银员权限。必须授予PAYMENT_MANAGE权限才能查看所有方法。
佣金计算似乎不正确
症状： 扣除的佣金与预期费率不符。
解决方案：
- 验证支付方式的佣金率（百分比）和固定费用。
- 佣金公式：佣金 = （收费金额 * 佣金率 / 100）+ 固定费用。
- 检查收银员是否对收费金额进行了手动覆盖。
客户端显示问题
客户端空闲屏幕为空白
症状： 空闲屏幕未显示配置的幻灯片。
解决方案：
- 确认在设置 > 客户端 > 空闲屏幕中启用了空闲屏幕。
- 检查是否至少添加了一个媒体项目（图像或视频）。
- 验证媒体文件是否有效且未损坏。
- 触发同步以将最新设置推送到客户端。
客户端菜单不显示应用程序
症状： 应用启动器为空或缺少类别。
解决方案：
- 验证应用程序和类别在设置 > 客户端 > 内容中已配置。
- 检查类别和应用程序的可见性是否已打开。
- 确认客户端已接收到最新的菜单数据（更改通过TCP自动推送）。
- 如果实时同步未应用，重启客户端。
客户端外观主题未应用
症状： 客户端显示默认外观而不是配置的主题。
解决方案：
- 验证主题设置已保存在设置 > 客户端 > 外观中。
- 触发设置推送到客户端。
- 重启客户端应用程序。
远程桌面问题
远程桌面延迟或卡顿
症状： 视频流延迟、卡顿或帧率低。
解决方案：
- 降低比特率（对于标准LAN使用，尝试1000-2000 kbps）。
- 降低FPS设置。
- 使用有线以太网而不是WiFi。
- 检查网络拥塞或其他应用程序的高带宽使用。
- 确保UDP端口5004未被阻止或限速。
远程桌面显示黑屏
症状： 远程桌面窗口打开但仅显示黑屏。
解决方案：
- 确认客户端在线且响应（尝试先截屏）。
- 检查UDP端口5004是否双向开放。
- 客户端的图形驱动程序可能需要更新。
- 尝试请求关键帧刷新。
无法远程控制鼠标或键盘
症状： 可以看到远程屏幕但点击和按键无效。
解决方案：
- 验证远程管理端口（TCP 5003）是否开放。
- 检查客户端应用程序是否具有适当的系统权限。
- 某些全屏游戏可能会阻止远程输入。
许可问题
许可证显示“offline_grace”
症状： 许可证状态显示offline_grace并有倒计时。
解决方案：
- 恢复服务器PC的互联网连接。
- 检查DNS解析。服务器必须能够访问许可服务器。
- 检查代理或防火墙是否阻止了出站HTTPS连接。
- 您有72小时的时间恢复连接，否则服务器将被锁定。
许可证显示“over_limit”
症状： 连接的客户端数量超过许可证允许的数量。
解决方案：
- 断开未使用的空闲客户端。
- 检查当前客户端数量与您的许可证限制。
- 升级您的许可证以增加PC容量。
- 注意：控制台也计入总PC限制。
许可证显示“expired”或“revoked”
症状： 服务器进入限制模式。
解决方案：
- 检查您的许可证到期日期。
- 通过HandyCafe网站续订您的许可证。
- 对于被撤销的许可证，请联系HandyCafe支持。
常规问题
设置更改未保存
症状： 更改后导航离开设置时恢复。
解决方案：
- 确保在更改后点击保存按钮。
- 检查验证错误（带有错误消息的高亮字段）。
- 确认您具有管理员权限。
审计日志缺少条目
症状： 预期的操作未出现在日志页面。
解决方案：
- 检查日志过滤器。确保选择了正确的类别和日期范围。
- 验证是否授予LOG_DISPLAY_FULL权限（否则仅显示今天的日志）。
- 使用文本搜索字段搜索特定操作。