AN HTTP Server Options

AN HTTPDオプション設定
－無闇に設定変更してはいけない－

2002.11.3改
v1.41f準拠

　AN HTTPDオプション設定の標準例を以下に示す。
無闇な設定変更は混乱の元。変更は各項目の意味を十分に理解した後で。

[ｖ] HTTPサーバ機能
- HTTPサーバとして使うときには必ずチェックする。プロクシサーバ機能しか使わない場合にだけチェックを外す。
- チェックを外すとHTTPサーバとして機能しなくなり、アクセスするとIEでは「サーバが見つからないか、DNS エラーです。」のエラーメッセージが出る。
[　]バーチャルホスト
- 異なるホスト名で複数の HTTPサーバを稼働させるときにチェックする(バーチャルホストタブが現れる)。
- 通常の使い方ではチェックする必要はない。
- バーチャルホストにチェックすると、以下の設定で「ドキュメントルート」「ポート」「デフォルトインデックス」「/~user -> ドキュメントルート\…」についてはバーチャルホスト毎に設定が必要である。
- バーチャルホストについてはこちらの説明を参考に。
HTTPバージョン [1.1]
- HTTPバージョン1.1 と 1.0 を切り換える。
- 通常はデフォルトの 1.1 を変える必要はない。
- (参考)
  1.0 と 1.1 とでは以下のように使えるメソッドに違いがある。
  　1.0 : GET, HEAD, POST, PUT, DELETE, LINK, UNLINK
  　1.1 : GET, HEAD, POST, PUT, DELETE, TRACE, OPTIONS, CONNECT
  1.1 では Host指定が必須、Keep-Alive(持続的接続)機能が使えるなど。
ドキュメントルート
- ここで指定したパスを最上位のディレクトリとし、そこ以下に置かれた文書/画像ファイルなどを閲覧できるようになる。そこより上のディレクトリにはアクセスできない。ドキュメントルートには任意のドライブ/フォルダを指定可能である。例えば、c:\www 。階層関係にないディレクトリ(例えば Dドライブや C:\xxx など)にもアクセスできるようにしたいときには「エイリアス」を使う。
- http://127.0.0.1/ 、http://192.168.0.2/ などIPアドレス(あるいはホスト名)だけでアクセスしたとき、このディレクトリの下のデフォルトインデックスファイル(上図の例では C:\www\index.html)が表示される。
- デフォルトでは AN HTTPDプログラムをインストールしたディレクトリになるので、必ず変更して使用する(そこをドキュメントルートにするのであればそのままでもよいが、セキュリティの観点からは好ましくない)。
- 空白を含むディレクトリ名はトラブルになり易いので避けた方が賢明である(ただし最近のバージョンでは、空白を含む場合でも特に問題は起きていない)。
- 自宅サーバを公開するときはドライブのルートディレクトリ(C:\, D:\など)には絶対に設定しないこと。特に Windows をインストールしたドライブ(WindowsやWinNTのあるドライブ)は厳禁である。
  （よく理解した上で正しく設定すればもちろん大丈夫ではあるが、例えばインデックスリストを表示するように設定すると、ドライブ内の全ファイルを閲覧されてしまう。また exe の CGI を「一般パスでも実行する」に設定したりすると、command.com や cmd.exe が実行できてしまい、他人が勝手にファイルを削除することも可能になってしまう。必ず公開専用のフォルダを作成しドキュメントルートに設定すること）
