リバースプロキシを使用するためにはプロキシモジュールの組み込みが必要です。プロキシモジュールを組み込むにはコンフィグファイル（httpsd.conf）に次に示すディレクティブを指定します。プロキシモジュールを組み込むには，コンフィグファイル（httpsd.conf）に次に示すディレクティブを指定します。UNIX版の場合は，必ず次に示す順序でLoadModuleディレクティブを指定してください。

• UNIX版
  

  LoadModule proxy_module libexec/mod_proxy.so LoadModule proxy_http_module libexec/mod_proxy_http.so

• Windows版
  

  LoadModule proxy_module modules/mod_proxy.so LoadModule proxy_http_module modules/mod_proxy_http.so

リバースプロキシを設定する各ディレクティブの設定例を次に示します。

ここでは各アドレスを次のように仮定しています。

リバースプロキシ：www.example.com

バックエンドサーバ：backend.example.com

(a)　リクエストURLの再割り当ておよびリクエストヘッダの再割り当て

次のようにProxyPassディレクティブを設定すると，クライアントからの"http://www.example.com/news/oct-2001"というリクエストは"http://backend.example.com/oct-2001"というリクエストに変更されます。

 
ProxyPass /news/ http://backend.example.com/
 

Host:ヘッダは"Host:www.example.com"から"Host:backend.example.com"に再割り当てします。そして，リバースプロキシはバックエンドサーバからのレスポンスをクライアントに応答します。

(b)　応答ヘッダの再割り当て

Redirectディレクティブの指定，イメージマップの利用または末尾を/（スラッシュ）で閉じないディレクトリ指定のリクエストなど，バックエンドサーバでリダイレクトが指示された場合には，バックエンドサーバからのレスポンスのLocationヘッダにバックエンドサーバのアドレスが記載されます。これをそのままクライアントに応答すると，クライアントはリダイレクトをリバースプロキシではなく，直接バックエンドサーバにリクエストします。そこで，ProxyPassReverseディレクティブに次のように指定し，リダイレクトリクエストもリバースプロキシを通るリクエストになるようにします。

 
ProxyPassReverse /news/ http://backend.example.com/
 

これで，Locationヘッダはリバースプロキシのアドレスに変更されます。

(c)　Set-Cookieヘッダの再割り当て

バックエンドサーバがクライアントに返すSet-Cookieヘッダには，ドメイン名およびパス名が指定される場合があります。これは，Set-Cookieヘッダのドメイン名およびパス名に一致したリクエストの場合だけ，クライアントにクッキーを送信させるためです。

Set-Cookieヘッダの再割り当てをしない場合と再割り当てをする場合について説明します。

●Set-Cookieヘッダの再割り当てをしない例

バックエンドサーバが応答したドメイン名およびパス名を含むSet-Cookieヘッダをリバースプロキシがそのままクライアントに応答する例を次の図に示します。なお，図中の数字は，説明文の項番と対応しています。

図4-8　Set-Cookieヘッダの再割り当てをしない例

1. クライアントからリバースプロキシに対して，http://www.example.com/front/cgi-bin/test-cgi.plがリクエストされます。
2. リバースプロキシは，URLを変換してバックエンドサーバへ転送します。
3. リバースプロキシは，バックエンドサーバからドメイン名domain=backend.example.com，パス名path=/cgi-bin/のSet-Cookieヘッダを受信します。
4. リバースプロキシは，バックエンドサーバから受信したSet-Cookieヘッダをそのままクライアントに返します。

この場合，クライアントはリバースプロキシを経由する/front/cgi-bin/以下へのリクエストについて，Set-Cookieヘッダで受信したクッキーを送信しません。これは，クライアントが受信したSet-Cookieヘッダのドメイン名backend.example.comが，リバースプロキシのドメイン名www.example.comと異なるためです。また，パス名についても同様に適合しません。

●Set-Cookieヘッダの再割り当てをする例

