Apache HTTP ServerをUbuntuで動かすVirtualHost設定|conf分割と有効化

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Linuxtips > Apache HTTP ServerをUbuntuで動かすVirtualHost設定|conf分割と有効化
「Ubuntuにapache2をインストールして設定ファイルを作ったのに、なぜか反映されない」

CentOSやRHELでApacheを設定してきた人が、はじめてUbuntuで同じ作業をすると戸惑うことがあります。
原因は、設定ファイルの構造とファイルを有効化する手順がディストリビューションによって異なるためです。

この記事では、Ubuntu 22.04/24.04 LTSを想定環境として、Apache HTTP ServerのVirtualHost設定ファイルの書き方と、a2ensiteコマンドを使ったconf分割・有効化の仕組みを解説します。

この記事のポイント

・UbuntuのApacheはsites-available/sites-enabledでconfファイルを管理する
・a2ensiteコマンドで設定ファイルを有効化し、a2dissiteで無効化できる
・apache2ctl configtestで構文チェックをしてからreloadするのが基本手順
・VirtualHostは1ドメイン1ファイルで管理すると後から無効化しやすい


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

UbuntuのApache設定ファイルはCentOSと何が違うのか

RHELやCentOSでApacheを使ってきた人に、まず押さえておいてほしいことがあります。

CentOS/RHELでは、設定ファイルを /etc/httpd/conf.d/ に置けば自動的に読み込まれます。
Ubuntu(apache2パッケージ)では、設定ファイルをただ置くだけでは有効になりません。

Ubuntuには「有効化する」というステップが別に存在します。
それを担うのが、sites-availableとsites-enabledというディレクトリの組み合わせと、a2ensiteコマンドです。

この仕組みを理解すると、複数のドメインをまとめて管理したり、一時的に特定のサイトだけ無効化したりする作業が、設定ファイルを削除せずに行えるようになります。

sites-availableとsites-enabledの仕組み

Ubuntuのapache2は、2つのディレクトリで設定ファイルを管理します。

1. 2つのディレクトリの役割を確認する

# sites-available:設定ファイルの置き場所 ls /etc/apache2/sites-available/ # sites-enabled:有効化された設定ファイル(シンボリックリンク)の置き場所 ls /etc/apache2/sites-enabled/

出力例(環境により異なります):

# sites-available の出力例 000-default.conf # sites-enabled の出力例 000-default.conf -> ../sites-available/000-default.conf

sites-enabledにはシンボリックリンクが並んでいます。
sites-availableに置いた設定ファイルへのリンクを、a2ensiteコマンドが自動的に作成します。

Apacheはsites-enabledにあるconfファイルだけを読み込むため、a2ensiteを実行していないファイルは無視されます。

2. a2ensiteとa2dissiteコマンドの使い方

有効化と無効化のコマンドは、どちらも引数にconfファイル名(拡張子なし、または拡張子付き)を指定します。

# 設定ファイルを有効化する sudo a2ensite example.com.conf # 設定ファイルを無効化する sudo a2dissite example.com.conf

有効化するとsites-enabledにシンボリックリンクが作成され、無効化するとリンクが削除されます。
元のconfファイルはsites-availableに残るため、設定自体は消えません。

VirtualHostの設定ファイルを作る

1. 設定ファイルを作成する

1ドメインにつき1ファイルを作成するのが、管理しやすい構成です。
ファイル名はドメイン名に合わせるのが慣習です。

sudo nano /etc/apache2/sites-available/example.com.conf

2. VirtualHostの基本設定を書く

ポート80(HTTP)向けの基本的なVirtualHostの設定例です。

<VirtualHost *:80> ServerName example.com ServerAlias www.example.com DocumentRoot /var/www/example.com ErrorLog ${APACHE_LOG_DIR}/example.com-error.log CustomLog ${APACHE_LOG_DIR}/example.com-access.log combined </VirtualHost>

各ディレクティブの意味は次のとおりです。

・ServerName:このVirtualHostが受け付けるメインのドメイン名
・ServerAlias:追加で受け付けるドメイン名(wwwあり/なし両対応などに使う)
・DocumentRoot:Webコンテンツを配置するディレクトリ
・ErrorLog/CustomLog:ログファイルの出力先(${APACHE_LOG_DIR}は/var/log/apache2に展開される)

DocumentRootに指定したディレクトリは、事前に作成しておく必要があります。

sudo mkdir -p /var/www/example.com sudo chown www-data:www-data /var/www/example.com

設定ファイルを有効化してApacheに反映する

1. a2ensiteで有効化する

作成した設定ファイルをa2ensiteで有効化します。

sudo a2ensite example.com.conf

出力例(環境により異なります):

Enabling site example.com. To activate the new configuration, you need to run: systemctl reload apache2

2. 構文チェックをしてからリロードする

設定を反映する前に、必ず構文チェックを実行してください。
構文エラーがある状態でリロードすると、Apacheが起動しなくなる可能性があります。

# 構文チェック sudo apache2ctl configtest # 問題がなければリロード sudo systemctl reload apache2

apache2ctl configtestの出力が「Syntax OK」ならリロードを実行します。

Apacheがポート80で待ち受けているかどうかは、ssコマンドでも確認できます(Linux ポート確認の全コマンド)。

よくあるエラーと対処法

「000-default.confが優先されてVirtualHostが効かない」

Ubuntuのapache2には、デフォルトで000-default.confが有効化されています。
独自のVirtualHostに置き換える場合は、先にa2dissiteでデフォルト設定を無効化します。

sudo a2dissite 000-default.conf sudo a2ensite example.com.conf sudo systemctl reload apache2

「apache2ctl configtestがSyntax OKにならない」

VirtualHostブロックの中のパスや記述に誤りがある可能性があります。
エラーメッセージにファイル名と行番号が表示されるので、その行を中心に設定を確認してください。

「DocumentRootのディレクトリが存在しない」

DocumentRootに指定したディレクトリがない場合、Apacheは設定自体は読み込みますが、アクセス時に403エラーを返します。
mkdirで事前にディレクトリを作成してから有効化してください。

VirtualHostの基本設定を整えた後、タイムアウト値の調整が必要になった場合はApache タイムアウト設定の詳細も参考にしてください。

Apacheの設定をより体系的に学びたい場合は、【初心者向けLinuxセミナー(2日間ハンズオン)】でサーバー構築の全体像をハンズオンで習得できます。

本記事のまとめ

Ubuntu上でApache HTTP ServerのVirtualHostを設定する手順をまとめます。
やること コマンド・ファイル
設定ファイルを作成する /etc/apache2/sites-available/ドメイン名.conf
設定ファイルを有効化する sudo a2ensite ドメイン名.conf
設定ファイルを無効化する sudo a2dissite ドメイン名.conf
構文チェックをする sudo apache2ctl configtest
Apacheに設定を反映する sudo systemctl reload apache2
CentOS/RHELとの最大の違いは、設定ファイルを置いただけでは有効にならない点です。
a2ensiteで有効化してからreloadする手順を、まず手を動かして試してみてください。

現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、

UbuntuやRHELを使ったApacheの設定から構築の全体像まで、2日間のハンズオンで体系的に学べます。>>【初心者向けLinuxセミナー(2日間ハンズオン)】

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。