sipcapture/heplify-server

heplify-server 镜像文档

!image

镜像概述和主要用途

heplify-server是一款独立的HOMER捕获服务器，采用Go语言开发，针对速度和简洁性进行了优化。作为单一二进制文件分发，可捕获来自https://github.com/sipcapture/heplify%E6%88%96%E5%85%B6%E4%BB%96https://github.com/sipcapture/hep%E5%85%BC%E5%AE%B9%E4%BB%A3%E7%90%86%E7%9A%84TLS%E5%92%8CUDP HEP包、Protobuf封装包，将数据索引至数据库并使用H5或H7表格式进行轮转。该服务器通过Prometheus和Grafana提供精确的SIP和RTCP指标，支持网络全局视图和单个SIP中继监控。

核心特点：无需Kamailio或OpenSIPS依赖的轻量级HOMER捕获服务器，不追求Kamailio/OpenSIPS的配置语言定制能力，专注于简洁易用。

核心功能和特性

• 独立运行：作为单一二进制文件，无需依赖Kamailio或OpenSIPS
• 协议支持：捕获TLS和UDP HEP包、Protobuf封装包
• 数据处理：支持数据库索引，采用H5（MySQL/MariaDB）或H7（PostgreSQL）表格式轮转
• 指标监控：集成Prometheus和Grafana，提供SIP和RTCP精确指标
• 网络视图：支持全局网络状态查看和单个SIP中继监控
• 灵活配置：通过命令行标志、环境变量、本地配置文件或Web表单（设置ConfigHTTPAddr）进行配置
• 热重载：0.92版本及以上支持PromTargetIP和PromTargetName配置热重载

使用场景和适用范围

• SIP网络流量捕获与分析
• VoIP通信质量监控
• 实时通信网络性能指标收集
• 中小型网络环境的SIP中继监控
• 需要轻量级HOMER部署的场景（无复杂SIP服务器依赖）

安装方法

选项1：下载发布版

直接从https://github.com/sipcapture/heplify-server/releases%E4%B8%8B%E8%BD%BD%E9%A2%84%E7%BC%96%E8%AF%91%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6%E3%80%82

选项2：Docker Compose

使用提供的Docker Compose配置快速部署：

bash
cd heplify-server/docker/hom5-hep-prom-graf/
docker-compose up -d

选项3：源码编译

1. 安装Go 1.11+环境：安装指南
2. 编译源码：

bash
go build cmd/heplify-server/heplify-server.go

系统要求

根据使用的数据库 schema 不同，要求如下：

• Homer5 schema：MySQL ≥ 5.7 或 MariaDB ≥ 10
• Homer7 schema：PostgreSQL ≥ 10

配置说明

heplify-server支持多种配置方式：

• 命令行标志
• 环境变量
• 本地https://github.com/sipcapture/heplify-server/blob/master/example/
• Web表单（需设置ConfigHTTPAddr参数）

!配置界面

Systemd服务设置

使用示例https://github.com/sipcapture/heplify-server/blob/master/example/%EF%BC%8C%E5%B9%B6%E6%8C%89%E7%85%A7%E6%96%87%E4%BB%B6%E9%A1%B6%E9%83%A8%E7%9A%84%E8%AF%B4%E6%98%8E%E8%BF%9B%E8%A1%8C%E9%85%8D%E7%BD%AE%E3%80%82

配置热重载

0.92版本及以上支持PromTargetIP和PromTargetName配置热重载，执行以下命令：

bash
killall -HUP heplify-server

使用方法

独立运行

bash
./heplify-server -h  # 查看帮助信息

Docker部署

提供包含heplify-server、Homer 5 UI、Prometheus、Alertmanager和Grafana的完整Docker Compose配置：

bash
# 克隆仓库（如需）
git clone https://github.com/sipcapture/heplify-server.git
cd heplify-server/docker/hom5-hep-prom-graf/
# 启动服务
docker-compose up -d

支持与贡献

• 欢迎测试人员、问题报告者和贡献者参与：https://github.com/sipcapture/heplify-server/issues

截图

!SIP指标 !XRTP监控 !Loki集成

由人类开发

本开源项目由独立开发者开发，无企业赞助。如果您在生产环境中使用本软件，欢迎通过贡献代码或***支持开发。

![]([]