Whistle

Whistle は、ネットワークトラフィックのキャプチャ、確認、書き換えに使えるクロスプラットフォームのネットワークデバッグ用プロキシツールです。公式サイトでは、その特長を「高機能、操作が簡単、拡張可能、クロスプラットフォーム」とまとめています。

主な機能

• マルチプロトコル対応のプロキシ:HTTP、HTTPS、SOCKS、リバースプロキシに対応し、主要なネットワークプロトコルのトラフィックを傍受して書き換えられます。
• ルール設定:ルールを設定して、リクエストやレスポンスを書き換えます。ルールには次のような種類があります。
  • ローカルファイルへのマッピングとリモートアドレスへのマッピング
  • DNS スプーフィング(host)と上流プロキシへの転送
  • リクエストやレスポンスのヘッダー、Cookie、Body の書き換え
  • HTML、CSS、JS の注入
  • 速度制限と遅延
• オールインワンの画面:Web 画面に、キャプチャの確認(Network)、ルール設定(Rules)、Values、プラグイン管理、リクエストの作成(Composer)、HTTPS 証明書の設定などの機能がまとまっています。
• 内蔵デバッグツール:Weinre などのデバッグツールと、Console/Log 機能を内蔵しています。
• プラグインによる拡張:プラグインで機能を拡張できるほか、NPM モジュールとして他のプロジェクトに組み込むこともできます。
• モバイルデバッグ:公式サイトのドキュメントに、モバイル端末のプロキシ設定の手順が掲載されています。

対象ユーザーと利用シーン

主な対象は、フロントエンドおよびクライアントの開発者、テストエンジニア、バックエンド開発者です。API リクエストの確認、本番データの再現、レスポンス内容の書き換え、本番リソースのローカルファイルへの向け替え、スマートフォンアプリや H5 ページのデバッグといった用途で使われます。

インストールと導入

公式サイトでは、次の2種類のインストール方法が案内されています。

1. デスクトップ版:macOS、Windows、および GUI のある Linux(Ubuntu、Fedora など)で利用できます。公式では Whistle クライアント(プロジェクト avwo/whistle-client)を推奨しています。
2. コマンドライン版:GUI のない Linux サーバー、Docker コンテナ、組み込みシステム、IoT デバイスなどで利用できます(プロジェクト avwo/whistle)。コマンドライン版は Node.js ベースで、通常は npm でグローバルにインストールしてから起動します。具体的な手順は GitHub リポジトリの README に従ってください。

注目すべき特長

• ルール駆動で、柔軟に設定できます。ルールの構文には多少の学習コストがかかりますが、トラフィックを精密に制御できます。
• デスクトップ版とコマンドライン版があり、ローカルでのデバッグだけでなく、サーバーに配備してチームで利用することもできます。
• プロジェクトは GitHub でホストされており、公式サイトには中国語と英語のドキュメントがあります。