Justniffer

プロジェクトページ

概要

Justniffer は、HTTP に重点を置いて TCP/IP トラフィックをキャプチャ、デコード、解析するために設計されたネットワーク TCP パケットスニッファ兼ロギングツールです。柔軟なロギングエンジンにより、事実上あらゆる TCP ベースのプロトコルに適応できるため、デバッグ、パフォーマンス分析、カスタムトラフィック検査に役立ちます。

Justniffer は HTTP リクエストとレスポンスをデコードし、以下を抽出できます：

• クライアントとサーバーの IP アドレス
• リクエストされた URL
• HTTP ヘッダー
• メッセージ本文
• タイミング情報（リクエスト時間、レスポンス時間、アイドル時間など）

HTTP 以外のトラフィックについては、Justniffer は強力でカスタマイズ可能なロギングシステムを提供し、TCP データストリームから関連するあらゆる情報を抽出できます。

パケットキャプチャは libpcap を使用して実行されるため、標準的なキャプチャ形式や tcpdump などのツールとの互換性が確保されています。

---

機能

• HTTP リクエスト/レスポンスのデコード
• あらゆる TCP ベースプロトコルに対応するカスタマイズ可能なログ形式
• パフォーマンス指標：リクエスト時間、レスポンス時間、アイドル時間、接続時間

sequenceDiagram
    participant Client
    participant Server

    %% Connection setup
    Client->>Server: SYN (connect)
    Note right of Server: %connection.time
    Server-->>Client: SYN/ACK
    Client->>Server: ACK
    Note right of Server: ESTABLISHED

    %% Idle before request
    Note right of Server: %idle.time.0\n(after connection, before request)

    %% Request phase
    Client->>Server: Request (first packet)
    Server-->>Client: ACK

    Client->>Server: Request (data...)
    Note right of Server: %request.time
    Server-->>Client: ACK

    Client->>Server: Request (last packet)
    Server-->>Client: ACK

    %% Response phase
    Note right of Server: %response.time.begin

    Server-->>Client: Response (first packet)
    Client->>Server: ACK

    Server-->>Client: Response (data...)
    Note right of Server: %response.time.end
    Client->>Server: ACK

    Server-->>Client: Response (last packet)
    Client->>Server: ACK

    %% Idle after response
    Note right of Server: %idle.time.1\n(after response, before next request/close)

    %% Connection close
    Server-->>Client: CLOSE

• libpcap ベースのキャプチャ（ライブまたは .pcap ファイルから）
• プロミスキャスモード対応によるパッシブ監視
• 外部スクリプト（bash、Python、Perl、ELF バイナリ）による拡張可能 — 詳細はこちら
• 並べ替え、再送、フラグメンテーションを含む TCP ストリームの再構築

---

クイックスタート

Ubuntu へのインストール

sudo apt install software-properties-common
sudo add-apt-repository ppa:oreste-notelli/ppa
sudo apt update
sudo apt install justniffer

アクセスログ形式でHTTPトラフィックをキャプチャする

justniffer -i eth0

各ログエントリに応答時間を追加する

justniffer -i eth0 -a " %response.time"

完全なHTTPリクエストとレスポンスをキャプチャする

justniffer -i eth0 -r

カスタムログ形式を使用する

justniffer -i eth0 -l "%request.timestamp %source.ip %dest.ip %request.header.host %request.url"

PCAP ファイルから読み取る

justniffer -f file.cap

例

例 1 — アクセスログ形式で HTTP トラフィックを取得する

justniffer -i eth0

output:

192.168.2.2 - - [15/Apr/2009:17:19:57 +0200] "GET /sflogo.php?group_id=205860&type=2 HTTP/1.1" 200 0 "" "Mozilla/5.0 ..."
...

例 2 — 追加フィールドの付加（例：HTTP 応答時間）

justniffer -i eth0 -a " %response.time"

output:

192.168.2.5 - - [22/Apr/2009:22:27:36 +0200] "GET /sflogo.php?group_id=205860&type=2 HTTP/1.1" ... 0.427993
...

例 3 — すべての TCP トラフィックをキャプチャする

(印刷不可能な文字をエンコードするには -u または -x を追加します)

justniffer -i eth0 -r

output:

GET /doc/maint-guide/ch-upload.en.html HTTP/1.1
Host: www.debian.org
...

例 4 — 完全にカスタムなログ形式を定義する

justniffer -i eth0 -l "%request.timestamp %source.ip %dest.ip %request.header.host %request.url"

output:

06/28/11 13:30:48 192.168.2.2 72.14.221.118 i1.ytimg.com /vi/TjSk6CVN5LY/default.jpg
...

例 5 — キャプチャファイルから読み取る

justniffer -f /file.cap

ドキュメント

完全なドキュメント、高度な例、および使用ガイド:
👉 https://onotelli.github.io/justniffer/

---

コントリビューション

プルリクエスト、バグレポート、機能提案を歓迎します。

---

ライセンス

Justniffer は GPLv3 ライセンスの下でリリースされています。