ApacheのDocumentRootを変更する手順と注意点【完全ガイド】

ApacheのWebサーバーで「DocumentRoot」を変更することは、公開するコンテンツの場所を自由に設定する重要な作業です。デフォルトでは「/var/www/html」などに設定されていますが、プロジェクトの構成やセキュリティの観点から、異なるディレクトリに変更したい場合があります。

本記事では、Apacheの設定ファイルであるhttpd.confを編集し、DocumentRootを安全かつ確実に変更する方法を詳しく解説します。手順の詳細だけでなく、権限の設定やエラーの対処法など、実践的な知識も網羅しています。

初心者でもわかりやすいようにステップバイステップで説明するので、Apacheの設定変更に自信がない方でも安心して作業を進められます。DocumentRootの変更で、より柔軟なWebサーバー運用を実現しましょう。

DocumentRootとは？基本概念の解説

DocumentRoot（ドキュメントルート）とは、ApacheがWebサイトのファイルを提供する際に参照するディレクトリのことです。Webブラウザが特定のURLにアクセスしたとき、Apacheはこのディレクトリ内のファイルを探してクライアントに返します。

たとえば、http://example.com/index.htmlにアクセスした場合、ApacheはDocumentRootで指定されたフォルダ内のindex.htmlを返します。デフォルトの設定では、多くのLinux環境で/var/www/htmlがDocumentRootとして設定されています。

DocumentRootの役割

DocumentRootは、次のような重要な役割を担っています。

Webコンテンツの格納場所：WebページのHTML、CSS、画像などのファイルを格納する場所です。
セキュリティとアクセス制御：外部からのアクセスを制御し、公開する範囲を限定できます。
プロジェクト管理：異なるWebサイトやプロジェクトごとにDocumentRootを変更することで、運用しやすくなります。

DocumentRootの例

以下のように設定されている場合：

DocumentRoot "/var/www/html"

ブラウザでhttp://example.com/about.htmlにアクセスすると、/var/www/html/about.htmlが表示されます。

このDocumentRootを変更することで、Apacheが参照するフォルダを自由に設定し、必要に応じて異なるディレクトリからコンテンツを提供できるようになります。

httpd.confの場所と開き方

Apacheの設定を変更するには、httpd.confファイルを編集する必要があります。このファイルには、Apacheの動作に関する基本的な設定が記述されており、DocumentRootの変更もここで行います。

httpd.confの場所

httpd.confの場所はシステムによって異なりますが、主に以下のディレクトリに配置されています。

CentOS / Red Hat系：

  /etc/httpd/conf/httpd.conf

Ubuntu / Debian系：

  /etc/apache2/apache2.conf

※Ubuntuではapache2.confがメイン設定ファイルで、DocumentRootは/etc/apache2/sites-available/000-default.confで管理されることが多いです。

Windows：

  C:\xampp\apache\conf\httpd.conf

httpd.confを開く方法

ターミナルまたはコマンドプロンプトから、以下のコマンドでhttpd.confを開くことができます。

Linux系：

  sudo vi /etc/httpd/conf/httpd.conf

または

  sudo nano /etc/httpd/conf/httpd.conf

Windows（XAMPP環境）：
エクスプローラーでC:\xampp\apache\conf\httpd.confをダブルクリックするか、メモ帳やVS Codeで開きます。

編集時の注意点

設定ファイルを編集する前に必ずバックアップを取ってください。
編集後は、Apacheを再起動して変更を反映させる必要があります。
権限が必要な場合はsudoコマンドを使用します。

次の項目では、DocumentRootの具体的な変更手順について解説します。

DocumentRootの変更手順【ステップバイステップ】

ApacheのDocumentRootを変更するには、httpd.confファイルまたはサイトごとの設定ファイルを編集します。ここでは、基本的な手順をステップバイステップで解説します。

1. DocumentRootの新しいディレクトリを作成

まず、新しくDocumentRootとして使用するディレクトリを作成します。

sudo mkdir /var/www/newroot

作成したディレクトリに必要なファイルを配置します。

2. httpd.confファイルを開く

以下のコマンドでhttpd.confファイルを開きます。

