# FastBee **Repository Path**: Andy986/fastbee ## Basic Information - **Project Name**: FastBee - **Description**: No description available - **Primary Language**: Unknown - **License**: AGPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-06-28 - **Last Updated**: 2026-07-10 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 说明 * 请使用主分支(master/main)拉取代码 * 其他分支开发使用,开发完成后会合并到主分支 # Version 2.8.0 ### 注意事项: * sql脚本有更新,升级前自行考虑是否需要备份数据,数据丢失我们概不负责; ### 新增功能: * 新增JT808通讯协议 * 新增物联网卡管理 * 新增设备维保 * 新增视频url流绑定设备 * 新增天地图 * 新增key参数管理 * 新增菜单打开方式(页签/新窗口) * 设备二维码新增打印功能 * 消息通知新增Http方式推送 * 移动端个人中心新增隐私政策 * 移动端未授权新增提醒 * 可视化大屏新增返回按钮优化卡顿 * 可视化大屏参数配置新增视频选择 * 组态新增变量映射关系 * 组态新增告警记录组件设备类型 * 组态新增动态数据和公共接口两种数据类型 * 组态新增交互点击事件 * 组态类别新增重命名功能 ### 功能优化: * 规则引擎可视化改造完善 * 上报下发设备查询优化为缓存 * 网关与子设备配置改造,支持导入多个子产品、设备 * 网关部分通讯协议改造支持同时上报多个子设备数据; * 单个查询、编辑、删除接口新增数据权限控制; * 优化视频操作流程、视频监控播放地址 * 视频中心-分屏管理新增全屏功能 * 优化场景管理列表基本属性展示 * 接口请求优化,只传修改参数 * 整理老字段枚举替换为字典 * 场景联动样式优化 * 设备数据采集数字显示优化 * svg图库整理、优化图库 * 固定大屏使用echart地图 * 产品应用配置拖拽编辑器代码目录优化 * 优化tcp设备编号生成 * 菜单管理,通用、产品物模型新增翻译配置 * 用户登录新增机构状态校验 * 产品物模型新增导出 * 优化网关子设备同步离线 * 视频点播改用新播放器 * 组态优化下拉框组件 * 组态科学计算组件优化 * 组态优化旋转表盘 * 组态优化组合显示/隐藏 * 组态视频组件单个通道优化 * 移动端优化场景联动关联告警配置 * 移动端优化数据loading * 移动端优化物模型虚拟列表 * 拖拽编辑器代码目录优化 ### Bug修复: * 代码生成模块字典类型默认空修复 * 组态预览被自动缩小修复 * 组态分辨率缩小拖拽会飘修复 * 修复多数据源适配报错 * 固件升级成功更新设备版本号 * 场景联动触发器负数、区间数值匹配失败修复 # Version 2.7.2 ### 注意事项: * 后端java打包部署时需要在application-dev/prod.yml中配置授权证书名称,在license:subject:这配置; * 如果要启用新的获取定位的api,可去后端application.yml中配置自己申请的key,在api:ipplus360Key:这配置; * 组态更新后组态界面里面的点击事件需要重新配置一下; * sql脚本有更新,升级前自行考虑是否需要备份数据,数据丢失我们概不负责; ### 新增功能: * 证书授权简化流程; * web新增工单管理、我的工单、工单邮箱通知、工单日志; * 移动端租户新增我的工单,终端用户新增问题反馈功能; * web端新增app版本安装包管理,热更新; * Tcp传输协议上报下发兼容规则脚本处理; * 视频监控支持rtmp,rtsp代理拉流,支持flv,hls,fmp4等url地址播放; * 代码生成器前端代码生成适配新UI; * 报表新增邮箱通知功能; * 设备分配新增租户内用户分配功能; * 场景联动-告警执行新增消息通知次数配置; * 组态新增数据运算组件; * 组态模型管理3D文件管理; * 组态新增下拉框; * 组态编辑器支持三维属性设置; * 组件单击事件新增脚本; * 组态形状组件增加实体和型体; * 组态取消密码组件整合到点击事件; * 组态页面直接需要可以相互复制; ### 功能优化: * 设备自动定位获取定位接口替换; * 报表管理、报表下载新增租户隔离; * 优化证书上传界面; * 场景管理,优化关联设备逻辑; * 规则脚本新增修改时,必须先验证; * 通知模版新增配置优化显示逻辑; * 固定大屏自适应优化; * 移动端告警处理样式优化、运行状态表盘修复; * 移动端环境配置文件优化; * 优化组态点击事件代码; * 优化组态元件库代码; * 优化组态对齐方式; ### Bug修复: * 修复场景历史数据查询报错; * 修复设备详情重复进入返回会多次订阅; * 修复监控设备通道绑定; * 修复tdengine事件日志时间筛选不生效 * 修复数组类型物模型模板导入失败修复; * 修复ModbusTcpOverRtu协议Tcp连接心跳包解析; * 修复Modbus协议直连设备写功能码上报区分从机地址; # Version 2.7.1 ### 注意事项: * 前端部署项目时需要删除node_modules和package-lock重新install; * 设备详情tab按钮加了权限控制,需重新对角色分配一下权限; * sql脚本有更新,升级前自行考虑是否需要备份数据; ### 新增功能: * web端新增报表功能,支持定时生成历史数据、聚合数据excel表; * 监控语音对讲支持tcp主动方式; * 多数据源适配电科金仓数据库; * 物模型计算公式支持负数、四则运算; * web新增登录信息配置界面 - 个人中心新增“系统风格”; * web端视频录像实现倍速播放; * web产品导入新增json模板文件下载; * web端数据采集历史数据和数据中心-历史记录新增导出功能; * 机构新增邀请码,新用户注册时可填邀请码绑定相应机构; * 移动端小程序更新提示; * 移动端增加子设备列表; * 移动端站内通知支持语音和振动告警; * 组态分辨率适配,新增缩放按钮,移动端可以旋转; * 组态变量选择可回显; * 组态数字面板支持枚举、布尔类型; * 组态数字面板和数据表格可自定义列顺序; * 组态开发和部署环境下的图片共用,增加更多加载; * 组态增加动画设置范围值; * 组态图层管理增加弹框可选删除功能; * 组态数据显示框数据类型和小数点优化; * 组态变量支持模拟数据、变量支持函数运算; * 组态支持pc端和移动端分开设计; * 组态支持分组设计、按钮点击事件增加分组选择; * 组态文字组件新增绑定参数; ### 功能优化: * web设备二维码只允许管理员查看; * 新增机构,角色数据权限跟随当前操作者; * web端设备分享管理员放开操作权限; * 限制终端用户查询自己创建的设备定时; * 监控录像回放优化; * web语音对讲移动到视频界面右下角按钮操作; * mqtt桥接支持高级参数配置; * web地图增加告警状态; * web首页数量统计链接到对应页面; * web所有多选列表分页多选保持之前页选择优化; * web运行状态整数数组物模型支持批量下发; * web表单构建界面样式优化; * web富文本组件新增补丁修复废弃参数报错; * web设备详情tab按钮新增权限控制; * web回收管理-场景管理新增物理删除和还原; * web运行状态物模型设置只读不可以下发; * 组态配置栏和组件配置代码目录结构优化; * 组态优化数据卡度,清除控制台错误; * 组态状态按钮和图片可根据状态颜色填充; * 组态萤石视频包升级; * 移动端用户注销直接删除账号; ### Bug修复: * 网关绑定同一产品的多个子设备,上报数据显示错乱问题; * 设备禁用功能上报状态给前端实时显示; * 修复告警恢复不触发问题; * 修复指令权限校验未获取到机构管理员id问题; * 修复netty版本上报16进制数据规则脚本转换报错; # Version 2.7.0 ### 升级注意 * 此次更新sql比较多,自行考虑,升级前是否要备份数据,数据丢失我们概不负责; * 更新前需要清除 redis 缓存这两个key(device:msg和MODBUS)目录下的所有缓存内容; * tdengine新增数据权限隔离create_by字段,需删除原来超级表,重新建表,想保留原来数据可以把原来数据导出,再插入到新库; ### 新增功能 * 多租户新增数据权限隔离,支持用户层级隔离,兼容组态、音箱; * 移动端、小程序、ios支持视频播放; * 新增ModbusTcp协议,设备作为服务端连接; * 新增Json格式网关协议,支持绑定子设备; * Modbus协议直连设备类型支持多从机地址配置; * 设备运行状态页面支持拖拽配置,在移动端展示; * 规则引擎新增规则列表可视化页面,支持动态配置; * 新增时序数据库InflusDB、IoTDB; * web端增加大屏自动生成接口页面,新增大屏匹配数据接口; * 场景联动新增分组筛选,一键触发功能; * 新增回收管理页面,支持物理删除设备、产品,恢复误删产品设备; * web端首页增加google地图(key需要国外地址) * 大屏更新到最新版本v2.2.9 * 移动端增加蓝牙配网(SDK可以参考文档,根据需求自行扩展),补充所有配网方式的文档 * 设备管理web和移动端增加了筛选和排序 * EMQX升级到5.8.4版本 * 新增支持HTTP协议设备 * 新增支持COAP协议设备 * 统一HTTP,COAP,MQTT认证账号密码 ### 功能优化 * 网关与子设备配置优化,网关与直连设备配置轮询任务; * 设备运行状态、数据采集页面展示优化; * 数据调试json解析协议支持多个物模型同时下发功能; * 组态可以选择多个组件同时修改颜色、大小和高度 * 运行状态对数组、数组对象和对象类型数据进行重置 * 移动端场景选项修改时展示上次的数据 * 移动端设备分享功能、样式、bug 优化修复 * 物模型排序优化,增加了上移、下移、置顶按钮 * 时序数据库时间筛选优化,适配多数据源 * 系统授权问题优化 * http桥接优化 ### Bug修复 * 修复emqx上报hex数据编码错误、json协议上报多余物模型报错; * netty版本修复设备禁用不生效问题; * 组态视频组件、按钮组件、状态按钮、数据面板、面板 bug 修复 * 场景联动设备告警修复可选自己作为告警的问题,告警恢复问题修复 # Version 2.6.0 ### 升级注意 * 产品原来有数组、对象、数组对象类物模型的,升级版本后先取消发布,然后在产品物模型那重新点一下同步按钮更新老数据; * 相关的产品物模型更新完后,如果产品下有设备在场景管理聚合使用的,需要删了重新关联一下; * tdengine新增租户隔离tenant_id字段,需删除原来超级表,重新建表,想保留原来数据可以把原来数据导出,再插入到新库; ### 新增功能 * 设备认证新增http方式接入 * 消息通知新增mqtt方式,系统内告警弹窗通知; * 忘记密码修改功能,租户可配置logo; * 产品新增复制、导入功能; * tdengine历史数据存储新增租户隔离字段; * 移动端可以自定义CRON; ### 功能优化 * web、移动端、组态新版UI升级 * 物模型数组、对象、数组对象类型存储改造,方便二次开发; * 产品固件升级配置优化,设备-数据采集页面重构; * 代码全面升级适配Mybatis-Plus,采用逻辑删除方式; * 数据桥接新增租户隔离,设备事件、功能日志存储优化; * 证书授权,可配置多个区域,认证日志回显; * 组态、音箱跟随主系统2.6版本升级; * web端产品管理和设备管理新增方式优化; * web端系统监控体验感优化; * 字典数据、字典类型新增,系统授权更新优化; ### Bug修复 * 监控设备分配增加通道分配; * 设备录像获取失败修复; * 规则脚本数据库桥接问题修复; * 全面的基础测试,bug修复,具体修复情况可看代码提交记录; # Version 2.5.2 ### 升级注意 * tdengine 超级表字段更新 identity 切换成 identify,需删除原来超级表,重新建表,想保留原来数据可以把原来数据导出,再插入到新库 * 执行 fastbee2.4-upgrade-v2.5.sql 中 “v2.5.2 修改的内容” * 找客服获取授权证书 导入到项目中,才可以访问后台 * 公共库和框架库分离,需要配置gitlab 私钥到maven的settings.xml中 [说明文档 >>](https://fastbee.cn/doc/install/license.html) ### 新增功能 * 支持sqlserver,postgres,oracle,达梦等数据库作为主库 * 新增授权证书功能 * 设备定时支持Modbus协议 ### 功能优化 * emqx版本更新到v5.7.2 * 流媒体目录访问增加秘钥校验 * 统一status字段格式为int * 数据库关键字优化和替换 * 代码升级适配Mybatis-Plus * 组态json导入优化,加保存提示 * 组态保存栅格去除 * 小程序端表盘图层优化 ### Bug修复 * 国际化配置: 补全遗漏的提示信息 * 移动端,运行状态数据模式功能修复 * 终端用户物模型名称显示问题修复 # Version 2.5.1 ### 功能优化 * 动态数据源纳管TDengine * 场景联动支持调试日志 * Mybatis-plus启动配置优化 * 新增Zlmediakit管理后台按钮 ### Bug修复 * 数据桥接mqtt连接复用问题修复 * TDengine中taosKeeper启动失败问题修复 * Zlmediakit镜像构建问题修复 # Version 2.5 ### 升级注意 * 升级前请将2.6版本tdengine数据库的数据清除(将服务器tdengine目录下log文件文件夹以及data目录下的内容删除),然后将项目tdengine目录下conf文件夹和taos-jdbcdriver-3.3.2-dist.jar上传 * Java目录下libtaos.so文件替换。 * zlmedia目录下Dockerfile文件替换 * docker-compose.yml文件替换 ### 新增功能 * SIP支持TCP接入 * 新增Modbus TCP协议接入 * 视频监控语音对讲 * 新增shardingsphere框架,可实现分库分表,读写分离等功能,提高SQL查询效率 * TDengine升级到3.2.2.0版本 * Zlmediakit docker镜像更新,支持WEB后台管理和WEBRTC功能 ### 功能优化 * OTA升级两种方式开发&兼容 * Goview代码更新 * 移动端播放器界面优化,功能完善 * 组态页面初始化数据处理 * Modbus网关产品配置改进 * 多语言:移动端新增功能的国际化,web端的遗漏的国际化和小度音响的国际化 * 系统和UI的改进优化 * HTTP客户端切换forest框架 ### Bug修复 * 播放器销毁报错问题修复 * 告警恢复问题修复 * 系统授权不生效问题修复 ### 文档&测试 * 文档新增:监控设备语音对讲调试和对接 * 稳定性和压力测试

