バーチャルホストの例

バーチャルホストバーチャルホストの例

この文書は、バーチャルホストの設定の際によくある質問に答えるものです。想定している対象は名前ベースや IP ベースのバーチャルホストを使って一つのサーバで複数のウェブサイトを運用している状況です。一つのプロキシサーバの後ろで複数のサーバを運用するサイト向けの説明は近々書かれるはずです。

一つの IP アドレスでいくつかの名前ベースのウェブサイトを実行する

サーバは IP アドレスを一つ割り当てられていて、DNS でマシンに複数の名前 (CNAME) が指定されています。このマシンで www.example.com と www.example.org のためのウェブサーバを実行させたいとします。

注

Apache サーバの設定でバーチャルホストの設定をしただけで、知らない間にそのホスト名に対応する DNS のエントリが作成されたりはしません。そのサーバの IP アドレスに解決されるように DNS に名前を登録しなければなりません。そうでないと誰もあなたのウェブサイトを見ることはできません。ローカルでのテストのために hosts ファイルにエントリを追加することもできますが、この場合はその hosts エントリのあるマシンからしか動作しません。

サーバ設定 # Ensure that Apache listens on port 80
Listen 80

# Listen for virtual host requests on all IP addresses
NameVirtualHost *:80

<VirtualHost *:80>
DocumentRoot /www/example1
ServerName www.example.com

# Other directives here

</VirtualHost>

<VirtualHost *:80>
DocumentRoot /www/example2
ServerName www.example.org

# Other directives here

</VirtualHost>

アスタリスクはすべてのアドレスにマッチしますので、主サーバはリクエストを扱いません。www.example.com は最初にあるため、優先順位は一番高くなり、default もしくは primary のサーバと考えることができます。つまり、リクエストがどの ServerName ディレクティブにもマッチしない場合、一番最初の VirtualHost により扱われます。

注

* をシステムの実際の IP アドレスに置き換えることもできます。その場合は VirtualHost の引数は NameVirtualHost の引数と同じにしなければなりません :

NameVirtualHost 172.20.30.40

<VirtualHost 172.20.30.40>
# etc ...

しかし、IP アドレスが予測不可能なシステム ――例えばプロバイダから動的に IP アドレスを取得して何らかのダイナミック DNS を使っている場合など――においては、* 指定はさらに便利です。* はすべての IP アドレスにマッチしますので、この設定にしておけば IP アドレスが変更されても設定変更せずに動作します。

名前ベースのバーチャルホスティングではほぼすべての状況で、上記の設定で希望の設定になっていることでしょう。実際この設定が動作しないのは、IP アドレスやポートの違いによって違うコンテンツを送るときだけです。

複数の IP アドレスのあるホストで名前ベースのホスティングを行なう注

ここで説明されている方法は IP アドレスが何個あっても同様にできます。

サーバには二つ IP アドレスがついています。一つ目 (172.20.30.40) では主サーバ server.domain.com を扱い、もう一方 (172.20.30.50) では二つかそれ以上の数のバーチャルホストを扱います。

サーバの設定 Listen 80

# This is the "main" server running on 172.20.30.40
ServerName server.domain.com
DocumentRoot /www/mainserver

# This is the other address
NameVirtualHost 172.20.30.50

<VirtualHost 172.20.30.50>
DocumentRoot /www/example1
ServerName www.example.com

# Other directives here ...

</VirtualHost>

<VirtualHost 172.20.30.50>
DocumentRoot /www/example2
ServerName www.example.org

# Other directives here ...

</VirtualHost>

172.20.30.50 以外のアドレスへのリクエストは主サーバが扱います。172.20.30.50 への、未知のホスト名または Host: ヘッダなしのリクエストは www.example.com が扱います。

違う IP アドレス (例えば、内部と外部アドレス) で同じコンテンツを送る

サーバマシンは IP アドレスを二つ (192.168.1.1 と 172.20.30.40) 持っています。このマシンは内部 (イントラネット) と外部 (インターネット) のネットワークの間にあります。server.example.com はネットワークの外からは外部アドレス (172.20.30.40) として解決されますが、ネットワークの中からは内部アドレス (192.168.1.1) として解決されます。

VirtualHost 一つだけでサーバが内部のリクエストと外部のリクエストの両方に同じコンテンツで応答するようにできます。

サーバの設定 NameVirtualHost 192.168.1.1
NameVirtualHost 172.20.30.40

<VirtualHost 192.168.1.1 172.20.30.40>
DocumentRoot /www/server1
ServerName server.example.com
ServerAlias server
</VirtualHost>

これでどちらのネットワークからのリクエストも同じ VirtualHost で扱われるようになります。