sudo vi /etc/httpd/conf/httpd.conf

または

sudo nano /etc/httpd/conf/httpd.conf

3. DocumentRootの設定を変更

httpd.conf内で以下のような記述を探します。

DocumentRoot "/var/www/html"
<Directory "/var/www/html">

これを、新しいディレクトリに変更します。

DocumentRoot "/var/www/newroot"
<Directory "/var/www/newroot">

<Directory>ディレクティブも忘れずに変更してください。これにより、新しいディレクトリへのアクセス許可が設定されます。

4. 権限の設定

新しいDocumentRootに対して、適切な権限を付与します。

sudo chown -R apache:apache /var/www/newroot
sudo chmod -R 755 /var/www/newroot

これにより、Apacheが新しいDocumentRootを適切に読み込めるようになります。

5. 設定を保存してApacheを再起動

ファイルを保存したら、Apacheを再起動して変更を反映させます。

sudo systemctl restart httpd

または

sudo service apache2 restart

6. 動作確認

ブラウザでhttp://サーバーIPアドレス/にアクセスし、新しいDocumentRootが反映されているか確認します。正しく表示されれば変更は完了です。

次は、必要なアクセス権と権限の詳細について解説します。

必要な権限とアクセス権の設定

DocumentRootを新しいディレクトリに変更した後は、Apacheが適切にアクセスできるように、必要な権限とアクセス権を設定する必要があります。不適切な権限設定は、403 Forbiddenエラーなどの原因になります。

1. 所有者とグループの設定

Apacheが新しいDocumentRootのディレクトリを読み書きできるように、所有者（owner）とグループ（group）を設定します。
デフォルトでは、Apacheのユーザーはapacheまたはwww-dataとして動作します。

以下のコマンドでディレクトリの所有者を変更します。
CentOS / RHEL系:

sudo chown -R apache:apache /var/www/newroot

Ubuntu / Debian系:

sudo chown -R www-data:www-data /var/www/newroot

2. アクセス権の設定

次に、ディレクトリとファイルに対して適切なパーミッションを設定します。一般的には以下の権限が推奨されます。

sudo chmod -R 755 /var/www/newroot

設定内容の解説：

7：所有者が読み取り・書き込み・実行可能（rwx）
5：グループとその他のユーザーが読み取り・実行可能（r-x）
-R：ディレクトリ以下の全てのファイルとサブディレクトリに対して再帰的に適用

3. SELinuxの設定（CentOS / RHEL系）

SELinuxが有効になっている環境では、Apacheが新しいDocumentRootにアクセスできるようにコンテキストを変更する必要があります。
以下のコマンドを実行してSELinuxのコンテキストを設定します。

sudo chcon -R -t httpd_sys_content_t /var/www/newroot

もし書き込み権限が必要な場合は、以下のコマンドを追加で実行します。

sudo chcon -R -t httpd_sys_rw_content_t /var/www/newroot

4. Apacheの設定テスト

権限設定後、Apacheの設定にエラーがないか確認します。

sudo apachectl configtest

Syntax OKと表示されれば問題ありません。

5. アクセス権の確認

ブラウザで新しいDocumentRootにアクセスし、ページが表示されることを確認します。もし403エラーが発生する場合は、次の点を再確認してください。

ディレクトリとファイルの所有者とグループが正しいか
パーミッションが適切か（755または644）
SELinuxが適切に設定されているか

次は、Apacheの再起動と変更が反映されているかの確認方法について解説します。

再起動と変更の反映確認方法

DocumentRootを変更した後は、Apacheを再起動して設定を反映させる必要があります。再起動を行わないと、httpd.confやサイト設定ファイルの変更が反映されません。ここでは、再起動の方法と反映を確認する手順を解説します。

1. Apacheの再起動

Linux環境での再起動方法

CentOS / RHEL系:

sudo systemctl restart httpd

Ubuntu / Debian系:

sudo systemctl restart apache2

serviceコマンドを使用する場合:

sudo service httpd restart  # CentOS系
sudo service apache2 restart  # Ubuntu系

Windows環境での再起動方法

XAMPP環境では、XAMPPコントロールパネルからApacheを「Stop」し、「Start」で再起動します。または、以下のコマンドプロンプトで再起動できます。

