插件管理
插件管理用于查看 GatewayRuntime 已安装的采集插件和数据转发插件，并控制插件启用状态。插件启用后，采集配置或数据转发配置中才能使用对应能力；禁用插件会影响依赖该插件的设备或转发目标。
先看术语
| 术语 | 现场理解 |
|---|---|
| 插件 | 网关扩展协议或对接能力的模块，例如 Modbus、OPC UA、MQTT、Kafka。 |
| 采集插件 | 从 PLC、仪表、传感器或第三方系统读取数据的插件。 |
| 数据转发插件 | 把数据发送到外部系统或写入存储目标的插件。 |
| 插件文件 | 安装在网关程序目录中的插件包文件。文件缺失或版本不对时，页面可能无法使用对应插件。 |
| 启用 / 禁用 | 控制插件是否参与运行。禁用后，依赖该插件的设备或转发目标可能离线。 |
| 同步插件 | 重新扫描插件文件并刷新列表，常用于安装或更新插件后确认是否生效。 |
功能入口
登录 GatewayRuntime Web 后，点击左侧菜单“开发配置 → 插件管理”。
筛选与搜索
| 控件 | 说明 |
|---|---|
| 状态筛选 | 按启用或禁用状态过滤插件。 |
| 类型筛选 | 按采集插件或数据转发插件过滤。 |
| 搜索插件 | 按插件名称搜索。 |
| 刷新 | 重新读取插件列表。 |
插件列表
| 列 | 说明 |
|---|---|
| 插件名称 | 插件显示名称。 |
| 插件文件 | 插件文件名。 |
| 插件类型 | 采集插件或数据转发插件。 |
| 版本 | 插件版本号。 |
| 类型 | 标准版或专业版。 |
| 状态 | 启用或禁用。 |
| 操作 | 使用开关启用或禁用单个插件。 |
页面底部支持分页，可选择每页 20、50 或 100 条。
插件类型
| 类型 | 说明 |
|---|---|
| 采集插件 | 用于从 PLC、仪表、传感器或第三方系统读取数据，例如 Modbus、OPC UA、Siemens S7、DLT645。 |
| 数据转发插件 | 用于把采集到的数据发送到外部系统或写入存储目标，例如 MQTT、Kafka、RabbitMQ、数据库。 |
启用或禁用插件
| 操作 | 步骤 |
|---|---|
| 启用单个插件 | 在插件列表中打开该插件的状态开关。 |
| 禁用单个插件 | 在插件列表中关闭该插件的状态开关。 |
| 批量启用 | 勾选多个插件，点击工具栏“批量启用”。 |
| 批量禁用 | 勾选多个插件，点击工具栏“批量禁用”。 |
注意
启用或禁用插件可能触发运行时重新处理插件状态。生产环境操作前，请先确认采集配置和数据转发配置中没有正在使用该插件的对象，并安排在维护窗口执行。
同步插件
安装或更新插件文件后，点击“同步插件”。同步会扫描插件目录，发现新增或更新的插件后刷新插件列表。
同步完成后建议检查以下内容：
| 检查项 | 说明 |
|---|---|
| 插件是否出现 | 确认新插件显示在列表中。 |
| 插件类型 | 确认插件被识别为采集插件或数据转发插件。 |
| 版本 | 确认版本号符合预期。 |
| 状态 | 根据现场需要启用或禁用插件。 |
常见问题
| 问题 | 处理方法 |
|---|---|
| 配置设备时找不到插件 | 到插件管理确认插件是否存在并处于启用状态。 |
| 转发目标无法选择插件 | 检查插件类型是否为数据转发插件，并确认插件已启用。 |
| 同步后插件仍不显示 | 检查插件文件是否放在正确目录，文件是否完整，必要时查看后台日志。 |
| 禁用插件后设备离线 | 重新启用插件，并检查关联通道、设备或转发目标运行状态。 |