# Version 2.4 ### 1.升级说明 * 网关改版,支持直连和绑定子设备的方式 * 新增场景管理,相当于设备分组,它集合了网关,直连设备,或者单个子设备,可配置录入、运算变量,可绑定组态和监控 * 新增数据桥接,支持Http推送、Mqtt桥接、数据库存储功能,且支持输入、输出侧 * 新增语言国际化,web端、小程序、app均支持多语言,可配置不同的语言 * 新增数据中心,支持对单个设备的数据运行状态展示,也支持对设备多个物模型的历史数据展示 * 设备新增数据采集、数据调试、指令权限功能 * Bug修复和代码优化 * 提示:升级后网关设备不再生效、去除采集点模板,升级前备份好数据

# Version 2.3 ### 1.升级说明 * 多租户改版,重构部门管理、改为机构,以机构维度进行多租户管理 * 机构内可灵活分配角色的权限,支持管理下级机构数据 * 组态、规则引擎、大屏、消息通知、音箱、视频支持租户隔离 * 设备管理新增批量导入设备,可选择设备分配给机构,回收机构的设备,优化设备绑定和分享 * 系统用户隔离,区分为终端用户和租户 * Bug修复和代码优化 * 提示:升级后旧版本部门和租户不再生效,升级前备份好数据

