Apache HTTP サーバ バージョン 2.2
Apache モジュール mod_proxy_scgi
| 説明: | mod_proxy のための SCGI ゲートウェイモジュール |
|---|---|
| ステータス: | Extension |
| モジュール識別子: | proxy_scgi_module |
| ソースファイル: | mod_proxy_scgi.c |
| 互換性: | Apache 2.2.14 以降で使用可能 |
概要
本モジュールには mod_proxy が必要です。
本モジュールは SCGI protocol,
version 1 をサポートします。
SCGI プロトコルを扱うためには、mod_proxy
と mod_proxy_scgiが サーバに組み込まれて
いなければいけません。
警告
安全なサーバにするまでプロキシ機能は有効にしないでください。 オープンプロキシサーバはあなた自身のネットワークにとっても、 インターネット全体にとっても危険です。
例
以下の例を動かすには、mod_proxy と mod_proxy_scgi
を有効にしなければいけないことを忘れないでください。
簡単なゲートウェイ
ProxyPass /scgi-bin/ scgi://localhost:4000/
ロードバランスするゲートウェイには、既に言及したプロキシモジュール
に加えて mod_proxy_balancer が必要です。
ロードバランスするゲートウェイ
ProxyPass /scgi-bin/ balancer://somecluster/
<Proxy balancer://somecluster/>
BalancerMember scgi://localhost:4000/
BalancerMember scgi://localhost:4001/
</Proxy>
ProxySCGIInternalRedirect ディレクティブ
| 説明: | バックエンドからの内部的なリダイレクトレスポンスを有効あるいは無効にする |
|---|---|
| 構文: | ProxySCGIInternalRedirect On|Off |
| デフォルト: | ProxySCGIInternalRedirect On |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy_scgi |
ProxySCGIInternalRedirect で、
バックエンドが内部的にゲートウェイを別の URL にリダイレクトできるようにします。
この機能は mod_cgi 起源で、レスポンスステータスが
OK (200) で、かつレスポンスが Location
ヘッダを持ち、かつヘッダ値の先頭がスラッシュ (/) であれば、
内部的にリダイレクトします。このヘッダ値が内部的なリダイレクト先の
新しい URL として解釈されます。
機能を無効にしない限り、mod_proxy_scgi は
上記の点で mod_cgi と同じ動作をします。
例
ProxySCGIInternalRedirect Off
ProxySCGISendfile ディレクティブ
| 説明: | X-Sendfile 疑似レスポンスヘッダの評価を有効にする |
|---|---|
| 構文: | ProxySCGISendfile On|Off|Headername |
| デフォルト: | ProxySCGISendfile Off |
| コンテキスト: | サーバ設定ファイル, バーチャルホスト, ディレクトリ |
| ステータス: | Extension |
| モジュール: | mod_proxy_scgi |
ProxySCGISendfile ディレクティブを設定すると、
SCGI バックエンドの代わりにゲートウェイが直接ファイルを転送できるようにします。
これはパフォーマンス向上のために使えます。 httpd は sendfile
などの最適化を行うことができます。これはバックエンドからソケット経由でファイルを
受けた時にはできない最適化です。
ProxySCGISendfile の引数でゲートウェイの動作
を制御します:
Off- 特別な動作をしません。
On- ゲートウェイはバックエンドのレスポンスヘッダから
X-Sendfileと 呼ばれるヘッダを探し、その値を転送対象のファイル名と見なします。 ヘッダは最終的なレスポンスヘッダからは除かれます。 次の設定と等価です。ProxySCGISendfile X-Sendfile. - その他
Onにした場合に似ていますが、ハードコードしたヘッダ名の 代わりに、引数がヘッダ名として使われます。
Example
# Use the default header (X-Sendfile)
ProxySCGISendfile On
# Use a different header
ProxySCGISendfile X-Send-Static