バックエンドサーバがSet-Cookieヘッダで応答したクッキーをクライアントから受け取るためには， HWSProxyPassReverseCookieディレクティブの指定が必要です。HWSProxyPassReverseCookieディレクティブを指定してSet-Cookieヘッダの再割り当てをする例を次の図に示します。なお，図中の数字は，説明文の項番と対応しています。

図4-9　Set-Cookieヘッダの再割り当てをする例

1. クライアントからリバースプロキシに対して，http://www.example.com/front/cgi-bin/test-cgi.plがリクエストされます。
2. リバースプロキシは，URLを変換してバックエンドサーバへ転送します。
3. リバースプロキシは，バックエンドサーバからドメイン名domain=backend.example.com，パス名path=/cgi-bin/のSet-Cookieヘッダを受信します。
4. リバースプロキシは，再割り当てしたSet-Cookieヘッダをクライアントに返します。

この場合，クライアントはリクエストURLのパス部分/front/cgi-bin/test-cgi.plに対して，前方一致するパス名/front/cgi-bin/のSet-Cookieヘッダを受信します。また，クライアントが受信するSet-Cookieヘッダにはドメイン名が含まれていません。これは，クライアントがリクエストしたURLのドメイン名www.example.com がSet-Cookieヘッダに指定されている場合と同じ意味となります。したがって，リバースプロキシを経由したバックエンドサーバへのリクエストに，Set-Cookieヘッダで設定したクッキーを送信させることができます。

リバースプロキシとバックエンドサーバにHitachi Web Serverを使用してシステムを構築する場合の設定例を次に示します。

システムの構築時には，リダイレクト処理に注意して設定する必要があります。バックエンドサーバ上のディレクトリに対し，URLの最後に/ (スラッシュ)を付けないでアクセスした場合，バックエンドサーバはLocationヘッダを付加したリダイレクト要求を返信します。このとき，Locationヘッダの値をバックエンドサーバのアドレスからリバースプロキシのアドレスに変換し，クライアントの再要求先をリバースプロキシ経由に変更する必要があります。

ここでは，システムのネットワーク構成を図4-10のように仮定しています。また各アドレスを次のように仮定しています。

リバースプロキシ：www.example.com

バックエンドサーバ：backend.example.com

図4-10　ネットワーク構成

(a)　推奨する構成

ProxyPassディレクティブに指定するホスト名，パス名と，ProxyPassReverseディレクティブに指定するホスト名，パス名は同一の値としてください。また，バックエンドサーバ側のすべてのバーチャルホストでServerNameディレクティブを指定し，その値はリバースプロキシ側のProxyPassReverseディレクティブに設定したホスト名と同一にしてください。

図4-10に示すネットワーク構成で，リバースプロキシおよびバックエンドサーバの設定を表4-6のようにした場合のリダイレクト処理の流れは，表4-7のようになります。

表4-6　推奨する構成の設定例

表4-7　推奨する構成でのリダイレクト処理の流れ

注

バックエンドサーバからの応答がステータスコード（302 Foundや404 Not Foundなど）になった場合，リバースプロキシはそのHTMLドキュメントをそのままクライアントに転送します。「404 Not Found」などのHTMLドキュメントに記載されるバックエンドサーバ名や，「302 Found」などに記載されるリダイレクト先のリンクアドレスはリバースプロキシの情報に変更されません。バックエンドサーバ側でErrorDocumentディレクティブを使用またはリバースプロキシ側でProxyErrorOverrideディレクティブを使用して，バックエンドサーバの情報をクライアントに見せないようにしてください。

(b)　リバースプロキシ側でProxyPreserveHostディレクティブにOnを設定する構成

通常，リバースプロキシはクライアントから受信したHostヘッダの値をProxyPassディレクティブの値に従って変更し，バックエンドサーバに転送します。クライアントが送信したHostヘッダの値をバックエンドサーバ側でもHostヘッダの値として取得したい場合は，リバースプロキシ側でProxyPreserveHostディレクティブの値をOnに設定します。このとき，次の点に注意してください。

