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ファイルで管理すると後から無効化しやすい
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
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-availableに置いた設定ファイルへのリンクを、a2ensiteコマンドが自動的に作成します。
Apacheはsites-enabledにあるconfファイルだけを読み込むため、a2ensiteを実行していないファイルは無視されます。
2. a2ensiteとa2dissiteコマンドの使い方
有効化と無効化のコマンドは、どちらも引数にconfファイル名(拡張子なし、または拡張子付き)を指定します。# 設定ファイルを有効化する sudo a2ensite example.com.conf # 設定ファイルを無効化する sudo a2dissite example.com.conf
元の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
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
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 |
a2ensiteで有効化してからreloadする手順を、まず手を動かして試してみてください。
現場で通用する安全なLinuxサーバー構築の「型」を体系的に身につけたい方へ、
UbuntuやRHELを使ったApacheの設定から構築の全体像まで、2日間のハンズオンで体系的に学べます。>>【初心者向けLinuxセミナー(2日間ハンズオン)】
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:Ubuntu Server 24.04 LTS の sysctl 設定|性能チューニングの主要パラメータ
- この記事の属するカテゴリ:Linuxtipsへ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます