### OpenLiteSpeed Web Server ユーザーズマニュアル

##### Version 1.4 — Rev. 3

- ライセンス
- はじめに
- インストール
- 管理
  - サービスマネージャ
- セキュリティ
- 設定
  - サーバー全般
  - サーバーログ
  - サーバーのチューニング
  - サーバーのセキュリティ
  - 外部アプリ
  - Fast CGIアプリ
  - Fast CGIオーソライザー
  - LSAPIアプリ
  - サーブレットエンジン
  - Webサーバー
  - パイプロガー
  - ロードバランサ
  - スクリプトハンドラ
  - Rack/Railsの設定
  - モジュール設定
  - リスナー全般
  - リスナーのSSL
  - テンプレート
  - バーチャルホストの基本
  - バーチャルホスト全般
  - バーチャルホストのセキュリティ
  - バーチャルホストのSSL
  - Rewrite
  - コンテキスト
  - 静的コンテテキスト
  - Java Webアプリのコンテキスト
  - サーブレットコンテキスト
  - Fast CGIコンテキスト
  - LSAPIコンテキスト
  - プロキシコンテキスト
  - CGIコンテキスト
  - ロードバランサコンテキスト
  - コンテキストのリダイレクト
  - Rack/Railsのコンテキスト
  - モジュールハンドラのコンテキスト
  - Web Socketプロキシ
- Webコンソール
  - 管理コンソール全般
  - 管理コンソールのセキュリティ
  - 管理リスナー全般
  - 管理リスナーのSSL

# バーチャルホストの一般

## 目次

### ドキュメントルート⇑

#### 説明

このバーチャルホストのドキュメントルートを指定します。 $VH_ROOT/htmlをお勧めします。 このディレクトリは、コンテキストでは$DOC_ROOTと呼ばれます。

#### 構文

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

### 管理者用電子メール⇑

#### 説明

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

#### 構文

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

### GZIPを有効にする⇑

#### 説明

このバーチャルホストに対してGZIP圧縮を有効にするかどうかを指定します。 この設定は、サーバーレベルでGZIP圧縮が有効になっている場合にのみ有効です。 圧縮設定はサーバーレベルで設定されます（チューニング> GZIP）。

#### 構文

ラジオボックスから選択

#### 参照

圧縮を有効にする, Brotli Compression Level (Dynamic Content)

### IPジオロケーションを有効にする⇑

#### 説明

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

#### 構文

ラジオボックスから選択

#### 参照

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

### cgroups⇑

#### 説明

Apply cgroup settings to this CGI process if supported by the current OS. At this time, RedHat/Centos Linux v7.5+ and Ubuntu 18.04+ are supported. The currently executing user will be used to determine which cgroup configuration to apply.
Setting this to Disabled at the Server level will disable this setting server-wide. In all other cases, the Server level setting can be overridden at the Virtual Host level.
Default values:
Server level: Off
VH level: Inherit Server level setting

#### 構文

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

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

#### 説明

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

#### 構文

ラジオボックスから選択

### File Name⇑

#### 説明

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

#### 構文

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

#### ヒント

[パフォーマンス]ログファイルを別のディスクに配置します。

### ログレベル⇑

#### 説明

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

#### 構文

選択

#### ヒント

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

#### 参照

デバッグレベル

### ローテーションサイズ（バイト）⇑

#### 説明

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

#### 構文

整数

#### ヒント

キロ、メガ、ギガバイトの数字に「K」、「M」、「G」を追加します。

### ログ制御⇑

#### 説明

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

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

#### 構文

選択

### ファイル名⇑

#### 説明

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

#### 構文

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

#### ヒント

[パフォーマンス]アクセスログファイルを別のディスクに配置します。

### パイプロガー⇑

#### 説明

