Apache2.4 Windows版の基本設定

Version 2.4.41

— y2sunlight 2019-10-07

Apacheに戻る

関連記事

• Apache2.4 Windows版の基本設定
• Apache2.4 httpd.confの編集

Appendix

• Apache2.4 基本認証とダイジェスト認証
• Apache2.4 アクセス制御ディレクティブ

Apacheのメインの設定ファイルは httpd.conf です。XAMPPのhttpd.conf は以下に配置されています。

{XAMPP Install folder}\apache\conf\*httpd.conf

httpd.conf はUNIX版とWindows版で記述方法や基本的な設定内容は同じです。httpd.conf は、テキストファイルなので、「メモ帳」などのテキストエディターで編集できます。編集後はApacheを再起動して下さい。

httpd.confの文法チェックは、コマンドプロンプトから以下のコマンドで実行できます。

httpd.conf の文法チェック

D:\>cd usr\xampp7.2.22\apache\bin
 
D:\usr\xampp7.2.22\apache\bin>httpd -t
Syntax OK

Apacheを設定する前に少しApacheについて復習しておきましょう。まず、基本的なApacheの構造です。Apache の前身はNCSAが開発したWeb サーバ( NCSA httpd )です。従って、構造や設定などは NCSA httpd を基本としたものになっています。

簡単に説明するとApache は右図のような構造となっています。システムの核(コア)となるモジュールと、機能別のモジュールから構成されています。Apache では NCSA httpd の基本構造を踏襲しつつ、徹底的な機能のモジュール化により、様々な拡張が行われてきました。サーバの管理者は必要とするモジュールを選択し、サーバに組み込んで機能拡張をする事ができます。

NCSA(米国立スーパーコンピュータ応用研究所)：
世界初のCGIによるWebブラウザ Mosaicを開発した組織として有名。Mosaic開発チームは、その後、Silicon Graphics社の創業者Jim Clark氏とNetscape Communications社を設立した。

インストール直後に httpd.conf でロード指定があるモジュールを挙げておきます。(XAMPP7.2.77/Apache2.4.41)

Apacheの設定は「ディレクティブ」を設定ファイル httpd.conf に記述する事により行います。Apache は起動時にのみ httpd.conf の変更を認識します。Apache は MIMEドキュメントタイプを含んでいるファイルも読み込みます。このファイル名は TypesConfig ディレクティブで設定され、デフォルトでは conf/mime.types になっています。

httpd.conf の各ディレクティブはいろいろなモジュールに作用します。Apacheのコアモジュールには基本的な機能だけが含まれ、その他の拡張機能はモジュールとして利用可能です。サーバが動的ロードモジュールを使うようにコンパイルされている場合、モジュールを別にコンパイルして、いつでも LoadModule ディレクティブを使って追加できます。設定ディレクティブは <IfModule> ブロックに入れることで特定のモジュールが存在するときだけ httpd.conf に含まれるようにすることができます。

httpd.conf にあるディレクティブはサーバ全体に適用されます。 サーバの一部分の設定だけを変更したい場合は <Directory>、 <Files> または <Location>ブロックの中にディレクティブを記述します。これらの記述はXMLに似ており<Block>・・・</Block>と書きます。

上記のTargetにはワイルドカードが使用できます。 “*” は任意の文字列にマッチし、“?” は任意の 1 文字にマッチし、 “[abc]” はabc の任意の文字にマッチします。但し、“/” はどのワイルドカードにもマッチしないので、明示的に指定する必要があります。(Perl5互換の)正規表現によるマッチングを望む場合は、<Directory ~ Target>、 <Files ~ Target>、<Location ~ Target> と記述します。 <Directory ~ Target >の代わりに<DirectoryMatch Target> と書く事もできます。同様に <FileMatch Target>、<LocationMatch Target>と書くこともできます。

<Directory>と<Files>を両方使ってより詳細な設定を行う事ができます。

例：ワイルドカードにマッチしたディレクトリ内の特定の拡張子のファイルを全てアクセス拒否にする

httpd.conf

<Directory "C:/Documents and Settings/*/My Documents/My Website">
　<Files ~ "\.(sql|log|dat|db)$">
    Require all granted
　</Files>
</Directory>

Apache は同時に多くの違うウェブサイトを扱う能力があります。 これは バーチャルホスト と呼ばれています。 特定のウェブサイトにのみ適用されるようにするために、 ディレクティブは<VirtualHost>ブロックの中に置くことでも適用範囲を変えることができます。

Apacheでは公開用のドキュメントツリー中に置かれた特別なファイルを使って httpd.conf の設定内容の一部を上書きする事ができます。そのファイルはアクセス制御ファイルと呼ばれ、デフォルトでは.htaccess という名前ですが、AccessFileName ディレクティブを使って変更する事もできます。また、AllowOverride ディレクティブを使って、.htaccessによる設定の上書きを制御することもできます。

