技术与接入

不绑定硬件,也不绑云

设备只要能发 HTTP,就能接进来。业务层完全自研,数据落在自己的服务器;设备量上来后,设备层可以换成 ThingsBoard CE,业务侧一行不用改。

现场设备按 token 鉴权
环境传感器墒情、温度、湿度、CO₂、pH、溶氧
阀门与执行器电磁阀、水肥一体机
设备模拟器复现上报、告警与灌溉闭环
飞葵业务服务业务层自研
规则与告警8 条阈值规则、去重、自动恢复
灌溉闭环开阀、回执、回升后自动关阀
施药与进销存合规规则与 append-only 台账
使用界面浏览器访问
13 个功能视图桌面与手机浏览器自适应
实时通道SSE 推送遥测、告警、阀门状态
多租户与审计租户硬隔离,关键动作留痕

本机运行形态为 Node 22 + 内置 SQLite 单进程;生产规模化形态为「ThingsBoard CE 设备层 + 飞葵业务后端 + 本品牌前端」。

设备接入

路径和 ThingsBoard 一模一样

设备侧只认 accessToken,不碰登录态。换成真 ThingsBoard 时,设备固件不用改,只需把地址和 token 换掉。

能力接口
遥测上报POST /api/v1/{token}/telemetry
设备属性POST /api/v1/{token}/attributes
指令下发GET /api/v1/{token}/rpc(长轮询)
指令回执POST /api/v1/{token}/rpc/{id}
  • 下发前三重校验:阀门存在、地块有在线执行器、状态合法
  • 网络异常不误判:桥接请求失败不写 FAILED,指令留在队列等重投
  • 回执语义诚实:拿不到真实执行结果时,不谎称已执行
  • 一台设备一条循环:单台掉线不影响其他设备
  • 遥测保留 7 天:按批次清理,避免高频上报拖慢写入

桥接已对仿真 ThingsBoard 做过 31 项联调测试,尚未对接真实 TB 实例;真机联调需在现场完成。

多基地、多租户,数据不串

一套部署可以管多个基地公司。除传感器字典外,所有业务表都带租户标识;请求进来先定租户,仓储层统一取值,漏传也不会跨租户泄露。

27张业务数据表
20个后端权限点
9类 SSE 实时事件
508项自动化测试

租户隔离怎么做的

请求级上下文用 AsyncLocalStorage 挂当前租户,仓储层统一取值。跨租户的查询、修改、删除与指令下发一律返回 404,不靠前端过滤。设备侧按 accessToken 反查归属,设备不需要知道自己属于谁。

实时通道怎么推的

服务端通过 SSE 推送遥测、告警、阀门、指令、地块、农事、病虫害、阈值与快照事件。前端合并进内存状态后节流重绘,用户在输入框里打字时不会被打断。

安全护栏:默认收紧

这些是已经落地的默认行为,不靠部署时记得配。安全护栏不等于渗透通过,正式上线前仍需独立的安全测试。

项做法
静态资源白名单只放行页面、样式、脚本与图片;源码、工具、部署脚本与数据库一律 404
路径穿越先解码再规范化,含 .. 或非法编码直接 404
安全响应头禁止被嵌入、内容类型嗅探关闭、地理定位只允许同源、CSP 不放行任意脚本与内联脚本
接口限流按来源 IP 令牌桶,超限返回 429 并给出重试时间
登录防爆破按「账号 + IP」记失败次数,超限锁定;锁定期内口令正确也先拒绝
账号枚举账号不存在与密码错误返回同一句提示
代理来源默认只信 socket 地址,显式开启后才读转发头,避免伪造头绕过限流
审计阈值变更、地块增改、告警处理、指令下发、合规放行全部留痕

选型与合规,先说清楚

哪些是自己写的、哪些是站在成熟底座上、哪些需要另外授权,一次说明白。

业务层

规则引擎、告警、灌溉闭环、施药合规、进销存、多租户、审计与前端界面,全部自研。本机形态零第三方运行时依赖。

设备层

规模化生产路径采用 ThingsBoard CE(Apache-2.0)。飞葵与它按协议对接,不修改上游代码;本机形态为等价的轻量实现。

外部服务

卫星底图使用腾讯位置服务,需自备 key 并按官方条款使用;未配置时降级为坐标示意图。系统内不内置任何可用 key。

不夸大的部分:未声称已通过等保三级,未声称大规模商用;卫星地图不是测绘成果;AI 能力不在本产品范围内。设备控制的安全最终由现场硬件互锁与操作规程承担。

要接现有传感器?先对一遍协议

只要设备能发 HTTP,就能接。把你现有设备的型号、上报格式和指令方式发来,我们给出接入方案。