Apache mod_rewriteを使ったサブドメインの動的書き換え方法を徹底解説

Apacheのmod_rewriteは、強力なURL操作を可能にするモジュールで、WebサイトのURLの書き換えやリダイレクトを柔軟に設定できます。特に、サブドメインの動的書き換えは、複数のサブドメインを効率的に管理し、アクセス制御やSEO対策を行う際に役立ちます。

たとえば、user.example.comのようなサブドメインをexample.com/userにリダイレクトすることで、ユーザーごとに異なるURLを簡潔に保ちつつ、管理コストを下げられます。

本記事では、mod_rewriteの基本概念からApache設定ファイルの編集方法、さらには動的なサブドメインリライトの応用例まで、実践的なノウハウを詳しく解説します。
Apacheの設定に慣れていない方でも理解しやすいように、コード例や具体的なケースを交えて紹介します。

mod_rewriteとは何か

mod_rewriteは、Apache HTTPサーバーで使用されるモジュールの一つで、URLのリライトやリダイレクトを行うために使われます。サーバーへのリクエストが処理される前にURLを書き換えることで、ユーザーフレンドリーなURLを作成したり、古いURLを新しいURLに自動的に転送できます。

mod_rewriteの特徴

• 柔軟なURL操作：条件に応じたリダイレクトやURL変更が可能です。
• 正規表現対応：複雑なURLパターンにも対応し、多様なルールを記述できます。
• SEO対策：古いURLから新しいURLへの301リダイレクトを簡単に設定し、SEO評価を維持できます。
• セキュリティ向上：リクエストのパターンを制御することで、不正アクセスを防ぐことが可能です。

導入のメリット

• ユーザビリティの向上：ユーザーが覚えやすいURLを提供できます。
• 管理の簡素化：ディレクトリ構造を変更することなく、仮想的に別のパスとして振る舞わせることができます。
• 効率的な運用：複数のドメインやサブドメインを一元管理し、リソースを節約します。

次のセクションでは、実際にサブドメインの動的リダイレクトを行うための基本的な設定方法を解説します。

サブドメインの動的リダイレクトの基本構成

サブドメインの動的リダイレクトとは、特定のサブドメインをルールに従って自動的に別のURLへ転送する仕組みです。例えば、user.example.comをexample.com/userにリダイレクトすることで、ユーザーごとに異なるページをサブドメイン形式で提供しつつ、実際には1つのディレクトリで管理することが可能になります。

基本的な構成の流れ

1. ユーザーのリクエストがuser.example.comに送られる。
2. mod_rewriteがサブドメインのパターンを検出し、リライトルールに従ってexample.com/userに変換。
3. ユーザーは、新しいURLexample.com/userでコンテンツにアクセス。

設定例

以下は、example.comのpublic_html直下にある.htaccessファイルを使用して、サブドメインをディレクトリへリダイレクトする基本的な例です。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9]+)\.example\.com$ [NC]
RewriteRule ^$ /%1/ [L]

コードの解説

• RewriteEngine On：mod_rewriteを有効化します。
• RewriteCond：HTTPホスト（ドメイン名）がexample.comのサブドメインである場合にのみ適用します。
• RewriteRule：ルートパス^$（空のリクエスト）を/%1/にリライトします。%1はサブドメイン部分をキャプチャし、それをリダイレクト先のパスとして利用します。

この構成を使うことで、user.example.comはexample.com/user/に動的に転送され、新しいユーザーごとに追加の設定を行う必要がありません。

次のセクションでは、具体的にApacheの設定ファイルを編集する方法を解説します。

Apacheの設定ファイルの変更手順

サブドメインの動的リダイレクトを実現するためには、Apacheの設定ファイルを適切に変更する必要があります。ここでは、VirtualHostを利用した方法と.htaccessを使う方法を説明します。

1. httpd.confファイルの編集

Apacheのメイン設定ファイルであるhttpd.confまたはapache2.confを編集して、サブドメインの処理を行います。

<VirtualHost *:80>
    ServerName example.com
    ServerAlias *.example.com
    DocumentRoot /var/www/example
    <Directory /var/www/example>
        AllowOverride All
    </Directory>
</VirtualHost>

ポイント解説

