OpenLiteSpeed logo Open LiteSpeed Web Serverユーザーズマニュアル

バーチャルホストの一般

目次

コア設定

バーチャルホストログ

アクセスログ

インデックスファイル

カスタマイズされたエラーページ

期限切れの設定

ファイルアップロード

スクリプトハンドラの定義

期限設定

php.ini上書き

ドキュメントルート

説明

このバーチャルホストのドキュメントルートを指定します。$VH_ROOT/htmlを推奨します。 このディレクトリは、コンテキストでは$DOC_ROOTとして参照されます。

構文

絶対パスか$SERVER_ROOTからの相対パス又は$VH_ROOTからの相対パス。

管理者用電子メール

説明

このバーチャルホストの管理者の電子メールアドレスを指定します。

構文

電子メールアドレスのカンマ区切りリスト

圧縮を有効にする

説明

このバーチャルホストでGZIP圧縮を有効にするかどうかを指定します。 この設定は、サーバーレベルで圧縮を有効にするYesに設定されている場合にのみ有効です。

構文

ラジオボックスから選択

参照

圧縮を有効にする

GeoLocationルックアップを有効にする

説明

IPジオロケーション検索を有効または無効にするかどうかを指定します。 サーバー、バーチャルホスト、またはコンテキストレベルで設定できます。"Not Set"値を使用すると、IPジオロケーションはデフォルトで無効になります。

構文

ラジオボックスから選択

参照

ヘッダー内のクライアントIPを使用, DBファイルパス,

cgroups

説明

プロセス群のリソース使用量(CPU、メモリ、ディスクI/O、ネットワークなど)を制限、集計、分離するLinuxカーネル機能です。ファイル/sys/fs/cgroup/cgroup.controllersの存在で判定されるcgroups v2を実行している必要があります。

サーバーレベルでDisabledに設定すると、この設定はサーバー全体で無効になります。それ以外の場合、サーバーレベルの設定はバーチャルホストレベルで上書きできます。

デフォルト値:
サーバーレベル:Off
VHレベル:サーバーレベル設定を継承

構文

ドロップダウンリストから選択

サーバーのログを使用する

説明

独自のログファイルを作成するのではなく、このバーチャルホストからのログメッセージをサーバーログファイルに入れるかどうかを指定します。

構文

ラジオボックスから選択

ファイル名

説明

ログファイルのパスを指定します。

構文

ファイル名への絶対パス又は$SERVER_ROOT、$VH_ROOTからの相対パス。

ヒント

Performance ログファイルは別のディスクに配置してください。

ログレベル

説明

ロギングのレベルを指定します。 使用可能なレベルは、ERRORWARNINGNOTICEINFODEBUGです。 現在の設定以上のレベルのメッセージのみが記録されます。 DEBUGに設定する場合は、サーバーログレベルもDEBUGに設定する必要があります。 デバッグのレベルは、デバッグレベルによってサーバーレベルでのみ制御されます。

構文

選択

ヒント

Performance デバッグレベルNONE以外のレベルに設定されていない限り、DEBUGログレベルはパフォーマンスに影響を及ぼさず、推奨されます。

参照

デバッグレベル

ローテーションサイズ(バイト)

説明

現在のログファイルをロールオーバーする必要があるとき、つまりログローテーションを指定します。 ファイルサイズがロールオーバー制限を超えると、アクティブなログファイルは同じディレクトリにlog_name.mm_dd_yyyy(.sequence)という名前に変更され、新しいアクティブなログファイルが作成されます。 ローテーション済みログファイルが実際に作成されると、そのサイズはこの制限より少し大きくなることがあります。ログローテーションを無効にするには、0に設定します。

構文

整数

ヒント

Information 数値に"K"、"M"、"G"を付けると、それぞれキロバイト、メガバイト、ギガバイトを表します。

保持日数

説明

アクセスログファイルをディスク上に保持する日数を指定します。 指定した日数より古いローテーション済みログファイルのみが削除されます。 現在のログファイルは、含まれるデータの日数に関係なく変更されません。 古くなった非常に古いログファイルを自動削除したくない場合は、0に設定します。

構文

整数

アーカイブを圧縮する

説明

ディスク領域を節約するためにローテーションしたログファイルを圧縮するかどうかを指定します。