ポート [80]
- 通常は 80 のまま使い、変える必要は全くない。。
- 他のHTTPDプログラム(例えば PWS, Apache, IISなど)と同時に実行したり、AN HTTPDを複数起動したい場合には重複しないように他のポート番号(例えば、8000, 8080, 8888, 10080など)を指定する。ただしバーチャルホストでは全てに80が使える。
- 自宅サーバを公開するときに、プロバイダによってはポート80ではアクセスできないこともあるので確認が必要である。
- ポート番号を80以外、例えば8080としたときは、URLを http://127.0.0.1:8080/ のようにポート番号付きで指定しないといけない(ポート番号が80のときのみ :80 を省略可能)。
デフォルトインデックス [index.html]
- URLをファイル名なしで指定した場合に補って使われるファイル名。例えばデフォルトインデックスを index.html とすると http://127.0.0.1/ にアクセスすると、http://127.0.0.1/index.html にアクセスしたことと同じである。
- 通常はデフォルトの index.html のままでよく、特別な事情がない限り変える必要はない。
- 他に index.shtml、default.htm、index.cgi など任意のファイル名を設定可能。
- 複数のファイルをコンマで区切って指定すれば、左側から順に探して見つかったファイルが表示される。例えば、index.html,index.cgi,index.php のように書くことができる。
- 指定したファイルがみつからない時は、index.shtml, index.html, index.htm の順に探し、もしあればそれが表示される。
- 上のどのファイルも見つからないときには、「表示/インデックス」タブでインデックスリストが表示される設定になっているとインデックスリストが表示され、非表示設定の場合には Error 404になる。
（注）デフォルトインデックスには以下のバグが残っているので要注意です。
　　http://homepage1.nifty.com/yito/namazu/gbook/20041027.1630.html
[ｖ]/~user -> ドキュメントルート\ [user\public_html]
- /~user のエイリアスを指定する。
- /~user は実際には /~yito のように自分のユーザ名にし、そのディレクトリ以下の所有者を明示するために使う。/~userの文字列の後ろに空白が入らないように注意が必要。
- ドキュメントルートが c:\www なら、c:\www\user\public_html が /~user に対応する。
  すなわち、http://127.0.0.1/~user/ で C:\www\user\public_html\index.html にアクセスする。
  --------------------------------------------------------------
  c:\www\index.html --> http://127.0.0.1/
  　　｜
  　　└\user\public_html\index.html --> http://127.0.0.1/~user/
  --------------------------------------------------------------
- user, public_html のディレクトリ名は固定ではないので任意の名称に変更してもよい。例えば、/~yito -> ドキュメントルート\ [htdocs]
- /~user はここでチェックしなくてもエイリアスの一つとして扱うことも可能。ドキュメントルートの下以外のパスにしたいときはここではなくエイリアスで指定する。
- チェックをしても、/~userを使わないという選択も可能。自宅サーバでユーザが自分だけという状況では /~user を使う必要性はあまりないように思う。ルート以下のパスをどうしてもプロバイダのサーバと同じにしたいときには使いたくなるかもしれないが、絶対パスで書かなくても大抵は相対パスでも済むことも知っておくとよい。
- /~user の設定がどうしても理解できないという方には、いっそチェックしないことをお勧めする。使わない設定でもドキュメントルート下が自由に使えるので何の支障もない。
- 複数のユーザに対してユーザ毎のルートディレクトリを設定したいなら、「エイリアス」タブの一般パスを利用するとよい。
リモートホストを取得　〇常時　〇CGI/SSIでは取得　●取得しない
- アクセスしてきたホストのホスト名を取得するかどうかを設定する。
- 取得したときはログにアクセス元のホスト名が、取得しないときはIPアドレスが記録される。
- DNSがローカルに設置されている会社などの LAN環境下ではホスト名が記録されるので「常時」にした方がログが分かり易くなる。
- 「取得する」場合は、DNSへの問い合わせが毎回(?)あるのでパフォーマンスが落ちる。そのため自宅サーバなどではデフォルトの「取得しない」のままがよいだろう。
- 「CGI/SSIでは取得」にすると CGI/SSI実行時に環境変数 REMOTE_HOST が必要な場合(例えば掲示板にアクセスしてきた相手のホスト名を知りたい)にのみホスト名を取得する。
- IPアドレスではなく、ホスト名やドメイン名でアクセス制御をする場合には必ず「常時」にすること。
[ｖ]SSIを許可する
- SSIを使うときにチェックし、SSIを許可するファイルの拡張子などを指定する。
  　・/index.html: ドキュメントルートのindex.html
  　・*.shtml: 拡張子が shtml(sht)のファイル
  　・*.html: 拡張子が html(htm)のファイル