httpd.exe -k restart

2. Apacheの設定テスト

再起動前にApacheの設定が正しいか確認します。エラーがある場合、Apacheが起動しなくなる可能性があります。

sudo apachectl configtest

Syntax OKと表示されれば、設定に問題はありません。エラーが表示された場合は、httpd.confや関連ファイルを再度確認してください。

3. 変更の反映を確認する方法

1. ブラウザでアクセスして確認

ブラウザからサーバーのIPアドレスまたはドメインにアクセスします。

http://<サーバーIPアドレス>/

もし新しいDocumentRootの内容が表示されれば、設定は正しく反映されています。

2. HTMLファイルを置いてテスト

新しいDocumentRoot内に簡単なHTMLファイルを作成し、ブラウザでアクセスします。

echo "<h1>Test Page</h1>" | sudo tee /var/www/newroot/index.html

ブラウザで以下のURLにアクセスし、「Test Page」と表示されれば成功です。

http://<サーバーIPアドレス>/index.html

4. エラーが発生した場合

403 Forbidden：権限やSELinuxの設定を再確認してください。
404 Not Found：DocumentRootのパスが正しいか、ファイルが存在するかを確認してください。
500 Internal Server Error：httpd.confの記述ミスがないか確認します。

これでDocumentRootの変更と反映の確認は完了です。次は、エラーが発生した場合のトラブルシューティングについて解説します。

エラーが発生した場合のトラブルシューティング

DocumentRootの変更後にApacheが正常に動作しない場合は、いくつかの原因が考えられます。ここでは、代表的なエラーとその解決方法を解説します。

1. 403 Forbiddenエラー

原因: アクセス権限の問題やSELinuxの設定ミスが考えられます。

解決方法:

アクセス権の確認

sudo ls -ld /var/www/newroot

権限がdrwxr-xr-x（755）となっているか確認します。不足している場合は以下で修正します。

sudo chmod -R 755 /var/www/newroot

所有者の確認と変更

sudo chown -R apache:apache /var/www/newroot  # CentOS系
sudo chown -R www-data:www-data /var/www/newroot  # Ubuntu系

SELinuxの設定（CentOS/RHEL系のみ）

sudo chcon -R -t httpd_sys_content_t /var/www/newroot

書き込みを許可する場合は以下を追加。

sudo chcon -R -t httpd_sys_rw_content_t /var/www/newroot

2. 404 Not Foundエラー

原因: DocumentRootの設定が正しく反映されていないか、ファイルが存在しません。

解決方法:

httpd.confまたはapache2.confでDocumentRootの記述が正しいか確認します。

DocumentRoot "/var/www/newroot"

新しいDocumentRoot内にテスト用のHTMLファイルを作成して確認します。

echo "<h1>Test Page</h1>" | sudo tee /var/www/newroot/index.html

3. 500 Internal Server Error

原因: httpd.confの記述ミスが考えられます。

解決方法:

Apacheの設定テストを実施し、エラー内容を確認します。

sudo apachectl configtest

記述ミスがある場合は指摘箇所を修正し、再度テストします。

4. SELinuxが原因でアクセスできない

原因: SELinuxが新しいDocumentRootへのアクセスをブロックしています。

解決方法:

現在のSELinuxの状態を確認します。

sestatus

SELinuxが有効な場合は、以下のコマンドで許可します。

sudo chcon -R -t httpd_sys_content_t /var/www/newroot

5. ポートやファイアウォールが原因のアクセス不可

原因: Apacheがリッスンするポートがブロックされている可能性があります。

解決方法:

Apacheが正しいポートでリッスンしているか確認します。

sudo netstat -tuln | grep :80

ファイアウォールの設定を確認し、必要であればポートを開放します。

sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --reload

これで、エラー発生時の主なトラブルシューティングは完了です。次はDocumentRootを変更するメリットとデメリットについて解説します。

DocumentRootを変更するメリットとデメリット

DocumentRootを変更することで、Apacheの運用が柔軟になり、さまざまなWebサイトやアプリケーションを効率的に管理できます。しかし、一方でリスクや注意点も存在します。ここでは、DocumentRootを変更するメリットとデメリットを詳しく解説します。