構文

ラジオボックスから選択

ヒント

Information ログファイルは圧縮率が高いため、古いログのディスク使用量を減らす目的で推奨されます。

ログ制御

説明

アクセスログを書き込む場所を指定します。3つのオプションがあります:

  1. サーバーのアクセスログに書き込む
  2. このバーチャルホストのアクセスログを作成する
  3. アクセスログを無効にする

構文

選択

ファイル名

説明

アクセスログファイル名。

構文

ファイル名への絶対パス、または$SERVER_ROOT、$VH_ROOTからの相対パス。

ヒント

Performance アクセスログファイルを別のディスクに配置します。

パイプロガー

説明

LiteSpeedがSTDINストリーム上のパイプを通じて送信するアクセスログデータを受け取る外部アプリケーションを指定します(ファイルハンドルは0)。 このフィールドが指定されると、アクセスログはロガーアプリケーションにのみ送信され、前のエントリで指定されたアクセスログファイルには送信されません。

ロガーアプリケーションは、最初に外部アプリケーションセクションで定義する必要があります。 サーバーレベルのアクセスログは、サーバーレベルで定義された外部ロガーアプリケーションのみを使用できます。 バーチャルホストレベルのアクセスロギングでは、バーチャルホストレベルで定義されたロガーアプリケーションのみを使用できます。

ロガープロセスは、他の外部(CGI/FastCGI/LSAPI)プロセスと同じ方法で生成されます。 つまり、バーチャルホストの外部アプリSet UIDモード設定で指定されたユーザーIDとして実行され、特権ユーザーとして実行されることはありません。

LiteSpeed Webサーバーは、ロガーアプリケーションのインスタンスが複数設定されている場合、複数のロガーアプリケーション間で簡単なロードバランシングを実行します。 LiteSpeedサーバーは、常にロガーアプリケーションの数を可能な限り少なく保とうとします。 1つのロガーアプリケーションがアクセスログエントリを時間内に処理できない場合にのみ、サーバーはロガーアプリケーションの別のインスタンスを生成しようとします。

ロガーがクラッシュした場合、Webサーバーは別のインスタンスを開始しますが、ストリームバッファーのログデータは失われます。 外部ロガーがログストリームの速度と量に追いつけない場合、ログデータを失う可能性があります。

構文

ドロップダウンリストから選択

ログ形式

説明

アクセスログのログ形式を指定します。 ログフォーマットが設定されると、ログヘッダーの設定より優先されます。

構文

文字列。ログ形式の構文はApache 2.0のカスタム ログ形式と互換性があります。


共通ログフォーマット(CLF)
"%h %l %u %t \"%r\" %>s %b"

バーチャルホストによる共通ログフォーマット
"%v %h %l %u %t \"%r\" %>s %b"

NCSA拡張/結合ログフォーマット
"%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-agent}i\"

FoobarのログCookie値
"%{Foobar}C"

参照

ログヘッダー

ログヘッダー

説明

HTTPリクエストヘッダーRefererUserAgentHostを記録するかどうかを指定します。

構文

チェックボックス

ヒント

[パフォーマンス] これらのヘッダーがアクセスログに不要な場合は、この機能をオフにします。

参照

ログ形式

バイトログ

説明

帯域幅バイトのログファイルへのパスを指定します。 指定すると、cPanel互換の帯域幅ログが作成されます。 これにより、要求と応答本体の両方を含む要求に対して転送された合計バイトが記録されます。

構文

ファイル名への絶対パス又は$SERVER_ROOTからの相対パス

ヒント

Performance ログファイルを別のディスクに配置します。

サーバーインデックスファイルを使用する

説明

サーバーのインデックスファイル設定を使用するかどうかを指定します。 Yesに設定すると、サーバーの設定だけが使用されます。 Noに設定すると、サーバーの設定は使用されません。 Additionに設定すると、このバーチャルホストのサーバーインデックスファイルリストに追加のインデックスファイルを追加できます。 このバーチャルホストのインデックスファイルを無効にする場合は、値をNoに設定して、インデックスファイル欄を空のままにします。

構文

ドロップダウンリストから選択

インデックスファイル

説明

URLがディレクトリにマップされたときに順番に検索されるインデックスファイルの名前を指定します。 サーバー、バーチャルホスト、コンテキストレベルでカスタマイズできます。

