HEG 网关

HEG（Hiasoon Edge Gateway，氦闪边缘网关） 是部署在您自有服务器上的数据访问代理程序。它使氦闪中台能够在不直连、不暴露数据库的前提下访问您的业务数据，是开发者后台 数据源配置 中 边缘网关模式 的落地组件。

适用版本：heg-verify 1.0.0

工作原理

1. HEG 启动后，主动通过 WebSocket 与氦闪中台建立长连接并完成 Token 鉴权。
2. 中台将需要执行的数据库操作（MySQL / Redis / MongoDB）或 HTTP 转发请求通过该连接下发。
3. HEG 在本机使用已配置的数据源执行操作，并把结果回传给中台。

整个过程由 HEG 主动出网建立连接，因此您无需向中台暴露数据源地址、账号与密码，也无需在数据源服务器上为中台开放白名单。

连接具备心跳保活（30 秒）与断线自动重连（指数退避，最长 60 秒），网络恢复后无需人工干预。

支持的能力

能力	说明
MySQL 操作转发	支持 SELECT / INSERT / UPDATE / DELETE / CREATE / ALTER 等，支持多条 SQL 智能拆分与事务
Redis 操作转发	支持 GET / SET / DEL / HGET / HSET / LRANGE 等常用命令
MongoDB 操作转发	支持 FIND / INSERT / UPDATE / DELETE / AGGREGATE 等操作
HTTP 请求转发	将业务请求转发到氦闪中台，自动完成 URL 转换与参数签名

文档导航

• 快速启动：获取镜像、配置并启动容器，完成首次连接。
• 持久化配置：配置持久化、日志持久化与数据卷挂载。
• 信息动态配置：通过 HEG 控制台在线调整云端连接、数据源与请求头。
• 开源社区：获取源码、问题反馈与参与贡献。

关键信息一览

项目	说明
服务端口	9000（控制台、健康检查，宿主机端口可自行映射）
中台 WebSocket	默认 9602，连接路径 /heg，HEG 作为客户端连接
中台网关地址	默认 10000（HTTP 转发使用）
控制台入口	http://<HEG 主机>:9000/monitor
健康检查	http://<HEG 主机>:9000/heg/test/health
运行时配置文件	/app/data/heg-runtime-config.yml（默认）
日志目录	/app/logs（默认）
数据卷	/app/data（配置）、/app/logs（日志）

相关技术栈

组件	版本
Spring Boot	2.7.18
Netty	4.1.100
Druid（MySQL 连接池）	1.2.20
Jedis（Redis 客户端）	3.x
MongoDB Driver	4.x
OkHttp（HTTP 客户端）	4.12.0

提示：HEG 需能访问中台的 WebSocket 端口，请确认服务器出方向网络与防火墙已放行。