• バックエンドサーバ側のServerNameディレクティブには，リバースプロキシのServerNameと同じ値を指定してください。
• ProxyPassReverseディレクティブに設定するホスト名は，リバースプロキシおよびバックエンドサーバのServerNameと同じ値にしてください。

図4-10に示すネットワーク構成で，リバースプロキシおよびバックエンドサーバの設定を表4-8のようにした場合のリダイレクト処理の流れは表4-9のようになります。

表4-8　リバースプロキシ側でProxyPreserveHostにOnを設定する構成の設定例

表4-9　リバースプロキシ側でProxyPreserveHostにOnを設定する構成でのリダイレクト処理の流れ

(a)　基本的な注意事項

• リバースプロキシはリクエストURLのパターンによって機能を設定します。このため，特定のリクエストはリバースプロキシとしてほかのバックエンドサーバに転送，それ以外のリクエストはリバースプロキシ自身がWebサーバとして応答するという設定もできます。しかし，このような設定は，リクエストがリバースプロキシかWebサーバかどちらで処理したかがわかりにくくなります。したがって，リバースプロキシを使用する場合は次のような設定にして，すべてのリクエストをリバースプロキシからバックエンドサーバへ転送することを推奨します。
  

  ProxyPass / http://転送先バックエンドサーバアドレス/

  リバースプロキシとWebサーバを共用する場合は，バーチャルホストで機能を分けた運用ができます。
  
• リバースプロキシでは，クライアントから受信したHostヘッダの値をX-Forwarded-Hostヘッダに格納し，Hostヘッダの値をProxyPassディレクティブの指定値に変換してバックエンドサーバへ転送します。このため，バックエンドサーバ側のアプリケーションでクライアントが送信したHostヘッダの値を参照する場合は，リバースプロキシが送信したX-Forwarded-Hostヘッダの値を参照してください。ただし，ProxyPreserveHostディレクティブの値にOnを設定している場合は，リバースプロキシが送信したHostヘッダの値をそのまま参照してください。
• リバースプロキシを経由してバックエンドサーバにアクセスする場合，バックエンドサーバが提供するHTMLコンテンツでのリンク先は，バックエンドサーバ上のURLではなく，リバースプロキシにアクセスされるURLを指定する必要があります。このほか，画像やスタイルシートなどのコンテンツの参照先URLを記述する場合も同じように注意が必要です。
  （例）
  次の状態にあるときに，index.htmlからindex2.htmlへリンクを張るとします。
  
  • リバースプロキシ側でProxyPassディレクティブの値が /before/ http://バックエンドサーバのアドレス/after/ と指定されている。
  • バックエンドサーバ側でindex.htmlとindex2.htmlが同じディレクトリ内（/after/以下）に存在する。
  この場合のindex.htmlの記述方法とアクセス可否の関係を次に示します。
  

  表4-10　リンクの記述方法とリンク可否の関係

  リンクの記述	リンクをクリックしたときのアクセス可否
  <A HREF="index2.html">リンク</A>	○
  <A HREF="/before/index2.html">リンク</A>	○
  <A HREF="http://リバースプロキシのアドレス/before/index2.html">リンク</A>	○
  <A HREF="/after/index2.html">リンク</A>	×

• リバースプロキシは，HTTPバージョン0.9をサポートしていません。

(b)　ProxyPassディレクティブに関する注意事項