.htaccess中のディレクティブはこのファイルを置いたディレクトリと全てのサブディレクトリに適用されます。.htaccess はクライアントからのリクエスト時で読み込まれるので、変更はすぐに反映されます。

例：基本認証

.htaccess

# ユーザ認証を基本認証に指定
AuthType Basic

# ブラウザのユーザ認証ダイアログに表示するメッセージ
AuthName "Password Required"

# パスワードファイル名
AuthUserFile /www/passwords/password.file

# パスワードファイル内でアクセスを許可するユーザの羅列
# require user UserName --- UserName だけに許可
# require valid-user --- 全てのユーザに許可
Require valid-user

一般にWebサーバでは、物理的なホストファイルシステムと仮想的なフォルダ（公開するされるURLパス）をマッピングする機能を提供しています。Apacheではこの仮想的なフォルダの事をドキュメントディレクトリと呼び、先頭のドキュメントディレクトリをドキュメントルート( DocummentRoot )と呼びます。

大雑把に言うと、Apacheは、HTTPリクエストに含まれるURLパスを DocummentRoot の最後に追加して、レスポンスとして返すファイルを決定します。従って、ブラウザからは DocumentRoot の下のディレクトリやファイルが木構造をしているように見えます。Apache にはバーチャルホストの機能もあります。この場合、それぞれのバーチャルホストに対してDocumentRoot を指定することができます。

DocumentRoot の外にあるディレクトリを公開する方法は、Alias ディレクティブを使う事です。Alias ディレクティブを使えば、ホストファイルシステムの任意の部分をドキュメントディレクトリにマッピングできます。また、ScriptAlias ディレクティブも Alias と同様ですが、対象となっているURLパスが CGIの実行を許可するという追加効果があります。 例えば、

Alias /icons/ "D:/usr/xampp7.2.8/apache/icons/"　------- (1)
ScriptAlias /cgi-bin/ "D:/usr/xampp7.2.22/cgi-bin/" ---- (2)

(1)の例は、URLパス /icons をファイルシステム “C:/usr/Apache Group/Apache2/icons/” にマッピングしています。このエイリアスは、ディレクトリインデックス表示のアイコン画像用にApacheがインストール時に設定したものです。

(2)の例は、URLパス /cgi-bin をファイルシステム “C:/usr/Apache2/cgi-bin” にマッピングしています。このエイリアスは、セキュリティ上の理由により、CGIの実行できるドキュメントディレクトリを限定するためにApacheがインストール時に設定したものです。

また、AliasMatch や ScriptAliasMatch ディレクティブ を使えば正規表現に基づいた強力なエイリアス設定を行なうことができます。

Unixシステムではユーザ user のホームディレクトリを ~user/ として参照できます。mod_userdir モジュールはこの考えをドキュメントディレクトリに対して拡張しました。mod_userdir モジュールを使用する場合は、以下のようにしてuserdir_moduleを有効にします。

LoadModule userdir_module modules/mod_userdir.so

userdir_module はユーザのホームディレクトリのファイルを以下のようなURLを使ってアクセスできるようにします。

http://localhost/~user/index.html

この設定には　UserDir ディレクティブを使用します。セキュリティ面から言えば、Webからユーザのホームディレクトリへの直接アクセスは避けるべきです。従って、 UserDir ディレクティブではユーザのホームディレクトリの下のWebファイルの置かれているディレクトリを指定します。尚、Unix ではホームディレクトリを/etc/passwdファイルで指定しています。

Apache Windows版についてもユーザディレクトリを設定できます。Windows10でのユーザのホームディレクトリは既定では “C:/Users/{ユーザ名}” です。Apacheインストール時の設定では、

UserDir "My Documents/My Website"

従って、上のURLは以下のファイルにマッピングされます。

"C:/Users/{ユーザ名}/My Documents/My Website/index.html"

ユーザのホームディレクトリを既定の場所以外に設定するには、ドライブ文字から始まる絶対パスで指定します。この場合、ユーザ名に変換される部分にアスタリスク(*)を使用します。

UserDir "D:/Apatch Users/*/My Website"

実験で分かった事ですが、UserDirで既定のホームディレクトリ以外を指定した場合、*で変換される部分は実際に存在するユーザ名である必要がありません。ApacheはURLパスに含まれるユーザ名がWindowsユーザである事の確認をしていないようです。

特定のユーザにのみディレクトリを使用させる場合は、disabledとenabledキーワードを使います。ApatcheはUserDirの引数がenabledでもdisabledでもない場合のみファイル名パターンとして扱います。

