Repolode
sipcapture

sipcapture/homer

HEPパケットをDuckDB/Parquetデータレイクに取り込み、検索やコールフロー分析に活用できるオープンソースのSIP/VoIP・RTCパケットキャプチャサーバー。

スター
2,032
フォーク
295
未解決の Issue
1
最終コミット
4 時間前

これは何?

Homerは、SIP、VoIP、リアルタイム通信のトラフィックを可視化する通信事業者向けサーバーです。キャプチャエージェントからUDP、TCP、TLS、HTTP、HTTPS経由でHEP(Homer Encapsulation Protocol)パケットを受信し、Parquetファイルを基盤とするDuckLakeデータレイクに保存します。カタログにはSQLiteまたはオブジェクトストレージを利用でき、REST API、組み込みWeb UI、Arrow FlightSQLエンドポイントを通じてデータにアクセスできます。

Goで実装されており、コマンドラインからの検索、対話型DuckLake SQLシェル、カタログのバックアップと復元、対話型設定ウィザードをサブコマンドとして備えた単一バイナリで提供されます。すべてのモジュールを1つのプロセスで実行することも、拡張性を高めるためにwriter、node、coordinatorの各ロールに分けて実行することもできます。

オプションモジュールとして、SIP QoSレポート用のVQRTCPコレクターと、SIPRECシグナリングレコーダーを追加できます。また、LLMやエージェント向けツールと連携するMCPインターフェースも備えています。

主な機能

  • 01UDP、TCP、TLS、HTTP、HTTPS経由でHEPパケットを受信
  • 02ローカルストレージまたはオブジェクトストレージ上のDuckLakeカタログにParquetファイルとしてデータを保存
  • 03REST API、組み込みWeb UI、Arrow FlightSQLによるクエリアクセスを提供
  • 04コールフロー、CSV、JSON、pcap形式で出力できるコマンドライン検索機能
  • 05オプションでVQRTCPによるSIP QoS収集とSIPRECシグナリング録音に対応
  • 06LLMやエージェントとの連携にMCPをサポート

ユースケース

  • VoIPネットワーク全体のコールフローを確認し、SIP通話の失敗をトラブルシューティング
  • セッションボーダーコントローラーからのRTPおよびSIP品質レポートを監視
  • メディアゲートウェイからのSIPRECセッションを記録・分析
  • FlightSQL経由でSQLやGrafanaを使って、キャプチャした通信事業者トラフィックをクエリ

クイックスタート

  1. 1

    リリースページからリリースをダウンロードし、お使いのOSとアーキテクチャに対応するhomerパッケージをインストールします

  2. 2

    プロジェクトをローカルでビルドします

    make
  3. 3

    設定ファイルを指定してサーバーを起動します

    ./homer --config-path /etc/homer/homer.json

使う前に知っておきたいこと

  • AGPL-3.0ライセンス(コピーレフト)で提供されており、ネットワーク経由で利用する改変版のソースコード開示が必要です。
  • 実行前に、ingest、storage、node、coordinatorモジュールを設定するJSON設定ファイルを作成する必要があります。
  • READMEに記載されている対応環境は、x64およびARM64のLinuxとmacOSのみです。

収録されている特集

トピック

よくある質問

homer とは?
HEPパケットをDuckDB/Parquetデータレイクに取り込み、検索やコールフロー分析に活用できるオープンソースのSIP/VoIP・RTCパケットキャプチャサーバー。 Homerは、SIP、VoIP、リアルタイム通信のトラフィックを可視化する通信事業者向けサーバーです。キャプチャエージェントからUDP、TCP、TLS、HTTP、HTTPS経由でHEP(Homer Encapsulation Protocol)パケットを受信し、Parquetファイルを基盤とするDuckLakeデータレイクに保存します。カタログにはSQLiteまたはオブジェクトストレージを利用でき、REST API、組み込みWeb UI、Arrow FlightSQLエンドポイントを通じてデータにアクセスできます。
homer は無料で使えますか?ライセンスは?
homer は Other ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
homer は今もメンテナンスされていますか?
活発にメンテナンス中。homer の最終コミットは 2026年11月7日 です。
homer は何に使えますか?
VoIPネットワーク全体のコールフローを確認し、SIP通話の失敗をトラブルシューティング セッションボーダーコントローラーからのRTPおよびSIP品質レポートを監視 メディアゲートウェイからのSIPRECセッションを記録・分析 FlightSQL経由でSQLやGrafanaを使って、キャプチャした通信事業者トラフィックをクエリ
homer のインストール方法は?
リリースページからリリースをダウンロードし、お使いのOSとアーキテクチャに対応するhomerパッケージをインストールします プロジェクトをローカルでビルドします: make 設定ファイルを指定してサーバーを起動します: ./homer --config-path /etc/homer/homer.json
homer はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/sipcapture/homer

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト