部署交付
数据不放在别人家
本机一条命令就能跑起来;正式使用部署在你自己的服务器,浏览器访问。设备层要扩容时再接 ThingsBoard CE,业务与界面不变。
先在本机跑通,再决定怎么上
演示环境不需要 Docker、不需要外部数据库,也不需要联网拉依赖。普通办公电脑就能启动。
1
进入程序目录
把交付包解压到本地目录,目录里包含服务、前端与演示数据。
2
启动服务
node server/index.js,默认监听 127.0.0.1:8787;端口被占用时加 --port=8790。
3
浏览器打开
访问 http://127.0.0.1:8787,用交付时提供的演示账号登录。首次启动会自动生成数据库并写入演示数据。
4
让设备动起来(可选)
另开一个终端执行 node tools/simulator.js --interval=1000 --dry=FK-P02,可看到「墒情下降 → 告警 → 开阀 → 回执 → 回升 → 关阀」完整闭环。
运行环境:Node 22(内置 SQLite),现代版 Chrome、Edge、Safari 或国产浏览器。演示形态无需 Docker、无需 JDK。
正式部署:一台服务器就够起步
单机私有化是最常见的落地方式:Nginx 在前面终止 TLS,业务服务只监听内网,数据落在服务器本地。
- 反向代理:Nginx 终止 HTTPS,SSE 关闭缓冲,转发真实来源地址
- 进程守护:以最小权限账号运行,异常自动拉起
- 数据备份:SQLite 单文件,按计划做快照并异地留存
- 证书续期:自动续期并保留文件验证路径
- 访问控制:管理入口限定来源,面板与业务端口分开
规模化路线:设备层换成 ThingsBoard CE
设备数量大、需要更强的规则链与遥测存储时,用 ThingsBoard CE 承担设备接入,飞葵继续做农业业务层。桥接进程负责协议翻译:指令转 TB RPC,TB 遥测回传飞葵。
TB CE 采用 Apache-2.0 许可,独立部署。官方编排文件已随交付包提供,但尚未在真实环境跑过,上线前需在现场完成联调。
上线前,这几件事必须做完
下面不是建议清单,是交付前的门槛。没做完就跑生产,出问题只能怪自己。
| 项 | 要求 | 状态 |
|---|---|---|
| 默认口令 | 删除或重置全部演示账号,启用强口令与定期轮换 | 交付时完成 |
| 安全测试 | 越权、注入、文件访问、限流绕过等手工渗透 | 建议独立测试 |
| 网络边界 | WAF 或等同防护;管理入口限定 IP | 按现场配置 |
| 数据备份 | 数据库快照、保留策略与恢复演练 | 按现场配置 |
| 施药数据复核 | 持证植保人员复核农药档案、限量值与判定口径 | 上线前完成 |
| 进销存复核 | 持证经营人员复核商品档案、供应商证照与实名口径 | 上线前完成 |
| 地图 key | 商用部署把地图鉴权移到后端代理,按官方条款配置域名白名单 | 按需完成 |
| 硬件安全 | 阀门控制必须有硬件互锁、时长上限与人工复核 | 现场负责 |
边界再强调一次:本产品交付的是软件系统。阀门动作、设备在线状态与告警处理在演示环境均为模拟;真实灌溉、施药与经营行为的安全与合规责任在现场,不在软件。