例：指定のユーザのみユーザディレクトリへのアクセスを許可する

UserDir "D:/Apatch Users/*/My Website"
UserDir disabled
UserDir enabled user1 user2 user3

Unixシステムでは、シンボリックリンク機能を使って、DocumentRoot外にあるディレクトリをDocumentRootの下に持ってくることができます。Aliasやユーザディレクトリの場合も、同様です。但し、セキュリティ上の理由により、Options ディレクティブに FollowSymLinks か SymLinksIfOwnerMatch がある場合に限られます。

例：Apacheインストール時のDocumentRootのOptionsディレクティブの設定

httpd.conf

<Directory "D:/usr/xampp7.2.22/htdocs">
    Options Indexes FollowSymLinks Includes ExecCGI
</Directory>

さて、Windowsのシンボリックリンクとは何を指すのでしょうか？ショートカットは拡張子が.lnkのファイルで、中にリンク先が書かれているだけです。明らかにシンボリックリンクではありません。Windows7以降、mklink コマンドによりシンボリックリンクを作ることが出来ます。シンボリックリンクは、ディレクトへのリンクもファイルへのリンクも可能です。筆者の実験では、Apacheは、WindowsのシンボリックリンクをUNIXのシンボリックリンクと同様に扱い、FollowSymLinks でのアクセス制御ができました。但し、シンボリックリンクの作成には管理者権限が必要となります。

ディレクトリのシンボリックリンクの作成

mklink /D {リンク} {ターゲット}
 
※ファイルのシンボリックリンクでは /D が不要です。

また、Winodwsでは、シンボリックリンクに良く似た、ジャンクションと言われるソフトウェアリンクの機能があります。これは、NTFSにシンボリックリンクよりも古くから実装されていたソフトウェアリンクで、ApacheでもUNIXのシンボリックリンクと同様に扱えます。ジャンクションの作成はディレクトへのリンクだけですが、管理者権限の無い一般ユーザでも可能です。

ジャンクションの作成

mklink /J {リンク} {ターゲット}

ソフトウェアリンク( シンボリックリンク と ジャンクション )にはリンク元とリンク先があり、リンク元が消えるとリンク先も無くなります。一方、WindowsのNTFSにはハードリンク機能もあります、ハードリンクは1つのファイルに複数のディレクトリエントリを作成でき、リンク元/リンク先という関係ではなく対等の関係があります。全てのハードリンクが消えないとファイルは無くなりません。従って通常のファイルはハードリンク数が1という事になります。ハードリンクはシンボリックリンクではなく、通常のファイルと同じです。Apacheでも勿論、FollowSymLinksの影響を受けません。

ハードリンクはソフトウェアリンクと異なり、以下の制限があります。

• フォルダのハードリンクは作れない
• 異なったドライブ間でハードリンクは作れない
• ネットワーク共有フォルダへのリンクは作れない

Windowsでハードリンクを作るには、シンボリックリンクと同様に、mklinkコマンドを使います。

ハードリンクの作成

mklink -H {リンク} {ターゲット}

WindowsのGUI（エクスプローラなど）では、シンボリックリンクとジャンクションはショートカットと同じく表す矢印のマークが付きます。一方、ハードリンクでは「一見して別のファイルが、実は同じファイルだった」という事が度々起きますので、リンクの管理が大変難しく、乱用は避けるべきでしょう。

尚、リンクを削除する場合は rmdir または del コマンドを使います。

リンクの削除

rmdir {リンク}  ---  ディレクトリへのリンクの削除 (ジャンクション/ディレクトリへのシンボリックリンク)
del {リンク}  ----- ファイルへのリンクの削除 (ハードリンク/ファイルへのシンボリックリンク)

また、WindowsのNTFSにはリパースポイントという機能もあります。これはソフトウェアリンクをさらに発展させた機能で、フォルダをリパースポイントにしてドライブをマウントする事ができます。Windows10では[マイコンピュータ][管理]から[記憶域][ディスクの管理]でドライブを選択し、右クリックで[ドライブ文字とパスの変更]を選択すると、そのドライブを空のフォルダにマウントする事ができます。リパースポイントも「シンボリックリンク」として扱われFollowSymLinksとしてアクセス制御ができます。

Apache Windows版の「シンボリックリンクのようなもの」をまとめると以下のようになります。

以上、Apache Windows版の基本設定について簡単に説明しました。アクセス制御については、アクセス制御ディレクティブに簡単にまとめてあります。Webサーバを公開する場合は、インデックス表示、ファイルタイプ、ユーザ認証、バーチャルホスト、ログファイルなどの設定も必要になります。より詳しい事は「Apache HTTP サーバ バージョン 2.4 ドキュメント( http://httpd.apache.org/docs-2.4/ )」を参照して下さい。