更新时间：2026-08-21 14:48:08 | 阅读：30 | 收藏：0 收藏 # App 连接节点 > **读者**：使用官方 App 或 H5 的用户。 > **不包含**：HBuilder 打包、源码构建。 应用内入口名称：**应用配置**（下文简称设置页）。 --- ## 开始前 - 家庭自建：节点与 MQTT 已按《家庭自建部署》跑通。 - 官方云端：已在 [产品页](https://z-y.site/works/nodelio.html) 相关渠道购买/开通，并准备好云平台账号。 - **不要**把 `z-y.site` 本身填成 IoT「服务器域名」（那是官网，不是节点）。 --- ## 方式 A：家庭自建（自定义） 1. 打开 **应用配置**。 2. 若出现 **云端 / 自定义** 两个页签：选 **自定义**。 3. 「服务器域名与端口」填写：`192.168.x.x:8899`（示例）。 - 系统自动生成 API（`…/api`）与 WebSocket（`…/ws`）。 4. 展开「协议与 WebSocket」：家用一般选 **HTTP**；WebSocket 多为 `ws://IP:8899/ws`。 5. 保存。保存前会探测节点是否可达。 ### 扫码 / 分享导入 - **扫码**：原生 App 可用；H5 需 HTTPS 页面（本地调试除外）。 - **分享配置**：在已配好的手机上生成带有效期的链接/二维码（需按界面填写管理账号等），他人扫码导入 API、WebSocket，可选带上所有者信息。 - 若目标节点是**云端 SaaS**：手填与扫码会被拒绝，必须用方式 B。 --- ## 方式 B：官方云端 1. 设置页切到 **云端**。 2. 先登录云平台账号（导航栏云图标可进用户中心；未登录会引导登录页）。 3. 点 **一键云端配置**：写入平台分配的 API / WebSocket / 节点信息。 4. 成功后回到首页。不要再对手填覆盖该地址。 --- ## 本节点管理员（owner）登录 连上节点后，设备列表还需要 **本节点所有者** 身份（与云平台登录不是一回事）： | 情况 | 操作 | |------|------| | 新节点（还没有管理员） | 按弹窗 **初始化本节点**：设置管理账号（如手机号）并确认 | | 已有管理员 | 使用已有账号登录本节点（`owner` + 令牌，由 App 保存） | 配网时在设备热点页填写的 **所有者**，一般须与已在本节点登录/初始化过的管理员一致，否则可能注册失败或列表里看不到设备。 **设备绑定码（推荐）**：本节点登录后，在应用配置中可生成有时效的 **8 位绑定码**；配网「绑定账号 / 所有者」栏填该码，注册时会兑换为真实管理员，减少手输账号错误。 --- ## 设备配网（WiFi 模组） 1. **先**在 App 完成本节点管理员登录（见上节）。 2. 设备进入配网热点（名称因型号而异）。 3. 手机连接该热点，打开配网页。 4. 填写家里 **2.4GHz** WiFi、所有者（管理员账号或绑定码）、服务端地址（设备能访问的 `http://局域网IP:8899` 一类）。 5. MQTT 细节多数由注册成功后自动下发，配网页上可能看不到全部字段。 6. 配网完成后回到 App，下拉刷新设备列表。 蓝牙 IO：模组本身不配 WiFi；先保证 **BLE 网关** 在线，再在 App 内扫描添加。云侧设备 ID 一般为 **`BLE-` + 12 位 MAC**（无冒号）。 --- ## 日常入口（简表） | 功能 | 常见位置 | |------|----------| | 开关 / 多路 | 设备详情 | | 定时 / 联动 / 情景 | 设备相关页面 | | 分享节点配置 | 应用配置内分享 | | 配网说明弹窗 | 应用配置相关入口 | | 授权激活 | **隐藏入口**，见《授权激活说明》 | | 服务端升级 | **轻点一次**设置页「服务端版本」前缀（勿连点）；按提示输入 **超级管理密码**（与服务端配置中的超管口令一致，若未改过见首次生成的密钥/说明文件） | --- ## 连不上时 | 现象 | 处理 | |------|------| | 保存失败 / 不可达 | 服务端与 MQTT 是否在跑；IP 端口；防火墙；手机是否同网 | | 必须用官方云端 | 当前是 SaaS 节点 → 用「一键云端配置」 | | 列表空 | 是否完成本节点登录；配网 owner 是否一致 | | 设备离线 | 见《常见问题》 | 评论区
