GatewayRuntime Web 操作手册
本页是 GatewayRuntime Web 的入口索引和现场任务路线，不再把所有功能细节堆在一个页面里。现场人员先按任务找到入口，再进入对应专题页完成配置、验证和排障。
GatewayRuntime Web 主要用于运行态配置、采集监控、数据转发、报警处理、日志查看和权限维护。普通现场调试最常用的是“系统总览、采集配置、内存计算、数据转发、数据查询、报警查询、系统日志”。
操作边界
变量写入、批量导入、批量删除、网络配置、系统重启、角色授权和菜单调整会影响运行系统。生产现场执行前，应先备份配置，并确认设备处于允许调试或维护的状态。
术语速查
| 术语 | 现场理解 |
|---|---|
| 通道 | 网关到设备的通讯链路，例如一条 TCP 连接、一个监听端口或一个串口。 |
| 设备 | 一台 PLC、仪表、采集模块，或一个由插件管理的逻辑对象。 |
| 变量 | 点表中的一个点位，例如温度、压力、运行状态、故障状态或控制写入点。 |
Other | 无普通通讯通道插件。插件自己管理连接，或不需要 TCP、UDP、串口通道。 |
| Cron 表达式 | 定时表达式。现场常规周期优先填毫秒数，例如 1000 表示 1 秒。 |
| RPC 写入 | 外部系统或 Web 页面反写点位。只有控制类点位才建议开启。 |
| 目标变量属性 | 某个转发目标对单个变量的外部映射，例如外部字段名、Modbus 从站地址、是否允许反写。 |
| StreamAsync | 串口异步读写方式。串口稳定时保持默认，遇到阻塞或读取不及时再调整。 |
| DtuId | DTU 或透传终端编号，用于区分哪台远端设备正在接入。 |
| 在线过滤 | 数据转发只发送在线变量。开启后离线设备下的变量不会进入转发。 |
| 采集组 | 变量的业务分组，可用于采集打包和数据转发筛选。 |
登录与首页确认
访问 http://<网关IP>:6100，输入用户名和密码后登录 GatewayRuntime Web。默认账号为 admin，默认密码为 111111；生产环境首次登录后应立即修改默认密码。
登录后默认进入“系统总览”。先确认页面可访问、工程信息正确、通道和设备数量符合现场点表，CPU、内存、磁盘没有持续异常。
| 首页项目 | 现场判断方式 |
|---|---|
| 通道、设备、变量数量 | 与当前工程、点表或交付清单一致。 |
| 设备在线数 | 新建链路时至少目标设备应在线；投运后离线数应符合现场状态。 |
| 实时报警 | 有报警时先进入报警查询确认设备、变量、报警值和时间。 |
| CPU、内存、磁盘 | 持续高位时检查采集频率、转发缓存、日志量和磁盘空间。 |
| 工程信息 | 确认版本、授权数量、网关名称和启动时间是否符合现场包。 |
按任务选择入口
| 现场任务 | 进入菜单 | 继续阅读 |
|---|---|---|
| 首次确认网关是否运行正常 | 系统总览 | 系统总览 |
| 接入 PLC、仪表、采集模块 | 开发配置 → 采集配置 | 采集配置 |
| 核对寄存器地址、数据类型或写入点 | 开发配置 → 采集配置 → 设备显示 → 调试 | 设备调试 |
| 配置内部计算值、状态保持或规则中间值 | 开发配置 → 内存计算 | 内存计算 |
| 把数据上传到上位机、MES、SCADA、云平台或数据库 | 开发配置 → 数据转发 | 数据转发 |
| 查看当前值、历史值或趋势 | 数据与告警 → 数据查询 | 数据查询 |
| 处理当前报警或追溯历史报警 | 数据与告警 → 报警查询 | 报警查询 |
| 排查离线、无值、转发失败、页面报错 | 系统日志，或采集/转发页面内日志 | 系统日志 |
| 修改网卡、时间、冗余、重启或备份 | 系统管理 → 系统设置 | 系统设置 |
| 修改端口、数据库、JWT、日志保留策略 | 配置文件 | 高级配置：配置文件说明 |
| 外部程序调用接口 | API | 开发接口：网关 API 文档 |
常用任务路线
接入一台 PLC 或仪表
| 顺序 | 操作 | 通过标准 |
|---|---|---|
| 1 | 在现场确认通讯方式、IP/端口或串口参数、站号、点表和字节序。 | 参数来自设备手册、PLC 程序或最终点表。 |
| 2 | 进入“采集配置”，先新建通道。 | 通道日志没有持续连接失败或超时。 |
| 3 | 新建设备，选择采集插件，填写站号、超时、字节序等插件属性。 | 设备显示在线，设备日志没有持续读写错误。 |
| 4 | 先建立 3 到 5 个典型变量。 | 当前值与 PLC 软件、仪表显示或现场校验值一致。 |
| 5 | 使用“设备显示 → 调试”验证地址和数据类型。 | 单点读取正确，再扩大到完整点表。 |
| 6 | 批量导入或复制完整点表。 | 导入结果无失败行，抽查关键点位正确。 |
详细字段和导入导出方法见 采集配置，插件地址格式见 插件参考。
验证读写或控制点
| 顺序 | 操作 | 通过标准 |
|---|---|---|
| 1 | 在“采集配置”切换到“设备显示”，选择目标设备。 | 右侧显示该设备详情、通道日志、设备日志和调试页。 |
| 2 | 先读取只读点或安全点。 | 地址、站号、数据类型、字节序已验证正确。 |
| 3 | 写入前确认现场设备允许远程控制。 | 设备处于维护或允许调试状态，写入值在允许范围内。 |
| 4 | 执行写入并回读反馈点。 | 回读值、反馈点或现场状态与预期一致。 |
写入会影响现场设备。详细调试页面和故障处理见 设备调试。
配置数据上传
| 顺序 | 操作 | 通过标准 |
|---|---|---|
| 1 | 与上位机、MES、SCADA、云平台或数据库负责人确认数据范围、格式、地址、账号、证书和验收方式。 | 对方明确 Topic（消息主题）、URL、表名、字段名、时间格式和验证方法。 |
| 2 | 先建一个小范围转发组，只放少量变量。 | 变量在组范围内，触发方式符合对方要求。 |
| 3 | 在该组下新增转发目标，填写连接参数。 | 目标启用并在线，目标日志无认证或连接错误。 |
| 4 | 如需外部字段或 Modbus 从站地址，维护目标变量属性（某个转发目标对单个变量的外部映射）。 | 外部系统字段、地址或写入权限与协议说明一致。 |
| 5 | 进入“调试”或查看目标日志确认发送。 | 对方能在指定页面、Topic（消息主题）、表或日志中看到正确数据。 |
| 6 | 扩大到正式点表，调回日志级别。 | 稳定运行后日志级别恢复为 Info。 |
变量有值不代表一定会转发。完整排查链见 数据转发。
查询数据与报警
| 任务 | 操作 | 注意事项 |
|---|---|---|
| 查看当前入库值 | 进入“数据查询 → 实时数据”。 | 数据来自实时数据目标，不是直接重新读取 PLC。 |
| 查看历史曲线 | 进入“数据查询 → 历史数据”。 | 时间范围要覆盖采集时间，目标需已写入历史数据。 |
| 处理当前报警 | 进入“报警查询 → 实时报警”。 | 确认报警只表示人员已知晓，不代表报警条件消失。 |
| 导出报警记录 | 进入“报警查询 → 历史报警”。 | 需要先配置历史报警目标并写入数据。 |
排查故障
| 现象 | 先看哪里 | 再看哪里 |
|---|---|---|
| 设备离线 | 采集配置 → 设备显示 → 通道日志、设备日志 | 系统日志 → 后台日志 |
| 变量无值或数值不对 | 变量地址、数据类型、字节序、数组长度 | 设备调试、插件参考 |
| 写入失败 | 变量读写权限、RPC 写入（外部系统反写点位）、写入值格式 | 设备日志、RPC 日志 |
| 数据没有发出 | 数据转发组范围、目标启用、触发模式、在线过滤 | 转发目标日志、转发组日志 |
| 页面操作失败 | 系统日志 → 操作日志 | 后台日志 |
| 外部系统调用失败 | 系统日志 → RPC 日志 | 设备日志或转发目标日志 |
日志使用方法见 系统日志。
高级功能入口
| 功能 | 适用对象 | 文档 |
|---|---|---|
| 规则引擎、脚本、自定义节点 | 熟悉业务逻辑和脚本维护的工程师 | 规则引擎、脚本管理、自定义节点类型 |
| 插件管理、插件参考 | 交付工程师、协议配置人员 | 插件管理、插件参考 |
| 证书管理 | 需要 TLS、OPC UA 安全策略或双向认证的项目 | 证书管理 |
| 用户、角色、菜单 | 系统管理员 | 用户管理、角色管理、菜单管理 |
| 配置文件 | 现场管理员、交付工程师、运维人员 | 高级配置：配置文件说明 |
| API | 系统集成和二次开发人员 | 开发接口：网关 API 文档 |
常见问题
| 现象 | 处理建议 |
|---|---|
| 登录失败 | 确认账号密码、用户是否启用、服务端口是否可访问。 |
| 设备离线 | 先查通道参数和设备插件属性，再查网络、串口和设备日志。 |
| 变量无值 | 检查变量地址、数据类型、设备在线状态和设备日志。 |
| 写入失败 | 确认读写权限、RPC 写入开关、写入值格式和现场设备是否允许下发。 |
| 转发目标离线 | 查看转发目标日志，检查地址、认证、证书、Topic/URL/表名和插件状态。 |
| 页面无数据 | 先确认目标已写入数据，再检查查询时间范围、用户权限和系统日志。 |