HOMER 10 技术文档

概述

HOMER 10 是一个100%开源的VoIP与RTC（实时通信）观测平台，专注于实现实时的数据包捕获、故障排查与监控。它基于HEP/EEP协议，适用于处理大量的信令、RTC事件、日志和统计信息，并提供即时搜索、端到端关联分析以及深度探索功能。这个平台已经被全球大型企业、语音网络运营商、VoIP服务提供商和流量承运商广泛采用。

安装指南

要快速开始使用HOMER 10，你可以按照以下步骤进行：

Docker安装（推荐）

对于最简易的安装方式，采用Docker是首选。请参考HOMER的GitHub Wiki页面来获取最新的Docker安装命令和指导。这将允许您在一个容器中运行整个HOMER环境，无需复杂配置数据库和其他依赖项。

手动安装（自定义配置）

对于需要更细粒度控制的场景，可以选择手动设置每一个组件。首先确保满足必要的系统要求，如PostgreSQL 11+作为数据存储，Prometheus或InfluxDB用于时间序列数据，以及可选的Loki用于日志管理。详情可参照已注释掉的手动安装部分或访问官方文档以获得更新的指引。

使用说明

1. 界面登录: 成功部署后，通过浏览器访问HOMER的服务地址，默认为http://your_server_ip:9080，初始登录用户名为admin，密码为sipcapture，建议立即更改密码。

2. 配置HEP Capture: 根据您的架构，配置HEP捕捉代理，它能够从SIP、RTCP等流中捕获数据并发送至HOMER服务器。这可以通过在相关通讯软件（如Kamailio、OpenSIPS等）中集成HEP客户端实现。

3. 数据查看与分析: 登录后，您可以浏览实时捕获的数据，利用HOMER提供的搜索、过滤功能对数据进行深入分析。

API使用文档

HOMER提供了API接口，便于开发者集成和自动化操作。虽然具体的API文档没有直接提供，但通常包括数据检索、系统状态查询等功能。具体API端点和调用方法应在HOMER的应用程序代码或者官方社区、论坛中有讨论或示例。为了获得API的详细信息，建议查阅源码文档或联系开发者社区。

项目特性概览

• 全面的VoIP/RTC支持: 支持SIP、RTP/RTCP、RTC事件等多种协议的捕获与解析。
• 现代观测架构: 适应标准的可观测性工具，如Grafana，使得数据分析更为直观。
• 高扩展性: 设计为可动态映射和关联内外部数据源，适合大规模部署。

社区与支持

• 矩阵频道: 加入Matrix频道#sipcapture_homer:gitter.im与其他用户交流经验。
• 邮件列表: 订阅Google Group homer-discuss以获取支持和分享知识。
• 专业服务: 需要商业支持或定制化解决方案？访问http://qxip.net与QXIP团队联系。

记住，HOMER是人本主义的项目，欢迎贡献与支持，一起构建更好的VoIP监控解决方案。

---

本文档旨在简化HOMER 10的了解和使用流程，详细的操作和配置可能需要依据官方最新文档进行调整。