部署交付

数据不放在别人家

本机一条命令就能跑起来;正式使用部署在你自己的服务器,浏览器访问。设备层要扩容时再接 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商用部署把地图鉴权移到后端代理,按官方条款配置域名白名单按需完成
硬件安全阀门控制必须有硬件互锁、时长上限与人工复核现场负责

边界再强调一次:本产品交付的是软件系统。阀门动作、设备在线状态与告警处理在演示环境均为模拟;真实灌溉、施药与经营行为的安全与合规责任在现场,不在软件。

给一台服务器,我们把环境搭好

说明你的服务器条件、基地数量和要接的设备,我们给出部署方案与上线节奏。