• ServerAlias *.example.com：すべてのサブドメインを受け入れる設定です。
• DocumentRoot：サブドメインアクセス時のルートディレクトリです。
• AllowOverride All：.htaccessファイルのリライトルールが適用されるようにします。

2. バーチャルホストの追加

必要に応じて、サブドメインごとに専用のVirtualHostを作成することも可能ですが、動的リダイレクトでは1つのバーチャルホストで対応できます。

3. mod_rewriteの有効化

Apacheでmod_rewriteが有効でない場合は、次のコマンドで有効化します。

sudo a2enmod rewrite
sudo systemctl restart apache2

4. .htaccessでの補助設定

サーバーのルートディレクトリまたは対象ディレクトリに.htaccessファイルを配置して、動的なリライトルールを追加します。
具体的な.htaccessの記述方法については、次のセクションで詳しく解説します。

これで、Apacheがサブドメインを処理できる環境が整います。
次は、.htaccessファイルで具体的なリライトルールを作成していきます。

.htaccessを使ったサブドメインリライトルールの作成

.htaccessファイルを使うことで、Apacheの設定を簡単に変更し、サブドメインのリダイレクトやリライトを柔軟に行えます。ここでは、サブドメインをディレクトリにリライトするルールを作成する方法を解説します。

1. .htaccessファイルの作成または編集

サーバーのDocumentRootディレクトリ（例：/var/www/example）に.htaccessファイルを作成します。すでに存在する場合は、そのファイルを編集します。

2. 基本的なリライトルール

以下のコードは、サブドメインを対応するディレクトリにリダイレクトするルールです。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteRule ^$ /%1/ [L]

コード解説

• RewriteEngine On：mod_rewriteを有効にします。
• RewriteCond %{HTTP_HOST}：アクセスされたホスト名（ドメイン名）がexample.comのサブドメインである場合に適用します。
• ^([a-z0-9-]+).example.com$：user.example.comのuser部分をキャプチャします。
• RewriteRule ^$ /%1/：ルートにアクセスがあった場合、/%1/（キャプチャしたサブドメイン名）へリライトします。
• [L]：このルールがマッチしたら処理を終了します。

3. サブドメインに応じた動的リダイレクト

サブドメインをディレクトリだけでなく、特定のファイルやスクリプトに動的にリダイレクトすることも可能です。

RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteRule ^$ /user.php?name=%1 [L]

このルールは、user.example.comへのアクセスをuser.phpに転送し、name=userというクエリパラメータを追加します。

4. リライト確認方法

変更が適用されたか確認するために、ブラウザでサブドメインにアクセスします。
例：

• john.example.com → example.com/john/
• admin.example.com → example.com/admin/

これで、ユーザーごとのサブドメインを動的に管理できる環境が整いました。
次は、クエリストリングを利用した条件付きリダイレクトについて詳しく解説します。

クエリストリングを利用した条件付きリダイレクト

クエリストリング（?key=value形式のパラメータ）を活用することで、サブドメインに応じて異なる処理を行う条件付きリダイレクトが可能です。これにより、特定の条件に一致した場合のみ、動的にリダイレクトを実行できます。

1. クエリストリングを使用した基本ルール

以下は、サブドメインをuser.phpスクリプトに転送し、クエリストリングでサブドメインの情報を渡す例です。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteRule ^$ /user.php?name=%1 [L]

動作例

• john.example.com → example.com/user.php?name=john
• admin.example.com → example.com/user.php?name=admin

この方法では、PHPや他のプログラムで$_GET['name']を利用して、サブドメイン情報を取得し、必要な処理を行います。

2. 条件付きのリダイレクト

クエリストリング内の値に基づき、特定のページへの転送を行うことも可能です。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteCond %{QUERY_STRING} ^page=dashboard$ [NC]
RewriteRule ^$ /dashboard/%1/ [L]

動作例

• admin.example.com?page=dashboard → example.com/dashboard/admin/
• user.example.com?page=dashboard → example.com/dashboard/user/

3. クエリストリングの複数条件処理

複数のクエリストリングを処理するには、条件を追加してリライトします。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteCond %{QUERY_STRING} ^type=admin&section=profile$ [NC]
RewriteRule ^$ /admin/%1/profile [L]

動作例

• admin.example.com?type=admin&section=profile → example.com/admin/admin/profile

4. パフォーマンスへの配慮