構文

インデックスファイル名のカンマ区切りリスト。

ヒント

[パフォーマンス]必要なインデックスファイルのみを設定します。

自動インデックス

説明

インデックスファイルにリストされているインデックスファイルがディレクトリで使用できないときに、その場でディレクトリインデックスを生成するかどうかを指定します。 このオプションは、バーチャルホストおよびコンテキストレベルでカスタマイズ可能で、明示的に上書きされるまでディレクトリツリーに沿って継承されます。 生成された索引ページをカスタマイズできます。 オンラインWikiのHow-toを確認してください。

構文

ラジオボックスから選択

ヒント

[セキュリティ] 可能であれば、自動インデックスをオフにして、機密データの漏えいを防ぐことをお勧めします。

参照

インデックスファイル, 自動インデックスURI

自動インデックスURI

説明

インデックスファイルにリストされているインデックスファイルがディレクトリで使用できない場合に、インデックスページを生成するために使用されるURIを指定します。 LiteSpeed Webサーバーは外部スクリプトを使用してインデックスページを生成し、最大限のカスタマイズの柔軟性を提供します。 デフォルトスクリプトは、Apacheと同じ外観のインデックスページを生成します。 生成されたインデックスページをカスタマイズするには、オンラインWikiのHow-toを読んでください。 インデックス対象のディレクトリは、環境変数"LS_AI_PATH"を介してスクリプトに渡されます。

構文

URI

参照

インデックスファイル, 自動インデックス

カスタマイズされたエラーページ

説明

サーバーが要求を処理する際に問題が発生すると、サーバーはエラーコードとhtmlページをエラーメッセージとしてWebクライアントに返します。 エラーコードはHTTPプロトコルで定義されています(RFC 2616参照)。 LiteSpeed Webサーバーには、エラーコードごとにデフォルトのエラーページが組み込まれていますが、各エラーコードに対してカスタマイズされたページを設定することもできます。 これらのエラーページは、各バーチャルホストごとに一意になるようにさらにカスタマイズすることができます。

エラーコード

説明

エラーページのHTTPステータスコードを指定します。 選択したHTTPステータスコードだけがこのカスタマイズされたエラーページを持ちます。

構文

ドロップダウンリストから選択

URL

説明

カスタマイズされたエラーページのURLを指定します。 サーバーは、対応するHTTPステータスコードが返されたときに、このURLにリクエストを転送します。 このURLが存在しないリソースを参照する場合は、組み込みのエラーページが使用されます。 URLは、静的ファイル、動的に生成されたページ、または別のWebサイトのページ("http(s)://"で始まるURL)にできます。 別のWebサイトのページを参照する場合、クライアントは元のステータスコードの代わりにリダイレクトステータスコードを受け取ります。

構文

URL

有効期限を有効にする

説明

静的ファイルのExpiresヘッダーを生成するかどうかを指定します。 有効にすると、デフォルトの期限タイプ別の期限に基づいてExpiresヘッダーが生成されます。

これは、サーバー、バーチャルホスト、コンテキストレベルで設定できます。 下位レベルの設定は上位レベルの設定を上書きします。 コンテキスト設定はバーチャルホストの設定を上書きし、バーチャルホストの設定はサーバーの設定を上書きします。

構文

ラジオボタンから選択

デフォルトの期限

説明

Expiresヘッダー生成のデフォルト設定を指定します。 この設定は、有効期限を有効にするが "はい"に設定されているときに有効になります。 タイプ別の期限で上書きできます。 すべてのページのExpiresヘッダーが生成されるため、必要がない限り、このデフォルトをサーバーまたはバーチャルホストレベルで設定しないでください。 ほとんどの場合、これは頻繁に変更されない特定のディレクトリのコンテキストレベルで設定する必要があります。 デフォルト設定がない場合、タイプ別の期限で指定されていないタイプに対してExpiresヘッダーは生成されません。

構文

A|M秒
このファイルは、基本時間(A | M)に指定された秒を加えた後に期限切れになります。 ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。

タイプ別の期限

説明

各MIMEタイプのExpiresヘッダー設定を指定します。

構文

