IoTEdge 是 IoTSharp 体系里的工业连接网关。它把现场协议执行、本地配置、平台同步、离线运行、采集轮询和数据上传收拢到一个可执行程序里,适合部署在工控机、边缘盒子或现场服务器上。
单宿主模型
IoTEdge 当前收口为一个可执行程序 IoTEdge。本地 Vue 管理界面由宿主托管,开发时可以通过 SpaProxy 拉起,发布时前端产物进入 wwwroot。这意味着现场交付时不必把网关 API、管理前端、同步 worker 拆成多个服务,部署模型更直接。
网关启动后会读取本地 bootstrap.json,向 IoTSharp 平台注册、心跳、上报能力,并从平台拉取采集配置。配置会映射为本地执行缓存,断网或上游不可用时仍能沿用上一版配置继续运行。
职责边界
平台侧负责采集模型设计、边缘节点管理、配置版本、任务下发和运行观察。Gateway 侧负责南向协议执行、本地执行缓存、采集轮询、BASIC 脚本执行、Bootstrap、诊断和本地配置 API。
这个边界很关键:平台不直接执行现场协议,网关也不替代平台做多租户、权限和全局配置管理。这样一来,现场节点可以离线运行,平台也能维持统一治理。
本地管理界面
IoTEdge 的本地管理界面提供运行态和配置统计、按协议目录驱动的采集拓扑编辑、按上传协议分组的多目标上传编辑、数据路由、本地 JSON 高级编辑、BASIC 采集脚本查看、运行日志和健康诊断。
在项目交付中,这种本地界面很有价值。现场工程师不一定能访问平台后台,但需要快速确认网关是否在采集、上传通道是否正常、配置是否已缓存、日志里有没有协议错误。
南向协议覆盖
当前 README 中列出的已接入驱动包括 Modbus TCP / RTU / 串口 ASCII、Siemens S7、Mitsubishi、Omron FINS、Allen-Bradley、OPC UA 和 MTConnect。OPC DA、Fanuc CNC、BACnet、IEC 60870-5-104、MQTT 等也保留了统一契约。
这些协议覆盖了大量工业现场的真实接入需求。IoTEdge 的定位不是做一个单协议采集器,而是把不同协议映射到统一采集模型和上传链路。
上传链路
平台或本地配置映射后,网关会自动派生上传通道:遥测和属性可以上传到 IoTSharp,也支持 ThingsBoard、SonnetDB 和 InfluxDB。SonnetDB 写入使用 NuGet 包提供的 ADO.NET provider,InfluxDB 则覆盖 v2 bucket 和 v1 database。
这让 IoTEdge 可以同时服务平台实时状态、历史时序存储和第三方系统集成。对于需要平滑迁移的工业项目,多目标上传往往比“一次性替换全部系统”更可行。
为什么它适合和 SonnetDB 组合
IoTEdge 解决现场采集和上传,SonnetDB 解决边缘或中心侧的历史查询。网关可以把 Modbus 模拟设备数据写入 SonnetDB 的 measurement,让现场数据在本地就能被 SQL、Workbench 和 Copilot 分析。
这种组合特别适合边缘自治:本地采集、本地缓存、本地查询,平台在线时再同步配置和状态。
项目地址:IoTSharp/IoTEdge