granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy.html.ja.utf8

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml" lang="ja" xml:lang="ja"><head>
   4 <meta content="text/html; charset=UTF-8" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mod_proxy - Apache HTTP サーバ バージョン 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p>
  21 <p class="apache">Apache HTTP サーバ バージョン 2.5</p>
  22 <img alt="" src="../images/feather.png" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP サーバ</a> &gt; <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> &gt; <a href="../">バージョン 2.5</a> &gt; <a href="./">モジュール</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Apache モジュール mod_proxy</h1>
  28 <div class="toplang">
  29 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  30 <a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  31 <a href="../ja/mod/mod_proxy.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
  32 </div>
  33 <div class="outofdate">この日本語訳はすでに古くなっている
  34             可能性があります。
  35             最近更新された内容を見るには英語版をご覧下さい。
  36         </div>
  37 <table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>HTTP/1.1 プロキシ/ゲートウェイサーバ</td></tr>
  38 <tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
  39 <tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>proxy_module</td></tr>
  40 <tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_proxy.c</td></tr></table>
  41 <h3>概要</h3>
  42
  43     <div class="warning"><h3>警告</h3>
  44       <p><a href="#access">サーバを安全にする</a>まで <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> は有効にしないでください。
  45       オープンプロキシサーバはあなた自身のネットワークにとっても、
  46       インターネット全体にとっても危険です。</p>
  47     </div>
  48
  49     <p>このモジュールは Apache のプロキシ/ゲートウェイ機能を実装しています。
  50     <code>AJP13</code> (Apache JServe Protocol version 1.3),
  51     <code>FTP</code>, <code>CONNECT</code> (SSL 用),
  52     <code>HTTP/0.9</code>, <code>HTTP/1.0</code>, <code>HTTP/1.1</code>
  53     のプロキシ機能を実装しています。これらのプロトコルやその他のプロトコル用の
  54     プロキシ機能を持った、他のモジュールに接続するようにも設定できます。</p>
  55
  56     <p>Apache のプロキシ機能は <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> の他に、
  57     いくつかのモジュールに分割されています:
  58     <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code>, <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code>,
  59     <code class="module"><a href="../mod/mod_proxy_ajp.html">mod_proxy_ajp</a></code>, <code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code>,
  60     <code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code> です。ですから、
  61     特定のプロキシの機能を使いたい場合は、<code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> <em>と</em>
  62     該当するモジュールをサーバに (コンパイル時に静的に行なうか
  63     <code class="directive"><a href="../mod/mod_so.html#loadmodule">LoadModule</a></code> で動的に読み込むかして)
  64     組み込む必要があります。</p>
  65
  66     <p>これに加えて、他のモジュールによって拡張機能が提供されています。
  67     キャッシュは <code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> と関連モジュールで
  68     提供されています。SSL/TLS で遠隔サーバに接続する機能は
  69     <code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code> の <code>SSLProxy*</code> ディレクティブで
  70     提供されています。これらの機能を利用するためには、該当するモジュールを
  71     組み込んで設定しなければなりません。</p>
  72 </div>
  73 <div id="quickview"><h3>トピック</h3>
  74 <ul id="topics">
  75 <li><img alt="" src="../images/down.gif" /> <a href="#forwardreverse">フォワードプロキシとリバースプロキシ</a></li>
  76 <li><img alt="" src="../images/down.gif" /> <a href="#examples">基本の例</a></li>
  77 <li><img alt="" src="../images/down.gif" /> <a href="#access">プロキシへのアクセス制御</a></li>
  78 <li><img alt="" src="../images/down.gif" /> <a href="#startup">遅い起動</a></li>
  79 <li><img alt="" src="../images/down.gif" /> <a href="#intranet">イントラネットプロキシ</a></li>
  80 <li><img alt="" src="../images/down.gif" /> <a href="#envsettings">プロトコルの調整</a></li>
  81 <li><img alt="" src="../images/down.gif" /> <a href="#request-bodies">リクエストボディ</a></li>
  82 </ul><h3 class="directives">ディレクティブ</h3>
  83 <ul id="toc">
  84 <li><img alt="" src="../images/down.gif" /> <a href="#balancergrowth">BalancerGrowth</a></li>
  85 <li><img alt="" src="../images/down.gif" /> <a href="#balancerinherit">BalancerInherit</a></li>
  86 <li><img alt="" src="../images/down.gif" /> <a href="#balancermember">BalancerMember</a></li>
  87 <li><img alt="" src="../images/down.gif" /> <a href="#balancerpersist">BalancerPersist</a></li>
  88 <li><img alt="" src="../images/down.gif" /> <a href="#noproxy">NoProxy</a></li>
  89 <li><img alt="" src="../images/down.gif" /> <a href="#proxy">&lt;Proxy&gt;</a></li>
  90 <li><img alt="" src="../images/down.gif" /> <a href="#proxyaddheaders">ProxyAddHeaders</a></li>
  91 <li><img alt="" src="../images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li>
  92 <li><img alt="" src="../images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li>
  93 <li><img alt="" src="../images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li>
  94 <li><img alt="" src="../images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li>
  95 <li><img alt="" src="../images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li>
  96 <li><img alt="" src="../images/down.gif" /> <a href="#proxymatch">&lt;ProxyMatch&gt;</a></li>
  97 <li><img alt="" src="../images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li>
  98 <li><img alt="" src="../images/down.gif" /> <a href="#proxypass">ProxyPass</a></li>
  99 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassinherit">ProxyPassInherit</a></li>
 100 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li>
 101 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li>
 102 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li>
 103 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li>
 104 <li><img alt="" src="../images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li>
 105 <li><img alt="" src="../images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li>
 106 <li><img alt="" src="../images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li>
 107 <li><img alt="" src="../images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li>
 108 <li><img alt="" src="../images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li>
 109 <li><img alt="" src="../images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li>
 110 <li><img alt="" src="../images/down.gif" /> <a href="#proxyset">ProxySet</a></li>
 111 <li><img alt="" src="../images/down.gif" /> <a href="#proxysourceaddress">ProxySourceAddress</a></li>
 112 <li><img alt="" src="../images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li>
 113 <li><img alt="" src="../images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li>
 114 <li><img alt="" src="../images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li>
 115 </ul>
 116 <h3>Bugfix checklist</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">httpd changelog</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_proxy">Known issues</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_proxy">Report a bug</a></li></ul><h3>参照</h3>
 117 <ul class="seealso">
 118 <li><code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code></li>
 119 <li><code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code></li>
 120 <li><code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li>
 121 <li><code class="module"><a href="../mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li>
 122 <li><code class="module"><a href="../mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li>
 123 <li><code class="module"><a href="../mod/mod_ssl.html">mod_ssl</a></code></li>
 124 <li><a href="#comments_section">コメント</a></li></ul></div>
 125 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 126 <div class="section">
 127 <h2><a name="forwardreverse" id="forwardreverse">フォワードプロキシとリバースプロキシ</a></h2>
 128       <p>Apache は<dfn>フォワード</dfn>プロキシとしても、
 129       <dfn>リバース</dfn>プロキシとしても設定することができます。</p>
 130
 131       <p>通常の<dfn>フォワードプロキシ</dfn>はクライアントと
 132       <em>オリジンサーバ</em> <span class="transnote">(<em>訳注:</em> コンテンツ生成元のサーバ)</span>
 133       の間に位置する中間サーバです。
 134       オリジンサーバからコンテンツを取得する過程では、クライアントは
 135       行き先としてオリジンサーバを指定しつつプロキシにリクエストを送り、
 136       プロキシはオリジンサーバからコンテンツ取得のリクエストを送り、
 137       コンテンツが取得できればそれをクライアントに返します。
 138       クライアントが他のサイトにフォワードプロクシ経由でアクセスするには、
 139       特別にそれ用の設定をしなければなりません。</p>
 140
 141       <p>フォワードプロキシの一般的な使用方法は、ファイアウォールによって
 142       制限されている内部のクライアントにインターネットへのアクセスを
 143       提供するものです。フォワードプロキシはネットワークの使用量を
 144       減らすために (<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code> で提供されている)
 145       キャッシュ機能を用いることもできます。</p>
 146
 147       <p>フォワードプロキシは <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> ディレクティブで
 148       有効になります。フォワードプロキシでは、クライアントは本当の身元を
 149       隠して任意のサイトにアクセスできるようになるため、フォワードプロキシを
 150       有効にする前に、承認されたクライアントのみがプロキシにアクセスできるように
 151       <a href="#access">サーバを安全にする</a>ことが重要です。</p>
 152
 153       <p>一方<dfn>リバースプロキシ</dfn>は、クライアントには普通の
 154       ウェブサーバのように見えます。クライアント側に特別な設定は必要ありません。
 155       クライアントはリバースプロキシの名前空間に対して通常のコンテンツへの
 156       リクエストを行ないます。プロキシはリクエストをどこに送れば良いかを判定し、
 157       あたかも自分自身がオリジンサーバであったかのようにクライアントに
 158       コンテンツを返します。</p>
 159
 160       <p>リバースプロキシのよくある利用方法は、インターネットユーザに
 161       ファイアウォールの中にあるサーバにアクセスを与えるというものです。
 162       リバースプロキシは複数のバックエンドサーバへ負荷分散をするために
 163       使ったり、遅いバックエンドエンドサーバのためにキャッシュ機能を提供したり
 164       するために使えます。また、リバースプロキシは複数のサーバを
 165       同じ URL 空間にまとめるために使うこともできます。</p>
 166
 167       <p>リバースプロキシは <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブや
 168       <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ディレクティブの
 169       <code>[P]</code> フラグを使うことで有効になります。リバースプロキシの
 170       設定のために <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> を設定する必要は
 171       <em>ありません</em>。</p>
 172     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 173 <div class="section">
 174 <h2><a name="examples" id="examples">基本の例</a></h2>
 175
 176     <p>以下の例は手始めの簡単な例です。個々のディレクティブの意味は
 177     それぞれの説明をお読みください。</p>
 178
 179     <p>またキャッシュ機能を有効にしたい場合は、<code class="module"><a href="../mod/mod_cache.html">mod_cache</a></code>
 180     の説明を読んでください。</p>
 181
 182     <div class="example"><h3>フォワードプロキシ</h3><p><code>
 183     ProxyRequests On<br />
 184     ProxyVia On<br />
 185     <br />
 186     &lt;Proxy *&gt;<br />
 187     <span class="indent">
 188       Order deny,allow<br />
 189       Deny from all<br />
 190       Allow from internal.example.com<br />
 191     </span>
 192     &lt;/Proxy&gt;
 193     </code></p></div>
 194
 195     <div class="example"><h3>リバースプロキシ</h3><p><code>
 196     ProxyRequests Off<br />
 197     <br />
 198     &lt;Proxy *&gt;<br />
 199     <span class="indent">
 200       Order deny,allow<br />
 201       Allow from all<br />
 202     </span>
 203     &lt;/Proxy&gt;<br />
 204     <br />
 205     ProxyPass /foo http://foo.example.com/bar<br />
 206     ProxyPassReverse /foo http://foo.example.com/bar
 207     </code></p></div>
 208     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 209 <div class="section">
 210 <h2><a name="access" id="access">プロキシへのアクセス制御</a></h2>
 211       <p>プロキシのアクセスは以下のように <code class="directive"><a href="#proxy">&lt;Proxy&gt;</a></code> コンテナの中に
 212       ディレクティブを書くことで制御できます:</p>
 213
 214       <div class="example"><p><code>
 215         &lt;Proxy *&gt;<br />
 216         <span class="indent">
 217           Order Deny,Allow<br />
 218           Deny from all<br />
 219           Allow from 192.168.0<br />
 220         </span>
 221         &lt;/Proxy&gt;
 222       </code></p></div>
 223
 224       <p>アクセス制御のためのディレクティブのより詳しい情報は
 225       <code class="module"><a href="../mod/mod_authz_host.html">mod_authz_host</a></code> をお読みください。</p>
 226
 227       <p>(<code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> ディレクティブを
 228       使って) フォワードプロキシを設定している場合は、厳しくアクセス
 229       制限を行なうことが非常に大切です。そうしないと、任意のクライアントが
 230       身元を明かすことなく任意のホストにアクセスするためにサーバを使うことが
 231       できてしまいます。これはあなた自身のネットワークにとっても、インターネット
 232       全体にとっても危険なことです。(<code>ProxyRequests Off</code> にして
 233       <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブを使って)
 234       リバースプロキシを使っている場合には、クライアントはあなたが明示的に
 235       設定したホストにしかアクセスできないため、フォワードプロキシのとき
 236       ほどアクセス制御に力を注がなくても大丈夫です。</p>
 237
 238     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 239 <div class="section">
 240 <h2><a name="startup" id="startup">遅い起動</a></h2>
 241       <p><code class="directive"><a href="#proxyblock">ProxyBlock</a></code> ディレクティブを使っている場合、
 242       後のテストのために起動時にホストの
 243       IP アドレスが調べられてキャッシュされます。ホスト名のルックアップの
 244       速さによっては、数秒 (かそれ以上) かかるかもしれません。</p>
 245     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 246 <div class="section">
 247 <h2><a name="intranet" id="intranet">イントラネットプロキシ</a></h2>
 248       <p>イントラネットにある Apache プロキシサーバは外部へのリクエストを
 249       会社のファイアウォールを通して送らなければなりません。(このためには
 250       個々の <var>scheme</var> についてそれぞれ、ファイアウォールの
 251       プロキシにフォワードされるように
 252       <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> ディレクティブを
 253       設定してください)。しかしイントラネット内のリソースにアクセスするときは、
 254       ファイアウォールを通さないでもアクセスできます。
 255       どのホストがイントラネットに属し、直接アクセスすべきかを指定するには、
 256       <code class="directive"><a href="#noproxy">NoProxy</a></code> ディレクティブが
 257       役に立ちます。</p>
 258
 259       <p>イントラネット内のユーザは WWW のリクエストでローカルドメインを
 260       省略することがよくあります。<code>http://somehost.example.com/</code>
 261       というリクエストの代わりに "http://somehost/" をリクエストしたりします。
 262       このようなリクエストを受け付け、サーバに設定されているローカルドメインが
 263       暗黙のうちに使われていると解釈して、単純にリクエストを処理するものも
 264       商用プロキシサーバの中にはあります。
 265       サーバが <a href="#proxyrequests">プロキシのサービス用に設定されていて</a>
 266       <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> ディレクティブが
 267       使用された場合には、Apache はクライアントにリダイレクト応答を送って、
 268       正しい、完全な (<span class="transnote">(<em>訳注:</em> fully qualified)</span>)
 269       サーバのアドレスに送ることができます。このように
 270       リダイレクトすると、ユーザのブックマークが正しい完全なホスト名を含む
 271       ことにもなるため、より好ましい方法と言えるでしょう。</p>
 272     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 273 <div class="section">
 274 <h2><a name="envsettings" id="envsettings">プロトコルの調整</a></h2>
 275       <p>Keepalive や HTTP/1.1 を適切に実装していないアプリケーションサーバに対して
 276       <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> がリクエストを送信する場合、
 277       HTTP/1.0 を使って keepalive を無しにしてリクエストを送るようにする
 278       環境変数が二つあります。これらは <code class="directive"><a href="../mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブで設定します。</p>
 279
 280       <p><code>force-proxy-request-1.0</code> と <code>proxy-nokeepalive</code>
 281       がその環境変数です。</p>
 282
 283       <div class="example"><p><code>
 284         &lt;Location /buggyappserver/&gt;<br />
 285         <span class="indent">
 286           ProxyPass http://buggyappserver:7001/foo/<br />
 287           SetEnv force-proxy-request-1.0 1<br />
 288           SetEnv proxy-nokeepalive 1<br />
 289         </span>
 290         &lt;/Location&gt;
 291       </code></p></div>
 292
 293     </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 294 <div class="section">
 295 <h2><a name="request-bodies" id="request-bodies">リクエストボディ</a></h2>
 296
 297     <p>POST メソッドなどのリクエストには、リクエストボディがあります。
 298     HTTP プロトコル仕様によると、ボディのあるリクエストは chunked
 299     転送を使うか、<code>Content-Length</code>
 300     ヘッダを送信しなければなりません。
 301     このようなリクエストをオリジンサーバに送信する場合、
 302     <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> は常に <code>Content-Length</code>
 303     を送ろうと試みます。しかし。ボディが大きく、オリジナルのリクエストで
 304     chunked 転送が使われている場合、上流へのリクエストに
 305     chunked 転送も使われます。
 306     この挙動は <a href="../env.html">環境変数</a>で制御できます。
 307     <code>proxy-sendcl</code> を設定すると、可能な限り常に
 308     <code>Content-Length</code> を付与して、
 309     上流サーバに送信するようになります。
 310     逆に <code>proxy-sendchunked</code> を設定すると、リソース消費を抑え、
 311     chnked エンコードを使って送信するようになります。</p>
 312
 313     </div>
 314 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 315 <div class="directive-section"><h2><a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a> <a name="balancergrowth" id="balancergrowth">ディレクティブ</a></h2>
 316 <table class="directive">
 317 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of additional Balancers that can be added Post-configuration</td></tr>
 318 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr>
 319 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerGrowth 5</code></td></tr>
 320 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 321 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 322 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 323 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerGrowth is only available in Apache HTTP Server 2.3.13
 324   and later.</td></tr>
 325 </table><p>このディレクティブの解説文書は
 326             まだ翻訳されていません。英語版をご覧ください。
 327             </p></div>
 328 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 329 <div class="directive-section"><h2><a name="BalancerInherit" id="BalancerInherit">BalancerInherit</a> <a name="balancerinherit" id="balancerinherit">ディレクティブ</a></h2>
 330 <table class="directive">
 331 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Inherit proxy Balancers/Workers defined from the main server</td></tr>
 332 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerInherit On|Off</code></td></tr>
 333 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerInherit On</code></td></tr>
 334 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 335 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 336 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 337 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerInherit is only available in Apache HTTP Server 2.4.5 and later.</td></tr>
 338 </table><p>このディレクティブの解説文書は
 339             まだ翻訳されていません。英語版をご覧ください。
 340             </p></div>
 341 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 342 <div class="directive-section"><h2><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">ディレクティブ</a></h2>
 343 <table class="directive">
 344 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Add a member to a load balancing group</td></tr>
 345 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr>
 346 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
 347 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 348 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 349 </table><p>Documentation not yet translated. Please see English version of document.</p>
 350 </div>
 351 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 352 <div class="directive-section"><h2><a name="BalancerPersist" id="BalancerPersist">BalancerPersist</a> <a name="balancerpersist" id="balancerpersist">ディレクティブ</a></h2>
 353 <table class="directive">
 354 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Attempt to persist changes made by the Balancer Manager across restarts.</td></tr>
 355 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerPersist On|Off</code></td></tr>
 356 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerPersist Off</code></td></tr>
 357 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 358 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 359 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 360 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerPersist is only available in Apache HTTP Server 2.4.4 and later.</td></tr>
 361 </table><p>このディレクティブの解説文書は
 362             まだ翻訳されていません。英語版をご覧ください。
 363             </p></div>
 364 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 365 <div class="directive-section"><h2><a name="NoProxy" id="NoProxy">NoProxy</a> <a name="noproxy" id="noproxy">ディレクティブ</a></h2>
 366 <table class="directive">
 367 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>直接接続する ホスト、ドメイン、ネットワーク</td></tr>
 368 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>NoProxy <var>host</var> [<var>host</var>] ...</code></td></tr>
 369 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 370 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 371 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 372 </table>
 373     <p>このディレクティブはイントラネット中の Apache プロキシサーバにのみ
 374     有用です。<code class="directive">NoProxy</code> ディレクティブは空白区切りで、
 375     サブネット、IP アドレス、ホスト、ドメインのリストを指定します。
 376     これらのどれかにマッチするホストへのリクエストは <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> で設定されたプロキシサーバに
 377     フォワードされず、直接処理されます。</p>
 378
 379     <div class="example"><h3>例</h3><p><code>
 380       ProxyRemote  *  http://firewall.mycompany.com:81<br />
 381       NoProxy         .mycompany.com 192.168.112.0/21
 382     </code></p></div>
 383
 384     <p><code class="directive">NoProxy</code> ディレクティブの <var>host</var> 引数は
 385     以下の種類のどれかです:</p>
 386
 387     <dl>
 388
 389     <dt><var><a name="domain" id="domain">Domain</a></var></dt>
 390     <dd>
 391     <p><dfn>Domain</dfn> は先頭にピリオドの着いた部分 DNS ドメイン名です。
 392     同一 DNS ドメイン及びゾーン (<em>すなわち</em>、ホスト名の末尾がすべて
 393     <var>Domain</var> で終わっているということ) に属するホストのリストを
 394     表します)。</p>
 395
 396     <div class="example"><h3>例</h3><p><code>
 397       .com .apache.org.
 398     </code></p></div>
 399
 400     <p><var>Domain</var> を <a href="#hostname">Hostname</a> と区別するために (意味的にも構文的にも。DNS ドメインも
 401     DNS の A レコードを持つことができるのです!)、<var>Domain</var> は
 402     常にピリオドで始まります。</p>
 403
 404     <div class="note"><h3>注</h3>
 405       <p>ドメイン名の比較は大文字小文字を区別せずに行なわれ、<var>Domain</var>
 406       は常に DNS ツリーのルートから始まるものとみなされます。ですから、
 407       次の二つのドメイン <code>.MyDomain.com</code> と
 408       <code>.mydomain.com.</code> (最後のピリオドに注目) は同一であると
 409       みなされます。ドメインの比較は DNS ルックアップなしで行なわれるため、
 410       サブネットの比較よりもずっと効率的です。</p>
 411     </div></dd>
 412
 413
 414     <dt><var><a name="subnet" id="subnet">SubNet</a></var></dt>
 415     <dd>
 416     <p><dfn>SubNet</dfn> は数値形式 (ドットで区切られた四つの数字) の
 417     部分インターネットアドレスです。後にスラッシュと <var>Subnet</var>
 418     の意味のあるビット数を指定するネットマスクとを続けることができます。
 419     共通のネットワークインタフェースを使って到達することのできるサブネットを
 420     表すために使われます。明示的にネットマスクを指定しない場合は
 421     最後の省略された (もしくは値が 0 の) 数字がマスクを指定します。
 422     (この場合は、ネットマスクは 8 ビット単位でしか指定できません。)
 423     例:</p>
 424
 425     <dl>
 426     <dt><code>192.168</code> もしくは <code>192.168.0.0</code></dt>
 427     <dd>サブネット 192.168.0.0 と暗黙の 16 ビット有効なネットマスク
 428     (<code>255.255.0.0</code> というネットマスクの形式で使われることも
 429     あります)</dd>
 430     <dt><code>192.168.112.0/21</code></dt>
 431     <dd>サブネット<code>192.168.112.0/21</code> と 21 ビット有効な
 432     ネットマスク (<code>255.255.248.0</code> という形式で使われることも
 433     あります)</dd>
 434     </dl>
 435
 436     <p>特別な場合に、32 ビット有効な <em>SubNet</em> は
 437     <var><a href="#ipadr">IPAddr</a></var> と同等で、
 438     0 ビット有効な <var>SubNet</var> (<em>例えば</em>、0.0.0.0/0) は
 439     すべての IP アドレスにマッチする定数 <var>_Default_</var> と同じです。</p>
 440     </dd>
 441
 442
 443     <dt><var><a name="ipaddr" id="ipaddr">IPAddr</a></var></dt>
 444     <dd>
 445     <p><dfn>IPAddr</dfn> は数値形式 (ドットで区切られた四つの数字) の
 446     完全インターネットアドレスです。通常はこのアドレスはホストを
 447     表しますが、必ずしもアドレスに対応する DNS ドメイン名があるわけでは
 448     ありません。</p>
 449
 450     <div class="example"><h3>例</h3><p><code>
 451       192.168.123.7
 452     </code></p></div>
 453
 454     <div class="note"><h3>注</h3>
 455       <p><var>IPAddr</var> は DNS システムにより解決される必要がないので、
 456       apache の性能が向上するかもしれません。</p>
 457     </div></dd>
 458
 459
 460     <dt><var><a name="hostname" id="hostname">Hostname</a></var></dt>
 461     <dd>
 462     <p><dfn>Hostname</dfn> は DNS ドメインサービスにより一つもしくは
 463     複数の <var><a href="#ipaddr">IPAddr</a></var> に解決可能な
 464     完全な DNS ドメイン名です。これは (<var><a href="#domain">Domain</a></var>
 465     と違って、説明は上記を参照) 論理的なホストを表し、少くとも一つの
 466     <var><a href="#ipaddr">IPAddr</a></var> (もしくは違う
 467     <var><a href="#ipaddr">IPAddr</a></var> のホストのリスト) に解決
 468     されなければなりません)。</p>
 469
 470     <div class="example"><h3>例</h3><p><code>
 471       prep.ai.mit.edu<br />
 472       www.apache.org
 473     </code></p></div>
 474
 475     <div class="note"><h3>注</h3>
 476       <p>多くの場合、<var>Hostname</var> の代わりに <var><a href="#ipaddr">IPAddr</a></var> を指定した方が、DNS ルックアップを
 477       避けることができるため、効率が良くなります。Apache の名前解決は
 478       ネームサーバへの接続が遅い PPP 上の場合などにかなり時間を取られる
 479       ことがあります。</p>
 480       <p><var>Hostname</var> の比較は大文字小文字を区別せずに行なわれ、
 481       <var>Hostname</var> は常に DNS ツリーのルートから始まるものとみなされます。
 482       ですから、二つのドメイン <code>WWW.MyDomain.com</code> と
 483       <code>www.mydomain.com.</code> (最後のピリオドに注目) は同一であると
 484       みなされます。</p>
 485      </div></dd>
 486     </dl>
 487
 488 <h3>参照</h3>
 489 <ul>
 490 <li><a href="../dns-caveats.html">DNS に関する問題</a></li>
 491 </ul>
 492 </div>
 493 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 494 <div class="directive-section"><h2><a name="Proxy" id="Proxy">&lt;Proxy&gt;</a> <a name="proxy" id="proxy">ディレクティブ</a></h2>
 495 <table class="directive">
 496 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされるリソースに適用されるコンテナ</td></tr>
 497 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;Proxy <var>wildcard-url</var>&gt; ...&lt;/Proxy&gt;</code></td></tr>
 498 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 499 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 500 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 501 </table>
 502     <p><code class="directive">&lt;Proxy&gt;</code> セクション中の
 503     ディレクティブはマッチするプロキシされるコンテンツにのみ適用されます。
 504     シェル形式のワイルドカードが使えます。</p>
 505
 506     <p>例えば、次の設定は <code>yournetwork.example.com</code> の
 507     ホストにのみプロキシサーバを経由したアクセスを許可します:</p>
 508
 509     <div class="example"><p><code>
 510       &lt;Proxy *&gt;<br />
 511       <span class="indent">
 512         Order Deny,Allow<br />
 513         Deny from all<br />
 514         Allow from yournetwork.example.com<br />
 515       </span>
 516       &lt;/Proxy&gt;
 517     </code></p></div>
 518
 519     <p>次の例は <code>example.com</code> の <code>foo</code> ディレクトリの
 520     すべてのファイルに対して、プロキシサーバを通して送られたときには
 521     <code>INCLUDES</code> フィルタを通して送るように設定します:</p>
 522
 523     <div class="example"><p><code>
 524       &lt;Proxy http://example.com/foo/*&gt;<br />
 525       <span class="indent">
 526         SetOutputFilter INCLUDES<br />
 527       </span>
 528       &lt;/Proxy&gt;
 529     </code></p></div>
 530
 531
 532
 533 </div>
 534 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 535 <div class="directive-section"><h2><a name="ProxyAddHeaders" id="ProxyAddHeaders">ProxyAddHeaders</a> <a name="proxyaddheaders" id="proxyaddheaders">ディレクティブ</a></h2>
 536 <table class="directive">
 537 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Add proxy information in X-Forwarded-* headers</td></tr>
 538 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyAddHeaders Off|On</code></td></tr>
 539 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyAddHeaders On</code></td></tr>
 540 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
 541 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 542 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 543 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in version 2.3.10 and later</td></tr>
 544 </table><p>このディレクティブの解説文書は
 545             まだ翻訳されていません。英語版をご覧ください。
 546             </p></div>
 547 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 548 <div class="directive-section"><h2><a name="ProxyBadHeader" id="ProxyBadHeader">ProxyBadHeader</a> <a name="proxybadheader" id="proxybadheader">ディレクティブ</a></h2>
 549 <table class="directive">
 550 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>応答におかしなヘッダがある場合の扱い方を決める</td></tr>
 551 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyBadHeader IsError|Ignore|StartBody</code></td></tr>
 552 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyBadHeader IsError</code></td></tr>
 553 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 554 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 555 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 556 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>2.0.44 以降</td></tr>
 557 </table>
 558     <p><code class="directive">ProxyBadHeader</code> ディレクティブは構文的に
 559     間違ったヘッダ (<em>つまり</em> コロンを含まないもの) を受け取ったときに
 560     <code class="module"><a href="../mod/mod_proxy.html">mod_proxy</a></code> がどう振る舞うかを決めます。以下の引数を
 561     取ることができます:</p>
 562
 563     <dl>
 564     <dt><code>IsError</code></dt>
 565     <dd>リクエストを中止して 502 (Bad Gateway) 応答を返す。
 566     これがデフォルトの動作です。</dd>
 567
 568     <dt><code>Ignore</code></dt>
 569     <dd>間違ったヘッダ行をそもそも存在しなかったものとして扱う。</dd>
 570
 571     <dt><code>StartBody</code></dt>
 572     <dd>間違ったヘッダ行を受け取ったら、ヘッダの読み込みを終了して、
 573     それ以降の残りをボディとして扱う。これはヘッダとボディの間に空行を入れ忘れて
 574     しまっているような、きちんと動作していないバックエンドサーバがあるときに、
 575     問題を回避するのに役に立ちます。</dd>
 576     </dl>
 577
 578 </div>
 579 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 580 <div class="directive-section"><h2><a name="ProxyBlock" id="ProxyBlock">ProxyBlock</a> <a name="proxyblock" id="proxyblock">ディレクティブ</a></h2>
 581 <table class="directive">
 582 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシ接続を禁止する語句、ホスト名、ドメインを指定する</td></tr>
 583 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyBlock *|<var>word</var>|<var>host</var>|<var>domain</var>
 584 [<var>word</var>|<var>host</var>|<var>domain</var>] ...</code></td></tr>
 585 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 586 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 587 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 588 </table>
 589     <p><code class="directive">ProxyBlock</code> ディレクティブは空白で区切られた
 590     語句、ホスト名、ドメインのリストを指定します。サイト名にその語句、ホスト名、
 591     ドメインを含むサイトへの HTTP、HTTPS、FTP によるドキュメントのリクエストは
 592     プロキシサーバにより<em>ブロックされます</em>。プロキシモジュールは
 593     起動時にホスト名と思しき項目の IP アドレスを調べ、後のテストのために
 594     キャッシュします。これにより、サーバの起動が少し遅くなるかもしれません。</p>
 595
 596     <div class="example"><h3>Example</h3><p><code>
 597       ProxyBlock joes-garage.com some-host.co.uk rocky.wotsamattau.edu
 598     </code></p></div>
 599
 600     <p><code>rocky.wotsamattau.edu</code> が IP アドレスで参照されたときでも
 601     マッチします。</p>
 602
 603     <p><code>wotsamattau.edu</code> のマッチには <code>wotsamattau</code>
 604     だけでも十分です。</p>
 605
 606     <div class="example"><p><code>
 607       ProxyBlock *
 608     </code></p></div>
 609
 610     <p>はすべてのサイトへの接続をブロックすることに注意してください。</p>
 611
 612 </div>
 613 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 614 <div class="directive-section"><h2><a name="ProxyDomain" id="ProxyDomain">ProxyDomain</a> <a name="proxydomain" id="proxydomain">ディレクティブ</a></h2>
 615 <table class="directive">
 616 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされたリクエストのデフォルトのドメイン名</td></tr>
 617 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyDomain <var>Domain</var></code></td></tr>
 618 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 619 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 620 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 621 </table>
 622     <p>このディレクティブはイントラネット内の Apache プロキシサーバにのみ
 623     有用です。<code class="directive">ProxyDomain</code> ディレクティブは
 624     apache プロキシサーバが属するデフォルトのドメインを指定します。
 625     ドメイン名の無いリクエストを受けた場合、設定された <var>Domain</var>
 626     が追加された同じホストへのリダイレクト応答が返されます。</p>
 627
 628     <div class="example"><h3>例</h3><p><code>
 629       ProxyRemote  *  http://firewall.mycompany.com:81<br />
 630       NoProxy         .mycompany.com 192.168.112.0/21<br />
 631       ProxyDomain     .mycompany.com
 632     </code></p></div>
 633
 634 </div>
 635 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 636 <div class="directive-section"><h2><a name="ProxyErrorOverride" id="ProxyErrorOverride">ProxyErrorOverride</a> <a name="proxyerroroverride" id="proxyerroroverride">ディレクティブ</a></h2>
 637 <table class="directive">
 638 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされたコンテンツのエラーページを上書きする</td></tr>
 639 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyErrorOverride On|Off</code></td></tr>
 640 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyErrorOverride Off</code></td></tr>
 641 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 642 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 643 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 644 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>バージョン 2.0 以降で使用可能</td></tr>
 645 </table>
 646     <p>このディレクティブはリバースプロキシを使用していて、
 647     エンドユーザに送られるエラーページの外見を共通のものにしたいときに
 648     有用です。このディレクティブは (<code class="module"><a href="../mod/mod_include.html">mod_include</a></code> の SSI によって)
 649     インクルードされたファイルがエラーコードを取得して、正しく動作を
 650     するようにもします (デフォルトの動作は、プロキシされたサーバの
 651     エラーページの表示で、このディレクティブを有効にすると SSI のエラー
 652     メッセージを表示します)。</p>
 653
 654 </div>
 655 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 656 <div class="directive-section"><h2><a name="ProxyIOBufferSize" id="ProxyIOBufferSize">ProxyIOBufferSize</a> <a name="proxyiobuffersize" id="proxyiobuffersize">ディレクティブ</a></h2>
 657 <table class="directive">
 658 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>内部データスループットバッファのサイズを決定する</td></tr>
 659 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyIOBufferSize <var>bytes</var></code></td></tr>
 660 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyIOBufferSize 8192</code></td></tr>
 661 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 662 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 663 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 664 </table>
 665     <p><code class="directive">ProxyIOBufferSize</code> ディレクティブは入力と
 666     出力用の一時メモリとして使われる内部バッファのサイズを調整します。
 667     サイズは <code>8192</code> 以下でなければなりません。</p>
 668
 669     <p>ほとんどすべての場合、この値を変更する理由はありません。</p>
 670
 671 </div>
 672 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 673 <div class="directive-section"><h2><a name="ProxyMatch" id="ProxyMatch">&lt;ProxyMatch&gt;</a> <a name="proxymatch" id="proxymatch">ディレクティブ</a></h2>
 674 <table class="directive">
 675 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現でのマッチによるプロキシリソース用のディレクティブコンテナ</td></tr>
 676 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>&lt;ProxyMatch <var>regex</var>&gt; ...&lt;/ProxyMatch&gt;</code></td></tr>
 677 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 678 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 679 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 680 </table>
 681     <p><code class="directive">&lt;ProxyMatch&gt;</code> は URL のマッチに
 682     <a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a> を用いることを除いて
 683     <code class="directive">&lt;Proxy&gt;</code> ディレクティブと同じです。</p>
 684
 685 </div>
 686 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 687 <div class="directive-section"><h2><a name="ProxyMaxForwards" id="ProxyMaxForwards">ProxyMaxForwards</a> <a name="proxymaxforwards" id="proxymaxforwards">ディレクティブ</a></h2>
 688 <table class="directive">
 689 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リクエストがフォワードされるプロキシの最大数</td></tr>
 690 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyMaxForwards <var>number</var></code></td></tr>
 691 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyMaxForwards 10</code></td></tr>
 692 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 693 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 694 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 695 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0 以降で使用可能</td></tr>
 696 </table>
 697     <p><code class="directive">ProxyMaxForwards</code> ディレクティブは
 698     リクエストに <code>Max-Forwards</code> ヘッダが指定されていない場合に
 699     リクエストが通過可能なプロキシの最大数を設定します。これは
 700     プロキシの無限ループや DoS 攻撃を防ぐために設定されています。</p>
 701
 702     <div class="example"><h3>例</h3><p><code>
 703       ProxyMaxForwards 15
 704     </code></p></div>
 705
 706 </div>
 707 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 708 <div class="directive-section"><h2><a name="ProxyPass" id="ProxyPass">ProxyPass</a> <a name="proxypass" id="proxypass">ディレクティブ</a></h2>
 709 <table class="directive">
 710 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リモートサーバをローカルサーバの URL 空間にマップする</td></tr>
 711 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPass [<var>path</var>] !|<var>url</var> [<var>key=value</var> <var>key=value</var> ...]]</code></td></tr>
 712 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
 713 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 714 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 715 </table>
 716     <p>このディレクティブはリモートサーバをローカルサーバの名前空間に
 717     マップできるようにします。ローカルサーバは通常の意味でのプロキシと
 718     しては動作せず、リモートサーバのミラーとして振る舞います。
 719     <var>path</var> はローカルの仮想パスの名前です。<var>url</var> は
 720     リモートサーバの部分 URL になり、クエリー文字列を含むことはできません。</p>
 721
 722     <div class="warning"><code class="directive">ProxyPass</code> ディレクティブを
 723     使っているときは <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> ディレクティブは通常は
 724     <strong>off</strong> に設定されているべきです。</div>
 725
 726     <p>ローカルサーバのアドレスが <code>http://example.com/</code> であると
 727     します。すると、</p>
 728
 729     <div class="example"><p><code>
 730       ProxyPass /mirror/foo/ http://backend.example.com/
 731     </code></p></div>
 732
 733     <p>と設定すると <code>http://example.com/mirror/foo/bar</code> への
 734     リクエストが内部的に <code>http://backend.example.com/bar</code> への
 735     プロキシリクエストに変換されることになります。</p>
 736
 737     <p>サブディレクトリをリバースプロキシしたくないときに <code>!</code> は
 738     役に立ちます。<em>例えば</em>、</p>
 739
 740     <div class="example"><p><code>
 741       ProxyPass /mirror/foo/i !<br />
 742       ProxyPass /mirror/foo http://backend.example.com
 743     </code></p></div>
 744
 745     <p>は <code>/mirror/foo/i</code> を<em>除く</em>
 746     <code>/mirror/foo</code> へのすべてのリクエストを
 747     <code>backend.example.com</code> にプロキシします。</p>
 748
 749     <div class="note"><h3>注</h3>
 750       <p>順番は重要です。一般的な <code class="directive">ProxyPass</code>
 751       ディレクティブの<em>前に</em>
 752       除外ディレクティブを置く必要があります。</p>
 753     </div>
 754
 755     <p>2.1 の機能で、バックエンドサーバとの接続にプールされたコネクションを
 756     使えるようになりました。<code>key=value</code> 形式のパラメータで
 757     このコネクションプーリングの調整ができます。<code>Hard Maximum</code>
 758     のデフォルト値は、有効になっている MPM でのプロセス当たりのスレッド数と
 759     同じ数のコネクション数です。prefork MPM では通常は 1 で、worker MPM では
 760     <code class="directive">ThreadsPerChild</code> で調整されます。</p>
 761
 762     <p><code>min</code> の設定で、バックエンドサーバとの間に何本のコネクションを
 763     常時開くかが決まります。Soft Maximum <code>smax</code> の数に
 764     達するまで必要に応じてコネクションは生成されます。<code>smax</code>
 765     を超えた数のコネクションは、生存時間 <code>ttl</code> で切断されます。
 766     バックエンドサーバと Hard Maximum <code>max</code> の数以上のコネクションを
 767     生成することはありません。</p>
 768
 769     <div class="example"><p><code>
 770         ProxyPass /example http://backend.example.com smax=5 max=20 ttl=120 retry=300
 771     </code></p></div>
 772
 773     <table>
 774     <tr><th>パラメータ</th>
 775         <th>デフォルト値</th>
 776         <th>説明</th></tr>
 777     <tr><td>min</td>
 778         <td>0</td>
 779         <td>バックエンドサーバとの接続で
 780             常に開いているコネクション数の最小値</td></tr>
 781     <tr><td>max</td>
 782         <td>1...n</td>
 783         <td>バックエンドサーバとの接続数の Hard Maximum
 784         <span class="transnote">(<em>訳注:</em> ハードリミット)</span>。
 785         デフォルト値は、使用している MPM のプロセスあたりのスレッド数になっています。
 786         Prefork MPM では常に 1 で、Worker MPM では <code class="directive">ThreadsPerChild</code>
 787         で調節できます。Hard Maximum 以上にバックエンドサーバとのコネクションを
 788         生成することはありません。</td></tr>
 789     <tr><td>smax</td>
 790         <td>max</td>
 791         <td>接続数の Soft Maximum <span class="transnote">(<em>訳注:</em> ソフトリミット)</span>まで、
 792         コネクションは必要に応じて生成されます。
 793         <code>smax</code> を超えた数のコネクションは生存時間 <code>ttl</code>
 794         で切断されます。
 795     </td></tr>
 796     <tr><td>ttl</td>
 797         <td>-</td>
 798         <td><code>smax</code> 数を超えた非活動状態のコネクションの生存時間を、
 799         秒で指定します。この期間内に使用されなかったコネクションは、
 800         全て閉じられます。
 801     </td></tr>
 802     <tr><td>timeout</td>
 803         <td><code class="directive">Timeout</code></td>
 804         <td>コネクションタイムアウトを秒で指定します。特に指定されなければ、
 805         フリーなコネクションを取得できるまで待ちます。このディレクティブは
 806         <code>max</code> パラメータと合わせて使うことで、バックエンドサーバとの
 807         接続数を制御するのに使います。
 808     </td></tr>
 809     <tr><td>acquire</td>
 810         <td>-</td>
 811         <td>設定すると、コネクションプールからフリーのコネクションを取得するために
 812         待機する待ち時間の最大値になります。フリーのコネクションがプールになかった場合は、
 813         <code>SERVER_BUSY</code> ステータスがクライアントに返されます。
 814     </td></tr>
 815     <tr><td>keepalive</td>
 816         <td>Off</td>
 817         <td>バックエンドサーバと Apache の間にファイアーウォールがある場合には、
 818         このパラメータを使ってください。ファイアウォールは往々にして、
 819         非活動状態のコネクションを落とそうとします。
 820         このフラグは OS に指示して、<code>KEEP_ALIVE</code> メッセージを非活動状態の
 821         コネクションでも送るようにします (間隔は OS のグローバル設定に依存し、
 822         通常は 120ms 間隔) 。これによってファイアウォールによってコネクションが
 823         落とされることを防げます。keepalive を有効にするには、このプロパティを
 824         <code>On</code> にしてください。
 825     </td></tr>
 826     <tr><td>retry</td>
 827         <td>60</td>
 828         <td>コネクションをプーリングするための、リトライのタイムアウトを秒で
 829         指定します。バックエンドサーバへのコネクションプーリングが失敗した場合は、
 830         タイムアウトの期間が過ぎるまで、そのサーバにリクエストをフォワードしません。
 831         この機能を使うと、バックエンドサーバをメンテナンスのためにシャットダウンし、
 832         後でオンラインに復帰させるといったことができます。
 833     </td></tr>
 834     <tr><td>loadfactor</td>
 835         <td>1</td>
 836         <td>ワーカーあたりの負荷係数です。BalancerMember で使います。
 837         1 から 100 までの数字でそのワーカーに対する正規化された負荷率を指定します。
 838     </td></tr>
 839     <tr><td>route</td>
 840         <td>-</td>
 841         <td>ロードバランサで使った場合、ワーカーのルーティングをします。
 842         ルートはセッション ID に付加された値になります。
 843     </td></tr>
 844     <tr><td>redirect</td>
 845         <td>-</td>
 846         <td>ワーカーのリダイレクション経路です。この値は通常は、
 847         安全にクラスタからノードを取り去る設定を動的に入れるために使います。
 848         セッション ID の無いリクエスト全てを指定した場合は、
 849         この値と同じルーティングパラメータを持つ
 850         BalancerMember にリダイレクトされます。
 851     </td></tr>
 852
 853     </table>
 854
 855     <p>Proxy ディレクティブのスキームが <code>balancer://</code> になっている場合は、
 856     バックエンドサーバと実際には通信しない仮想ワーカーが生成されます。
 857     このワーカーは幾つかの "本物の" ワーカーの管理をつかさどります。
 858     この場合パラメータは、この仮想ワーカーに対して設定されます。
 859     </p>
 860     <table>
 861     <tr><th>パラメータ</th>
 862         <th>デフォルト値</th>
 863         <th>説明</th></tr>
 864     <tr><td>lbmethod</td>
 865         <td>-</td>
 866         <td>Balancer のロードバランス方法。使用するロードバランスの
 867         スケジューリング方法を選びます。処理したリクエストの数で重み付けする
 868         <code>byrequests</code> か、転送量のバイト数で重み付けする
 869         <code>bytraffic</code> を設定できます。デフォルトは
 870         <code>byrequests</code> です。
 871     </td></tr>
 872     <tr><td>stickysession</td>
 873         <td>-</td>
 874         <td>バランサーのスティッキーセッション名です。通常はこの値は <code>JSESSIONID</code>
 875         や <code>PHPSESSIONID</code> といったものになりますが、この値は
 876         バックエンドアプリケーションのサポートするセッションに依存します。
 877     </td></tr>
 878     <tr><td>nofailover</td>
 879         <td>Off</td>
 880         <td><code>On</code> になっていると、ワーカーがエラーを起こしたり
 881         無効になっている場合にセッションが切れます。
 882         バックエンドサーバがセッションレプリケーションをサポートしていない場合は、
 883         On にしてください。
 884     </td></tr>
 885     <tr><td>timeout</td>
 886         <td>0</td>
 887         <td>バランサーのタイムアウトを秒で指定します。
 888         この値を設定すると、フリーのワーカーを取得するまでの最大待機時間になります。
 889         デフォルトでは待機しません。
 890     </td></tr>
 891     <tr><td>maxattempts</td>
 892         <td>1</td>
 893         <td>フェイルオーバーを試みる最大の回数を指定します。
 894     </td></tr>
 895
 896     </table>
 897     <div class="example"><p><code>
 898       ProxyPass /special-area http://special.example.com/ smax=5 max=10<br />
 899       ProxyPass / balancer://mycluster stickysession=jsessionid nofailover=On<br />
 900       &lt;Proxy balancer://mycluster&gt;<br />
 901       <span class="indent">
 902         BalancerMember http://1.2.3.4:8009<br />
 903         BalancerMember http://1.2.3.5:8009 smax=10<br />
 904         # Less powerful server, don't send as many requests there<br />
 905         BalancerMember http://1.2.3.6:8009 smax=1 loadfactor=20<br />
 906       </span>
 907       &lt;/Proxy&gt;
 908     </code></p></div>
 909
 910     <p><code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> セクションの中で使われた場合、最初の引数は
 911     省略され、ローカルディレクトリは <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> から取得されます。</p>
 912
 913     <p>より柔軟なリバースプロキシの設定が必要な場合は、<code>[P]</code>
 914     フラグ付きの <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>
 915     ディレクティブを参照してください。</p>
 916
 917 </div>
 918 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 919 <div class="directive-section"><h2><a name="ProxyPassInherit" id="ProxyPassInherit">ProxyPassInherit</a> <a name="proxypassinherit" id="proxypassinherit">ディレクティブ</a></h2>
 920 <table class="directive">
 921 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Inherit ProxyPass directives defined from the main server</td></tr>
 922 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPassInherit On|Off</code></td></tr>
 923 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyPassInherit On</code></td></tr>
 924 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
 925 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 926 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 927 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>ProxyPassInherit is only available in Apache HTTP Server 2.4.5 and later.
 928         </td></tr>
 929 </table><p>このディレクティブの解説文書は
 930             まだ翻訳されていません。英語版をご覧ください。
 931             </p></div>
 932 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 933 <div class="directive-section"><h2><a name="ProxyPassInterpolateEnv" id="ProxyPassInterpolateEnv">ProxyPassInterpolateEnv</a> <a name="proxypassinterpolateenv" id="proxypassinterpolateenv">ディレクティブ</a></h2>
 934 <table class="directive">
 935 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Enable Environment Variable interpolation in Reverse Proxy configurations</td></tr>
 936 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr>
 937 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
 938 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 939 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 940 </table><p>Documentation not yet translated. Please see English version of document.</p>
 941 </div>
 942 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 943 <div class="directive-section"><h2><a name="ProxyPassMatch" id="ProxyPassMatch">ProxyPassMatch</a> <a name="proxypassmatch" id="proxypassmatch">ディレクティブ</a></h2>
 944 <table class="directive">
 945 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Maps remote servers into the local server URL-space using regular expressions</td></tr>
 946 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr>
 947 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
 948 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 949 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 950 </table><p>Documentation not yet translated. Please see English version of document.</p>
 951 </div>
 952 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 953 <div class="directive-section"><h2><a name="ProxyPassReverse" id="ProxyPassReverse">ProxyPassReverse</a> <a name="proxypassreverse" id="proxypassreverse">ディレクティブ</a></h2>
 954 <table class="directive">
 955 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リバースプロキシされたサーバから送られた HTTP 応答ヘッダの
 956 URL を調整する</td></tr>
 957 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPassReverse [<var>path</var>] <var>url</var></code></td></tr>
 958 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
 959 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
 960 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
 961 </table>
 962     <p>このディレクティブは Apache に HTTP リダイレクト応答の
 963     <code>Location</code>, <code>Content-Location</code>, <code>URI</code>
 964     ヘッダの調整をさせます。これは、Apache がリバースプロキシとして使われている
 965     ときに、リバースプロキシを通さないでアクセスすることを防ぐために
 966     重要です。これによりバックエンドサーバの HTTP リダイレクトが
 967     リバースプロキシとバックエンドの間で扱われるようになります。</p>
 968
 969     <p>ディレクティブで明示されている HTTP 応答ヘッダのみが書き換えられます。
 970     Apache は他の応答ヘッダを書き換えたり、HTML ページの中の URL 参照を
 971     書き換えたりすることはありません。HTML の中を見て、URL 参照を書き換える
 972     モジュールに Nick Kew さんの <a href="http://apache.webthing.com/mod_proxy_html/">mod_proxy_html</a> があります。</p>
 973
 974     <p><var>path</var> はローカル仮想パスの名前です。<var>url</var> は
 975     リモートサーバの部分 URL です。これらは <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブと同様です。</p>
 976
 977     <p>例えば、ローカルサーバのアドレスが <code>http://example.com/</code>
 978     だとします。すると</p>
 979
 980     <div class="example"><p><code>
 981       ProxyPass         /mirror/foo/ http://backend.example.com/<br />
 982       ProxyPassReverse  /mirror/foo/ http://backend.example.com/<br />
 983       ProxyPassReverseCookieDomain  backend.example.com  public.example.com<br />
 984       ProxyPassReverseCookiePath  /  /mirror/foo/
 985     </code></p></div>
 986
 987     <p>という設定をすると、<code>http://example.com/mirror/foo/bar</code>
 988     へのローカルリクエストが <code>http://backend.example.com/bar</code>
 989     へのプロキシリクエストに内部でリダイレクトされるだけではありません
 990     (これは <code>ProxyPass</code> の機能です)。<code>backend.example.com</code>
 991     が送るリダイレクトの面倒もみます。<code>http://backend.example.com/bar</code>
 992     が <code>http://backend.example.com/quux</code> にリダイレクトされたとき、
 993     Apache は HTTP リダイレクト応答をクライアントに送る前に、
 994     <code>http://example.com/mirror/foo/quux</code> に変更します。
 995     URL を構成するのに使われるホスト名は <code class="directive"><a href="../mod/core.html#usecanonicalname">UseCanonicalName</a></code> の設定に応じて選択されることに
 996     注意してください。</p>
 997
 998     <p><code class="directive">ProxyPassReverse</code> ディレクティブは
 999     対応する <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブには依存しないため、