クエリストリングの利用は便利ですが、多用するとパフォーマンスに影響する可能性があります。シンプルなルールにまとめるか、必要最低限の条件だけに適用するのがベストプラクティスです。

次は、SSL対応のサブドメインリライト設定について詳しく解説します。

SSL対応のサブドメインリライト設定方法

サブドメインのリダイレクトをHTTPSで行うことは、セキュリティの向上とSEO対策の両面で重要です。mod_rewriteを使用して、サブドメインへのリクエストを自動的にHTTPSへリダイレクトする設定を行います。

1. SSL対応の基本設定

HTTPSへ強制リダイレクトする基本的な.htaccessルールは以下の通りです。

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

コード解説

• RewriteCond %{HTTPS} off：HTTPでアクセスされた場合にのみ適用します。
• %{HTTP_HOST}：リクエストされたホスト名（サブドメイン）を取得します。
• R=301：301リダイレクトを行い、HTTPSに転送します。
• %{REQUEST_URI}：アクセスしたパスがそのまま保持されます。

2. SSL証明書の準備

HTTPSでサブドメインにアクセスするためには、ワイルドカードSSL証明書またはサブドメインごとのSSL証明書が必要です。

ワイルドカードSSL証明書の例

*.example.comに対応する証明書を取得すれば、すべてのサブドメインがSSLで保護されます。

3. ApacheのVirtualHost設定

次に、Apacheの設定ファイルでSSLの有効化を行います。

<VirtualHost *:80>
    ServerName example.com
    ServerAlias *.example.com
    Redirect permanent / https://%{HTTP_HOST}%{REQUEST_URI}
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    ServerAlias *.example.com
    DocumentRoot /var/www/example
    SSLEngine on
    SSLCertificateFile /etc/ssl/certs/example.com.crt
    SSLCertificateKeyFile /etc/ssl/private/example.com.key
</VirtualHost>

ポイント解説

• ポート80でのリクエストは自動的にポート443（HTTPS）へリダイレクトされます。
• SSLEngine onによりSSL通信が有効になります。
• 証明書ファイルと鍵ファイルを指定してSSLを動作させます。

4. リダイレクト確認

ブラウザでサブドメインにアクセスし、HTTPSに自動的にリダイレクトされることを確認します。

例：

• http://user.example.com → https://user.example.com

これでサブドメインごとにSSL対応の動的リダイレクトが可能になります。
次は、複数条件を使ったリライトの応用例について解説します。

複数条件を使ったリライトの応用例

mod_rewriteは、複数の条件を組み合わせることで、より柔軟で高度なURLリライトを実現できます。特定のサブドメインやクエリストリングの組み合わせに応じて異なるリダイレクトやアクセス制限を行うことが可能です。

1. 複数のサブドメインを条件にしたリダイレクト

例えば、admin.example.comは管理画面に、user.example.comはユーザーページにリダイレクトする設定を行います。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^admin\.example\.com$ [NC]
RewriteRule ^$ /admin/dashboard/ [L]

RewriteCond %{HTTP_HOST} ^user\.example\.com$ [NC]
RewriteRule ^$ /user/home/ [L]

動作例

• admin.example.com → /admin/dashboard/
• user.example.com → /user/home/

2. IPアドレスとサブドメインの組み合わせで制限

管理者サブドメインに特定のIPアドレスからのみアクセスを許可し、それ以外のIPは403エラーを返します。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^admin\.example\.com$ [NC]
RewriteCond %{REMOTE_ADDR} !^192\.168\.1\.[0-9]+$
RewriteRule ^ - [F]

動作例

• admin.example.com へのアクセスが192.168.1.x以外のIPからの場合、403エラーを返します。
• 192.168.1.5などの許可されたIPアドレスは正常にアクセスできます。

3. クエリストリングを使った条件分岐

特定のクエリストリングが存在する場合にリライトを行い、それ以外は通常のページを表示します。

RewriteEngine On
RewriteCond %{QUERY_STRING} ^page=profile$ [NC]
RewriteRule ^$ /user/profile/ [L]

RewriteCond %{QUERY_STRING} ^page=dashboard$ [NC]
RewriteRule ^$ /user/dashboard/ [L]

動作例

• example.com?page=profile → /user/profile/
• example.com?page=dashboard → /user/dashboard/

4. サブドメインとディレクトリの組み合わせリライト