注:

内部ネットワークでは完全なホスト名の server.example.com の代わりに、単に server を使うことができます。

上の例では、IP アドレスのリストを、すべてのアドレスに同じコンテンツで応答する * に置き換えられます。

違うポートで違うサイトを運営する

同じ IP に複数のドメインがあり、さらに複数のポートを使ってリクエストを扱いたいときがあります。"NameVirtualHost" タグの中でポートを定義することで、これを動作させられます。 NameVirtualHost name:port 無しや Listen ディレクティブで <VirtualHost name:port> を使おうとしても、その設定は動作しません。

サーバの設定 Listen 80
Listen 8080

NameVirtualHost 172.20.30.40:80
NameVirtualHost 172.20.30.40:8080

<VirtualHost 172.20.30.40:80>
ServerName www.example.com
DocumentRoot /www/domain-80
</VirtualHost>

<VirtualHost 172.20.30.40:8080>
ServerName www.example.com
DocumentRoot /www/domain-8080
</VirtualHost>

<VirtualHost 172.20.30.40:80>
ServerName www.example.org
DocumentRoot /www/otherdomain-80
</VirtualHost>

<VirtualHost 172.20.30.40:8080>
ServerName www.example.org
DocumentRoot /www/otherdomain-8080
</VirtualHost>

IP ベースのバーチャルホスティング

サーバは www.example.com と www.example.org にそれぞれ解決される、二つの IP アドレス (172.20.30.40 と 172.20.30.50) があります。

サーバの設定 Listen 80

<VirtualHost 172.20.30.40>
DocumentRoot /www/example1
ServerName www.example.com
</VirtualHost>

<VirtualHost 172.20.30.50>
DocumentRoot /www/example2
ServerName www.example.org
</VirtualHost>

<VirtualHost> ディレクティブのどれでも指定されていないアドレス (例えば localhost) は、主サーバがあればそこに行きます。

ポートベースと IP ベースの混ざったバーチャルホスト

サーバマシンはそれぞれ www.example.com と www.example.org にそれぞれ解決される、IP アドレスを二つ (192.168.1.1 と 172.20.30.40) 持っています。どちらもポート 80 と 8080 でホストを走らせます。

サーバの設定 Listen 172.20.30.40:80
Listen 172.20.30.40:8080
Listen 172.20.30.50:80
Listen 172.20.30.50:8080

<VirtualHost 172.20.30.40:80>
DocumentRoot /www/example1-80
ServerName www.example.com
</VirtualHost>

<VirtualHost 172.20.30.40:8080>
DocumentRoot /www/example1-8080
ServerName www.example.com
</VirtualHost>

<VirtualHost 172.20.30.50:80>
DocumentRoot /www/example2-80
ServerName www.example.org
</VirtualHost>

<VirtualHost 172.20.30.50:8080>
DocumentRoot /www/example2-8080
ServerName www.example.org
</VirtualHost>

名前ベースと IP ベースを混ぜたバーチャルホスト

いくつかのマシンでは名前ベースの、その他では IP ベースのバーチャルホストをします。

サーバの設定 Listen 80

NameVirtualHost 172.20.30.40

<VirtualHost 172.20.30.40>
DocumentRoot /www/example1
ServerName www.example.com
</VirtualHost>

<VirtualHost 172.20.30.40>
DocumentRoot /www/example2
ServerName www.example.org
</VirtualHost>

<VirtualHost 172.20.30.40>
DocumentRoot /www/example3
ServerName www.example3.net
</VirtualHost>

# IP-based
<VirtualHost 172.20.30.50>
DocumentRoot /www/example4
ServerName www.example4.edu
</VirtualHost>

<VirtualHost 172.20.30.60>
DocumentRoot /www/example5
ServerName www.example5.gov
</VirtualHost>

<code>_default_</code> のバーチャルホストを使う

すべてのポートに対する <code>_default_</code> バーチャルホスト

未指定の IP アドレスとポート、つまり他のバーチャルホストに使われていないアドレスとポートの組み合わせ、へのすべてのリクエストを受け取ります。

サーバの設定 <VirtualHost _default_:*>
DocumentRoot /www/default
</VirtualHost>

このようにワイルドカードのポートでデフォルトのバーチャルホストを指定すると、主サーバにリクエストが行くのを防げます。

デフォルトのバーチャルホストは名前ベースのバーチャルホストに使われているアドレスとポートの組に送られたリクエストを扱うことはありません。リクエストが不明な Host: ヘッダやそのヘッダがなかったりする場合は基本名前ベースバーチャルホスト (そのアドレスとポートで設定ファイル中で最初のバーチャルホスト) により扱われます。