1. DocumentRootを変更するメリット

1-1. 複数のプロジェクトを効率的に管理できる

複数のWebサイトやアプリケーションを1台のサーバーで運用する際、プロジェクトごとにDocumentRootを設定することで、管理が容易になります。
例えば、以下のようにバーチャルホストを使ってプロジェクトを分けられます。

<VirtualHost *:80>
    ServerName project1.example.com
    DocumentRoot "/var/www/project1"
</VirtualHost>

<VirtualHost *:80>
    ServerName project2.example.com
    DocumentRoot "/var/www/project2"
</VirtualHost>

1-2. セキュリティ強化

デフォルトの/var/www/htmlを使用しないことで、攻撃者に対するセキュリティ対策となります。公開ディレクトリを任意の場所に設定することで、予期しないディレクトリトラバーサル攻撃を回避できます。

1-3. カスタマイズ性の向上

特定のプロジェクト用にカスタムディレクトリを作成することで、ディレクトリ構成やアクセス権の設定を柔軟に変更できます。

1-4. パフォーマンスの向上

SSDストレージを搭載したディレクトリをDocumentRootに指定することで、Webサイトの読み込み速度を向上させることが可能です。

2. DocumentRootを変更するデメリット

2-1. 設定ミスによるエラーの発生

DocumentRootを変更した際に設定ファイルの記述ミスや権限の不備があると、403 Forbiddenや404 Not Foundなどのエラーが発生します。特にSELinuxが有効な環境では、アクセス制限がかかることがあります。

2-2. セキュリティの低下リスク

不適切なパーミッションを設定すると、サーバー全体が脆弱になります。例えば、777のように誰でも書き込み可能な権限を付与すると、悪意のあるスクリプトがアップロードされる可能性があります。

2-3. バックアップや移行の手間

DocumentRootを複数設置した場合、バックアップやサーバー移行の際に混乱する可能性があります。ディレクトリが分散すると、管理が複雑になります。

2-4. Apacheの再起動が必要

DocumentRootの変更はApacheの再起動が必要になるため、サービスのダウンタイムが発生します。運用中のサーバーでは、タイミングを見極める必要があります。

3. 変更時のポイント

必ず設定ファイルを変更する前にバックアップを取ること
設定後はApacheの設定テストを行い、エラーがないことを確認すること
必要に応じてSELinuxの設定やファイアウォールの調整を行うこと

次は、複数のDocumentRootを設定する方法について解説します。

複数のDocumentRootを設定する方法【応用編】

Apacheでは、バーチャルホスト（VirtualHost）を使用することで、1台のサーバーで複数のWebサイトを運用し、それぞれ異なるDocumentRootを設定できます。この方法は、ドメインやサブドメインごとに異なるコンテンツを提供する際に便利です。

1. バーチャルホストの基本概念

バーチャルホストとは、1つのApacheサーバーで複数のWebサイトをホストする仕組みです。

名前ベースのバーチャルホスト：ドメイン名で異なるサイトを識別
IPベースのバーチャルホスト：異なるIPアドレスでサイトを識別

ここでは、名前ベースのバーチャルホストを使って複数のDocumentRootを設定する方法を解説します。

2. バーチャルホストの設定例

例：
project1.example.comとproject2.example.comの2つのWebサイトを運用し、それぞれのDocumentRootを設定します。

2-1. 必要なディレクトリを作成

sudo mkdir -p /var/www/project1
sudo mkdir -p /var/www/project2

それぞれのディレクトリに簡単なHTMLファイルを配置します。

echo "<h1>Project 1</h1>" | sudo tee /var/www/project1/index.html
echo "<h1>Project 2</h1>" | sudo tee /var/www/project2/index.html

2-2. httpd.conf（またはsites-available）にバーチャルホストを追加

<VirtualHost *:80>
    ServerName project1.example.com
    DocumentRoot "/var/www/project1"
    <Directory "/var/www/project1">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName project2.example.com
    DocumentRoot "/var/www/project2"
    <Directory "/var/www/project2">
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

2-3. ホストファイルの設定（テスト用）

