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 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_proxy - Apache HTTP サーバ</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<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" /> 12<script src="/style/scripts/prettify.min.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">モジュール</a> | <a href="/mod/directives.html">ディレクティブ</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">用語</a> | <a href="/sitemap.html">サイトマップ</a></p> 19<p class="apache">Apache HTTP サーバ バージョン 2.4</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">HTTP サーバ</a> > <a href="http://httpd.apache.org/docs/">ドキュメンテーション</a> > <a href="../">バージョン 2.4</a> > <a href="./">モジュール</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Apache モジュール mod_proxy</h1> 26<div class="toplang"> 27<p><span>翻訳済み言語: </span><a href="/en/mod/mod_proxy.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 29<a href="/ja/mod/mod_proxy.html" title="Japanese"> ja </a></p> 30</div> 31<div class="outofdate">この日本語訳はすでに古くなっている 32 可能性があります。 33 最近更新された内容を見るには英語版をご覧下さい。 34 </div> 35<table class="module"><tr><th><a href="module-dict.html#Description">説明:</a></th><td>HTTP/1.1 プロキシ/ゲートウェイサーバ</td></tr> 36<tr><th><a href="module-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 37<tr><th><a href="module-dict.html#ModuleIdentifier">モジュール識別子:</a></th><td>proxy_module</td></tr> 38<tr><th><a href="module-dict.html#SourceFile">ソースファイル:</a></th><td>mod_proxy.c</td></tr></table> 39<h3>概要</h3> 40 41 <div class="warning"><h3>警告</h3> 42 <p><a href="#access">サーバを安全にする</a>まで <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> は有効にしないでください。 43 オープンプロキシサーバはあなた自身のネットワークにとっても、 44 インターネット全体にとっても危険です。</p> 45 </div> 46 47 <p>このモジュールは Apache のプロキシ/ゲートウェイ機能を実装しています。 48 <code>AJP13</code> (Apache JServe Protocol version 1.3), 49 <code>FTP</code>, <code>CONNECT</code> (SSL 用), 50 <code>HTTP/0.9</code>, <code>HTTP/1.0</code>, <code>HTTP/1.1</code> 51 のプロキシ機能を実装しています。これらのプロトコルやその他のプロトコル用の 52 プロキシ機能を持った、他のモジュールに接続するようにも設定できます。</p> 53 54 <p>Apache のプロキシ機能は <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> の他に、 55 いくつかのモジュールに分割されています: 56 <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>, 57 <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>, 58 <code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code> です。ですから、 59 特定のプロキシの機能を使いたい場合は、<code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> <em>と</em> 60 該当するモジュールをサーバに (コンパイル時に静的に行なうか 61 <code class="directive"><a href="/mod/mod_so.html#loadmodule">LoadModule</a></code> で動的に読み込むかして) 62 組み込む必要があります。</p> 63 64 <p>これに加えて、他のモジュールによって拡張機能が提供されています。 65 キャッシュは <code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> と関連モジュールで 66 提供されています。SSL/TLS で遠隔サーバに接続する機能は 67 <code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code> の <code>SSLProxy*</code> ディレクティブで 68 提供されています。これらの機能を利用するためには、該当するモジュールを 69 組み込んで設定しなければなりません。</p> 70</div> 71<div id="quickview"><h3 class="directives">ディレクティブ</h3> 72<ul id="toc"> 73<li><img alt="" src="/images/down.gif" /> <a href="#balancergrowth">BalancerGrowth</a></li> 74<li><img alt="" src="/images/down.gif" /> <a href="#balancerinherit">BalancerInherit</a></li> 75<li><img alt="" src="/images/down.gif" /> <a href="#balancermember">BalancerMember</a></li> 76<li><img alt="" src="/images/down.gif" /> <a href="#balancerpersist">BalancerPersist</a></li> 77<li><img alt="" src="/images/down.gif" /> <a href="#noproxy">NoProxy</a></li> 78<li><img alt="" src="/images/down.gif" /> <a href="#proxy"><Proxy></a></li> 79<li><img alt="" src="/images/down.gif" /> <a href="#proxyaddheaders">ProxyAddHeaders</a></li> 80<li><img alt="" src="/images/down.gif" /> <a href="#proxybadheader">ProxyBadHeader</a></li> 81<li><img alt="" src="/images/down.gif" /> <a href="#proxyblock">ProxyBlock</a></li> 82<li><img alt="" src="/images/down.gif" /> <a href="#proxydomain">ProxyDomain</a></li> 83<li><img alt="" src="/images/down.gif" /> <a href="#proxyerroroverride">ProxyErrorOverride</a></li> 84<li><img alt="" src="/images/down.gif" /> <a href="#proxyiobuffersize">ProxyIOBufferSize</a></li> 85<li><img alt="" src="/images/down.gif" /> <a href="#proxymatch"><ProxyMatch></a></li> 86<li><img alt="" src="/images/down.gif" /> <a href="#proxymaxforwards">ProxyMaxForwards</a></li> 87<li><img alt="" src="/images/down.gif" /> <a href="#proxypass">ProxyPass</a></li> 88<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinherit">ProxyPassInherit</a></li> 89<li><img alt="" src="/images/down.gif" /> <a href="#proxypassinterpolateenv">ProxyPassInterpolateEnv</a></li> 90<li><img alt="" src="/images/down.gif" /> <a href="#proxypassmatch">ProxyPassMatch</a></li> 91<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreverse">ProxyPassReverse</a></li> 92<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiedomain">ProxyPassReverseCookieDomain</a></li> 93<li><img alt="" src="/images/down.gif" /> <a href="#proxypassreversecookiepath">ProxyPassReverseCookiePath</a></li> 94<li><img alt="" src="/images/down.gif" /> <a href="#proxypreservehost">ProxyPreserveHost</a></li> 95<li><img alt="" src="/images/down.gif" /> <a href="#proxyreceivebuffersize">ProxyReceiveBufferSize</a></li> 96<li><img alt="" src="/images/down.gif" /> <a href="#proxyremote">ProxyRemote</a></li> 97<li><img alt="" src="/images/down.gif" /> <a href="#proxyremotematch">ProxyRemoteMatch</a></li> 98<li><img alt="" src="/images/down.gif" /> <a href="#proxyrequests">ProxyRequests</a></li> 99<li><img alt="" src="/images/down.gif" /> <a href="#proxyset">ProxySet</a></li> 100<li><img alt="" src="/images/down.gif" /> <a href="#proxysourceaddress">ProxySourceAddress</a></li> 101<li><img alt="" src="/images/down.gif" /> <a href="#proxystatus">ProxyStatus</a></li> 102<li><img alt="" src="/images/down.gif" /> <a href="#proxytimeout">ProxyTimeout</a></li> 103<li><img alt="" src="/images/down.gif" /> <a href="#proxyvia">ProxyVia</a></li> 104</ul> 105<h3>トピック</h3> 106<ul id="topics"> 107<li><img alt="" src="/images/down.gif" /> <a href="#forwardreverse">フォワードプロキシとリバースプロキシ</a></li> 108<li><img alt="" src="/images/down.gif" /> <a href="#examples">基本の例</a></li> 109<li><img alt="" src="/images/down.gif" /> <a href="#access">プロキシへのアクセス制御</a></li> 110<li><img alt="" src="/images/down.gif" /> <a href="#startup">遅い起動</a></li> 111<li><img alt="" src="/images/down.gif" /> <a href="#intranet">イントラネットプロキシ</a></li> 112<li><img alt="" src="/images/down.gif" /> <a href="#envsettings">プロトコルの調整</a></li> 113<li><img alt="" src="/images/down.gif" /> <a href="#request-bodies">リクエストボディ</a></li> 114</ul><h3>参照</h3> 115<ul class="seealso"> 116<li><code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code></li> 117<li><code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code></li> 118<li><code class="module"><a href="/mod/mod_proxy_ftp.html">mod_proxy_ftp</a></code></li> 119<li><code class="module"><a href="/mod/mod_proxy_connect.html">mod_proxy_connect</a></code></li> 120<li><code class="module"><a href="/mod/mod_proxy_balancer.html">mod_proxy_balancer</a></code></li> 121<li><code class="module"><a href="/mod/mod_ssl.html">mod_ssl</a></code></li> 122</ul><ul class="seealso"><li><a href="#comments_section">コメント</a></li></ul></div> 123<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 124<div class="section"> 125<h2><a name="forwardreverse" id="forwardreverse">フォワードプロキシとリバースプロキシ</a></h2> 126 <p>Apache は<dfn>フォワード</dfn>プロキシとしても、 127 <dfn>リバース</dfn>プロキシとしても設定することができます。</p> 128 129 <p>通常の<dfn>フォワードプロキシ</dfn>はクライアントと 130 <em>オリジンサーバ</em> <span class="transnote">(<em>訳注:</em> コンテンツ生成元のサーバ)</span> 131 の間に位置する中間サーバです。 132 オリジンサーバからコンテンツを取得する過程では、クライアントは 133 行き先としてオリジンサーバを指定しつつプロキシにリクエストを送り、 134 プロキシはオリジンサーバからコンテンツ取得のリクエストを送り、 135 コンテンツが取得できればそれをクライアントに返します。 136 クライアントが他のサイトにフォワードプロクシ経由でアクセスするには、 137 特別にそれ用の設定をしなければなりません。</p> 138 139 <p>フォワードプロキシの一般的な使用方法は、ファイアウォールによって 140 制限されている内部のクライアントにインターネットへのアクセスを 141 提供するものです。フォワードプロキシはネットワークの使用量を 142 減らすために (<code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> で提供されている) 143 キャッシュ機能を用いることもできます。</p> 144 145 <p>フォワードプロキシは <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> ディレクティブで 146 有効になります。フォワードプロキシでは、クライアントは本当の身元を 147 隠して任意のサイトにアクセスできるようになるため、フォワードプロキシを 148 有効にする前に、承認されたクライアントのみがプロキシにアクセスできるように 149 <a href="#access">サーバを安全にする</a>ことが重要です。</p> 150 151 <p>一方<dfn>リバースプロキシ</dfn>は、クライアントには普通の 152 ウェブサーバのように見えます。クライアント側に特別な設定は必要ありません。 153 クライアントはリバースプロキシの名前空間に対して通常のコンテンツへの 154 リクエストを行ないます。プロキシはリクエストをどこに送れば良いかを判定し、 155 あたかも自分自身がオリジンサーバであったかのようにクライアントに 156 コンテンツを返します。</p> 157 158 <p>リバースプロキシのよくある利用方法は、インターネットユーザに 159 ファイアウォールの中にあるサーバにアクセスを与えるというものです。 160 リバースプロキシは複数のバックエンドサーバへ負荷分散をするために 161 使ったり、遅いバックエンドエンドサーバのためにキャッシュ機能を提供したり 162 するために使えます。また、リバースプロキシは複数のサーバを 163 同じ URL 空間にまとめるために使うこともできます。</p> 164 165 <p>リバースプロキシは <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブや 166 <code class="directive"><a href="/mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> ディレクティブの 167 <code>[P]</code> フラグを使うことで有効になります。リバースプロキシの 168 設定のために <code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> を設定する必要は 169 <em>ありません</em>。</p> 170 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 171<div class="section"> 172<h2><a name="examples" id="examples">基本の例</a></h2> 173 174 <p>以下の例は手始めの簡単な例です。個々のディレクティブの意味は 175 それぞれの説明をお読みください。</p> 176 177 <p>またキャッシュ機能を有効にしたい場合は、<code class="module"><a href="/mod/mod_cache.html">mod_cache</a></code> 178 の説明を読んでください。</p> 179 180 <div class="example"><h3>フォワードプロキシ</h3><p><code> 181 ProxyRequests On<br /> 182 ProxyVia On<br /> 183 <br /> 184 <Proxy *><br /> 185 <span class="indent"> 186 Order deny,allow<br /> 187 Deny from all<br /> 188 Allow from internal.example.com<br /> 189 </span> 190 </Proxy> 191 </code></p></div> 192 193 <div class="example"><h3>リバースプロキシ</h3><p><code> 194 ProxyRequests Off<br /> 195 <br /> 196 <Proxy *><br /> 197 <span class="indent"> 198 Order deny,allow<br /> 199 Allow from all<br /> 200 </span> 201 </Proxy><br /> 202 <br /> 203 ProxyPass /foo http://foo.example.com/bar<br /> 204 ProxyPassReverse /foo http://foo.example.com/bar 205 </code></p></div> 206 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 207<div class="section"> 208<h2><a name="access" id="access">プロキシへのアクセス制御</a></h2> 209 <p>プロキシのアクセスは以下のように <code class="directive"><a href="#proxy"><Proxy></a></code> コンテナの中に 210 ディレクティブを書くことで制御できます:</p> 211 212 <div class="example"><p><code> 213 <Proxy *><br /> 214 <span class="indent"> 215 Order Deny,Allow<br /> 216 Deny from all<br /> 217 Allow from 192.168.0<br /> 218 </span> 219 </Proxy> 220 </code></p></div> 221 222 <p>アクセス制御のためのディレクティブのより詳しい情報は 223 <code class="module"><a href="/mod/mod_authz_host.html">mod_authz_host</a></code> をお読みください。</p> 224 225 <p>(<code class="directive"><a href="#proxyrequests">ProxyRequests</a></code> ディレクティブを 226 使って) フォワードプロキシを設定している場合は、厳しくアクセス 227 制限を行なうことが非常に大切です。そうしないと、任意のクライアントが 228 身元を明かすことなく任意のホストにアクセスするためにサーバを使うことが 229 できてしまいます。これはあなた自身のネットワークにとっても、インターネット 230 全体にとっても危険なことです。(<code>ProxyRequests Off</code> にして 231 <code class="directive"><a href="#proxypass">ProxyPass</a></code> ディレクティブを使って) 232 リバースプロキシを使っている場合には、クライアントはあなたが明示的に 233 設定したホストにしかアクセスできないため、フォワードプロキシのとき 234 ほどアクセス制御に力を注がなくても大丈夫です。</p> 235 236 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 237<div class="section"> 238<h2><a name="startup" id="startup">遅い起動</a></h2> 239 <p><code class="directive"><a href="#proxyblock">ProxyBlock</a></code> ディレクティブを使っている場合、 240 後のテストのために起動時にホストの 241 IP アドレスが調べられてキャッシュされます。ホスト名のルックアップの 242 速さによっては、数秒 (かそれ以上) かかるかもしれません。</p> 243 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 244<div class="section"> 245<h2><a name="intranet" id="intranet">イントラネットプロキシ</a></h2> 246 <p>イントラネットにある Apache プロキシサーバは外部へのリクエストを 247 会社のファイアウォールを通して送らなければなりません。(このためには 248 個々の <var>scheme</var> についてそれぞれ、ファイアウォールの 249 プロキシにフォワードされるように 250 <code class="directive"><a href="#proxyremote">ProxyRemote</a></code> ディレクティブを 251 設定してください)。しかしイントラネット内のリソースにアクセスするときは、 252 ファイアウォールを通さないでもアクセスできます。 253 どのホストがイントラネットに属し、直接アクセスすべきかを指定するには、 254 <code class="directive"><a href="#noproxy">NoProxy</a></code> ディレクティブが 255 役に立ちます。</p> 256 257 <p>イントラネット内のユーザは WWW のリクエストでローカルドメインを 258 省略することがよくあります。<code>http://somehost.example.com/</code> 259 というリクエストの代わりに "http://somehost/" をリクエストしたりします。 260 このようなリクエストを受け付け、サーバに設定されているローカルドメインが 261 暗黙のうちに使われていると解釈して、単純にリクエストを処理するものも 262 商用プロキシサーバの中にはあります。 263 サーバが <a href="#proxyrequests">プロキシのサービス用に設定されていて</a> 264 <code class="directive"><a href="#proxydomain">ProxyDomain</a></code> ディレクティブが 265 使用された場合には、Apache はクライアントにリダイレクト応答を送って、 266 正しい、完全な (<span class="transnote">(<em>訳注:</em> fully qualified)</span>) 267 サーバのアドレスに送ることができます。このように 268 リダイレクトすると、ユーザのブックマークが正しい完全なホスト名を含む 269 ことにもなるため、より好ましい方法と言えるでしょう。</p> 270 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 271<div class="section"> 272<h2><a name="envsettings" id="envsettings">プロトコルの調整</a></h2> 273 <p>Keepalive や HTTP/1.1 を適切に実装していないアプリケーションサーバに対して 274 <code class="module"><a href="/mod/mod_proxy.html">mod_proxy</a></code> がリクエストを送信する場合、 275 HTTP/1.0 を使って keepalive を無しにしてリクエストを送るようにする 276 環境変数が二つあります。これらは <code class="directive"><a href="/mod/mod_env.html#setenv">SetEnv</a></code> ディレクティブで設定します。</p> 277 278 <p><code>force-proxy-request-1.0</code> と <code>proxy-nokeepalive</code> 279 がその環境変数です。</p> 280 281 <div class="example"><p><code> 282 <Location /buggyappserver/><br /> 283 <span class="indent"> 284 ProxyPass http://buggyappserver:7001/foo/<br /> 285 SetEnv force-proxy-request-1.0 1<br /> 286 SetEnv proxy-nokeepalive 1<br /> 287 </span> 288 </Location> 289 </code></p></div> 290 291 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 292<div class="section"> 293<h2><a name="request-bodies" id="request-bodies">リクエストボディ</a></h2> 294 295 <p>POST メソッドなどのリクエストには、リクエストボディがあります。 296 HTTP プロトコル仕様によると、ボディのあるリクエストは chunked 297 転送を使うか、<code>Content-Length</code> 298 ヘッダを送信しなければなりません。 299 このようなリクエストをオリジンサーバに送信する場合、 300 <code class="module"><a href="/mod/mod_proxy_http.html">mod_proxy_http</a></code> は常に <code>Content-Length</code> 301 を送ろうと試みます。しかし。ボディが大きく、オリジナルのリクエストで 302 chunked 転送が使われている場合、上流へのリクエストに 303 chunked 転送も使われます。 304 この挙動は <a href="/env.html">環境変数</a>で制御できます。 305 <code>proxy-sendcl</code> を設定すると、可能な限り常に 306 <code>Content-Length</code> を付与して、 307 上流サーバに送信するようになります。 308 逆に <code>proxy-sendchunked</code> を設定すると、リソース消費を抑え、 309 chnked エンコードを使って送信するようになります。</p> 310 311 </div> 312<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 313<div class="directive-section"><h2><a name="BalancerGrowth" id="BalancerGrowth">BalancerGrowth</a> <a name="balancergrowth" id="balancergrowth">ディレクティブ</a></h2> 314<table class="directive"> 315<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Number of additional Balancers that can be added Post-configuration</td></tr> 316<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerGrowth <var>#</var></code></td></tr> 317<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerGrowth 5</code></td></tr> 318<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> 319<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 320<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr> 321<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerGrowth is only available in Apache HTTP Server 2.3.13 322 and later.</td></tr> 323</table><p>このディレクティブの解説文書は 324 まだ翻訳されていません。英語版をご覧ください。 325 </p></div> 326<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 327<div class="directive-section"><h2><a name="BalancerInherit" id="BalancerInherit">BalancerInherit</a> <a name="balancerinherit" id="balancerinherit">ディレクティブ</a></h2> 328<table class="directive"> 329<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Inherit ProxyPassed Balancers/Workers from the main server</td></tr> 330<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerInherit On|Off</code></td></tr> 331<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerInherit On</code></td></tr> 332<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> 333<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 334<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr> 335<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerInherit is only available in Apache HTTP Server 2.5.0 336 and later.</td></tr> 337</table><p>このディレクティブの解説文書は 338 まだ翻訳されていません。英語版をご覧ください。 339 </p></div> 340<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 341<div class="directive-section"><h2><a name="BalancerMember" id="BalancerMember">BalancerMember</a> <a name="balancermember" id="balancermember">ディレクティブ</a></h2> 342<table class="directive"> 343<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Add a member to a load balancing group</td></tr> 344<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code /></td></tr> 345<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>ディレクトリ</td></tr> 346<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 347<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr> 348</table><p>Documentation not yet translated. Please see English version of document.</p> 349</div> 350<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 351<div class="directive-section"><h2><a name="BalancerPersist" id="BalancerPersist">BalancerPersist</a> <a name="balancerpersist" id="balancerpersist">ディレクティブ</a></h2> 352<table class="directive"> 353<tr><th><a href="directive-dict.html#Description">説明:</a></th><td>Attempt to persist changes made by the Balancer Manager across restarts.</td></tr> 354<tr><th><a href="directive-dict.html#Syntax">構文:</a></th><td><code>BalancerPersist On|Off</code></td></tr> 355<tr><th><a href="directive-dict.html#Default">デフォルト:</a></th><td><code>BalancerPersist Off</code></td></tr> 356<tr><th><a href="directive-dict.html#Context">コンテキスト:</a></th><td>サーバ設定ファイル, バーチャルホスト</td></tr> 357<tr><th><a href="directive-dict.html#Status">ステータス:</a></th><td>Extension</td></tr> 358<tr><th><a href="directive-dict.html#Module">モジュール:</a></th><td>mod_proxy</td></tr> 359<tr><th><a href="directive-dict.html#Compatibility">互換性:</a></th><td>BalancerPersist is only available in Apache HTTP Server 2.4.4 and later. 360 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"><Proxy></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><Proxy <var>wildcard-url</var>> ...</Proxy></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"><Proxy></code> セクション中の 503 ディレクティブはマッチするプロキシされるコンテンツにのみ適用されます。 504 シェル形式のワイルドカードが使えます。</p> 505 506 <p>例えば、次の設定は <code>yournetwork.example.com</code> の 507 ホストにのみプロキシサーバを経由したアクセスを許可します:</p> 508 509 <div class="example"><p><code> 510 <Proxy *><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 </Proxy> 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 <Proxy http://example.com/foo/*><br /> 525 <span class="indent"> 526 SetOutputFilter INCLUDES<br /> 527 </span> 528 </Proxy> 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"><ProxyMatch></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><ProxyMatch <var>regex</var>> ...</ProxyMatch></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"><ProxyMatch></code> は URL のマッチに 682 <a class="glossarylink" href="/glossary.html#regex" title="用語集を参照">正規表現</a> を用いることを除いて 683 <code class="directive"><Proxy></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 <Proxy balancer://mycluster><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 </Proxy> 908 </code></p></div> 909 910 <p><code class="directive"><a href="/mod/core.html#location"><Location></a></code> セクションの中で使われた場合、最初の引数は 911 省略され、ローカルディレクトリは <code class="directive"><a href="/mod/core.html#location"><Location></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.5.0 and later. 928 and later.</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 応答ヘッダの 956URL を調整する</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"><Location></a></code> セクションの中で使われた場合は、 1004 最初の引数は省略され、ローカルディレクトリは <code class="directive"><a href="/mod/core.html#location"><Location></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"> en </a> | 1248<a href="/fr/mod/mod_proxy.html" hreflang="fr" rel="alternate" title="Français"> fr </a> | 1249<a href="/ja/mod/mod_proxy.html" title="Japanese"> ja </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&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[//><!-- 1252var comments_shortname = 'httpd'; 1253var comments_identifier = 'http://httpd.apache.org/docs/2.4/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 2014 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/directives.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[//><!-- 1270if (typeof(prettyPrint) !== 'undefined') { 1271 prettyPrint(); 1272} 1273//--><!]]></script> 1274</body></html>