版本更新记录
信息
本页面记录 ThingsGatewayRuntime 的版本更新历史。
文档站点更新 (2026-07-03)
操作手册
- 完善 GatewayRuntime Web、Studio Web、Watchdog Web 操作手册,覆盖登录、总览、采集配置、数据转发、调试、报警、规则、脚本、节点、证书、日志、用户、角色和系统设置。
- 补充配置弹窗、配置抽屉、参数说明、操作截图和常见故障处理,便于用户按页面完成日常配置与运维。
- 补充 Studio 工程管理、Watchdog 连接、项目上传与下载、备份、隧道和运行参数相关说明。
v2.1.33 (2026-07-24)
新增
- Studio 与 Watchdog HTTP IP 远程管理
- Studio 和 Watchdog 随包配置支持监听全部网卡,可直接通过
http://设备IP:5100和http://设备IP:6200登录;远程初始化、Watchdog 工程部署和进程控制同步支持已启用的远程管理场景。 - 普通 HTTP 仍不提供 TLS 传输保护,公网或不可信网络应继续使用 HTTPS,并限制管理端口的网络访问范围。
- Studio 和 Watchdog 随包配置支持监听全部网卡,可直接通过
优化
-
Studio 与 Watchdog 当前认证协议
- 登录和首次初始化密码统一使用两分钟有效、只能消费一次的 RSA-OAEP-SHA256 公钥挑战;Watchdog 管理接口改用八小时不透明 Bearer 会话,登出或 Watchdog 重启后会话失效。
- Studio 连接 Watchdog 时同样使用一次性密码挑战和 Bearer 会话,并在 Watchdog 重启导致会话失效时自动重新登录和重试。
-
部署、操作与接口文档
- 中英文文档补充 Studio/Watchdog HTTP IP 配置、认证接口、会话规则、安全边界和
importKey、401、403、挑战过期等故障排查说明。
- 中英文文档补充 Studio/Watchdog HTTP IP 配置、认证接口、会话规则、安全边界和
修复
- 普通 HTTP IP 页面登录
- 修复 GatewayRuntime、Studio 和 Watchdog 通过普通 HTTP IP 打开时,浏览器缺少
SubtleCrypto而导致importKey读取失败、无法登录的问题;当前前端可使用浏览器强随机数完成 RSA-OAEP-SHA256 密码加密。
- 修复 GatewayRuntime、Studio 和 Watchdog 通过普通 HTTP IP 打开时,浏览器缺少
v2.1.32 (2026-07-23)
新增
-
双机热备身份、安全链路与共享仲裁(升级须知)
- 双机热备新增冗余组、本机节点和期望对端节点身份校验,可选双向 TLS,以及基于两台网关共享 SQLite 文件的工作授权。页面同步展示本机角色、对端身份、采集、数据转发、报警、规则引擎、链路与仲裁状态。
- 升级后,启用双机热备时必须为两台网关填写相同的冗余组名称、彼此不同的本机节点名称,并将对端节点名称互相对应。共享仲裁文件留空时仍是仅链路主备,网络分区可能双活;TLS 的本机连接证书、信任根证书和对端证书主机名必须全部填写或全部留空。
-
历史数据与历史报警双库镜像
- 历史数据和历史报警目标可同时写入主库与备用库,并通过 Journal、积压状态、时间范围对比、双向补齐、定时一致性检查和自动修复维护两库一致性。
- 双库镜像仅支持 SqlServer、MySql、Sqlite、PostgreSql 的标准表写入;QuestDB、TDengine、自定义 SQL、历史表脚本和历史报警表脚本不支持。主库和备用库必须是不同物理目标,该能力与双机热备的历史补偿相互独立。
-
历史查询与 MQTT 历史 RPC
- 新增带 UTC 时间范围、变量集合、分页和白名单排序的类型化历史查询,以及 Auto、Raw、Average、Minimum、Maximum、First、Last 等数值序列模式和点数限制。
- MQTT 客户端与 MQTT 服务端生产者新增
RpcHistory历史查询主题,支持目标、记录、数值序列、报警、确认和取消等请求,并通过 gzip、Base64 分块及请求、响应、并发限制保护运行时。
优化
-
Modbus 主站打包规则(升级须知)
- 原单一“最大打包长度”配置已替换为 FC1、FC2、FC3、FC4、FC15、FC16 六项独立数量上限,并在单变量读取量或批量写入量超过限制时提前返回校验错误。升级后应打开每个 Modbus 主站设备检查六项打包规则,不要假设旧
MaxPack数值会自动映射。
- 原单一“最大打包长度”配置已替换为 FC1、FC2、FC3、FC4、FC15、FC16 六项独立数量上限,并在单变量读取量或批量写入量超过限制时提前返回校验错误。升级后应打开每个 Modbus 主站设备检查六项打包规则,不要假设旧
-
证书与管理接口统一(升级须知)
- 证书管理迁移到 TAdmin 统一模块,Web 页面入口保持不变;旧
/api/gatewaycertificatecontroller/...已替换为/api/certificatecontroller/...,动作名称和权限码同步调整,外部 API 集成需要迁移。
- 证书管理迁移到 TAdmin 统一模块,Web 页面入口保持不变;旧
-
数据转发与规则流程配置可靠性
- 增强转发组、目标、变量范围、插件属性和主备目标拓扑校验,配置变化后可定向重启受影响对象,并避免旧积压按新配置误投递或主备权威状态丢失。
- 规则流程名称新增长度、非法字符、保留名和大小写无关唯一性校验;多人同时编辑时使用版本检查阻止后保存者静默覆盖。
-
实时状态与页面交互
- 实时状态和调试消息按等价订阅分组,增加订阅上限、有界队列、防重入、重连退避和过期响应保护,改善大点表、频繁切页和连接波动时的稳定性。
修复
-
SQLite 配置数据库备份
- 修复 WAL 模式下直接复制数据库文件可能遗漏已提交记录或依赖
-wal、-shm伴随文件的问题;备份改为可独立打开、包含 WAL 已提交数据的一致性单文件快照。
- 修复 WAL 模式下直接复制数据库文件可能遗漏已提交记录或依赖
-
历史、转发与主备运行恢复
- 修复部分目标重启、缓存补发、主备切换和运行态恢复过程中状态不完整、积压归属错误或任务恢复不一致的问题。
v2.1.22 (2026-07-14)
新增
-
历史可靠同步诊断
- 系统设置的网关冗余页面新增历史可靠同步诊断,可查看目标支持状态、Journal 状态、Epoch 租约和 Journal 事件,并支持按目标键、来源节点、记录类型、记录唯一键、待 Peer 和待 DB 状态筛选。
-
TCP 客户端备用远程地址
- 采集通道新增 TCP 客户端备用远程地址配置。主远程地址连接失败、断开或响应超时后,同一通道可自动尝试备用地址,降低单条 TCP 链路故障对采集的影响。
优化
-
历史数据与历史报警冗余可靠性
- 历史数据和历史报警的标准 SQL 写入链路增强为 Journal、Peer ACK、DB Epoch 租约和记录唯一键协同处理,提升主备切换、短时断链、数据库短时不可用和运行时重启后的补写与去重能力。
-
数据转发运行态可观测性
- 数据转发详情增强插件运行态、在线状态、可靠历史标签、Journal 目标键、不支持原因和 CacheDB 出站队列诊断,便于定位目标启动失败、离线缓存积压和历史可靠同步状态。
-
离线缓存与失败重试
- 优化 CacheDB 出站队列、内存队列、重试保留和恢复补发流程,运行态可直接观察模型数、积压数量、最早积压时间和异常信息。
修复
-
历史写入一致性
- 修复主备切换、重启恢复或短时离线场景下历史数据、历史报警可能重复写入或漏补写的问题,标准 SQL 目标可通过记录唯一键进行幂等写入。
-
目标运行状态恢复
- 修复部分数据转发目标在缓存补发、重试或运行态刷新后状态不清晰的问题,减少目标已恢复但页面难以判断真实运行状态的情况。
v2.1.20 (2026-07-12)
新增
-
变量引用追踪
- 变量详情新增“引用”信息,可汇总变量在数据转发组/目标、规则流程、脚本和变量表达式中的引用,并支持跳转到对应数据转发组、转发目标或规则流程,便于改点、删点前确认影响范围。
-
二开与插件文档
- 文档站新增采集插件、业务插件、脚本开发和自定义节点开发说明,补充插件属性参考、生命周期、参数模型、示例代码和排障清单,方便集成和项目二开交付。
优化
-
数据转发配置体验
- 数据转发页面改为可拖动分栏,组/目标列表更紧凑,并支持通过链接参数定位指定转发组或转发目标,变量引用页面跳转后可直接查看相关配置。
-
网关系统设置安全性
- 网络、系统时间和 NTP 配置改为参数化执行系统命令,增加输入校验、超时和提权写入处理,降低特殊字符或异常命令导致配置失败的风险。
-
权限与调试接口
- Gateway、插件和 NOAOT 插件调试接口统一使用权限常量和种子数据,减少升级后页面按钮可见但接口无权限的情况。
-
Studio 与 Watchdog 交付可靠性
- Watchdog 支持启停健康检查配置、密码哈希保存、项目包安全解压、临时文件下载和应用失败后的回退快照;Studio 项目上传、下载和启动安全校验同步增强。
-
文档站点
- 重写当前操作手册为入口索引和常用任务路线,补充数据采集、内存计算、数据转发、规则、脚本、插件和权限等专题说明,并刷新 GatewayRuntime 页面截图。
修复
-
网络与时间配置
- 修复 Linux 网络配置中 DNS、默认路由和子网掩码处理不稳的问题,并优化 Windows/Linux 时间同步配置,减少因命令拼接、格式错误或服务状态导致的失败。
-
项目包处理安全
- 修复 Studio/Watchdog 上传或解压项目包时可能受异常路径、过大文件或临时文件残留影响的问题。
v2.1.9 (2026-07-08)
新增
- TAdmin 统一管理模块
- GatewayRuntime 接入共享 TAdmin 管理模块,用户、角色、菜单、按钮权限和审计日志由统一模块承载,网关侧提供默认菜单、角色和按钮权限种子数据。
- Gateway Web 引入 TAdmin 前端插件,管理菜单按
/gateway-workspace挂载,系统管理能力与网关工作台路由保持一致。
优化
-
网关权限与日志配置
- 后端启动时注册 Gateway 菜单挂载、菜单路由、角色和按钮权限,并同步 WebApi 权限目录,减少升级后按钮或插件调试接口缺少授权的情况。
GatewayLogOptions聚焦网关运行日志,后端、操作、SQL 和审计日志保留策略拆分到AdminLogOptions,日志配置边界更清晰。
-
数据转发运行恢复
- 数据转发目标初始化或启动失败后会按 30 秒间隔自动重试,并优先恢复最久未尝试的失败目标;恢复后会重新启动组级数据生产循环,减少临时故障后的人工重启。
修复
-
冗余设备变量配置
- 保存通道/设备变量、变量导入和批量编辑变量时会将变量配置归一到主配置设备,避免冗余设备场景下变量误挂到备用设备导致采集、转发或查询结果不一致。
-
调试与转发权限
- 补齐 CAN、OPC、IEC61850、SOE、ZeroMQ 和 SyncBridge 强制同步等调试/转发维护接口的默认权限,避免角色已授权页面操作但接口仍被拦截。
v2.1.5 (2026-07-05)
优化
- 采集配置资源列表
- 采集配置左侧设备列表改为按通道分组,通道标题下展示插件名称、插件提示和通道地址摘要,设备行直接展示主/备角色与在线状态,未配置冗余时不再显示无效占位。
- 编辑通道时会按当前通道第一个设备的插件筛选可选通道类型;新增通道或插件没有匹配结果时保留全部通道类型,减少通道类型选择错误。
修复
-
冗余设备与变量查询
- 修复编辑已有冗余设备时备用设备候选列表为空的问题,当前设备已配置的备用设备会保留在下拉列表中。
- 修复按设备、通道或插件查询变量时,备用设备数据未按主配置设备归并的问题,采集配置和变量状态查询在冗余场景下结果更一致。
-
插件与通道类型
- 修复插件名包含多余空格或插件不存在时通道类型查询结果异常的问题,无法按插件获取通道类型时会回退到全部通道类型。
v2.1.3 (2026-07-04)
新增
-
数据转发批处理
- 数据转发组新增“整个转发组作为一个批次”的批处理模式,便于按转发组统一组织周期快照。
-
IEC61850 调试能力
- 调试服务新增 IEC61850 主站与服务端能力识别,便于前端按插件类型展示对应调试入口。
-
当前版本操作手册
- 文档站点新增 GatewayRuntime Web、Studio Web、Watchdog Web 当前操作手册入口,并补充数据查询、内存、数据转发和运维截图。
优化
-
数据转发离线缓存与补发
- MQTT、Kafka、RabbitMQ、ThingsBoard 等 TopicArray 转发失败时可缓存未确认数据,并在恢复后优先补发;关闭离线缓存时会明确提示失败数据不会重试。
- ThingsBoard 设备连接上报队列超过上限、取消或发送失败时可转入离线缓存,减少恢复后漏发。
-
数据转发启动与配置校验
- 转发目标保存时提前校验插件属性和变量属性,减少运行态启动后才暴露配置错误的情况。
- 优化转发目标批量启动失败时的清理与冗余切换,避免半初始化目标继续接收数据。
-
消息与安全配置
- RabbitMQ 支持发布确认和 mandatory 路由要求,并补齐插件事件主题的队列声明。
- MQTT 与 ThingsBoard 默认不再信任未验证证书,手动放宽证书校验时会记录告警。
- ModbusSlave 在监听全部网卡、客户端权限为空或启用 RPC 写入时记录风险提示。
-
文档站点体验
- 优化首页图片、侧边栏结构和当前截图目录,便于直接进入当前版本操作手册。
修复
-
日志文件路径
- 通道、设备、转发组和转发目标日志文件名会进行安全化处理,避免名称中的非法路径字符导致日志写入或清理异常。
-
插件稳定性
- Webhook 自定义请求头 JSON 配置异常时会返回清晰错误,不再静默忽略。
- 加强 TDengine 历史数据写入的库表标识符和值转义,避免特殊字符引起建库建表或写入失败。
- 优化 Kafka 生产者关闭和并发发送互斥,减少关闭过程中的发送异常。
v2.1.0 (2026-07-02)
新增
-
业务插件转发配置
- 新增转发组与转发目标配置,支持按组组织业务数据转发链路
- 转发组支持配置多个转发目标,满足组内多目标转发场景
- 转发目标支持冗余配置,提升转发链路可用性与容错能力
-
内存计算页面
- 新增内存计算页面,便于集中查看和管理内存计算相关配置
优化
- 业务插件重构
- 重构业务插件模块,拆分独立 UI,降低业务插件配置与主界面的耦合
- 优化业务插件配置入口与交互体验
v2.0.232 (2026-06-26)
优化
-
UI 重构
- 重构 Gateway、Studio、Watchdog 前端界面结构与视觉风格
- 优化页面布局、导航、表格、表单、日志面板和紧凑模式体验
-
脚本与自定义节点编译体验优化
- 编译失败时优先展示用户需要处理的错误信息,减少无关技术输出
- 自定义节点编译错误日志支持按行列跳转到编辑器对应位置
- 修正自定义节点编译错误行号映射,使返回行号对应用户编辑器代码
-
批量编译流程优化
- 优化脚本批量编译体验,批量验证时日志更集中、结果更清晰
- 优化自定义节点批量编译体验,便于升级后统一检查节点状态
-
发布包体验优化
- 优化 Watchdog、Runtime、Studio 发布包内容,便于按平台部署和交付
修复
- 脚本与自定义节点删除体验
- 删除脚本或自定义节点后,同步清理相关运行结果,避免列表状态与实际加载状态不一致
- 批量删除脚本和自定义节点时同步处理相关运行结果
v2.0.223 (2026-06-23)
新增
-
网关数据页面重构
-
变量表格视觉重构
-
左侧树面板优化
-
VariableNode 触发规则筛选逻辑修正
优化
-
TabBar 保留页面状态
- 现在切换 Tab 真正保留页面滚动位置、表单输入、筛选条件等状态
-
紧凑模式适配
修复
-
变量历史数据配置定时保存丢失
-
内存变量编辑弹窗所属设备显示 id 数字
-
修复已知问题
v2.0.222 (2026-06-22)
优化
- 日志导出统一查询条件
- DeviceLog、ChannelLog 的导出补传
conditionalModel,修复导出时忽略日志级别 / 关键字 / 时间范围筛选的问题 - RpcLog、OperateLog 的导出条件与查询条件存在
LikevsEqual、'true'vs'success'等不一致,统一抽buildConditions()函数共用 - BackendLog、SqlLog 同步抽
buildConditions()消除重复代码 - 全部 6 个日志页面现在查询和导出 100% 共用同一份条件构建逻辑
- DeviceLog、ChannelLog 的导出补传
修复
- 快速创建表达式未持久化
- GatewayWeb 的 QuickExpressionDialog 原先只调用
compileScript编译并热加载,未写入数据库,重启后表达式丢失 - 现在"应用"按钮在 emit 前先调用
createScriptAPI 持久化到script_expression表,同名脚本已存在时提示错误
- GatewayWeb 的 QuickExpressionDialog 原先只调用
v2.0.190 (2026-06-22)
新增
-
ModbusSlave 客户端权限控制
- 插件属性新增"客户端权限列表",支持配置多个允许的客户端 IP 及写入权限
- 列表为空时不限制,列表非空时仅命中的 IP 才允许写入
- 每条记录支持
AllowedClientIp(支持精确匹配 /*通配)和AllowWrite(是否允许写入) - 写入请求会按 IP 白名单校验,未授权 IP 或禁止写入的客户端会被拒绝
- 插件参数编辑器支持可视化表格编辑,可新增、删除或编辑客户端权限行
-
Studio Roslyn 智能补全集成
- 脚本编辑器提供 C# 智能提示、语法诊断、签名帮助、悬停提示、语义高亮与跳转定义
- 自动检测 Studio Roslyn 服务可用性,断开后定时后台重连,恢复后无缝切回
优化
- 数据库连接测试
- SqlServer、MySql、Sqlite、PostgreSql、QuestDb、TDengine 等数据库连接支持统一测试
- 实时数据、历史数据、历史报警相关配置支持一键“测试连接”
修复
- 修复已知问题
v2.0.189 (2026-06-17)
修复
- 修复已知问题
v2.0.188 (2026-06-13)
修复
- 修复已知问题
v2.0.179 (2026-06-11)
修复
- 修复已知问题
v2.0.178 (2026-06-08)
修复
- 修复已知问题
v2.0.177 (2026-06-08)
新增
- 新增内置的历史数据存储
v2.0.176 (2026-06-05)
优化
- 优化操作体验
v2.0.170 (2026-06-04)
修复
- 修复已知问题
v2.0.168 (2026-06-03)
修复
- 修复已知问题
v2.0.166 (2026-06-03)
修复
- 修复已知问题
v2.0.158 (2026-06-01)
修复
- 修复已知问题
v2.0.157 (2026-05-30)
新增
- 业务插件并发上传
修复
- 修复已知问题
v2.0.155 (2026-05-28)
新增
- 业务上传插件支持并发上传
- 上传实体增加 createTime 字段
v2.0.152 (2026-05-27)
新增
- TCP穿透功能
- 支持内网穿透,实现远程访问
- 提供稳定的穿透连接服务
v2.0.149 (2026-05-25)
修复
- 修复 Studio 导入工程文件大小限制
- 提高操作体验
v2.0.148 (2026-05-25)
修复
- 修复 PLC 读取数组错误
- 修复变量插件属性更新错误
v2.0.143 (2026-05-24)
修复
- 修复已知问题
v2.0.140 (2026-05-24)
修复
- 修复已知问题
v2.0.136 (2026-05-19)
新增
- 国际化适配
v2.0.126 (2026-05-14)
新增
- ** 网关版本更新功能**
- 工具栏新增"网关版本"按钮
- 自动从 NuGet 官网和本地 nupkgs 目录获取最新版本
- 支持一键更新 GatewayVersion 并自动重建
优化
- 适配暗黑模式
修复
- 修复已知问题
v2.0.124 (2026-05-13)
新增
- 导入 ZIP 工程时支持重名检查,可选择重命名或覆盖同名工程
优化
- 网关数据树节点显示
v2.0.123 (2026-05-12)
新增
- 规则引擎 Excel 导出导入
修复
- 修复已知问题
v2.0.122 (2026-05-12)
优化
- MQTT RPC 主题支持通配符
v2.0.121 (2026-05-12)
优化
- OPCUA Server 证书提示优化
v2.0.120 (2026-05-11)
新增
- 导入时可选清空原数据
优化
- 前端网络错误时不再显示空白页
修复
- 内存变量写入错误
- 已知问题
v2.0.118 (2026-05-09)
新增
-
Studio 新增 NuGet 包插件管理
- 支持可视化插件管理界面
- 支持批量启用/禁用插件
- 插件状态持久化到 project.json
- 自动根据 project.json 配置构建和重启运行时
-
规则引擎变量 RPC 节点
- 新增变量 RPC 节点类型
- 支持通过规则引擎调用变量 RPC 方法
v2.0.111 (2026-05-07)
修复
- 修正已知问题。
调整
- API操作时不等待后台线程重启。
v2.0.104 (2026-05-06)
新增功能
- 批量复制:支持复制通道、设备、变量,可配置复制数量,名称自动去重
- 复制通道时自动级联复制其下所有设备和变量
- 复制设备时自动级联复制其下所有变量
v2.0.0 (2026-05-06)
新增功能
- 数据采集:支持 Modbus TCP/RTU、OPC UA、MQTT、Kafka、RabbitMQ 等多种工业协议的数据采集
- 报警管理:支持布尔开/关报警、高限/高高限/低限/低低限报警及自定义报警规则
- 规则引擎:可视化规则流程编排,支持自定义节点和脚本扩展
- 冗余配置:主备冗余架构,支持自动故障切换和数据同步
- 脚本扩展:支持自定义表达式脚本和 C# 脚本节点扩展业务逻辑
- 权限管理:用户-角色-权限三级管理体系,精细化权限控制
- 看门狗服务:自动监控和管理网关进程,保障系统稳定运行
- Studio 开发环境:提供可视化配置界面,便捷管理通道、设备和变量
平台支持
- Windows x64
- Linux x64