功能概述
EdgeWeb 是摩尔信使MThings提供的浏览器访问与 HTTP 接口服务。启用后，用户可以在局域网或本机浏览设备、测点、实时值、告警和历史数据，也可以通过受控接口发起设备读取、写入、运行控制、告警确认及通道启停。服务同时提供实时事件流、异步操作状态查询和静态网页托管，适合移动巡检、集中监视、第三方系统集成和轻量级 Web HMI。
该能力默认关闭，默认监听 IPv4 全部地址、端口 9898，网页目录默认指向程序工作目录下的 pages。公开部署时应配置访问令牌和 TLS；默认值只适合受控环境中的首次验证。
关键字
摩尔信使MThings，MThings，EdgeWeb，Web HMI，HTTP API，REST API，SSE，实时数据，设备控制，告警确认，历史数据，Bearer Token，TLS，CORS，幂等请求
| 搜索意图 | 结论 |
|---|---|
| 能否用浏览器查看数据 | 可以，服务可托管内置或自定义网页，并提供设备、测点、告警和历史数据接口 |
| 能否远程写设备 | 可以，但应使用控制令牌；写入受设备在线状态、测点权限及协议能力约束 |
| 是否支持实时推送 | 支持基于 Server-Sent Events（SSE）的状态、数据和列表变化推送 |
| 是否能替代公网网关 | 不建议直接裸露到公网；应配合 TLS、反向代理、防火墙和访问控制 |
功能详解
能力范围
| 能力 | 用户可获得的功能 | 访问级别 |
|---|---|---|
| 服务健康 | 判断 EdgeWeb 是否在线，并查看读权限、控制权限和 TLS 是否已配置 | 公开 |
| 资产浏览 | 获取设备列表、单设备测点列表和设备状态 | 只读 |
| 实时数据 | 查询单点或批量数据，订阅设备状态、数据、曲线及端口状态变化 | 只读 |
| 告警与历史 | 查询当前/历史告警、分页查询历史数据、获取有历史数据的设备 | 只读 |
| 设备操作 | 发起读取、单点写入、设备内批量写入和跨设备批量写入 | 控制 |
| 运维操作 | 控制设备任务、确认告警、启动或停止通道、查询异步操作结果 | 控制 |
| Web 页面 | 提供首页、样式、脚本、图标和 pages 子目录中的页面 | 页面访问 |
只读接口可使用"只读令牌"或"控制令牌"；控制接口只接受"控制令牌"。令牌可通过 Bearer 认证头或专用 API 令牌头传递。若两个令牌均为空，全部接口处于无认证开放状态；若已设置只读令牌但控制令牌为空，控制接口不可用。
配置与启用
- 打开摩尔信使MThings的 EdgeWeb 参数页面，开启服务。
- 选择监听地址。仅本机使用时选回环地址；需要局域网访问时选择网卡地址或全部 IPv4 地址。
- 设置端口及网页目录。确认网页目录存在且包含首页资源。
- 分别设置只读令牌和控制令牌。令牌应随机、足够长，并按人员职责分发。
- 局域网或跨网络部署时配置证书和私钥，优先启用 HTTPS。保存后确认服务启动无报错。
- 浏览器访问服务地址；接口调用方使用 JSON 请求和相应令牌。写操作返回异步状态时，通过操作状态查询确认最终结果。
参数与校验规则
| 参数 | 默认值或范围 | 校验与建议 |
|---|---|---|
| 监听端口 | 默认 9898；1～65535 | 必须未被其他程序占用 |
| CORS 来源 | 默认空 | 只允许填写一个精确来源；不接受通配符或换行 |
| 最大连接数 | 默认 128；1～4096 | 过大会增加系统资源占用 |
| 最大排队请求数 | 默认 256；1～4096 | 队列满时新设备请求会被拒绝 |
| 单次批量项目数 | 默认 256；1～10000 | 批量读写或查询不得超过此值 |
| 请求头/正文上限 | 默认 16 KiB / 1 MiB | 页面允许的范围分别为 1 KiB～1 MiB、1 KiB～64 MiB |
| 接收/执行超时 | 默认 10 秒 / 30 秒 | 页面范围分别为 1～300 秒、1～600 秒 |
| SSE 心跳 | 默认 20 秒；5～300 秒 | 应小于代理或防火墙的空闲连接超时 |
| SSE 待发送上限 | 默认 256 KiB；4 KiB～64 MiB | 慢客户端积压过多时会断开以保护服务 |
| SSE 重放数量 | 默认 256；1～10000 | 用于短暂断线后的有限事件续接，不等同于历史数据库 |
| 操作结果保留 | 默认 10 分钟；1 分钟～24 小时 | 超期后不能再凭操作号查询 |
| 告警/历史分页 | 每页 1～100 条 | 日期采用 yyyyMMdd；时间采用 HH:mm:ss |
写请求支持幂等键：同一键和同一请求可安全重试；同一键用于不同请求会被拒绝。幂等键可不填，填写时最长 128 个可见 ASCII 字符。POST 请求必须声明 JSON 内容类型，正文必须是 JSON 对象。
常见问题
| 问题 | 排查方向 |
|---|---|
| 本机可访问，其他电脑不可访问 | 检查监听地址、系统防火墙、端口和网络路由；不要只监听回环地址 |
| 配置令牌后服务无法在局域网启动 | 非回环地址携带令牌时默认要求 TLS；配置证书，或仅在可信隔离网明确允许不安全 LAN |
| 页面能打开但接口返回 401/403 | 401 通常表示未带令牌，403 通常表示令牌错误或权限不足 |
| 写请求超时但设备后来执行成功 | 设备操作是异步任务；使用操作号查询最终状态，并为重试设置幂等键 |
| 实时流频繁断开 | 检查代理缓冲、空闲超时、SSE 心跳和客户端消费速度 |
注意事项
- EdgeWeb 页面可以访问，不代表设备一定在线或测点一定可写；最终结果仍由设备配置、通道状态和底层协议决定。
- 不要在无认证模式下监听局域网地址。控制令牌权限高于只读令牌，应分别生成、分别保存并定期轮换。
- "允许不安全局域网"会让令牌通过明文 HTTP 传输，仅可用于物理隔离且可信的临时网络。
- TLS 证书与私钥必须配套；修改安全参数、监听地址或端口后，应重新验证健康状态和远程访问。
- 静态页面只能从指定网页根目录提供，越界路径会被拒绝。发布自定义页面前应备份并测试资源引用。
- 批量写入可能部分成功、部分失败。调用方必须检查每项结果，不能只依据 HTTP 请求已接收判断设备写入成功。
- 对外集成时应设置合理的连接数、正文大小、超时和速率限制，并保留服务访问日志。公网场景建议置于受控反向代理或 VPN 后方。