LiteSpeedがSTDINストリーム上のパイプを通じて送信するアクセスログデータを受け取る外部アプリケーションを指定します（ファイルハンドルは0）。 このフィールドが指定されると、アクセスログはロガーアプリケーションにのみ送信され、前のエントリで指定されたアクセスログファイルには送信されません。
ロガーアプリケーションは、最初に外部アプリケーションセクションで定義する必要があります。 サーバー・レベルのアクセス・ロギングは、サーバー・レベルで定義された外部ロガー・アプリケーションのみを使用できます。 バーチャルホストレベルのアクセスロギングでは、バーチャルホストレベルで定義されたロガーアプリケーションのみを使用できます。
ロガープロセスは、他の外部（CGI/FastCGI/LSAPI）プロセスと同じ方法で生成されます。 つまり、バーチャルホストの外部アプリ Set UID モード設定で指定されたユーザーIDとして実行され、特権ユーザーのために実行されることはありません。.
LiteSpeed Webサーバーは、複数のロガーアプリケーションのインスタンスが設定されている場合、複数のロガーアプリケーション間で簡単なロードバランシングを実行します。 LiteSpeedサーバーは、常にロガーアプリケーションの数を可能な限り低く抑えようとします。 1つのロガーアプリケーションがアクセスログエントリを時間内に処理できない場合にのみ、サーバーはロガーアプリケーションの別のインスタンスを生成しようとします。
ロガーがクラッシュした場合、Webサーバーは別のインスタンスを開始しますが、ストリームバッファーのログデータは失われます。 外部ロガーがログ・ストリームの速度と量に追いつけない場合、ログ・データを失う可能性があります。

#### 構文

選択

### Log Format⇑

#### 説明

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

#### 構文

文字列。ログフォーマットの構文はApache 2.0のカスタムと互換性があります log format。

#### 例

共通ログフォーマット（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"

#### 参照

ログヘッダー

### ログヘッダー⇑

#### 説明

Referer、UserAgent、HostのいずれかをHTTPリクエストヘッダとして記録するかどうかを指定します。

#### 構文

チェックボックス

#### ヒント

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

#### 参照

Log Format

### 保持日数⇑

#### 説明

アクセスログファイルをディスクに保管する日数を指定します。 指定した日数より古いローテーションしたログファイルのみが削除されます。 現在のログファイルには、それに含まれるデータの日数にかかわらず、表示されません。 古いログファイルを自動削除しない場合は、 0 に設定します。

#### 構文

整数

### バイトログ⇑

#### 説明

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

#### 構文

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

#### ヒント

[パフォーマンス]ログファイルを別のディスクに配置します。

### アーカイブを圧縮する⇑

#### 説明

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

#### 構文

ラジオボックスから選択

#### ヒント

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

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

#### 説明

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

#### 構文

選択

### インデックスファイル⇑

#### 説明

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

#### 構文

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

#### ヒント

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

### 自動インデックス⇑

#### 説明

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

#### 構文

ラジオボックスから選択

#### ヒント

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

#### 参照

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

### 自動インデックス URI⇑

#### 説明

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

#### 構文

URI

#### 参照

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

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

#### 説明

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

### エラーコード⇑

#### 説明

Sエラーページの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リソースとファイル転送時間が節約されますが、実装するためにバックエンドに若干の更新が必要です。 無効にすると、ファイルの内容はバックエンドハンドラに転送され、要求本文は引き続きファイルに解析されます。

#### 構文

ラジオボックスから選択

#### ヒント

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

### サフィックス⇑

#### 説明

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

#### 構文

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

#### ヒント

サーバーは、リスト内の最初の接尾辞に特殊なMIMEタイプ（ "application / x-httpd- [suffix]"）を自動的に追加します。 たとえば、接尾辞 "php53"にMIMEタイプ "application / x-httpd-php53"が追加されます。 接尾辞はMIME設定設定で最初に設定する必要があります。
このフィールドではサフィックスを列挙していますが、スクリプトハンドラは接尾辞ではなくMIMEタイプを使用して、処理するスクリプトを決定します。
[パフォーマンスとセキュリティ]本当に必要なサフィックスのみを指定してください。

### ハンドラタイプ⇑

#### 説明

これらのスクリプトファイルを処理する外部アプリケーションのタイプを指定します。 使用可能なタイプは以下のとおりです：CGI、FastCGI、Webサーバー、LSAPI app、ロードバランサ 又はサーブレットエンジン。 FastCGI、Webサーバー、およびServlet Engineの場合は、ハンドラ名を指定する必要があります。 これは、外部アプリケーションセクションで事前定義されている外部アプリケーション名です。

#### 構文

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

### ハンドラ名⇑

#### 説明

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

#### 構文

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

### php.ini Override⇑

#### 説明

Used to overwrite php.ini settings in the current context (Virtual Host level or Context level).
Supported directives are:
php_value
php_flag
php_admin_value
php_admin_flag
All other lines/directives will be ignored.

#### 構文

Override syntax is similar to Apache, a newline separated list of directives and their values with each directive being prepended by php_value, php_flag, php_admin_value, or php_admin_flag appropriately.

#### 例

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