更新时间：2026-08-21 14:48:08 | 阅读：32 | 收藏：0 收藏 # 常见问题 > **读者**：安装与使用排障。 > 提工单请附：现象、大概时间、家庭自建还是官方云端、App 提示原文。**不要**粘贴授权密钥、MQTT 密码、设备密钥全文。 --- ## 节点与 App ### 保存配置失败 / 节点不可达 - `nodelio-server` 与 `mqtt-server` 是否都在运行（菜单安装的 MQTT 常在 `…/server/` 子目录）。 - 手机是否同一局域网（访客 WiFi 常隔离）。 - 「服务器域名与端口」是否写成 `IP:8899`；家庭场景协议是否为 HTTP。 - Windows 防火墙是否拦截。 - 电脑浏览器访问 `http://本机IP:8899/api/app/bootstrap` 是否有 JSON。 ### 提示必须用「官方云端」 当前地址是云端（SaaS）节点：请用设置页 **云端 → 一键云端配置**，不要手填或扫码覆盖。 ### 把 z-y.site 填进服务器域名 官网不能当 IoT 节点。自建请填家里电脑 IP；云端请用一键配置。 ### 设备列表是空的 - 是否完成本节点 **管理员登录 / 初始化**（与云平台登录不同）。 - 配网前是否已用该管理员登录过节点；所有者栏是账号还是 **绑定码**。 - 配网时填写的所有者是否与当前登录一致。 - 是否连错了一台旧电脑上的节点。 ### 服务端升级提示要密码 轻点「服务端版本」会走升级流程，需填写配置里的 **超级管理密码**。连点约 10 次才是授权窗口，二者勿混淆。 --- ## 设备离线 / 控不动 ### WiFi 设备 OFFLINE - 设备与 MQTT 是否同网；MQTT 进程是否在听 1883。 - 是否改过 MQTT 密码但设备未重新配网。 - 路由器 AP 隔离。 - 按该型号说明重新配网。 ### 能看见但开关无反应 - 详情是否显示在线。 - 接线与共地（见接线文）。 - 多路是否点错通道。 - 所有者是否被平台封禁（少见；表现为无权限）。 ### 蓝牙 IO 异常 - BLE 网关是否在线。 - 手机是否正用其它 App 连着模组（会与网关抢连）。 - 是否已在 App 扫描添加（列表里多为 `BLE-` 开头的设备 ID）。 - 距离与供电。 --- ## 配网 - 多数模组只要 **2.4GHz** WiFi。 - 配网时建议临时关闭手机移动数据。 - 服务端地址填设备能访问的局域网地址。 - 重置方式以模块说明书为准；重置可能清空 WiFi 与节点配置。 --- ## 授权 ### 找不到「授权激活」菜单 这是隐藏入口：在 **应用配置** 页对 **服务端版本** 一行前缀 **连点约 10 次**。详见《授权激活说明》。 ### 无法再添加设备 - 是否已激活；是否达到套餐设备上限。 - 官方云端：是否用购买时的同一云账号完成一键配置。 ### 联网激活失败 - 电脑或手机能否访问外网。 - 授权是否绑在另一台电脑 → 先解绑。 - 是否过期。 --- ## 提交问题前可附 - 家庭自建或官方云端 - 服务端版本（设置页可见）与 App 版本 - 设备在 App 中的中文类型名 - 报错原文或打码截图 - 是否已用浏览器测过 `/api/app/bootstrap` 评论区