- デフォルトではドキュメントルート下の index.html と拡張子が .shtml のファイルでのみSSIの実行が可能である。セキュリティ上問題が生じることもありうるので *.html は許可しない方がよい。
  例えば、SSIカウンタをトップページ以外など複数ページに設置したり、以下のようにファイルの更新日時を各ページで表示する場合には *.shtml というファイル名にする。
  　　
  　　
- ドキュメントルート直下の index.html で SSIを使わないときは /index.htmlのチェックを外し、使う場合でもファイル名を index.htmlではなく、index.shtmlとすることをお勧めする。この場合でもデフォルトインデックスを index.html,index.shtml のように変更する必要はない。
- 自宅サーバを公開する場合には、セキュリティ上できるだけSSI利用を制限するのが望ましい。プロバイダのWebサーバでもSSIが使えないことが多いので事前に確認しておくことが必要である。
- SSIを使わないならチェックしないこと。v1.29b(含む)以前のバージョンでCPU 100%の原因となることがある。
- *.html にチェックすると全ての HTMLファイルに対してページ内にSSIを含むかどうを調べることになるので、パフォーマンスが落ちる。SSIを含むページは陽に拡張子 shtml とするのが賢明な使い方である。
[ｖ]CGIを実行する
- CGIを使うなら、絶対にチェックを外してはいけない。
- チェックをはずすとCGIは実行されずに、スクリプトのソースが表示されたり、ダウンロードになったりする。
[ｖ]NPHスクリプトではサーバから接続を切る
- NPHスクリプトの場合、HTTP/1.0の場合と同様に出力が終わったらサーバから接続を切断するかどうかの設定。
- 通常は NPHスクリプトを使うことはないだろうが、デフォルトのまま(切断するになっている)で構わない。
拡張子、実行プログラム
- CGIプログラムの拡張子別に実行プログラムなどを設定する
- 例えば phpといった新しい拡張子と実行プログラムを追加するときは追加ボタンをクリックして入力する
- 入力済の情報の編集、削除は該当する拡張子を反転後、編集/削除ボタンをクリックする
- [ｖ]実行する:その拡張子を実行するときはチェックする。チェックを外すとその拡張子は実行されなくなる(ダウンロードになる)。
- 拡張子:実行する拡張子を .(ドット)から指定する。複数指定するときは , で区切る。例: .pl,.cgi
- 実行プログラム
  - その拡張子のファイルを実行するexeプログラム(インタプリタ)のある場所を指定。例えば PHPを実行したいときは、ここに php.exeのインストール先(例えば c:\php\php.exe)を設定する。
  - Perlはデフォルトでは、perl となっているが、フルパスで指定した方が間違いが起き難い。
    例えば、perlをデフォルトのディレクトリ(c:\Perl)にインストールしたときは、c:\Perl\bin\perl.exe とする。
  - パスが通っているなら(Win9xでは AUTOEXEC.BAT の中で SET PATH= に perl.exe へのパスが設定されている、WinNT系では環境変数のPATHに設定されている)、単に perl でも構わない。
  - perl.exeにパスが通っているかどうかは、MS-DOSプロンプト(コマンドプロンプト)から、perl -v とコマンド入力して Perlのバージョンメッセージが表示されるかどうかで分かる。ただし Perlのインストール直後は、Windowsの再起動が必要である。
  - Perlスクリプトをデバッグするとき、コマンドプロンプトからperlを実行する(perl hello.cgiのように)と便利なので、perlへのパスを通しておくのがよい。
  - perl としては ActivePerl、Perl for Win32、JPerl などがあるが、ActivePerl がベストである。JPerlでなくても日本語処理可能なので、JPerlは使わないのが賢明。
  - *.pl, *.cgi を perl.exe ではなく、ISAPI対応の PerlIS.dll で実行する時はここに PerlIS.dllをフルパスで指定する。例えば、C:\Perl\bin\PerlIS.dll(プルダウンメニューから選択可能)。
  - perl.exe よりも PerlIS.dll にした方がパフォーマンスは上がるが、CGIをテストするなど特にスピードを要求される使い方でなければ、経験上はISAPIを使用しない方が信頼性が高い。PHPでも ISAPIを使わない方がよいという状況は同じ。
  - .exe, .bat など Windows自身が実行可能な拡張子に対しては、"-- self --"と指定する。
  - 便利な設定方法
    　PHPの実行プログラムを exe と ISAPI を簡単に切り換えるには、両方を登録してチェックのオン/オフだけで切り換えるとよい。
