家庭自建部署

更新时间：2026-08-21 14:48:08 阅读：36 收藏：0 收藏
# 家庭自建部署

> **读者**：在家里或内网自己跑 NodeLio 节点的用户。  
> **不包含**：`build.bat` / 源码编译 / 发版上传。请只用官方发布的 **可执行文件**（当前无 Windows「安装向导」setup.exe，解压或下载后直接运行即可）。

---

## 您需要准备

| 组件 | 说明 |
|------|------|
| 同一局域网 | 手机、跑节点的电脑、设备尽量同一网段（避免访客 WiFi 隔离） |
| 常开电脑 / NAS / 工控机 | Windows 最常见；也有 Linux 二进制 |
| **两个程序** | ① `nodelio-server-…` 服务端 ② `mqtt-server-…` MQTT（独立进程，默认可监听 **1883**） |
| 手机 App 或 H5 | 产品页：[https://z-y.site/works/nodelio.html](https://z-y.site/works/nodelio.html) |
| 已刷官方固件的设备 | 蓝牙模组还需至少一台 BLE 网关 |

家庭自建默认部署模式为 **`on_prem`**，**不依赖**公网也能控设备。云平台账号仅在您要用「官方云端」或云端已购授权时才需要。

---

## 推荐拓扑

```text
手机 App ──HTTP/WS──► 家中电脑：nodelio-server（默认端口 8899）
                              │
                              ├─ MQTT(1883) ──► WiFi 设备
                              └─ MQTT ──► BLE 网关 ──蓝牙──► BLE IO 模组
```

服务端与 MQTT **必须都能运行**；启动菜单里可用「环境自检 / 安装托管 MQTT」协助完成。

---

## Windows：下载与首次启动

1. 从官方渠道下载（版本号以页面为准），例如：  
   - 服务端：`https://z-y.site/works/iot-env/nodelio-server-windows-amd64-<版本>.exe`  
   - MQTT：`https://z-y.site/works/iot-env/mqtt-server-windows-amd64.exe`  
2. 把 **服务端 exe** 放到固定目录（路径尽量短、少中文）。  
3. 双击运行 **服务端**。首次会在同目录生成：  
   - `nodelio-server-config.json`（配置）  
   - `devices.db`（设备库，之后会出现）  
   - 可能还有 `nodelio-initial-secrets.txt` 等，请妥善保存、勿公开分享  
4. 按 **启动菜单**（交互窗口）建议顺序：  
   - 用 **环境自检** 检查防火墙等  
   - 在 Redis/MQTT 相关项中 **下载/安装并启动 MQTT**（菜单编号以您当前版本界面为准）  
   - 菜单托管安装时，MQTT 常见落在 **`服务端同级目录下的 server/`**（例如 `…/server/mqtt-server-windows-amd64.exe`），不一定与主程序 exe 并排  
   - 需要时可 **随机生成 MQTT 账号密码**（默认禁止匿名连接）  
   - 选 **继续启动** 进入主服务（MQTT 未就绪时可能无法继续）  
5. 记下电脑局域网 IP，默认业务端口 **`8899`**。  
6. 若希望开机自启：可用菜单里的计划任务 / 启动文件夹方案（会生成先启 MQTT、再启服务端的脚本，如 `nodelio-autostart.cmd`）。

默认 `server.deploymentmode` 为家庭自建（`on_prem`）。不要改成需要平台配额地址的云端节点模式，除非您清楚在做官方节点运维。

---

## 连上手机 App

1. 手机连同一 WiFi。  
2. 打开 App → **应用配置**（设置）。  
3. 若有「云端 / 自定义」切换：选 **自定义**。  
4. 在「服务器域名与端口」填写例如：`192.168.1.50:8899`（系统会自动补 `/api` 与 WebSocket）。  
5. 家庭局域网一般在「协议与 WebSocket」里选 **HTTP**（不要误用 HTTPS，除非您已做反代）。  
6. 保存。探测失败时 App 可能尝试切换协议，以提示为准。  

更细步骤与本节点管理员登录见《App 连接节点》。

---

## 上电自检

1. 电脑浏览器打开：`http://本机IP:8899/api/app/bootstrap`，应返回 JSON。  
2. App 能保存配置；设备列表可刷新。  
3. 完成「本节点」管理员初始化或登录后，能看到并控制至少一台设备。  
4. 有 BLE：网关在线 → App 扫描添加模组 → 可开关。  
5. （可选）断开光猫上行，仅局域网仍可控制。

---

## 安全（家用）

- 设备注册 / MQTT 在家用路径多为**局域网明文**。**不要把 8899、1883 映射到公网。**  
- 需要手机远程用域名 HTTPS 时：在路由器或 Nginx/Caddy **反代**到本机 8899；设备配网仍填 `http://局域网IP:8899`。  
- MQTT 须有账号密码；勿把配置文件、密钥文件发到聊天群。

---

## 备份与换机

定期备份同目录下的：

- `nodelio-server-config.json`  
- `devices.db`  
- 授权 / 密钥相关文件（若有）  

换机：停止两端程序 → 拷贝上述文件到新机同结构目录 → 先 MQTT 后服务端 → 若局域网 IP 变了，在 App 里改域名端口。
评论区