# Version 2.2 ### 1.升级说明 * 增加规则引擎,重构设备告警和场景联动 * 场景联动增加产品触发和指定设备触发、多种触发条件、静默时间和延迟执行,支持物模型的对象和对象数组类型 * 增加规则脚本,支持消息重发,兼容更多设备接入 * 消息通知支持邮箱、腾讯短信和语音、阿里短信和语音、微信、企业微信、钉钉等告警通知方式 * 增加短信登陆 * 产品增加定位方式,创建设备默认继承定位方式,设备可单独修改 * Bug修复和代码优化 * 提示:升级后旧版本告警和场景联动配置不再生效,升级前备份好数据



# Version 2.1 ### 1.升级说明 * Mqtt主题重构,物模型主题统一为接口调用 * OTA升级优化 * Emqx升级到5.1版本 * 支持微信登录 * 增加视频中心模块,包括视频监控分屏显示,录像管理,通道管理和配置管理 * 设备详情优化为懒加载 * 设备分享支持分享设备指定功能属性 * modbus协议兼容01、02、04读功能码,05写功能码 * modbus解析数据类型兼容:位、16位无符号、16位有符号、32位有(无)符号(ABCD/CDAB)、32位浮点数(ABCD/CDAB) * 边缘网关方案兼容 * 修复场景联动/告警触发指令兼容 * 修复影子模式,topic整合 * 设备回复闭环,展示设备下发指令影响详情 * 优化设备上报数据计算、处理、存储 * 平台界面优化改进和bug修复 * 移动端:新增天气预报,微信登陆,优化首页UI布局,完善用户管理 ### 2.Mysql脚本 注意:执行升级脚本前请备份老数据,请仔细查看升级脚本里的注释,不要直接执行 * V2.3升级V2.4脚本:位于项目`/springboot/sql/fastbee2.3-upgrade-v2.4.sql` * V2.4脚本:位于项目`/springboot/sql/fastbee-v2.4.sql` * V2.2升级V2.3脚本:位于项目`/springboot/sql/fastbee2.2-upgrade-v2.3.sql` * V2.3脚本:位于项目`/springboot/sql/其他/fastbee-v2.3.sql` * V2.1升级V2.2脚本:位于项目`/springboot/sql/fastbee2.1-upgrade-v2.2.sql` * V2.2脚本:位于项目`/springboot/sql/fastbee-v2.2.sql` * V2.0升级V2.1脚本:位于项目`/springboot/sql/其他/v2.0-upgrade-2.1.sql` * V2.1脚本:位于项目`/springboot/sql/其他/fastbee2.1.sql` * V2.0脚本:位于项目`/springboot/sql/fastbee-v2.1.sql` * V1.3.1升级V2.0脚本:位于项目`/springboot/sql/v2.0-upgrade-v2.1.sql` ### 3.使用说明 * **Emqx和netty-mqtt服务器切换修改配置** ``` # application.yml文件 # 基于netty的服务器 broker: enabled: true # mqttBroker类型选择, true: 基于netty的mqttBroker和webSocket false: emq的mqttBroker broker-node: node1 # 服务器集群节点 port: 1883 openws: true # 控制webSocket是否开启 websocket-port: 8083 websocket-path: /mqtt keep-alive: 70 # 默认的全部客户端心跳上传时间 # application-dev/prod.yml文件 # mqtt 配置 mqtt: username: fastbee # 账号(仅用于后端自认证) password: fastbee # 密码(仅用于后端自认证) host-url: tcp://177.7.0.12:1883 # 连接 Emqx 消息服务器地址 # host-url: tcp://177.7.0.13:1883 # 内置netty mqtt broker地址 client-id: ${random.int} # 客户端Id,不能相同,采用随机数 ${random.value} default-topic: test # 默认主题 timeout: 30 # 超时时间 keepalive: 30 # 保持连接 clearSession: true # 清除会话(设置为false,断开连接,重连后使用原来的会话 保留订阅的主题,能接收离线期间的消息) ``` * **Emqx配置Http认证和Webhook(处理客户端上下线),有两种方式,一种是通过emqx.conf配置,配置好的文件位于docker/data/emqx/ect文件夹(配置的账号admin,admin123);一种是控制台直接填写:** ``` # Http认证配置 请求方式:POST 请求地址:http://177.7.0.13:8080/iot/tool/mqtt/authv5 (地址可以是内网或者外网,确保能访问) 请求Body: { "clientid": "${clientid}", "password": "${password}", "username": "${username}" } # Webhook配置,先创建数据桥接,然后创建规则,规则跟数据桥接关联 数据桥接名称:fastbee_hook(随意填写) 请求方式:POST 请求地址:http://177.7.0.13:8080/iot/tool/mqtt/webhookv5 (地址可以是内网或者外网,确保能访问) 请求Body: {"clientid" : "${clientid}","event" : "${event}"} 规则名称:fastbee_rule SQL编辑器内容(分别代表客户端连接/断开连接/主题订阅完成): SELECT * FROM "t/#","$events/client_connected", "$events/client_disconnected", "$events/session_subscribed" 动作:选择创建的数据桥接fastbee_hook ``` * **录像管理需要打包后端的fastbee-record模块,放置打包文件fastbee-record.jar到服务器的\var\data\zlmedia\record目录下**



