Please note

This document refers to a legacy release (2.2) of Apache httpd. The active release (2.4) is documented here. If you have not already upgraded, please follow this link for more information.

You may follow this link to go to the current version of this document.

Apache モジュール mod_proxy_scgi

翻訳済み言語: en | ja

説明:	`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_balancer

例

以下の例を動かすには、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