特定のサブドメインにアクセスした際に、URLのディレクトリ構造を維持しつつリライトします。

RewriteEngine On
RewriteCond %{HTTP_HOST} ^([a-z0-9-]+)\.example\.com$ [NC]
RewriteRule ^/docs/(.*)$ /%1/docs/$1 [L]

動作例

• docs.example.com/docs/install → /docs/docs/install
• user.example.com/docs/setup → /user/docs/setup

5. ルールの優先度と[L]フラグの重要性

複数のRewriteRuleが存在する場合、最初に一致したルールで処理が終了します。
[L]フラグを適切に使用することで、不要なルールが適用されないように制御できます。

これで、複雑な条件を組み合わせた高度なURLリライトが可能になります。
次は、トラブルシューティングとエラー対処法について詳しく解説します。

トラブルシューティングとエラー対処法

mod_rewriteの設定は強力ですが、設定ミスや予期せぬ動作が発生することもあります。ここでは、mod_rewriteを使ったサブドメインリライトに関する代表的なエラーとその対処法を解説します。

1. mod_rewriteが機能しない

mod_rewriteが有効になっていない場合、リダイレクトやリライトが行われません。

原因と対処法

• 原因：Apacheでmod_rewriteが有効化されていない。
• 対処法：
  以下のコマンドでmod_rewriteを有効化し、Apacheを再起動します。

sudo a2enmod rewrite
sudo systemctl restart apache2

その後、.htaccessやhttpd.conf内で次の記述があることを確認します。

RewriteEngine On

2. .htaccessが無視される

.htaccessファイルが存在していても、リライトルールが適用されない場合があります。

原因と対処法

• 原因：AllowOverrideが無効になっている。
• 対処法：VirtualHost設定に以下を追加し、.htaccessが動作するようにします。

<Directory /var/www/example>
    AllowOverride All
</Directory>

Apacheを再起動して変更を反映します。

sudo systemctl restart apache2

3. 無限ループが発生する

リライトルールが不適切であると、同じリクエストが繰り返され、無限リダイレクトが発生することがあります。

原因と対処法

• 原因：リライト条件が曖昧で、ループが止まらない。
• 対処法：ループを防ぐため、条件にRewriteCondを追加します。

RewriteCond %{REQUEST_URI} !^/user/
RewriteRule ^(.*)$ /user/$1 [L]

これにより、既に/user/で始まるリクエストは再リライトされません。

4. 403 Forbiddenエラーが表示される

アクセスが拒否される場合は、RewriteRuleやDirectory設定のミスが考えられます。

原因と対処法

• 原因：アクセス制限の設定ミスやパーミッションの問題。
• 対処法：
• Directoryディレクティブに以下を追加し、アクセスを許可します。

<Directory /var/www/example>
    Require all granted
</Directory>

• ファイルやディレクトリのパーミッションを確認します。

sudo chmod -R 755 /var/www/example

5. 404 Not Foundエラー

リライト先のファイルやディレクトリが存在しない場合、404エラーが発生します。

原因と対処法

• 原因：リライト先のパスが誤っている。
• 対処法：

1. .htaccess内のリライト先パスを確認します。
2. 実際のディレクトリやファイルが存在するかをチェックします。
3. 必要に応じてRewriteBaseを設定し、基準となるパスを明示します。

RewriteBase /

これで、mod_rewriteの設定時に発生しやすいエラーを回避し、安定したリダイレクト設定を構築できます。
次は、記事のまとめです。

まとめ

本記事では、Apacheのmod_rewriteを使ったサブドメインの動的書き換え方法について解説しました。mod_rewriteの基本から始まり、サブドメインのリダイレクト方法、SSL対応、クエリストリングの利用方法、さらには複数条件を使った応用例まで幅広く紹介しました。

サブドメインのリライトを活用することで、ユーザーごとに異なるページを提供したり、SEO対策やセキュリティ向上を実現できます。特に、条件付きリライトやSSL対応は、より柔軟で安全なWeb運用に不可欠です。

また、mod_rewrite設定においては、無限リダイレクトや403エラーなどのトラブルが発生することもありますが、本記事で紹介したトラブルシューティング方法を参考にして、適切に対応してください。

mod_rewriteを使いこなすことで、Apacheサーバーの柔軟性を最大限に引き出し、スケーラブルなWebサイト運用を実現しましょう。