# Version 2.0 ### 1.升级说明 * 新增基于Netty的Mqtt消息服务器,通过配置选择使用Emqx或netty-mqtt * 新增网关支持Modbus等协议 * 物模型中的枚举类型增加按钮展示方式,支持字符串 * 新增Modbus设备模拟器,需要使用netty-mqtt ### 2.Mysql脚本 * V2.0脚本:位于项目`/springboot/sql/fastbee-v2.0.sql` ### 3.使用说明 * 后端新增dev和prod配置文件,application.yml文件中修改spring/profiles/active值切换,dev=开发环境,prod=生产环境 ``` # Spring配置 spring: profiles: # 环境配置,dev=开发环境,prod=生产环境 active: prod ``` * 后端新增基于netty的mqtt消息服务器,application.yml文件中修改server/broker/enabled值,true=基于netty的mqttBroker和webSocket false= emq的mqttBroker ``` server: # 基于netty的服务器 broker: enabled: false # mqttBroker类型选择, true: 基于netty的mqttBroker和webSocket false: emq的mqttBroker broker-node: node1 # 服务器集群节点 port: 1883 websocket-port: 8083 websocket-path: /mqtt keep-alive: 90 # 默认的全部客户端心跳上传时间 ``` * docker部署默认安装JDK、Nginx、Redis、Mysql、Emqx、ZLMediakit、TDengine容器