"MIME-type=A|Mseconds"のカンマで区切られたリスト。 このファイルは、基本時間(A|M)に指定された秒を加えた後に期限切れになります。

ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。 MIMEタイプはimage/*のようなワイルドカード "*"を受け入れます。

ファイルアップロード

説明

Request Body Parserを使用してファイルをアップロードしてサーバーのローカルディレクトリにファイルを解析し、第三者のモジュールによる悪意のある行為を簡単にスキャンできるようにする、追加のセキュリティ機能を提供します。 Request Body Parserは、ファイルパスによるアップロードデータの転送が有効になっているか、モジュールがLSI_HKPT_HTTP_BEGINレベルでLSIAPIのset_parse_req_bodyを呼び出すときに使用されます。 ソースパッケージで提供されるAPIの例

参照

フック::HTTP_BEGIN 優先度

一時ファイルパス

説明

要求本体パーサーが動作している間に、サーバーにアップロードされるファイルが格納される一時ディレクトリ。 デフォルト値は/tmp/lshttpd/です。

構文

絶対パス、または$SERVER_ROOTで始まるパス(ServerおよびVHostレベル)、または$VH_ROOTで始まるパス(VHostレベル)。

一時ファイルのアクセス許可

説明

一時ディレクトリに格納されるファイルに使用するファイル権限を決定します。 サーバーレベルの設定はグローバルで、VHostレベルでオーバーライドできます。

構文

3桁の8進数。デフォルト値は666です。

ファイルパスによるアップロードデータの転送

説明

ファイルデータをパスでアップロードするかどうかを指定します。 有効にすると、アップロード時にファイル自体ではなく、バックエンドハンドラにファイルパスと他の情報が送信されます。 これにより、CPUリソースとファイル転送時間が節約されますが、実装するためにバックエンドに若干の更新が必要です。 無効にすると、ファイルの内容はバックエンドハンドラに転送され、要求本文は引き続きファイルに解析されます。

構文

ラジオボタンから選択

ヒント

[パフォーマンス]下位互換性が問題にならないようにするには、これを有効にしてファイルのアップロード処理を高速化します。

サフィックス

説明

このスクリプトハンドラによって処理されるスクリプトファイルのサフィックスを指定します。 接尾辞は一意である必要があります。

構文

カンマ区切りリストでピリオド"."は禁止されています。

ヒント

Information サーバーは、リスト内の最初のサフィックスに特殊なMIMEタイプ("application/x-httpd-[suffix]")を自動的に追加します。 たとえば、サフィックス"php53"にはMIMEタイプ"application/x-httpd-php53"が追加されます。 最初以降のサフィックスはMIME設定設定で構成する必要があります。
このフィールドではサフィックスを列挙しますが、スクリプトハンドラはサフィックスではなくMIMEタイプを使用して処理対象のスクリプトを決定します。
PerformanceSecurity 本当に必要なサフィックスのみを指定してください。

ハンドラタイプ

説明

これらのスクリプトファイルを処理する外部アプリケーションのタイプを指定します。使用可能なタイプは次のとおりです: LSAPI appWeb Server (Proxy)Fast CGISCGICGILoad balancerServlet EngineuWSGI、またはModule HandlerCGIおよびModule Handlerハンドラタイプを除き、ハンドラ名外部アプリケーションセクションで事前に定義された外部アプリケーションに設定する必要があります。

構文

ドロップダウンリストから選択

ハンドラ名

説明

ハンドラタイプがLSAPI app、Web Server (Proxy)、Fast CGI、SCGI、Load balancer、Servlet Engine、またはuWSGIの場合に、スクリプトファイルを処理する外部アプリケーションの名前を指定します。

構文

ドロップダウンリストから選択

php.ini上書き

説明

現在のコンテキスト(バーチャルホストレベルまたはコンテキストレベル)でphp.ini設定を上書きするために使用します。

サポートされるディレクティブ:
php_value
php_flag
php_admin_value
php_admin_flag

その他の行/ディレクティブはすべて無視されます。

構文

上書き構文はApacheに似ており、ディレクティブと値を改行区切りで指定します。各ディレクティブには、必要に応じてphp_value、php_flag、php_admin_value、またはphp_admin_flagを付けます。

php_value include_path ".:/usr/local/lib/php"
php_admin_flag engine on
php_admin_value open_basedir "/home"