1000     <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> のプロキシ通過機能
1001     (<code>RewriteRule ...  [P]</code>) と併せて使用することができます。</p>
1002
1003     <p><code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> セクションの中で使われた場合は、
1004     最初の引数は省略され、ローカルディレクトリは <code class="directive"><a href="../mod/core.html#location">&lt;Location&gt;</a></code> から取得されます。</p>
1005
1006 </div>
1007 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1008 <div class="directive-section"><h2><a name="ProxyPassReverseCookieDomain" id="ProxyPassReverseCookieDomain">ProxyPassReverseCookieDomain</a> <a name="proxypassreversecookiedomain" id="proxypassreversecookiedomain">ディレクティブ</a></h2>
1009 <table class="directive">
1010 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>リバースプロキシサーバからの Set-Cookie ヘッダの Domain 文字列を
1011 調整する</td></tr>
1012 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPassReverseCookieDomain <var>internal-domain</var> <var>public-domain</var></code></td></tr>
1013 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1014 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1015 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1016 </table>
1017 <p>使用法は基本的に
1018 <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> と同じですが、
1019 ヘッダの URL の代わりに <code>Set-Cookie</code> ヘッダの
1020 <code>domain</code> 文字列を書き換えます。</p>
1021
1022 </div>
1023 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1024 <div class="directive-section"><h2><a name="ProxyPassReverseCookiePath" id="ProxyPassReverseCookiePath">ProxyPassReverseCookiePath</a> <a name="proxypassreversecookiepath" id="proxypassreversecookiepath">ディレクティブ</a></h2>
1025 <table class="directive">
1026 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Reverse プロキシサーバからの Set-Cookie ヘッダの Path 文字列を
1027 調整する</td></tr>
1028 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPassReverseCookiePath <var>internal-path</var> <var>public-path</var></code></td></tr>
1029 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト, ディレクトリ</td></tr>
1030 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1031 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1032 </table>
1033 <p>使用法は基本的に
1034 <code class="directive"><a href="#proxypassreverse">ProxyPassReverse</a></code> と同じですが、
1035 ヘッダの URL の代わりに <code>Set-Cookie</code> ヘッダの
1036 <code>path</code> 文字列を書き換えます。</p>
1037
1038 </div>
1039 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1040 <div class="directive-section"><h2><a name="ProxyPreserveHost" id="ProxyPreserveHost">ProxyPreserveHost</a> <a name="proxypreservehost" id="proxypreservehost">ディレクティブ</a></h2>
1041 <table class="directive">
1042 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシリクエストに、受け付けた Host HTTP ヘッダを使う</td></tr>
1043 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyPreserveHost On|Off</code></td></tr>
1044 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyPreserveHost Off</code></td></tr>
1045 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1046 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1047 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1048 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.31 以降で使用可能</td></tr>
1049 </table>
1050     <p>このオプションが有効になっている場合、<code class="directive">ProxyPass</code>
1051     で指定したホスト名の代わりに、受け付けたリクエストの Host: 行を
1052     プロキシ先のホストに送ります。</p>
1053
1054     <p>このオプションは通常は <code>Off</code> に設定してください。
1055     ほとんどの場合、これは大量の名前ベースのバーチャルホスティングを行なっていて、
1056     元々の Host ヘッダをバックエンドサーバが解釈する必要のあるときのような、
1057     特別な設定が必要な場合にのみ有用です。</p>
1058
1059 </div>
1060 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1061 <div class="directive-section"><h2><a name="ProxyReceiveBufferSize" id="ProxyReceiveBufferSize">ProxyReceiveBufferSize</a> <a name="proxyreceivebuffersize" id="proxyreceivebuffersize">ディレクティブ</a></h2>
1062 <table class="directive">
1063 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされる HTTP と FTP 接続のためのネットワークバッファサイズ</td></tr>
1064 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyReceiveBufferSize <var>bytes</var></code></td></tr>
1065 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyReceiveBufferSize 0</code></td></tr>
1066 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1067 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1068 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1069 </table>
1070     <p><code class="directive">ProxyReceiveBufferSize</code> ディレクティブは
1071     スループットを上げるために明示的に (TCP/IP) ネットワークバッファのサイズを
1072     設定します。値は <code>512</code> 以上か、システムのデフォルトのバッファ
1073     サイズを意味する <code>0</code> でなければなりません。</p>
1074
1075     <div class="example"><h3>例</h3><p><code>
1076       ProxyReceiveBufferSize 2048
1077     </code></p></div>
1078
1079 </div>
1080 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1081 <div class="directive-section"><h2><a name="ProxyRemote" id="ProxyRemote">ProxyRemote</a> <a name="proxyremote" id="proxyremote">ディレクティブ</a></h2>
1082 <table class="directive">
1083 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>特定のリクエストを扱う時に使われるリモートプロキシを指定する</td></tr>
1084 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyRemote <var>match</var> <var>remote-server</var></code></td></tr>
1085 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1086 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1087 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1088 </table>
1089     <p>このディレクティブはこのプロキシに対するリモートプロキシを定義します。
1090     <var>match</var> はリモートサーバがサポートする URL スキーム、
1091     リモートサーバが使うはずの URL の一部分、サーバがすべての
1092     リクエストに使われることを示す <code>*</code> のどれかになります。
1093     <var>remote-server</var> はリモートサーバの部分 URL です。構文:</p>
1094
1095     <div class="example"><p><code>
1096       <dfn>remote-server</dfn> =
1097           <var>scheme</var>://<var>hostname</var>[:<var>port</var>]
1098     </code></p></div>
1099
1100     <p><var>scheme</var> は実際上リモートサーバとの通信に使われるプロトコルを
1101     決定します。このモジュールでは <code>http</code> だけがサポートされて
1102     います。</p>
1103
1104     <div class="example"><h3>例</h3><p><code>
1105       ProxyRemote http://goodguys.com/ http://mirrorguys.com:8000<br />
1106       ProxyRemote * http://cleversite.com<br />
1107       ProxyRemote ftp http://ftpproxy.mydomain.com:8080
1108     </code></p></div>
1109
1110     <p>この例では、プロキシは FTP リクエストを別の HTTP リクエストで包んで
1111     そのようなリクエストを扱える別のプロキシに転送します。</p>
1112
1113     <p>このオプションはリバースプロキシの設定もサポートします。
1114     サーバが別のフォワードプロキシの後ろに隠されている場合でも
1115     バックエンドウェブサーバをバーチャルホストの URL 空間に入れることが
1116     できます。</p>
1117
1118 </div>
1119 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1120 <div class="directive-section"><h2><a name="ProxyRemoteMatch" id="ProxyRemoteMatch">ProxyRemoteMatch</a> <a name="proxyremotematch" id="proxyremotematch">ディレクティブ</a></h2>
1121 <table class="directive">
1122 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>正規表現でのマッチによるリクエストを扱うリモートプロキシの指定</td></tr>
1123 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyRemoteMatch <var>regex</var> <var>remote-server</var></code></td></tr>
1124 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1125 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1126 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1127 </table>
1128     <p><code class="directive">ProxyRemoteMatch</code> は最初の引数がリクエストされた
1129     URL にマッチする<a class="glossarylink" href="../glossary.html#regex" title="用語集を参照">正規表現</a>であることを除けば <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> ディレクティブと同じです。</p>
1130
1131 </div>
1132 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1133 <div class="directive-section"><h2><a name="ProxyRequests" id="ProxyRequests">ProxyRequests</a> <a name="proxyrequests" id="proxyrequests">ディレクティブ</a></h2>
1134 <table class="directive">
1135 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>フォワード (標準の) プロキシリクエストを有効にする</td></tr>
1136 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyRequests On|Off</code></td></tr>
1137 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyRequests Off</code></td></tr>
1138 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1139 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1140 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1141 </table>
1142     <p>これは Apache のフォワードプロキシサーバとしての動作を
1143     有効もしくは無効にします。(ProxyRequests を <code>Off</code> に
1144     設定しても、<code class="directive"><a href="#proxypass">ProxyPass</a></code>
1145     の設定は無効になりません。)</p>
1146
1147     <p>通常のリバースプロキシの設定では、このオプションは <code>Off</code>
1148     に設定してください。</p>
1149
1150     <p>HTTP や FTP サイトへのプロキシの機能を有効にしたい場合は、
1151     <code class="module"><a href="../mod/mod_proxy_http.html">mod_proxy_http</a></code> や <code class="module"><a href="../mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code> が
1152     サーバに組み込まれていなければなりません。</p>
1153
1154     <div class="warning"><h3>警告</h3>
1155       <p><a href="#access">サーバを安全にする</a>まで <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> は有効にしないでください。
1156       オープンプロキシサーバはあなた自身のネットワークにとっても、
1157       インターネット全体にとっても危険です。</p>
1158     </div>
1159
1160 </div>
1161 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1162 <div class="directive-section"><h2><a name="ProxySet" id="ProxySet">ProxySet</a> <a name="proxyset" id="proxyset">ディレクティブ</a></h2>
1163 <table class="directive">
1164 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Set various Proxy balancer or member parameters</td></tr>
1165 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr>
1166 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr>
1167 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1168 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1169 </table><p>Documentation not yet translated. Please see English version of document.</p>
1170 </div>
1171 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1172 <div class="directive-section"><h2><a name="ProxySourceAddress" id="ProxySourceAddress">ProxySourceAddress</a> <a name="proxysourceaddress" id="proxysourceaddress">ディレクティブ</a></h2>
1173 <table class="directive">
1174 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Set local IP address for outgoing proxy connections</td></tr>
1175 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxySourceAddress <var>address</var></code></td></tr>
1176 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1177 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1178 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1179 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Available in version 2.3.9 and later</td></tr>
1180 </table><p>このディレクティブの解説文書は
1181             まだ翻訳されていません。英語版をご覧ください。
1182             </p></div>
1183 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1184 <div class="directive-section"><h2><a name="ProxyStatus" id="ProxyStatus">ProxyStatus</a> <a name="proxystatus" id="proxystatus">ディレクティブ</a></h2>
1185 <table class="directive">
1186 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Show Proxy LoadBalancer status in mod_status</td></tr>
1187 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr>
1188 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1189 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1190 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1191 </table><p>Documentation not yet translated. Please see English version of document.</p>
1192 </div>
1193 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1194 <div class="directive-section"><h2><a name="ProxyTimeout" id="ProxyTimeout">ProxyTimeout</a> <a name="proxytimeout" id="proxytimeout">ディレクティブ</a></h2>
1195 <table class="directive">
1196 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされたリクエストのネットワークタイムアウト</td></tr>
1197 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyTimeout <var>seconds</var></code></td></tr>
1198 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyTimeout 300</code></td></tr>
1199 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1200 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1201 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1202 <tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>Apache 2.0.31 以降で使用可能</td></tr>
1203 </table>
1204     <p>このディレクティブはユーザがプロキシリクエストのタイムアウトを
1205     指定できるようにします。これはハングしてしまう遅い、もしくは挙動の
1206     怪しいサーバがあり、サーバがデータを返すまでひたすら待ち続けるよりも
1207     タイムアウトを返してより緩やかに<span class="transnote">(<em>訳注:</em> graceful に)</span>
1208     失敗させたい場合に役に立ちます。</p>
1209
1210 </div>
1211 <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
1212 <div class="directive-section"><h2><a name="ProxyVia" id="ProxyVia">ProxyVia</a> <a name="proxyvia" id="proxyvia">ディレクティブ</a></h2>
1213 <table class="directive">
1214 <tr><th><a href="directive-dict.html#Description">説明:</a></th><td>プロキシされたリクエストの <code>Via</code> HTTP 応答ヘッダ
1215 により提供される情報</td></tr>
1216 <tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>ProxyVia On|Off|Full|Block</code></td></tr>
1217 <tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>ProxyVia Off</code></td></tr>
1218 <tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr>
1219 <tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr>
1220 <tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr>
1221 </table>
1222     <p>このディレクティブはプロキシの <code>Via:</code> HTTP ヘッダの使用を
1223     制御します。想定されている使い方は、プロキシサーバがいくつも繋がっているときに
1224     プロキシリクエストの流れを制御することです。<code>Via:</code> ヘッダ行の
1225     説明は <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC 2616</a> (HTTP/1.1)
1226     の 14.45 節を読んでください。</p>
1227
1228     <ul>
1229     <li>デフォルトの <code>Off</code> に設定されていると、特別な処理は
1230     行なわれません。リクエストやリプライに <code>Via:</code> ヘッダがあれば、
1231     変更されずにそのまま渡します。</li>
1232
1233     <li><code>On</code> に設定されていれば、各リクエストとリプライに
1234     <code>Via:</code> 行が追加されます。</li>
1235
1236     <li><code>Full</code> に設定されていれば、<code>Via:</code> ヘッダは
1237     コメント部分に Apache サーバのバージョンも含むようになります。</li>
1238
1239     <li><code>Block</code> に設定されていれば、すべてのプロキシリクエストから
1240     <code>Via:</code> ヘッダが取り除かれます。新たに <code>Via:</code> が
1241     生成されることはありません。</li>
1242     </ul>
1243
1244 </div>
1245 </div>
1246 <div class="bottomlang">
1247 <p><span>翻訳済み言語: </span><a href="../en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
1248 <a href="../fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
1249 <a href="../ja/mod/mod_proxy.html" title="Japanese">&nbsp;ja&nbsp;</a></p>
1250 </div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">コメント</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
1251 <script type="text/javascript"><!--//--><![CDATA[//><!--
1252 var comments_shortname = 'httpd';
1253 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_proxy.html';
1254 (function(w, d) {
1255     if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
1256         d.write('<div id="comments_thread"><\/div>');
1257         var s = d.createElement('script');
1258         s.type = 'text/javascript';
1259         s.async = true;
1260         s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
1261         (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
1262     }
1263     else {
1264         d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
1265     }
1266 })(window, document);
1267 //--><!]]></script></div><div id="footer">
1268 <p class="apache">Copyright 2016 The Apache Software Foundation.<br />この文書は <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a> のライセンスで提供されています。.</p>
1269 <p class="menu"><a href="../mod/">モジュール</a> | <a href="../mod/quickreference.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">用語</a> | <a href="../sitemap.html">サイトマップ</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
1270 if (typeof(prettyPrint) !== 'undefined') {
1271     prettyPrint();
1272 }
1273 //--><!]]></script>
1274 </body></html>