# Version1.3.1 ### 1.升级说明 * 重要:请勿直接在生产环境中升级,测试后再用于生产环境 * 重要:移动端需3月中旬完成对应升级 * 物模型新增对象类型和对象数组类型,用于支持子设备和物模型分组 * 物模型的数组类型改为:integer(替换int)、decimal(替换double)、string、object * 物模型删除is_top(置顶),增加is_readonly(只读)和order(排序) * 告警/定时/场景联动暂不支持对象类型、对象数组类型和数组 * 设备列表页面简化,删除物模型,提高页面加载速度 * 视频监控整合到产品和设备里面 * 增加视频配置菜单,动态配置流媒体服务器和批量生成设备通道 * 视频监控支持直播、云台控制、录像回放 * 视频监控使用开源的播放器,移动端测试完成后会购买对应商业版本播放器使用 * 其他细节优化 * [查看演示站点](https://iot.fastbee.cn/) ## 2.Mysql脚本(使用升级脚本,请先备份Mysql数据) * V1.3.1脚本:位于项目`/springboot/sql/fastbee-v1.3.1.sql` * V1.3升级V1.3.1脚本:位于项目`/springboot/sql/v1.3-upgrade-v1.3.1.sql` ## 3.视频监控配置 application.yml文件中可设置enabled:true启用视频监控功能 ``` # sip 配置 sip: enabled: false # 是否启用视频监控SIP,true为启用 ip: 177.7.0.13 # 默认为容器IP,做了内网端口映射,设备接入时填写部署服务器公网IP port: 5061 # SIP端口(保持默认) domain: 3402000000 # 由省级、市级、区级、基层编号组成,参照GB/T 2260-2007,(可保持默认) id: 34020000002000000001 # 同上,另外增加编号,(可保持默认) password: 12345678 # 监控设备接入的密码 ```



# Version1.3 ### 1.新增功能 * 设备自定义告警 * 场景联动控制 * 设备物模型值(设备状态),重新存储到Redis(物模型和物模型值分别在Redis的TSL和TSLV命名空间下) * 视频监控接入 * 物模型增加只读属性,新增时设置默认值 * 产品发布后,取消发布,不需要删除产品下设备 * [集成go-view可视化平台 >>](https://wumei.live/commercial-license/wumei-smart-view) ## 2.Mysql脚本(使用升级脚本,请先备份Mysql数据) * V1.2升级V1.3脚本:位于项目`/springboot/sql/v1.2-upgrade-v1.3.sql` * V1.3脚本:位于项目`/springboot/sql/fastbee-v1.3.sql`