サーバー内からアクセスする場合は、/etc/hostsに以下を追加します。

127.0.0.1 project1.example.com
127.0.0.1 project2.example.com

3. Apacheの設定をテスト

設定が正しいかを確認します。

sudo apachectl configtest

Syntax OKと表示されれば問題ありません。

4. Apacheの再起動

sudo systemctl restart httpd  # CentOS系
sudo systemctl restart apache2  # Ubuntu系

5. 動作確認

ブラウザで以下のURLにアクセスします。

http://project1.example.com
http://project2.example.com

それぞれのHTMLが正しく表示されれば、複数のDocumentRootが設定されています。

6. エラーが出た場合の確認ポイント

403エラー：ディレクトリの権限が正しいか確認

sudo chown -R apache:apache /var/www/project1
sudo chmod -R 755 /var/www/project1

404エラー：DocumentRootのパスが正しいか確認
アクセスできない場合：SELinuxやファイアウォールの設定を確認

これで、複数のDocumentRootを持つバーチャルホストの設定は完了です。次は、この記事のまとめに入ります。

まとめ

本記事では、ApacheのDocumentRootを変更する方法と、その際の注意点について詳しく解説しました。DocumentRootの変更は、Webサイトの管理を効率化し、セキュリティを強化する重要な作業です。

ステップバイステップで進めることで、初心者でも確実に設定を行えるようになります。さらに、複数のバーチャルホストを設定することで、1台のサーバーで複数のサイトを運用する応用技術も習得できました。

重要なポイント:

設定変更前には必ずバックアップを取る
権限設定やSELinuxの適切な構成が403エラーの防止に役立つ
設定後は必ずApacheを再起動し、動作確認を行う

DocumentRootを自由に変更できるようになれば、Apacheの運用スキルがさらに向上します。ぜひ実際に手を動かして試してみてください。

ApacheのDocumentRootを変更する手順と注意点【完全ガイド】

DocumentRootとは？基本概念の解説

DocumentRootの役割

DocumentRootの例

httpd.confの場所と開き方

httpd.confの場所

httpd.confを開く方法

編集時の注意点

DocumentRootの変更手順【ステップバイステップ】

1. DocumentRootの新しいディレクトリを作成

2. httpd.confファイルを開く

3. DocumentRootの設定を変更

4. 権限の設定

5. 設定を保存してApacheを再起動

6. 動作確認

必要な権限とアクセス権の設定

1. 所有者とグループの設定

2. アクセス権の設定

3. SELinuxの設定（CentOS / RHEL系）

4. Apacheの設定テスト

5. アクセス権の確認

再起動と変更の反映確認方法

1. Apacheの再起動

Linux環境での再起動方法

Windows環境での再起動方法

2. Apacheの設定テスト

3. 変更の反映を確認する方法

1. ブラウザでアクセスして確認

2. HTMLファイルを置いてテスト

4. エラーが発生した場合

エラーが発生した場合のトラブルシューティング

1. 403 Forbiddenエラー

2. 404 Not Foundエラー

3. 500 Internal Server Error

4. SELinuxが原因でアクセスできない

5. ポートやファイアウォールが原因のアクセス不可

DocumentRootを変更するメリットとデメリット

1. DocumentRootを変更するメリット

1-1. 複数のプロジェクトを効率的に管理できる

1-2. セキュリティ強化

1-3. カスタマイズ性の向上

1-4. パフォーマンスの向上

2. DocumentRootを変更するデメリット

2-1. 設定ミスによるエラーの発生

2-2. セキュリティの低下リスク

2-3. バックアップや移行の手間

2-4. Apacheの再起動が必要

3. 変更時のポイント

複数のDocumentRootを設定する方法【応用編】

1. バーチャルホストの基本概念

2. バーチャルホストの設定例

2-1. 必要なディレクトリを作成

2-2. httpd.conf（またはsites-available）にバーチャルホストを追加

2-3. ホストファイルの設定（テスト用）

3. Apacheの設定をテスト

4. Apacheの再起動

5. 動作確認

6. エラーが出た場合の確認ポイント

まとめ

コメント

コメントする コメントをキャンセル

コメントするコメントをキャンセル