proxy2

単一のPythonスクリプトで動作するHTTP/HTTPSプロキシ

Features

• カスタマイズが簡単
• 外部モジュール不要
• IPv4とIPv6の両方をサポート
• HTTP/1.1永続接続をサポート
• HTTPS傍受のための動的証明書生成をサポート

このスクリプトはPython 2.7で動作します。 HTTPS接続を傍受するにはOpenSSLのインストールが必要です。

Usage

スクリプトとして実行するだけです:

$ python proxy2.py

上記のコマンドはlocalhost:8080でプロキシを実行します。 同じホストの別のターミナルで以下のコマンドを入力して動作を確認できます。

$ http_proxy=localhost:8080 curl http://www.example.com/

proxy2はデバッグ/テスト用に作られているため、localhostからの接続のみを受け付けます。

別のポートを使用するには、最初の引数としてポート番号を指定します。

$ python proxy2.py 3128

Enable HTTPS intercept

HTTPS接続を傍受するには、秘密鍵とプライベートCA証明書を生成します:

$ ./setup_https_intercept.sh

プロキシ経由でhttp://proxy2.test/ にアクセスし、ブラウザにCA証明書をインストールできます。

Customization

プロキシを簡単にカスタマイズして、リクエスト/レスポンスを変更したり、ファイルに何かを保存したりできます。 ProxyRequestHandlerクラスには、カスタマイズ用の3つのメソッドがあります:

• request_handler: アップストリームサーバーにアクセスする前に呼び出されます
• response_handler: クライアントに応答する前に呼び出されます
• save_handler: クライアントへの応答後に排他ロック付きで呼び出されるため、端末やファイルシステムへの書き出しを安全に行えます

デフォルトでは、save_handlerのみが実装されており、HTTP(S)ヘッダーと有用なデータを標準出力に出力します。