```
　  .php,.php3,.phtml c:\php\php.exe            v 　 v
　v .php,.phtml,.php3 c:\php\sapi\php4isapi.dll v 　 v
```
    　PHP4と PHP5を切り替える場合などにも使える。
    (注)拡張子の文字列の並びを上下で全く同じにしないこと。
- [ｖ]一般パスでも実行する
  - CGIは通常実行パスに置いて実行するが、一般パス(エイリアスタブで設定する)にある場合にもその拡張子のファイル(CGI)を実行するときにチェックする。
  - チェックなしのときは、ファイルのダウンロードになる。
  - これはCGIについてであり、SSIについてはこの限りではない(SSIには実行パス/一般パスの概念はない)。
  - exe については一般パスでは実行できない設定にしておくのがよい(セキュリティ上もあるが、exeファイルをダウンロードしたい状況は多いと思う)。
- [　]PATH_TRANSRATEDを使う
  - PATH_TRANSLATED に実行ファイル名を入れるかどうかを指定する。
  - 古いバージョンの PerlIS.dll や、php.exe、php4isapi.dllなどではチェックが必要。
- [　]#! の行を調べる
  - #! で始まるスクリプトの実行を、CGIファイルの1行目に記述した実行プログラム(perlなど)を使って実行するかどうかを指定する。
  - AN HTTPDではperl.exeがあるパスを別途指定するので #!行を調べる必要は全くなく、絶対にチェックしてはいけない。
  - チェックすると動いていたスクリプトでも「Error 500 CGI エラー - 以下のコマンドラインを実行できません」(Win9x)、「Error 500 CGI エラー - Content-Type ヘッダが正しくありません CGI 出力メッセージ: 指定されたパスがみつかりません。」(WinNT系)とエラーメッセージが出るようになる。
  - 上記エラーが出ないようにするには、スクリプトの先頭行を例えば
    　#! C:/Perl/bin/perl.exe
    のように変更すれば C:\Perl\bin\perl.exe を使って実行するが、わざわざそのような変更をする必要は何もない。
  - すなわち、CGI配布サイトなどからダウンロードして入手したスクリプトの #!行は変更することなくそのまま使うことができる。AN HTTPDでテスト後にプロバイダのサーバにアップロードして実行するのであれば、そのサーバ上での perl のパスを記述しておけばよい。
- [　]EXE 形式の実行
  - EXE形式(バイナリ)のCGIを拡張子を .exe 以外に変更して実行させるときにチェックする。例えば、全文検索システム Namazu の実行ファイルは namazu.cgi.exe であるが、これを namazu.cgi というファイル名に変更してCGIとして実行させるには、拡張子 .pl,.cgi の「EX」にチェックする。チェックがあるとAN HTTPDはCGIスクリプトか exeファイルかを調べてから実行する。
    (注) 自宅サーバでは namazu.cgi.exeの場合に限らず、exeのまま CGIとして実行させればよいので EX にチェックが必要な状況は現実にはほとんどないのではないかと思う。