• ProxyPassディレクティブで指定するパス名とリクエストURLは完全に等しいか，パス名がリクエストURLの先頭から含まれていれば，適合と判断します。
  ただし，パス名の終端が/（スラッシュ）でない場合，リクエストURLと完全に等しいかまたは先頭からディレクトリとして含まれていれば適合と判断します。
  適合すると，ProxyPassディレクティブに指定したパス名にリクエストURLの先頭からパス名と等しい部分を除いた残りの部分を追加してリクエストを転送します。
  ProxyPassディレクティブに指定するパス名は終端を/（スラッシュ）で閉じたものを指定してください。次にProxyPassディレクティブの指定とリクエストの関係を次に示します。
  

  表4-11　ProxyPassディレクティブの指定とリクエストの関係

  ProxyPassディレクティブの指定例	リクエスト	適合可否	リクエスト転送先
  ProxyPass /abc/ http://backend.example.com/	http://リバースプロキシのアドレス/abc/	○	http://backend.example.com/
  	http://リバースプロキシのアドレス/abc	×	−
  	http://リバースプロキシのアドレス/abc/def	○	http://backend.example.com/def
  ProxyPass /abc http://backend.example.com/	http://リバースプロキシのアドレス/abc	○	http://backend.example.com/
  	http://リバースプロキシのアドレス/abc/	○	http://backend.example.com//
  	http://リバースプロキシのアドレス/abc/def	○	http://backend.example.com//def

  （凡例）

  ○：適合する。

  ×：適合しない。

  −：該当しない。

  
  
• ProxyPassディレクティブを複数指定し，リクエストURLが複数のパス名に一致した場合，先に指定したProxyPassディレクティブが有効になります。
  （例）
  /abc/def/へのリクエストを処理するバックエンドサーバ：backend1.example.com
  /abc/def/以外の/abc/へのリクエストを処理するバックエンドサーバ：backend2.example.com
  ほかのすべてのリクエストを処理するバックエンドサーバ：backend3.example.com
  このように設定するには次の順序で指定してください。
  

  ProxyPass /abc/def/ http://backend1.example.com/ ProxyPass /abc/ http://backend2.example.com/ ProxyPass / http://backend3.example.com/

• ProxyPassディレクティブの指定によるリクエストURLはWebサーバの機能である自プロセス内の該当ファイルの検索より先に転送します。したがって，リクエストURLに適合するファイルがある場合でも，ProxyPassディレクティブのパス名に適合すれば，バックエンドサーバへのリクエストに変換して転送します。
• /（スラッシュ）で閉じていないディレクトリを指定したリクエストURLの場合，リバースプロキシではリダイレクトを応答しません。
  

  （例）ProxyPass /ab/ http://backend.example.com/　の場合

  リクエストがhttp://リバースプロキシのアドレス/abのとき，適合していないと判断して，リバースプロキシ内に/abがなければ，「404 Not Found」を返します。

(c)　ProxyPassReverseディレクティブに関する注意事項

• ProxyPassReverseディレクティブに指定したURLとバックエンドサーバから受信したLocationヘッダの値は，完全に等しいかまたはURLがリクエストURLの先頭から含まれていれば，適合と判断します。適合すると，アドレスをリバースプロキシとして，ProxyPassReverseディレクティブの指定に従って，クライアントに送信します。
  

  （例）バックエンドサーバからの応答のLocationヘッダが，Location: http://バックエンドサーバのアドレス/docs/memo/の場合

  ProxyPassReverseディレクティブの指定が，

  ProxyPassReverse /path/ http://バックエンドサーバのアドレス/docs/

  と指定されていれば，クライアントに返すLocationヘッダは

  Location: http://リバ−スプロキシのアドレス/path/memo/

  となります。

  ProxyPassReverseディレクティブを複数指定した場合，先に指定した方が有効になります。
  
• リバースプロキシがProxyPassReverseディレクティブの設定値に従ってLocationヘッダの値を変換してクライアントに転送する際，Locationヘッダの値のスキームは現在のコネクションで使用しているものを設定します。例えば，httpでアクセスしている場合，httpを設定します。このため，httpでアクセスしている場合にLocationヘッダでhttpsにリダイレクトさせるときは，バックエンドサーバ側でリバースプロキシのホスト名をLocationヘッダの値に設定しておくなどしてProxyPassReverseディレクティブの値と一致しないようにしてください。

(d)　HWSProxyPassReverseCookieディレクティブに関する注意事項

