维护与故障排查

先判断问题在访问管理页、网关联网、转发、终端入网、数据解析还是外部接收，记录型号、模式、版本、EUI、时间和错误，再改相关配置。

打不开网页或登录失败

先按连接方式排查：

• 网关热点：确认电脑实际连接的是网关热点，在浏览器地址栏输入 http://192.168.188.251。这是固定热点登录地址；电脑提示“无互联网”不等于无法访问管理页。改过热点名称或密码时，按新凭据重连；热点已关闭时，改用局域网入口。
• 路由器局域网：检查供电、网线、DHCP 分配地址或已保存的静态 IP，以及电脑与网关是否可互访。录制现场的 192.168.31.124 不是统一登录地址。

保存配置或重启后，等待网关启动并重新连接相应网络。仍无法访问时，再检查代理/VPN 是否改变本地访问路径；通过访客网络连接时检查设备间隔离。浏览器账户、Wi-Fi、MQTT 和 SSH 凭据分别核对，登录过期时重新登录。

网关在线但没有业务

现象	依次检查
没有射频包	天线/频段、终端供电、区域模板、上行信道
CRC 失败多	信号、干扰、距离和天线，不先改密钥
收包但终端未入网	ABP/OTAA、EUI、密钥、MIC、重复地址、会话计数
有明文无解析	先读终端 deviceType 是否为 0，再核对 FPort、型号、协议版本和解码目录；更新目录不会自动补全手工记录的类型
有本机数据无外部数据	Edge 输出是否勾选、目标服务/端口/认证；Std 的桥接版本与外部 NS
能上行不能下行	A/C、RX1/RX2/Join 延时、频率/SF、NS 下行、队列及终端应用回复

连接测试的含义

MQTT 测试建立实际 Broker 连接，不验证发布/订阅权限及业务下行；Client ID 重复可能影响现有连接。HTTP 测试会向目标 URL 发送 {} 的真实 POST 并要求 2xx，不是假预览；接收端需区分测试体与正式上报。UDP 测试与对应服务交互，不能用成功替代终端业务验收。

高级功能的 Ping需选择目标与网络接口；能够 Ping 不证明 MQTT、HTTP 或 UDP 端口可用。测试对象应为现场允许访问的服务。Std 只读视频未执行这些测试；Edge 实录已完成 MQTT 和 HTTP 测试，Ping 与 UDP 尚未实测。

重启、模式切换与恢复

重启中断当前业务；保存网关配置、模式切换、升级也可能触发重启。恢复出厂可能改变网络、热点、账户和业务配置，不能作为首次连接故障的默认处理。执行前保存所需配置和终端资料，确认恢复连接方法，再按当前界面确认框处理。

固件升级

进入高级功能，使用匹配型号、CPU 架构和版本的正式网关升级包；选择文件后检查名称，再按页面执行。升级不是终端固件升级，也不是解码器更新。保持供电与管理连接稳定，不将任意终端 bin、其他架构包或普通压缩文件当作升级包。

当前界面的进度条按等待时间递增，并非实时上传或安装百分比；收到成功响应后才显示 100%。应以页面结果提示、重启后版本和业务复核为准，不据进度条推算剩余时间。升级完成重新登录，核对版本、模式、网关 EUI、区域、网络、输出、终端列表及真实收包。失败时按具体错误处理，不反复上传不同未知包：

当前程序的提示	处理方式
升级包超过 32 MB、单文件超过 16 MB、解压总大小超过 40 MB	使用维护方提供的适配升级包，不自行拆包或删除文件
内存、临时空间或持久存储空间不足	记录具体提示，按维护方指导释放资源后再升级
升级失败且回滚失败（UPGRADE_ROLLBACK_FAILED）	保持供电，不重启或断电；当前提示说明备份仍在临时内存，联系技术支持处理
文件权限设置失败（UPGRADE_PERMISSION_FAILED）	不要自行重启，联系技术支持检查文件状态

这些限制和提示对应当前配套程序，旧版升级界面可能不同。本轮未执行升级或恢复。

账户与反馈

账户菜单中的修改密码与 Wi-Fi/MQTT 密码分开；修改后确认重新登录方式。反馈提供脱敏配置、完整型号、模式/版本、连接方式、终端型号、FPort/原始载荷与时间、测试结果和接收端日志，去掉账户密码、LoRaWAN 密钥及证书私钥。

按症状定位，保留可复核的结果

故障现象	先查哪里	正常后应看到
保存后原 IP 打不开	局域网查 DHCP / 新静态 IP；热点重连后访问 192.168.188.251	能用当前地址登录，配置读回一致
Wi-Fi 显示连接但业务不通	目标地址/端口、路由、认证	接收端有实际应用请求或 NS 统计
MQTT 能连接但收不到消息	输出勾选、精确主题、开头斜杠、ACL、兼容开关	同一真实上行在本机和应用端对应
HTTP 测试 200、业务仍失败	空测试体与正式 JSON 的区别、格式、接收日志	正式上行有正确 EUI/FPort/原始字节
Std 网关在线但终端没入网	外部 NS 的区域、终端登记、密钥/Join、计数	外部 NS 有有效会话与应用上行
RS485 总为零	终端实际数字序号、N、重启后的新上报缓存	主站原始字节与终端业务对应
网页下发成功但终端无动作	协议命令、FPort、Class/窗口、频率/SF、队列	终端应用回复或实际动作
API JSON 解析错误	HTTP 原文、认证状态、单条查询尾随响应、版本	获得完整预期 JSON，不吞掉解析错误

排查只改与现象有关的一项，保留变更前参数和结果；恢复正常后用实际业务再核对一次，不以 Ping/连接测试代替最终数据验收。