バーチャルホストの一般
目次
コア設定
バーチャルホストログ
アクセスログ
インデックスファイル
カスタマイズエラーページ
スクリプトハンドラの定義
.htaccess
期限設定
Apacheスタイルの設定
WebSocketプロキシ
ドキュメントルート
説明
このバーチャルホストのドキュメントルートを指定します。$VH_ROOT/htmlを推奨します。 このディレクトリは、コンテキストでは$DOC_ROOTとして参照されます。
構文
絶対パスか$SERVER_ROOTからの相対パス又は$VH_ROOTからの相対パス。
圧縮優先度
説明
複数の有効な圧縮方式を使用できる場合に、このバーチャルホストでZstandard、Brotli、GZIPの優先する圧縮方式の順序を指定します。この設定が未設定の場合、サーバーレベルの圧縮優先度が使用されます。この設定はヒントであり、すべてのレスポンスで最終的な順序を強制するものではありません。
構文
ドロップダウンリストから選択
参照
IPジオロケーションを有効化
説明
Enterprise Edition Only IPジオロケーション検索を有効または無効にするかどうかを指定します。 サーバー、バーチャルホスト、またはコンテキストレベルで設定できます。"Not Set"値を使用すると、IPジオロケーションはデフォルトで無効になります。
構文
ラジオボックスから選択
参照
cgroups
説明
プロセス群のリソース使用量(CPU、メモリ、ディスクI/O、ネットワークなど)を制限、集計、分離するLinuxカーネル機能です。ファイル/sys/fs/cgroup/cgroup.controllersの存在で判定されるcgroups v2を実行している必要があります。
サーバーレベルで無効に設定すると、この設定はサーバー全体で無効になります。それ以外の場合、サーバーレベルの設定はバーチャルホストレベルで上書きできます。
デフォルト値:
サーバーレベル:Off
VHレベル:サーバーレベル設定を継承
構文
ドロップダウンリストから選択
ファイル名
説明
ログファイルのパスを指定します。
構文
ファイル名への絶対パス又は$SERVER_ROOT、$VH_ROOTからの相対パス。
ヒント
パフォーマンス ログファイルは別のディスクに配置してください。
ログレベル
説明
ロギングのレベルを指定します。 使用可能なレベルは、ERROR、WARNING、NOTICE、INFO、DEBUGです。 現在の設定以上のレベルのメッセージのみが記録されます。 DEBUGに設定する場合は、サーバーログレベルもDEBUGに設定する必要があります。 デバッグのレベルは、デバッグレベルによってサーバーレベルでのみ制御されます。
構文
選択
ヒント
パフォーマンス デバッグレベルがNONE以外のレベルに設定されていない限り、DEBUGログレベルはパフォーマンスに影響を及ぼさず、推奨されます。
参照
ローテーションサイズ(バイト)
説明
現在のログファイルをロールオーバーする必要があるとき、つまりログローテーションを指定します。 ファイルサイズがロールオーバー制限を超えると、アクティブなログファイルは同じディレクトリにlog_name.mm_dd_yyyy(.sequence)という名前に変更され、新しいアクティブなログファイルが作成されます。 ローテーション済みログファイルが実際に作成されると、そのサイズはこの制限より少し大きくなることがあります。ログローテーションを無効にするには、0に設定します。
構文
整数
ヒント
情報 数値に"K"、"M"、"G"を付けると、それぞれキロバイト、メガバイト、ギガバイトを表します。
保持日数
説明
アクセスログファイルをディスク上に保持する日数を指定します。 指定した日数より古いローテーション済みログファイルのみが削除されます。 現在のログファイルは、含まれるデータの日数に関係なく変更されません。 古くなった非常に古いログファイルを自動削除したくない場合は、0に設定します。
構文
整数
圧縮アーカイブ
説明
ディスク領域を節約するためにローテーションしたログファイルを圧縮するかどうかを指定します。
構文
ラジオボックスから選択
ヒント
情報 ログファイルは圧縮率が高いため、古いログのディスク使用量を減らす目的で推奨されます。
ファイル名
説明
アクセスログファイル名。
構文
ファイル名への絶対パス、または$SERVER_ROOT、$VH_ROOTからの相対パス。
ヒント
パフォーマンス アクセスログファイルを別のディスクに配置します。
パイプロガー
説明
LiteSpeedがSTDINストリーム上のパイプを通じて送信するアクセスログデータを受け取る外部アプリケーションを指定します(ファイルハンドルは0)。 このフィールドが指定されると、アクセスログはロガーアプリケーションにのみ送信され、前のエントリで指定されたアクセスログファイルには送信されません。
ロガーアプリケーションは、最初に外部アプリケーションセクションで定義する必要があります。 サーバーレベルのアクセスログは、サーバーレベルで定義された外部ロガーアプリケーションのみを使用できます。 バーチャルホストレベルのアクセスロギングでは、バーチャルホストレベルで定義されたロガーアプリケーションのみを使用できます。
ロガープロセスは、他の外部(CGI/FastCGI/LSAPI)プロセスと同じ方法で生成されます。 つまり、バーチャルホストの外部アプリのSet UIDモード設定で指定されたユーザーIDとして実行され、特権ユーザーとして実行されることはありません。
LiteSpeed Webサーバーは、ロガーアプリケーションのインスタンスが複数設定されている場合、複数のロガーアプリケーション間で簡単なロードバランシングを実行します。 LiteSpeedサーバーは、常にロガーアプリケーションの数を可能な限り少なく保とうとします。 1つのロガーアプリケーションがアクセスログエントリを時間内に処理できない場合にのみ、サーバーはロガーアプリケーションの別のインスタンスを生成しようとします。
ロガーがクラッシュした場合、Webサーバーは別のインスタンスを開始しますが、ストリームバッファーのログデータは失われます。 外部ロガーがログストリームの速度と量に追いつけない場合、ログデータを失う可能性があります。
構文
ドロップダウンリストから選択
ログ形式
説明
Enterprise Edition Only アクセスログのログ形式を指定します。 ログフォーマットが設定されると、ログヘッダーの設定より優先されます。
構文
文字列。ログ形式の構文は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リクエストヘッダーReferer、UserAgent、Hostを記録するかどうかを指定します。
構文
チェックボックス
ヒント
パフォーマンス これらのヘッダーがアクセスログに不要な場合は、この機能をオフにします。
参照
バイトログ
説明
帯域幅バイトのログファイルへのパスを指定します。 指定すると、cPanel互換の帯域幅ログが作成されます。 これにより、要求と応答本体の両方を含む要求に対して転送された合計バイトが記録されます。
構文
ファイル名への絶対パス又は$SERVER_ROOTからの相対パス
ヒント
パフォーマンス ログファイルを別のディスクに配置します。
サーバーインデックスファイルを使用する
説明
サーバーのインデックスファイル設定を使用するかどうかを指定します。 はいに設定すると、サーバーの設定だけが使用されます。 いいえに設定すると、サーバーの設定は使用されません。 Additionに設定すると、このバーチャルホストのサーバーインデックスファイルリストに追加のインデックスファイルを追加できます。 このバーチャルホストのインデックスファイルを無効にする場合は、値をいいえに設定して、インデックスファイル欄を空のままにします。
構文
ドロップダウンリストから選択
インデックスファイル
説明
URLがディレクトリにマップされたときに順番に検索されるインデックスファイルの名前を指定します。 サーバー、バーチャルホスト、コンテキストレベルでカスタマイズできます。
構文
インデックスファイル名のカンマ区切りリスト。
ヒント
パフォーマンス必要なインデックスファイルのみを設定します。
自動インデックス
説明
インデックスファイルにリストされているインデックスファイルがディレクトリで使用できないときに、その場でディレクトリインデックスを生成するかどうかを指定します。 このオプションは、バーチャルホストおよびコンテキストレベルでカスタマイズ可能で、明示的に上書きされるまでディレクトリツリーに沿って継承されます。 生成された索引ページをカスタマイズできます。 オンラインWikiのHow-toを確認してください。
構文
ラジオボックスから選択
ヒント
セキュリティ 可能であれば、自動インデックスをオフにして、機密データの漏えいを防ぐことをお勧めします。
参照
自動インデックスURI
説明
インデックスファイルにリストされているインデックスファイルがディレクトリで使用できない場合に、インデックスページを生成するために使用されるURIを指定します。 LiteSpeed Webサーバーは外部スクリプトを使用してインデックスページを生成し、最大限のカスタマイズの柔軟性を提供します。 デフォルトスクリプトは、Apacheと同じ外観のインデックスページを生成します。 生成されたインデックスページをカスタマイズするには、オンラインWikiのHow-toを読んでください。 インデックス対象のディレクトリは、環境変数"LS_AI_PATH"を介してスクリプトに渡されます。
構文
URI
参照
カスタマイズエラーページ
説明
サーバーが要求を処理する際に問題が発生すると、サーバーはエラーコードとhtmlページをエラーメッセージとしてWebクライアントに返します。 エラーコードはHTTPプロトコルで定義されています(RFC 2616参照)。 LiteSpeed Webサーバーには、エラーコードごとにデフォルトのエラーページが組み込まれていますが、各エラーコードに対してカスタマイズされたページを設定することもできます。 これらのエラーページは、各バーチャルホストごとに一意になるようにさらにカスタマイズすることができます。
URL
説明
カスタマイズされたエラーページのURLを指定します。 サーバーは、対応するHTTPステータスコードが返されたときに、このURLにリクエストを転送します。 このURLが存在しないリソースを参照する場合は、組み込みのエラーページが使用されます。 URLは、静的ファイル、動的に生成されたページ、または別のWebサイトのページ("http(s)://"で始まるURL)にできます。 別のWebサイトのページを参照する場合、クライアントは元のステータスコードの代わりにリダイレクトステータスコードを受け取ります。
構文
URL
サフィックス
説明
このスクリプトハンドラで処理するスクリプトファイルのサフィックスを指定します。 サフィックスは一意である必要があります。
構文
カンマ区切りリストでピリオド"."は禁止されています。
ヒント
情報 サーバーは、リスト内の最初の接尾辞に特殊なMIMEタイプ( "application/x-httpd-[suffix]")を自動的に追加します。 たとえば、接尾辞 "php53"にMIMEタイプ "application/x-httpd-php53"が追加されます。 接尾辞はMIME設定設定で最初に設定する必要があります。
このフィールドではサフィックスを列挙していますが、スクリプトハンドラは接尾辞ではなくMIMEタイプを使用して、処理するスクリプトを決定します。 したがって、.htaccessファイルのApache設定ディレクティブ "AddType"と "ForceType"(ファイルMIMEタイプを制御する)を使用して、特定のファイルが使用するスクリプトハンドラを変更することができます。 たとえば、適切に配置された.htaccessファイルにAddType application/x-httpd-php53.phpディレクティブを指定すると、このディレクトリにあるphpファイルのMIMEタイプが "application/x-httpd-php53"となり、MIMEタイプ"application/x-httpd-php53"(接尾辞" php53 ")を使用するスクリプトハンドラによって処理されます。 これにより、異なるファイルサフィックスだけでなく、ファイルの場所に基づいて、異なるスクリプトハンドラを割り当てることができます。
パフォーマンスセキュリティ本当に必要なサフィックスのみを指定してください。
ハンドラタイプ
説明
これらのスクリプトファイルを処理する外部アプリケーションのタイプを指定します。使用可能なタイプは次のとおりです: LSAPI app、Webサーバー、Fast CGI、SCGI、CGI、Load balancer、 サーブレットエンジン、uWSGI、またはモジュールハンドラ。CGIおよびモジュールハンドラハンドラタイプを除き、ハンドラ名も 外部アプリケーションセクションで事前に定義された外部アプリケーションに設定する必要があります。
構文
ドロップダウンリストから選択
ハンドラ名
説明
ハンドラタイプがLSAPI app、Web Server (Proxy)、Fast CGI、SCGI、Load balancer、Servlet Engine、またはuWSGIの場合に、スクリプトファイルを処理する外部アプリケーションの名前を指定します。
構文
ドロップダウンリストから選択
.htaccess
説明
次のディレクティブは、ディレクトリレベルのアクセス制御ファイル(.htaccessファイル)でサポートされています。
- Authentication
- AuthType
- AuthName
- AuthUserFile
- AuthGroupFile
- Require
- Access Control
- Allow from
- Deny from
- Order
- File Info
- AddDefaultCharset
- AddType
- DefaultType
- ExpiresActive
- ExpiresDefault
- ExpiresByType
- ForceType
- Redirect
- RedirectTemp
- RedirectPermanent
- RewriteEngine
- RewriteOptions
- RewriteBase
- RewriteCond
- RewriteRule
- Satisfy
- Other
- <Limit>
- <LimitExcept>
- DirectoryIndex
- Options
オーバーライドを許可
説明
アクセス制御ファイル内のどのディレクティブが許可されるかを指定します。 アクセス制御ファイルは、そのディレクトリの下にあるファイルのアクセシビリティを制御するためにディレクトリに置くことができます。
- 何もチェックしないと、継承されたデフォルト設定が使用されます。
- なしをチェックすると、アクセス制御ファイルは無視されます。
- 制限をチェックすると、 "Order"、 "Allow from"、 "Deny from"の各ディレクティブが許可されます。
- 認証がチェックされていると、 "AuthGroupFile"、 "AuthName"、 "AuthType"、 "AuthUserFile"、および "Require"の各ディレクティブが許可されます。
- ファイル情報がチェックされているとき、 "Satisfy"、 "AddDefaultCharset"、 "AddType"、 "DefaultType"、 "ForceType"、 "ExpiresActive"、 "ExpiresDefault"、 "ExpiresByType"、 "RedirectTemp" 、 "RedirectPermanent"、 "RewriteEngine"、 "RewriteOptions"、 "RewriteBase"、 "RewriteCond"、および "RewriteRule"は許可されています
- インデックスがチェックされている場合、ディレクティブ "DirectoryIndex"が許可されます
- オプションがチェックされていると、 "Options"ディレクティブが許可されます
Allow Override設定には、サーバー、バーチャルホスト、およびコンテキストの3つのレベルがあります。 サーバレベルでコンフィグレーションがチェックされていない場合、より低いレベルで有効になっているかどうかに関わらず、制御されたディレクティブはサーバ全体で無効になります。 サーバーレベルで何かが有効になっている場合、バーチャルホストはデフォルトで同じ設定を継承します。 同様に、コンテキストレベルの設定はバーチャルホスト設定から継承されます。 下位レベルでは、上位レベルで有効になっている設定は無効にできますが、上位レベルで無効になっている設定は有効にできません。
構文
チェックボックスから選択
ヒント
パフォーマンスディレクトリレベルの設定をカスタマイズする必要がない場合は、なしをチェックしてください。
アクセスファイル名
説明
アクセス制御ファイルの名前を指定します。 これらのファイルは、オーバーライドを許可が有効な場合にのみ使用されます。 デフォルトの名前は.htaccessです。 これはサーバーレベルとバーチャルホストレベルで構成できます。 サーバーレベルはデフォルト設定で、バーチャルホストレベルでオーバーライドすることができます。
構文
"."で始まるファイル名
参照
有効期限を有効にする
説明
静的ファイルのExpiresヘッダーを生成するかどうかを指定します。 有効にすると、デフォルトの期限とタイプ別の期限に基づいてExpiresヘッダーが生成されます。
これは、サーバー、バーチャルホスト、コンテキストレベルで設定できます。 下位レベルの設定は上位レベルの設定を上書きします。 コンテキスト設定はバーチャルホストの設定を上書きし、バーチャルホストの設定はサーバーの設定を上書きします。
構文
ラジオボタンから選択
デフォルトの期限
説明
Expiresヘッダー生成のデフォルト設定を指定します。 この設定は、有効期限を有効にするが "はい"に設定されているときに有効になります。 タイプ別の期限で上書きできます。 すべてのページのExpiresヘッダーが生成されるため、必要がない限り、このデフォルトをサーバーまたはバーチャルホストレベルで設定しないでください。 ほとんどの場合、これは頻繁に変更されない特定のディレクトリのコンテキストレベルで設定する必要があります。 デフォルト設定がない場合、タイプ別の期限で指定されていないタイプに対してExpiresヘッダーは生成されません。
構文
A|M秒
このファイルは、基本時間(A | M)に指定された秒を加えた後に期限切れになります。 ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。
タイプ別の期限
説明
各MIMEタイプのExpiresヘッダー設定を指定します。
構文
"MIME-type=A|Mseconds"のカンマで区切られたリスト。 このファイルは、基本時間(A|M)に指定された秒を加えた後に期限切れになります。
ベース時刻 "A"はクライアントのアクセス時間に値を設定し、 "M"はファイルの最終変更時刻を設定します。 MIMEタイプはimage/*のようなワイルドカード "*"を受け入れます。
Apacheスタイル設定
説明
LiteSpeed固有の設定ファイルで使用するApache設定ディレクティブ(LiteSpeedでサポート)を指定します。 たとえば、デフォルトのPHP設定(php.iniエントリ)をオーバーライドするには、 "php_value"、 "php_flag"、 "php_admin_value"、 "php_admin_flag"の4つのディレクティブが必要です。
構文
Apache設定ファイルと同じです。
URI
説明
このWebSocketバックエンドを使用するURIを指定します。このURIへのトラフィックは、WebSocketアップグレードリクエストを含む場合にのみWebSocketバックエンドへ転送されます。
このアップグレードリクエストを含まないトラフィックは、このURIが属するコンテキストへ自動的に転送されます。このURIにコンテキストが存在しない場合、LSWSはこのトラフィックを$DOC_ROOT/URIの場所にある静的コンテキストへアクセスしているものとして扱います。
構文
プレーンURI("/"で始まる)。URIが"/"で終わる場合、このWebSocketバックエンドにはこのURI配下のすべてのサブURIが含まれます。
例
アドレス
説明
WebSocketバックエンドによって使用される一意のソケットアドレス。 IPv4ソケット、IPv6ソケット、Unixドメインソケット(UDS)がサポートされています。 IPv4およびIPv6ソケットは、ネットワークを介した通信に使用できます。 UDSは、WebSocketバックエンドがサーバーと同じマシンに存在する場合にのみ使用できます。
構文
IPv4/IPv6アドレス:ポート、UDS://パス、またはunix:パス
例
UDS://tmp/lshttpd/php.sock
unix:/tmp/lshttpd/php.sock
ヒント
セキュリティ WebSocketバックエンドが同じマシン上で実行される場合は、UDSの使用を推奨します。 IPv4またはIPv6ソケットを使用する必要がある場合は、IPアドレスをlocalhostまたは127.0.0.1に設定し、 他のマシンからWebSocketバックエンドへアクセスできないようにします。
パフォーマンス Unixドメインソケットは、一般にIPv4またはIPv6ソケットよりも高いパフォーマンスを提供します。