氦闪中台文档

# 信息动态配置

HEG 内置了一个轻量管理控制台，支持无需重启容器即可在线调整云端连接、数据源、转发请求头与日志策略等配置。

# 控制台入口

http://<HEG 所在主机>:9000/monitor

控制台分为 运行概览 与 系统配置 两个页面。

安全提示：该控制台为本地管理接口，未内置鉴权。请勿将 9000 端口直接暴露到公网，建议仅在内网访问或通过安全组/防火墙限制来源 IP。

# 运行概览

用于查看 HEG 的运行状态与执行明细：

区块 说明
远端连接状态 与氦闪中台的 WebSocket 连接状态
执行日志 展示 SQL 执行日志与转发日志，支持按条数查询
日志操作 一键 清空 SQL 日志 / 清空转发日志

# 系统配置

可在线修改以下配置，点击对应的 保存 / 保存并重载 按钮即时生效：

区块 操作 生效方式
云端连接配置 修改 WebSocket 地址、APPID、密钥、网关地址 保存后若连接参数变化，自动触发 WebSocket 重连
MySQL 数据源 修改连接 URL、账号密码、连接池参数 保存并重载，重载 MySQL 连接池
Redis 数据源 修改地址、端口、密码、库号 保存并重载，重载 Redis 连接池
MongoDB 数据源 修改连接串、数据库名 保存并重载，重载 MongoDB 连接池
接口转发请求头配置 维护允许透传到氦闪平台的请求头列表 立即生效
日志持久化 开关业务操作日志、调整路径与保留天数 立即生效
连接池管理 一键 重载所有连接池 重新初始化全部数据源连接池

# 敏感信息处理

  • 密钥 / 密码等敏感项在页面中以 *** 显示，MongoDB 连接串中的账号密码也会被脱敏；
  • 提交时，若敏感项仍为 *** 或留空，则保留原值不被覆盖，可放心只修改其它字段。

# 配置持久化

以上保存操作会依据 配置持久化 策略落盘：

  • type=file（默认）：写入 /app/data/heg-runtime-config.yml，重启后仍生效；
  • type=memory：仅当前进程有效，重启后回归配置文件中的值。

注意：由于持久化文件的值会覆盖环境变量，建议配置项以「控制台修改」或「配置文件/环境变量」之一为准，避免两处不一致造成困惑。

# 接口转发请求头

只有出现在 接口转发请求头配置 列表中的请求头，才会在 HEG 转发请求到氦闪平台时被透传；列表外的请求头会被丢弃。

  • 新增请求头时会与现有列表合并去重；
  • 请求头名称不区分大小写。

# 管理接口（REST API）

除控制台页面外，相关能力也可通过以下接口以编程方式调用（均为本地接口，路径以 /monitor 开头）：

接口 方法 说明
/monitor GET 控制台页面
/monitor/api/connection-status GET 查询远端连接状态
/monitor/api/sql-logs GET 查询 SQL 日志（limit 指定条数）
/monitor/api/proxy-logs GET 查询转发日志（limit 指定条数）
/monitor/api/clear/sql POST 清空 SQL 日志
/monitor/api/clear/proxy POST 清空转发日志
/monitor/api/clear/all POST 清空所有日志
/monitor/api/config GET 获取当前配置（敏感项已脱敏）
/monitor/api/config/cloud POST 更新云端连接配置
/monitor/api/config/mysql POST 更新 MySQL 数据源
/monitor/api/config/redis POST 更新 Redis 数据源
/monitor/api/config/mongodb POST 更新 MongoDB 数据源
/monitor/api/config/proxy-headers POST 新增/合并转发请求头
/monitor/api/config/proxy-headers/{header} DELETE 删除指定转发请求头
/monitor/api/config/log-persistence POST 更新日志持久化配置
/monitor/api/config/reload POST 重载所有连接池
/monitor/api/stats GET 运行统计（运行时长、各数据源数量）
/heg/test/health GET 健康检查

# 与外部配置的关系

通过控制台修改的配置仅作用于当前运行的 HEG 实例，并不会反写镜像内置的 application.yml。它只按持久化策略写入运行时配置存储。若您希望以外部配置文件为唯一来源，可：

  1. 将 heg.config-persistence.type 设为 memory；或
  2. 保持 file 模式，但每次修改外部配置后同步清理运行时配置文件。

← 开源社区 →