• HWSProxyPassReverseCookieディレクティブは，バックエンドサーバが応答したSet-Cookieヘッダを変換する場合に指定します。HWSProxyPassReverseCookieディレクティブに，ProxyPassディレクティブのパス名と同じ値を指定することで，ProxyPassディレクティブ単位に設定できます。
• リバースプロキシのディレクティブ指定が次のような場合のSet-Cookieヘッダの変換規則について説明します。
  

  ProxyPass /front/ http://backend.example.com/ HWSProxyPassReverseCookie /front/

  表4-12　Set-Cookieヘッダの変換規則

  項番	クライアントに応答するSet-Cookieヘッダ	バックエンドサーバが応答するSet-Cookieヘッダ	変換規則の説明
  1	Set-Cookie: 〜; path=/front/	Set-Cookie: 〜; path=/	バックエンドサーバが応答するSet-Cookieヘッダにドメイン名が指定されていない場合は，Set-Cookieヘッダのパス名/（スラッシュ）を/front/に置き換えます。
  2	Set-Cookie: 〜; path=/front/	Set-Cookie: 〜; domain=backend.example.com; path=/	バックエンドサーバが応答するSet-Cookieヘッダのドメイン名が，ProxyPassディレクティブで指定した転送先URLのドメイン名と完全に一致している場合は，Set-Cookieヘッダのパス名/（スラッシュ）を/front/に置き換えます。また，Set-Cookieヘッダのドメイン名を削除してクライアントに返します。
  3	Set-Cookie: 〜; domain=.example.com; path=/	Set-Cookie: 〜; domain=.example.com; path=/	バックエンドサーバが応答するSet-Cookieヘッダのドメイン名が，.（ピリオド）から始まるドメイン名である場合は，バックエンドサーバが応答したSet-Cookieヘッダをそのままクライアントに返します。
  4	Set-Cookie: 〜; domain=other.example.com; path=/	Set-Cookie: 〜; domain=other.example.com; path=/	バックエンドサーバが応答するSet-Cookieヘッダのドメイン名がProxyPassディレクティブで指定した転送先URLのドメイン名と異なる場合は，バックエンドサーバが応答したSet-Cookieヘッダをそのままクライアントに返します。
  5	Set-Cookie: 〜	Set-Cookie: 〜	バックエンドサーバが応答するSet-Cookieヘッダにドメイン名およびパス名が指定されていない場合は，バックエンドサーバが応答したSet-Cookieヘッダをそのままクライアントに返します。

• リバースプロキシのディレクティブ指定が次の場合に，バックエンドサーバが応答したSet-Cookieヘッダのパス名を変換する規則について説明します。
  

  ProxyPass /front/ http://backend.example.com/abc/def/ HWSProxyPassReverseCookie /front/

  • バックエンドサーバが返すSet-Cookieヘッダのパス名が/abc/def/ghi/の場合
    ProxyPassディレクティブの転送先URLのパス名部分が，Set-Cookieヘッダのパス名に前方から一致する場合は，一致したパス名部分をProxyPassディレクティブのパス名で置き換えます。
    

    

  • バックエンドサーバが返すSet-Cookieヘッダのパス名が/abc/の場合
    Set-Cookieヘッダのパス名が，ProxyPassディレクティブの転送先URLのパス名部分に前方から一致する場合は，Set-Cookieヘッダのパス名としてProxyPassディレクティブのパス名で置き換えます。
    

    

  • バックエンドサーバが返すSet-Cookieヘッダのパス名が/abc/xxx/の場合
    ProxyPassディレクティブの転送先URLのパス名部分とSet-Cookieヘッダのパス名が一致しない場合は，リバースプロキシでのSet-Cookieヘッダ変換は実行しません。バックエンドサーバが応答したSet-Cookieヘッダをそのままクライアントに返します。
    

    

(e)　性能に関する注意事項

ProxyPassディレクティブにドメイン名またはホスト名を指定している場合，DNSへの問い合わせが発生します。バックエンドサーバのIPアドレスがわかっている場合は，hostsファイルにあらかじめIPアドレスを記載しておくことによって，名前解決の時間を短縮できます。