产品简介
产品定位
ThingsGatewayRuntime 面向工业现场的数据采集、边缘处理、报警判断和数据转发场景，提供 GatewayRuntime、Studio 和 Watchdog 三类管理入口，分别用于运行态配置、工程维护和运行守护。
本文档按 GatewayRuntime 2.1.22 的配置项和 Web 界面整理；不同现场包如果调整过端口、插件或菜单权限，请以实际运行环境为准。
首次使用时，先了解 Studio、Watchdog、GatewayRuntime 三个入口的分工，再按现场任务阅读 采集配置、设备调试、数据转发 或 系统设置。无需从全部页面顺序阅读。
ThingsGatewayRuntime 是一款工业物联网边缘网关运行时平台，专注于边缘侧的数据采集、处理和转发。平台部署在工业现场，直接与 PLC、传感器、仪表等设备通讯，完成数据的实时采集、转换、报警检测和业务处理。
什么是边缘网关？
边缘网关是部署在工业现场的智能设备，位于现场设备层和上层管理系统之间。它的核心作用是在数据源头完成数据处理，而不是将所有原始数据传输到云端处理。
产品由 Studio、Watchdog 和 GatewayRuntime 三个 Web 管理界面组成，分别覆盖工程维护、运行守护和网关配置。
传统模式 vs 边缘计算模式
| 对比项 | 传统模式（云端处理） | 边缘计算模式（本地处理） |
|---|---|---|
| 数据流向 | 现场设备 → 全部数据 → 云端服务器 → 数据处理 | 现场设备 → 边缘网关 → 处理后数据 → 云端服务器 |
| 网络带宽 | 占用大 | 占用小 |
| 响应延迟 | 高 | 低 |
| 成本 | 高 | 低 |
| 可靠性 | 依赖网络 | 本地处理，可靠性高 |
边缘网关的核心功能
| 功能 | 说明 |
|---|---|
| 数据采集 | 从设备获取原始数据 |
| 数据处理 | 过滤、转换、聚合 |
| 报警检测 | 实时检测异常 |
| 数据转发 | 仅上传有效数据 |
边缘网关的应用场景
典型应用场景包括本地设备采集、边缘侧报警判断、运行时规则处理、数据转发到上位系统，以及通过 Watchdog 执行远程部署和恢复。
核心价值
| 价值点 | 说明 | 收益 |
|---|---|---|
| 边缘智能 | 在现场侧完成数据处理 | 减少网络传输，降低延迟 |
| 协议转换 | 支持多种工业协议 | 打破设备通讯壁垒 |
| 实时响应 | 毫秒级数据采集 | 满足实时监控需求 |
| 高可靠性 | 冗余和自动恢复机制 | 保障业务连续性 |
| 灵活扩展 | 通过插件、脚本和规则扩展能力 | 适应不同业务场景 |
| 易于部署 | 开箱即用 | 降低实施成本 |
| 可视管理 | Web界面管理 | 降低使用门槛 |
产品组成
ThingsGatewayRuntime 由三个核心部分构成，它们协同工作，共同完成边缘计算任务。
| 部分 | 用途 | 运行位置 |
|---|---|---|
| Studio 工程管理 | 工程管理、本地运行验证、远程部署、隧道 Broker 和 Watchdog 连接管理 | 工程维护电脑 |
| Watchdog 看门狗服务 | 进程管理、健康检查、自动恢复、备份管理 | 网关设备 |
| GatewayRuntime 网关运行时 | 数据采集、报警处理、规则执行、脚本编译、数据转发 | 网关设备 |
Studio 工程管理
Studio 是 ThingsGateway 的工程维护和部署工具，用于管理本地工程、启动本地运行环境、上传或下载网关工程，并维护隧道 Broker 与 Watchdog 连接。
Studio 工程管理界面：
Studio 主要功能
| 功能模块 | 功能说明 |
|---|---|
| 项目管理 | 创建、导入、导出本地工程，启动或停止本地运行环境 |
| 工程发布 | 上传工程到 Watchdog，选择发布类型、目标环境、运行时和插件 |
| 工程回传 | 从 Watchdog 管理的网关下载项目包回 Studio |
| 内网穿透 | 配置 Studio 端隧道 Broker，配合 Watchdog 客户端暴露内网服务 |
| 看门狗管理 | 保存 Watchdog 连接、测试状态、查看备份并作为上传下载目标 |
Studio 使用场景
- 工程维护人员在管理电脑上创建、导入和备份工程
- 启动本地运行环境，验证采集、转发和权限配置
- 将通过验证的工程上传到生产网关的 Watchdog
Watchdog 看门狗服务
Watchdog 是网关运行时的守护进程，负责管理和监控网关运行时进程。
Watchdog 主要功能
| 功能 | 说明 |
|---|---|
| 进程管理 | 启动、停止、重启网关运行时进程 |
| 健康检查 | 定期检查进程状态和API可用性 |
| 自动恢复 | 进程异常退出时自动重启 |
| 项目管理 | 管理多个项目配置和切换 |
| 备份管理 | 项目备份和恢复功能 |
Watchdog 使用场景
- 部署在网关设备上作为系统服务运行
- 7x24小时监控网关运行时状态
- 异常情况下自动恢复服务
- 支持远程工程上传和部署
看门狗提供 Web 管理界面，默认端口为 6200，可通过浏览器访问 http://<网关IP>:6200 进行管理。网关的Web界面由 GatewayRuntime 提供，端口为 6100。
Studio 默认使用 http://<Studio服务器IP>:5100，Watchdog 默认使用 http://<网关IP>:6200。两者随包配置都支持普通 HTTP IP 访问；登录密码通过一次性 RSA-OAEP-SHA256 公钥挑战加密，但 Bearer Token、项目包和其他管理数据仍应依靠 HTTPS 获得完整传输保护。
GatewayRuntime 网关运行时
GatewayRuntime 是核心运行时引擎，负责执行数据采集、报警检测、规则处理等核心业务逻辑。
网关运行时界面：
GatewayRuntime 主要功能
| 功能模块 | 功能说明 |
|---|---|
| 数据采集 | 通过通讯插件从设备采集数据 |
| 报警检测 | 根据配置的报警规则检测异常 |
| 规则引擎 | 执行可视化编排的业务流程 |
| 脚本执行 | 运行用户自定义的 C# 脚本 |
| 数据转发 | 将数据推送到上层系统 |
| Web管理 | 提供Web界面进行配置和管理 |
GatewayRuntime 使用场景
- 由看门狗自动启动和管理
- 执行数据采集和业务处理
- 提供Web管理界面
- 与上层系统进行数据交互
GatewayRuntime 运行方式
- 由看门狗自动启动
- 或手动运行 ThingsGatewayRuntime
- 默认端口：6100（Web管理界面）
产品特性
高可靠性
| 特性 | 说明 |
|---|---|
| 进程守护 | 看门狗自动监控和恢复进程 |
| 冗余支持 | 主备站点自动切换 |
| 异常处理 | 完善的异常捕获和处理机制 |
| 数据持久化 | 配置和数据自动保存 |
高性能
| 特性 | 说明 |
|---|---|
| 高并发采集 | 支持大量设备同时采集 |
| 低延迟处理 | 毫秒级数据处理延迟 |
| 高效存储 | 优化的数据存储机制 |
| 资源占用低 | 最小256MB内存即可运行 |
易用性
| 特性 | 说明 |
|---|---|
| Web管理 | 浏览器即可管理，无需安装客户端 |
| 可视化配置 | 图形化配置界面 |
| 在线调试 | 实时查看采集数据和日志 |
| 快速部署 | 开箱即用，快速上线 |
可扩展性
| 特性 | 说明 |
|---|---|
| 插件架构 | 通讯插件可扩展 |
| 脚本扩展 | C# 脚本自定义功能 |
| 自定义节点 | 规则引擎节点可扩展 |
| 开放 API | 提供受权限控制的 Web API 接口 |
技术规格
Studio 系统要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11、Linux |
| 运行时 | .NET 10.0 SDK 或产品发布包要求的运行环境 |
| CPU | x64架构，建议2核心及以上 |
| 内存 | 建议2GB及以上 |
| 存储 | 建议4GB及以上 |
GatewayRuntime 运行时
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10/11、Windows Server 2016+、Linux |
| 运行时 | .NET 10.0 Runtime 或 AOT独立部署 |
| CPU | x64架构，1核心即可 |
| 内存 | 最低256MB，建议512MB及以上 |
| 存储 | 建议2GB及以上 |
容量规划
实际变量数量、采集周期和处理延迟取决于通讯协议、设备响应时间、点表规模、脚本复杂度、转发目标、历史存储以及网关硬件。项目投运前应使用真实点表和真实通讯链路进行压力验证，并为 CPU、内存、磁盘和离线缓存预留余量，不直接套用其它现场的测试结果。
网络端口
| 服务 | 默认端口 | 说明 |
|---|---|---|
| Studio | 5100 | Web管理界面 |
| GatewayRuntime | 6100 | Web管理界面 |
| Watchdog | 6200 | Web管理界面 |
Studio 和 Watchdog 默认监听 0.0.0.0。通过设备 IP 访问时，应同时确认远程管理开关、防火墙和普通 HTTP 许可配置；详细步骤见快速开始。