网络接入与验证
ZundaLink 机台的网络接入方式由管理员根据场所网络、机台版本和授权范围提供。本文只说明使用者能够观察和验证的步骤，不提供内部地址、私有映射或系统文件内容。
两种常见接入方式
预配置网络设备
管理员提供已经配置好的路由器或网络设备时：
- 确认设备电源、网线和上游网络均正常；
- 按管理员标记连接机台，不要交换端口；
- 等待网络设备完成启动；
- 再启动机台并观察健康状态；
- 完成一次二维码登录和数据读取。
这种方式适合首次安装和需要稳定回滚的场所。不要自行重置设备或修改管理员未说明的设置。
机台直连
部分已完成配置的机台可以直接接入场所网络：
- 确认管理员明确允许直连；
- 让机台正常关机后再更换网络连接；
- 启动后等待完整的网络检查；
- 用网页、登录和记录上传三项交叉验证；
- 如果状态图标与实际登录结果矛盾，以健康检查和实际请求结果为准。
首次验证清单
浏览器侧
- ZundaLink Web 可以打开；
- Token 验证成功；
- 二维码页面可以生成一次性访问码；
- 配方页面能够读取当前账号可见项目。
机台侧
- 健康页显示在线或最近上报时间更新；
- HTTP/TCP 检查没有持续失败；
- 订单进度能够变化；
- 普通用户可以完成登录和退出；
- 游玩记录、相片和缓存操作没有新增错误。
只显示灰色网络图标怎么办
灰色图标可能是展示状态、采样延迟或实际网络异常。请按以下顺序排查：
- 刷新健康数据；
- 检查最后上报时间；
- 观察 HTTP/TCP 检查失败项；
- 完成一次最小化登录测试；
- 检查路由器和上游网络；
- 保存错误信息后联系管理员。
不要因为灰色图标就连续切换网络、重启或清理订单。
DHCP 没有给机台分配地址
聊天经验中出现过“机台有网但 DHCP 没有地址”“网页能打开但机台连不上”的分离故障。先区分物理链路和地址分配：
- 检查机台网线是否接在管理员指定的 LAN 口；
- 确认路由器端口灯、机台网卡灯和路由器电源；
- 查看路由器是否仍启用 DHCP，以及地址池是否已耗尽；
- 只重启网络设备或机台中的一项，并记录结果；
- 获取到地址后再验证网页、健康检查和登录。
不要把机台固定地址、路由器管理密码或完整网络文本发送到公开群。若 DHCP 恢复但健康检查仍失败，再按 HTTP/TCP 检查结果区分服务问题。
每天固定时段短暂掉线
历史群聊中有人观察到凌晨维护窗口会出现短暂掉线。当前页面可能把这类状态显示为最后上报时间变旧或网络图标变灰。先等待维护窗口结束并刷新一次；如果超过窗口仍未恢复，再按电源、路由器、健康检查和登录四项顺序排查。
更换网络设备
更换前：
- 下载账号缓存；
- 截图保存健康状态和当前版本；
- 记录端口、设备名称和连接时间；
- 准备恢复 U 盘。
更换后：
- 先只验证网络，不要同时更新版本；
- 确认稳定后再读取配方；
- 最后进行登录、记录和相片验收。
不要做的事情
- 不要把私有网络文本发布到公开群组；
- 不要把多个场所的网络设备混用；
- 不要在机台忙碌时拔插网络设备；
- 不要同时修改路由器、机台配方和订单；
- 不要把 Token、二维码或恢复介质上传到公共网盘。