どんなリクエストでも AliasMatch や RewriteRule を使って単一の情報ページ (やスクリプト) に書き換えることができます。

違うポートのための <code>_default_</code> バーチャルホスト

一つめの設定とほぼ同じですが、サーバは複数のポートを listen しており、 80 番ポートに対して二つめの _default_ バーチャルホストを設定したい場合です。

サーバの設定 <VirtualHost _default_:80>
DocumentRoot /www/default80
# ...
</VirtualHost>

<VirtualHost _default_:*>
DocumentRoot /www/default
# ...
</VirtualHost>

80 番ポートのデフォルトバーチャルホスト (ワイルドカードポートのデフォルトバーチャルホストよりも前に書かれていなければなりません) は未指定の IP アドレスに送られたすべてのリクエストを扱います。主サーバはリクエストを扱いません。

一つのポートに対してだけの <code>_default_</code> バーチャルホスト

80 番ポートにはデフォルトのバーチャルホストが必要で、他のバーチャルホストはデフォルトが必要ない場合です。

サーバの設定 <VirtualHost _default_:80>
DocumentRoot /www/default
...
</VirtualHost>

80 番ポートへのアドレス未指定のリクエストはデフォルトのバーチャルホストから送られます。他の未指定のアドレスとポートへのリクエストは主サーバから送られます。

名前ベースのバーチャルホストから IP ベースのバーチャルホストに移行する

ホスト名が名前 www.example.org のバーチャルホスト (名前ベースの例の 2 番目の設定) が専用の IP アドレスを得たとします。名前ベースのバーチャルホストの古い IP アドレスをキャッシュしているネームサーバやプロキシのために移行期間中は両方のバーチャルホストを提供したいとします。

答は簡単です。単に新しい IP アドレス (172.20.30.50) を VirtualHost ディレクティブに追加することでできます。

サーバ設定 Listen 80
ServerName www.example.com
DocumentRoot /www/example1

NameVirtualHost 172.20.30.40

<VirtualHost 172.20.30.40 172.20.30.50>
DocumentRoot /www/example2
ServerName www.example.org
# ...
</VirtualHost>

<VirtualHost 172.20.30.40>
DocumentRoot /www/example3
ServerName www.example.net
ServerAlias *.example.net
# ...
</VirtualHost>

このバーチャルホストは新しいアドレス (IP ベースのバーチャルホストとして) と古いアドレス(名前ベースのバーチャルホストとして) の両方からアクセスできます。

<code>ServerPath</code> ディレクティブを使う

名前ベースのバーチャルホストが二つあるサーバがあるとします。正しいバーチャルホストを得るためにはクライアントは正しい Host: ヘッダを送らなければなりません。古い HTTP/1.0 はそのようなヘッダを送らないので、Apache はクライアントがどのバーチャルホストを意図したのかさっぱりわかりません (なので、主バーチャルホストでリクエストを扱います)。可能な限りの下位互換性を得るため、名前ベースのバーチャルホストの URL 接頭辞へのリンクの書かれたページを返す、主バーチャルホストが作成されます。

サーバの設定 NameVirtualHost 172.20.30.40

<VirtualHost 172.20.30.40>
# primary vhost
DocumentRoot /www/subdomain
RewriteEngine On
RewriteRule ^/.* /www/subdomain/index.html
# ...
</VirtualHost>

<VirtualHost 172.20.30.40>
DocumentRoot /www/subdomain/sub1
ServerName www.sub1.domain.tld
ServerPath /sub1/
RewriteEngine On
RewriteRule ^(/sub1/.*) /www/subdomain$1
# ...
</VirtualHost>

<VirtualHost 172.20.30.40>
DocumentRoot /www/subdomain/sub2
ServerName www.sub2.domain.tld
ServerPath /sub2/
RewriteEngine On
RewriteRule ^(/sub2/.*) /www/subdomain$1
# ...
</VirtualHost>

ServerPath ディレクティブの設定により、URL http://www.sub1.domain.tld/sub1/ は常に sub1-vhost により扱われます。URL http://www.sub1.domain.tld/ へのリクエストはクライアントが正しい Host: ヘッダを送ったときにのみ sub1-vhost から送られます。Host: ヘッダがなければクライアントは主ホストの情報ページを得ます。

一つ奇妙な動作をする点があることは覚えておいてください。 http://www.sub2.domain.tld/sub1/ へのリクエストも Host: ヘッダがなければ sub1-vhost により扱われます。

正しい Host: ヘッダを送ったクライアントはどちらの URL、つまり接頭辞がある方も無い方も使えるように RewriteRule ディレクティブが使われています。