网络接入与分层诊断
网页、机台、上游网络和服务检查可能在不同时间返回不同结果。本页提供不改配置的诊断顺序，避免把网络问题、配方问题、订单问题和浏览器缓存混在一起。
四层模型
| 层 | 观察对象 | 能证明什么 |
|---|---|---|
| 物理/链路 | 电源、网线、接口、链路灯 | 设备是否连接到上游 |
| 网络路径 | 本地地址、网关、HTTP/TCP | 某条路径是否可达 |
| 机台上报 | 健康时间、在线状态 | 机台最近是否成功上报 |
| 应用会话 | Token、登录、只读数据 | 服务和账号是否能实际使用 |
一层成功不等于四层都成功。例如 TCP 可达不代表登录有效，网页能打开也不代表机台已经完成订单。
只读诊断顺序
- 记录当前时间和时区；
- 检查电源和物理链路；
- 读取网页健康页；
- 记录最后上报时间；
- 展开 HTTP/TCP 检查；
- 验证网页 Token；
- 发起一个只读数据请求；
- 刷新订单/缓存状态；
- 比较两次读取结果。
在这组证据完成前不要修改 Hosts、代理、路由器和配方。
在线图标的含义
在线图标通常是最近一次上报快照。它可能滞后，也可能只代表上报服务可达。判断时同时看：
- 最后上报时间是否新；
- 当前网页刷新是否成功；
- HTTP/TCP 检查是否成功；
- 机台是否能完成最小登录；
- 订单进度是否变化。
网页离线但机台仍可用时，先等待一个采样周期再刷新，不要立即重启。
HTTP 检查
成功项可以记录延迟；失败项记录检查名称和非敏感错误摘要。延迟高不一定失败，失败也不一定永久不可用。多个检查同时失败更像网络路径问题，单项失败要看该服务是否确实被当前流程使用。
不要把检查名称直接当成修复命令，也不要将完整地址粘贴到公开群组。
TCP 检查
TCP 成功只表示端口层连通：
- 应用层可能仍拒绝请求；
- Token 仍可能过期；
- 内容和订单仍可能处于等待；
- DNS/代理/证书问题可能在更高层发生。
TCP 失败时先看物理链路、网关和上游网络；不要先改服务 JSON。
网页能打开、机台不能用
分步验证：
- 网页 Token 验证；
- 机台健康刷新；
- 机台最后上报；
- 机台本地登录；
- 只读记录/缓存；
- 订单状态。
网页成功只证明网页请求到达服务，不代表机台已经收到或完成动作。页面取消通常停止浏览器等待，不保证撤销机台动作。
网页和机台都失败
先检查公共因素：电源、物理链路、网关、上游网络和服务状态。一次只改一个变量，并在每次变更前保存原值。网络恢复后不要连续重启，先完成 Token 和只读数据验收。
DNS/代理/自定义服务地址
自定义地址只有在页面明确允许且管理员已确认时使用。修改前记录：
- 原地址类别；
- 当前账号/机台别名；
- 修改时间；
- HTTP/TCP 结果；
- 是否需要重启。
不要在地址中写入凭据，也不要用群聊旧截图中的地址替换当前公告。
Hosts 文本
Hosts 编辑属于高风险配置：
- 先获取并离线备份当前内容；
- 只修改管理员明确指定的行；
- 保存后等待结果；
- 刷新健康和登录；
- 异常时恢复已验证备份。
本文不提供具体域名、地址或内部映射。反馈时只描述“哪一类检查失败”和时间，不贴原文。
网络恢复后的验收
- [ ] 物理链路稳定；
- [ ] 网关检查正常；
- [ ] 健康页有新上报；
- [ ] HTTP/TCP 检查结果已记录；
- [ ] Token 验证通过；
- [ ] 只读记录或缓存可读取；
- [ ] 订单进度有明确状态；
- [ ] 必要时完成一次登录退出；
- [ ] 没有同时改动配方和订单；
- [ ] 临时日志已脱敏。
网络反馈模板
text
机台/账号别名：
发生时间/时区：
物理链路：
网页是否可打开：
Token 验证：
最后上报时间：
HTTP 检查摘要：
TCP 检查摘要：
只读请求：
订单状态：
已尝试动作：不要加入完整 IP、网关、代理密码、Token、二维码、Hosts 原文或完整服务 JSON。