CGI/SSIプロセス制御
- [　]単一スレッド
  - チェックすると、CGI/SSIプロセスはシングルスレッドで動作する。すなわち複数のCGI/SSIプロセスが同時に起動しなくなる。
  - Win9xなどファイルロックが使えない場合には代替となる。
  - WinNT/2000/XPではOSレベルで排他制御が行われるためチェックは不要(チェックするとより確実ではあるが、同時には一つの CGIしか実行できなくなるので何かの原因で時間のかかる処理があるとその CGIが終了するまで他の全ての CGIの実行が待たされたり、時には CGIが全く実行されなくなるという深刻な問題が生じることがあるので、CGIが安定に動作するようならチェックはしない方がいい)。
  - Win9xでは通常はチェックした方がよい。
- [　]ヘルパープロセス
  - Win98で、システムリソース減少対策用であるが、何も問題がなければ外しておく。
  - Win95/NT/2000/XP ではチェックしてはいけない。チェックによる誤動作の報告例もある。
- [ｖ]CGI出力を検査, [ｖ]SSI出力を検査
  - チェックすると、エラーがあるとブラウザにメッセージを表示する。
  - トラブル解決の手がかりを得るため、通常はチェックしておくのがよい。
  - このチェックはしない方が実行が速いという報告がある。
  - 自宅サーバを公開するときには、エラー発生時にローカルパスを表示することがあるのでセキュリティ上チェックは外した方がいいという人もいるが、メッセージが出力されなくなるというデメリットの方が大きいと筆者は思う。
ISAPI タイムアウト[20]秒
- ISAPI, PerlIS のタイムアウト時間を指定。デフォルトは20秒。
- 特に理由がなければ変更しない。
- 0秒を指定するとタイムアウトしなくなる。
接続持続タイムアウト[15]秒
- HTTP/1.1の場合、応答後に接続を切らず同じスレッドからリクエストがあるかどうかこの時間だけ待つ。デフォルトは15秒。0秒を指定するとタイムアウトしなくなる。
- Googleで「Keep-Alive」を検索すれば関連情報が得られる。
「一般」以外のタブ
- エイリアスを使うと、URLが短くなる、ドキュメントルート下以外のローカルパス(例えばCD-ROMドライブ)やLAN内の他のホスト(ローカルパスを \\host\共有名のように記述する)でもアクセス可能になるなど大変便利である。
- エイリアスで設定した仮想パス名は大文字/小文字が区別されるので、URLで指定するときは注意が必要である。パスの中のディレクトリ(フォルダ名)は大文字/小文字の区別はされない。ただしプロバイダのサーバはUNIX系であることが多く、UNIX上ではディレクトリ名の大文字/小文字は区別されるので、プロバイダのサーバにアップロードするのであればリンクの記述で大文字/小文字を使い分けることが必要である。
- AN HTTPDの起動時にダイヤルアップ動作をするようなら「表示/インデックス」タブの「ホスト名/アドレスを取得」のチェックを外す。ただしこのチェックを外すとタスクバーにホスト名、IPアドレスが表示されなくなる(FAQ#6)。
- 一般以外のタブの使い方の詳細を知りたいなら、以下のページなどに詳しい説明がある。
  - AN HTTP Server オプション(中田さん) 最新版対応 (まずここから)
  - AN HTTPDの設定(KOROさん) v1.40対応 (お勧め、他のページも必見)
  - AN HTTP Serverについて(スーパー工房) v1.41対応 (詳しい)
  - 個別には私の以下の解説ページも参考にしてください。
設定の初期化
- 設定を全くの初期値に戻すときは、レジストリエディタで以下のキーを削除する。
  　　HKEY_LOCAL_MACHINE\Software\AnHttpd
- 設定名を使用していて、特定の設定名(例えば default)だけを削除する場合にはその設定名以下を削除。
  　　HKEY_LOCAL_MACHINE\Software\AnHttpd\default

作成者:いと，mailto:gfh05223@nifty.com

AN HTTPDオプション設定－ 無闇に設定変更してはいけない －

AN HTTPDオプション設定
－無闇に設定変更してはいけない－